smcss - Display information about the AF_SMC sockets and link groups

6.10 LPAR mode z/VM guest KVM guest

Use the smcss command to display information about the AF_SMC sockets and link groups.

smcss syntax

Entering smcss without any parameters displays a list of connecting, closing, or connected SMC sockets.

-a or --all: lists all SMC sockets: listening, opening, closing, and connected.
-d or --debug: displays debug information, such as the shutdown state.
-D or --smcd: lists SMC-D sockets only. Displays additional SMC-D specific information.
-R or --smcr: lists SMC-R sockets only. Displays additional SMC-R specific information.
-l or --listening: lists listening sockets only. These are omitted in the default listing.
-w or --wide: prevents truncation of IP addresses.
-h or --help: displays help information for the command.
-v or --version: displays the version number of smcss.

Meaning of the output fields

Entry	Values and meaning
State	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.
Inode	denotes the inode of the SMC socket.
UID	denotes the unique ID of the SMC socket.
Local Address	denotes address and port number of the local end of the SMC socket. Trailing dots indicate a truncated address. Use the -w option to display full addresses.
Peer Address	denotes address and port number of the remote end of the socket.
Intf	denotes that if the socket is explicitly bound with setsockopt option SO_BINDTODEVICE, "Intf" shows the interface number of the Ethernet device to which the socket is bound.
Mode	can have the following values: SMCD The SMC socket uses SMC-D for data exchange. SMCR The SMC socket uses SMC-R for data exchange. TCP An SMC connection could not be established. The SMC socket uses the TCP protocol for data exchange.
ShutD	(shutdown) can take the following values: <-> 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 and cannot receive or send data.
Token	is a unique ID of the SMC socket connection.
Sndbuf	denotes the size of the to-be-sent window of the SMC socket connection.
Rcvbuf	denotes the size of the receiving window of the SMC socket connection (filled by peer).
Peerbuf	denotes the size of the peer receiving window of the SMC socket connection (to fill during data 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	Role can take the following values: 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.
IB-Device	Name of the RoCE device used by the link group to which the SMC socket belongs.
Port	Port of the RoCE device used by the link group to which the SMC socket belongs.
Linkid	unique link ID of the link within the link group to which the SMC socket belongs.
GID	Group identifier of the RoCE port used by the link group to which the SMC socket belongs.
Peer-GID	GID of the foreign RoCE port used by the link group to which the SMC socket belongs.

Examples

To display information about all SMC sockets on the server:

[root@myserver]# smcss -a
State          UID   Inode   Local Address           Peer Address            Intf Mode
INIT           00000 0000000
ACTIVE         00000 0060177 ::ffff:10.100.80..:6668 ::ffff:10.100.8..:40812 0000 SMCD
ACTIVE         00000 0060173 ::ffff:10.100.80..:6668 ::ffff:10.100.8..:40804 0000 SMCD
LISTEN         00000 0059058 :::6668

To list listening sockets on the server:

[root@myserver]# smcss -l
State          UID   Inode   Local Address           Peer Address            Intf Mode
LISTEN         00000 0059058 :::6668

To display debug information about all SMC sockets on the server:

[root@myserver]# smcss -d
State          UID   Inode   Local Address           Peer Address            Intf Mode Shutd Token    
ACTIVE         00000 0060177 ::ffff:10.100.80..:6668 ::ffff:10.100.8..:40812 0000 SMCD  <->  00...
ACTIVE         00000 0060173 ::ffff:10.100.80..:6668 ::ffff:10.100.8..:40804 0000 SMCD  <->  00...
...

For command return codes, see the man page.