core-lightning/doc/lightning-cli.1.md
Christian Decker c3254e6639 docs: Update manpages to be recognized correctly by mrkd
mrkd started enforcing the `name -- short description` style of top-level
headings somewhere, and was thus failing to build the man-pages. I swapped
the title and with the existing short description to make it work
again. `mrkd` will automatically infer the section from the filename so no
need to put it in the title as well.

In addition I removed the "last updated" lines at the bottom since they are
out of date at best, and misleading at the worst. If we want to keep them, I'd
suggest generating them from the commit that last touched them.
2019-09-02 16:31:36 +02:00

2.2 KiB
Raw Blame History

lightning-cli -- Control lightning daemon

SYNOPSIS

lightning-cli [OPTIONS] command

DESCRIPTION

lightning-cli sends commands to the lightning daemon.

OPTIONS

--lightning-dir=DIR Set the directory for the lightning daemon were talking to; defaults to $HOME/.lightning.

--rpc-file=FILE Named pipe to use to talk to lightning daemon: default is lightning-rpc in the lightning directory.

--keywords/-k Use format key=value for parameters in any order

--order/-o Follow strictly the order of parameters for the command

--json/-J Return result in JSON format (default unless help command)

--raw/-R Return raw JSON directly as lightningd replies

--human-readable/-H Return result in human-readable output (default for help command)

--help/-h Print summary of options to standard output and exit.

--version/-V Print version number to standard output and exit.

COMMANDS

lightning-cli simply uses the JSON RPC interface to talk to lightningd, and prints the results. Thus the commands available depend entirely on the lightning daemon itself.

ARGUMENTS

Arguments may be provided positionally or using key=value after the command name, based on either -o or -k option. Arguments may be integer numbers (composed entirely of digits), floating-point numbers (has a radix point but otherwise composed of digits), true, false, or null. Other arguments are treated as strings.

Some commands have optional arguments. You may use null to skip optional arguments to provide later arguments.

EXAMPLES

Example 1. List commands

lightning-cli help

BUGS

This manpage documents how it should work, not how it does work. The pretty printing of results isnt pretty.

AUTHOR

Rusty Russell <rusty@rustcorp.com.au> is mainly to blame.

RESOURCES

Main web site: https://github.com/ElementsProject/lightning

COPYING

Note: the modules in the ccan/ directory have their own licenses, but the rest of the code is covered by the BSD-style MIT license.