2019-08-31 13:30:56 +01:00
|
|
|
|
lightning-disconnect -- Command for disconnecting from another lightning node
|
|
|
|
|
=============================================================================
|
2019-08-10 00:54:18 +01:00
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
------------
|
|
|
|
|
|
doc/schemas: disableoffer, disconnect, feerates, fetchinvoice, fundchannel, fundchannel_cancel, fundchannel_complete, fundchannel_start, fundpsbt, getinfo, getlog, getroute.
We also add a test for getlog, since it was never called by the
testsuite.
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2021-05-26 08:35:01 +01:00
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
2019-08-10 00:54:18 +01:00
|
|
|
|
On success, an empty object is returned.
|
doc/schemas: disableoffer, disconnect, feerates, fetchinvoice, fundchannel, fundchannel_cancel, fundchannel_complete, fundchannel_start, fundpsbt, getinfo, getlog, getroute.
We also add a test for getlog, since it was never called by the
testsuite.
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2021-05-26 08:35:01 +01:00
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
2019-08-10 00:54:18 +01:00
|
|
|
|
|
2020-01-07 16:59:24 +00:00
|
|
|
|
On error the returned object will contain `code` and `message` properties,
|
|
|
|
|
with `code` being one of the following:
|
2019-08-10 00:54:18 +01:00
|
|
|
|
|
2020-01-07 16:59:24 +00:00
|
|
|
|
- -32602: If the given parameters are wrong.
|
|
|
|
|
- -1: Catchall nonspecific error.
|
2019-08-10 00:54:18 +01:00
|
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
Michael Hawkins <<michael.hawkins@protonmail.com>>.
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
lightning-connect(1), lightning-listpeers(1)
|
|
|
|
|
|
|
|
|
|
RESOURCES
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
2020-08-25 02:33:16 +01:00
|
|
|
|
|
2021-06-16 02:08:17 +01:00
|
|
|
|
[comment]: # ( SHA256STAMP:f807f98a54c194fab710f8a3393e96685fdbd0efa5e178cca54507a70a7a5c20)
|