Provided by: smc-tools_1.8.2-0ubuntu3_amd64 bug

NAME

       smcss - 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.

   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
       Gid 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.

   VLAN
       tbd.

RETURN CODES

       Successful smcss commands return 0 and display the requested socket state  table  or  link
       group  information.   If  an  error occurs, smcss writes a message to stderr and completes
       with a return code other than 0.

SEE ALSO

       af_smc(7), smc_chk(8) smc_rnics(8), smc_run(8), smc_pnet(8), smcd(8), smcr(8)