smcss - Man Page

print information about the AF_SMC sockets and link groups

Synopsis

smcss [--debug|-d] [--smcd|-D] [--wide|-W]

smcss {--all|-a} [--debug|-d] [--smcd|-D] [--wide|-W]

smcss [--debug|-d] [--smcr|-R] [--wide|-W]

smcss {--all|-a} [--debug|-d] [--smcr|-R] [--wide|-W]

smcss {--listening|-l} [--wide|-W]

smcss {--version|-v}

smcss {--help|-h}

Description

smcss prints information about the Linux AF_SMC sockets and link groups. The type of information printed is controlled by the first argument, as follows:

(none): displays a list of connecting, closing, or connected SMC sockets with basic information.
-a, --all: displays all types of SMC sockets: listening, opening, closing, and connected.
-l, --listening: shows listening sockets only. These are omitted by default.

Options

-d, --debug: displays additional debug information, such as shutdown state.
-D, --smcd: displays additional SMC-D specific information. Shows SMC-D sockets only.
-h, --help: displays usage information.
-R, --smcr: displays additional SMC-R specific information. Shows SMC-R sockets only.
-v, --version: displays program version.
-W, --wide: do not truncate IP addresses.

Output

State

The state of the socket. The state can be one of these values:

INIT: The SMC socket is being initialized. It is not connected nor listening yet.
CLOSED: The SMC socket is closed. It is not connected nor listening anymore.
LISTEN: The SMC socket is a listening socket, waiting for incoming connection requests.
ACTIVE: The SMC socket has an established connection. In this state, the TCP connection is fully established, rendezvous processing has been completed, and SMC peers can exchange data via RDMA.
PEERCLW1: No further data will be sent to the peer.
PEERCLW2: No further data will be sent to or received from the peer.
APPLCLW1: No further data will be received from the peer.
APPLCLW2: No further data will be received from or sent to the peer.
APPLFINCLW: The peer has closed the socket.
PEERFINCLW: The socket is closed locally.
PEERABORTW: The socket was abnormally closed locally.
PROCESSABORT: The peer has closed the socket abnormally.

Uid

User ID of the SMC socket.

Inode

Inode attribute of the socket.

Local Address

Address and port number of the local end of the SMC socket. The displayed address is truncated when it ends with '..'. -W, --wide can be used to display addresses untruncated.

Peer Address

Address and port number of the remote end of the socket. Analogous to "Local Address".

Intf

When the socket is explicitly bound with setsockopt option SO_BINDTODEVICE then Intf shows the interface number of the Ethernet device to which the socket is bound.

Mode

SMCD: The SMC socket uses SMC-D for data exchange.
SMCR: The SMC socket uses SMC-R for data exchange.
TCP: The SMC socket uses the TCP protocol for data exchange, because an SMC connection could not be established.

In case of an error during connection setup, respective error codes will be displayed in the format <local>/<remote>.

Linux error codes:

0x01010000: Out of memory
0x02010000: Timeout while waiting for confirm link message over RDMA device
0x02020000: Timeout while waiting for RDMA device to be added
0x03000000: Configuration error
0x03010000: Peer does not support SMC
0x03020000: Connection uses IPsec
0x03030000: No SMC devices found (R and D)
0x03030001: No ISM device for SMC-D found
0x03030002: No RDMA device for SMC-R found
0x03030003: Hardware has no ISMv2 support
0x03030004: Peer sent no SMCv2 extension
0x03030005: Peer sent no SMC-Dv2 extension
0x03030006: Peer sent no ISMv2 SEID
0x03030007: No SMC-Dv2 device found, but required
0x03030008: Peer sent no UEID
0x03040000: SMC modes mismatch (R or D)
0x03050000: Peer has eyecatcher in RMBE
0x03060000: Fastopen sockopt not supported
0x03070000: IP prefix / subnet mismatch
0x03080000: Error retrieving Vlan ID of IP device
0x03090000: Error while registering Vlan ID on ISM device
0x030a0000: No active SMC-R link in link group
0x030b0000: SMC-R link from server not found
0x030c0000: SMC version mismatch
0x030d0000: SMC-D connection limit reached
0x030e0000: SMC-Rv2 connection found no route to peer
0x030f0000: SMC-Rv2 connection mismatch direct/indirect with peer 0x04000000 Synchronization error
0x05000000: Peer declined during handshake
0x09990000: Internal error
0x09990001: rtoken handling failed
0x09990002: RDMA link failed
0x09990003: RMB registration failed

ShutD

<->: The SMC socket has not been shut down.
R->: The SMC socket is shut down one-way and cannot receive data.
<-W: The SMC socket is shut down one-way and cannot send data.
R-W: The SMC socket is shut down in both ways and cannot receive or send data.

Token

Unique ID of the SMC socket connection.

Sndbuf

Size of the to-be-sent window of the SMC socket connection.

Rcvbuf

Size of the receiving window of the SMC socket connection (filled by peer).

Peerbuf

Size of the peer receiving window of the SMC socket connection (to fill during RDMA-transfer).

rxprod-Cursor

Describes the current cursor location of the "Rcvbuf" for data to be received from the peer.

rxcons-Cursor

Describes the current cursor location of the "Peerbuf" for data sent to peer and confirmed by the peer.

rxFlags

SMC socket connection flags set by and received from the peer.

txprod-Cursor

Describes the current cursor location of the "Peerbuf" for data sent to peer.

txcons-Cursor

Describes the current cursor location of the "Rcvbuf" for data received from the peer and confirmed to the peer.

txFlags

SMC socket connection flags set locally and sent to the peer.

txprep-Cursor

Describes the current cursor location of the "Sndbuf" for data to be sent. The data is to be moved to the "Peerbuf".

txsent-Cursor

Describes the current cursor location of the "Sndbuf" for data sent. The data was moved to the "Peerbuf".

txfin-Cursor

Describes the current cursor location of the "Sndbuf" for data sent and send completion confirmed. The data was moved to the "Peerbuf" and completion was confirmed.

Role

CLNT: The link group of the SMC socket is used for client connections.
SERV: The link group of the SMC socket is used for server connections.