mirror of
https://github.com/ElementsProject/lightning.git
synced 2025-01-05 21:44:42 +01:00
3cf91b23b9
Change all man pages to follow the style of doc/lightning-pay.7.md for the section on returning errors. Changelog-None
58 lines
1.3 KiB
Markdown
58 lines
1.3 KiB
Markdown
lightning-disconnect -- Command for disconnecting from another lightning node
|
||
=============================================================================
|
||
|
||
SYNOPSIS
|
||
--------
|
||
|
||
**disconnect** *id* \[*force*\]
|
||
|
||
DESCRIPTION
|
||
-----------
|
||
|
||
The disconnect RPC command closes an existing connection to a peer,
|
||
identified by *id*, in the Lightning Network, as long as it doesn’t have
|
||
an active channel. If *force* is set then it will disconnect even with
|
||
an active channel.
|
||
|
||
The *id* can be discovered in the output of the listpeers command, which
|
||
returns a set of peers:
|
||
|
||
{
|
||
"peers": [
|
||
{
|
||
"id": "0563aea81...",
|
||
"connected": true,
|
||
...
|
||
}
|
||
]
|
||
}
|
||
|
||
Passing the *id* attribute of a peer to *disconnect* will terminate the
|
||
connection.
|
||
|
||
RETURN VALUE
|
||
------------
|
||
|
||
On success, an empty object is returned.
|
||
|
||
On error the returned object will contain `code` and `message` properties,
|
||
with `code` being one of the following:
|
||
|
||
- -32602: If the given parameters are wrong.
|
||
- -1: Catchall nonspecific error.
|
||
|
||
AUTHOR
|
||
------
|
||
|
||
Michael Hawkins <<michael.hawkins@protonmail.com>>.
|
||
|
||
SEE ALSO
|
||
--------
|
||
|
||
lightning-connect(1), lightning-listpeers(1)
|
||
|
||
RESOURCES
|
||
---------
|
||
|
||
Main web site: <https://github.com/ElementsProject/lightning>
|