status
receptorctl status
displays the status of the Receptor network.
Command syntax: receptorctl --socket=<socket_path> status [--json]
socket_path
is the control socket address for the Receptor connection.The default is
unix:
for a Unix socket. Usetcp://
for a TCP socket. The corresponding environment variable isRECEPTORCTL_SOCKET
.
ss --listening --processes --unix 'src = unix:<socket_path>'
Netid State Recv-Q Send-Q Local Address:Port Peer Address:Port Process
u_str LISTEN 0 4096 /tmp/local.sock 38130170 * 0 users:(("receptor",pid=3226769,fd=7))
ps -fp $(pidof receptor)
lsof -p <<pid>
--json
option returns the output in JSON format.The default output format is human-readable. Using this argument allows output to be machine consumable. For example, piping into
jq
.
The output is divided into sections listed below. Field values may be listed in their own section. Columns are the actual JSON node values.
Node section
Column |
Description |
---|---|
|
Node identifier. |
|
Number of logical CPU cores on the node. |
|
Available memory (MiB) of the node. |
|
Receptor version. |
Connections section
Column |
Description |
---|---|
|
Connections. |
|
Metric (route preference) to reach NodeID. |
|
Node ID. |
Known connections section
Column |
Description |
---|---|
|
Known Connections. |
|
Remote node ID. |
|
Cost to get to NodeID 1 through NodeID 2. |
Routing Table Section
Column |
Description |
---|---|
|
Routing Table. |
|
List of NodeID(s) used to get to desired NodeID. |
Service Advertisement Section
Column |
Description |
---|---|
|
Advertisements. |
|
Connection type (see below for values). |
|
Node identifier issuing advertisement. |
|
Receptor services on node. |
|
Tags associated with node. |
|
Timestamp when advertisement sent. |
Execution Node Section
Column |
Description |
---|---|
|
Execution Node work commands. |
|
Boolean indicating whether the work commands are signed. |
|
Work command(s) supported. |
Connection Type
ConnType Value |
Description |
---|---|
0 |
Datagram. |
1 |
Stream. |
2 |
StreamTLS. |