mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-20 02:27:51 +01:00
6e636a835f
1. listpeers has a deprecated `"closer": null`, which we need to handle in the schema, while trying not to damage our documentation too much. 2. Don't print a condition if there are no fields to print. 3. Allow a special "untyped" marker for multifundchannel which returns arbitrary JSON in a field. 4. Allow a single field return (for 'stop'). Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
67 lines
1.4 KiB
Groff
Generated
67 lines
1.4 KiB
Groff
Generated
.TH "LIGHTNING-DISCONNECT" "7" "" "" "lightning-disconnect"
|
||
.SH NAME
|
||
lightning-disconnect - Command for disconnecting from another lightning node
|
||
.SH SYNOPSIS
|
||
|
||
\fBdisconnect\fR \fIid\fR [\fIforce\fR]
|
||
|
||
.SH DESCRIPTION
|
||
|
||
The disconnect RPC command closes an existing connection to a peer,
|
||
identified by \fIid\fR, in the Lightning Network, as long as it doesn’t have
|
||
an active channel\. If \fIforce\fR is set then it will disconnect even with
|
||
an active channel\.
|
||
|
||
|
||
The \fIid\fR can be discovered in the output of the listpeers command, which
|
||
returns a set of peers:
|
||
|
||
.nf
|
||
.RS
|
||
{
|
||
"peers": [
|
||
{
|
||
"id": "0563aea81...",
|
||
"connected": true,
|
||
...
|
||
}
|
||
]
|
||
}
|
||
|
||
|
||
.RE
|
||
|
||
.fi
|
||
|
||
Passing the \fIid\fR attribute of a peer to \fIdisconnect\fR will terminate the
|
||
connection\.
|
||
|
||
.SH RETURN VALUE
|
||
|
||
On success, an empty object is returned\.
|
||
|
||
|
||
On error the returned object will contain \fBcode\fR and \fBmessage\fR properties,
|
||
with \fBcode\fR being one of the following:
|
||
|
||
.RS
|
||
.IP \[bu]
|
||
-32602: If the given parameters are wrong\.
|
||
.IP \[bu]
|
||
-1: Catchall nonspecific error\.
|
||
|
||
.RE
|
||
.SH AUTHOR
|
||
|
||
Michael Hawkins \fI<michael.hawkins@protonmail.com\fR>\.
|
||
|
||
.SH SEE ALSO
|
||
|
||
\fBlightning-connect\fR(1), \fBlightning-listpeers\fR(1)
|
||
|
||
.SH RESOURCES
|
||
|
||
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
||
|
||
\" SHA256STAMP:ce9e367309c8e5cabc9d4ac8dfd878f893dd3b9235c0c4b1a2bb0e431cf5b5f6
|