1SMCSS(8) Linux Programmer's Manual SMCSS(8)
3
7 smcss - print information about the AF_SMC sockets and link groups.
8
11 smcss [--debug|-d] [--smcd|-D] [--wide|-W]
12 smcss {--all|-a} [--debug|-d] [--smcd|-D] [--wide|-W]
14 smcss [--debug|-d] [--smcr|-R] [--wide|-W]
16 smcss {--all|-a} [--debug|-d] [--smcr|-R] [--wide|-W]
18 smcss {--listening|-l} [--wide|-W]
20 smcss {--version|-v}
22 smcss {--help|-h}
24
27 smcss prints information about the Linux AF_SMC sockets and link
28 groups. The type of information printed is controlled by the first
29 argument, as follows:
30 (none)
32 displays a list of connecting, closing, or connected SMC sockets
33 with basic information.
34 -a, --all
37 displays all types of SMC sockets: listening, opening, closing,
38 and connected.
39 -l, --listening
42 shows listening sockets only. These are omitted by default.
43
46 -d, --debug
47 displays additional debug information, such as shutdown state.
48 -D, --smcd
51 displays additional SMC-D specific information. Shows SMC-D
52 sockets only.
53 -R, --smcr
56 displays additional SMC-R specific information. Shows SMC-R
57 sockets only.
58 -W, --wide
61 do not truncate IP addresses.
62
65 State
66 The state of the socket. The state can be one of these values:
67 INIT The SMC socket is being initialized. It is not connected nor
69 listening yet.
70 CLOSED The SMC socket is closed. It is not connected nor listening any‐
72 more.
73 LISTEN The SMC socket is a listening socket, waiting for incoming con‐
75 nection requests.
76 ACTIVE The SMC socket has an established connection. In this state,
78 the TCP connection is fully established, rendezvous processing
79 has been completed, and SMC peers can exchange data via RDMA.
80 PEERCLW1
82 No further data will be sent to the peer.
83 PEERCLW2
85 No further data will be sent to or received from the peer.
86 APPLCLW1
88 No further data will be received from the peer.
89 APPLCLW2
91 No further data will be received from or sent to the peer.
92 APPLFINCLW
94 The peer has closed the socket.
95 PEERFINCLW
97 The socket is closed locally.
98 PEERABORTW
100 The socket was abnormally closed locally.
101 PROCESSABORT
103 The peer has closed the socket abnormally.
104 UID
106 User ID of the SMC socket.
107 Inode
109 Inode attribute of the socket.
110 Local Address
112 Address and port number of the local end of the SMC socket. The dis‐
113 played address is truncated when it ends with '..'. -W, --wide can be
114 used to display addresses untruncated.
115 Peer Address
117 Address and port number of the remote end of the socket. Analogous to
118 "Local Address".
119 Intf
121 When the socket is explicitly bound with setsockopt option SO_BINDTODE‐
122 VICE then Intf shows the interface number of the Ethernet device to
123 which the socket is bound.
124 Mode
126 SMCD The SMC socket uses SMC-D for data exchange.
127 SMCR The SMC socket uses SMC-R for data exchange.
129 TCP The SMC socket uses the TCP protocol for data exchange, because
131 an SMC connection could not be established.
132 In case of an error during connection setup, respective error codes
134 will be displayed in the format <local>/<remote>.
135 Linux error codes:
137 0x01010000 Out of memory
139 0x02010000 Timeout while waiting for confirm link message over RDMA
141 device
142 0x02020000 Timeout while waiting for RDMA device to be added
144 0x03000000 Configuration error
146 0x03010000 Peer does not support SMC
148 0x03020000 Connection uses IPsec
150 0x03030000 No SMC devices found (R and D)
152 0x03030001 No ISM device for SMC-D found
154 0x03030002 No RDMA device for SMC-R found
156 0x03030003 Peer not reachable through ISM device
158 0x03040000 SMC modes mismatch (R or D)
160 0x03050000 Peer has eyecatcher in RMBE
162 0x03060000 Fastopen sockopt not supported
164 0x03070000 IP prefix / subnet mismatch
166 0x03080000 Error retrieving VLAN ID of IP device
168 0x03090000 Error while registering VLAN ID on ISM device
170 0x030a0000 No active SMC-R link in link group
172 0x030b0000 SMC-R link from server not found
174 0x030c0000 SMC version mismatch
176 0x030d0000 SMC-D connection limit reached
178 0x04000000 Synchronization error
180 0x05000000 Peer declined during handshake
182 0x09990000 Internal error
184 0x09990001 rtoken handling failed
186 0x09990002 RDMA link failed
188 0x09990003 RMB registration failed
190 ShutD
193 <-> The SMC socket has not been shut down.
194 R-> The SMC socket is shut down one-way and cannot receive data.
196 <-W The SMC socket is shut down one-way and cannot send data.
198 R-W The SMC socket is shut down in both ways and cannot receive or
200 send data.
201 Token
203 Unique ID of the SMC socket connection.
204 Sndbuf
206 Size of the to-be-sent window of the SMC socket connection.
207 Rcvbuf
209 Size of the receiving window of the SMC socket connection (filled by
210 peer).
211 Peerbuf
213 Size of the peer receiving window of the SMC socket connection (to fill
214 during RDMA-transfer).
215 rxprod-Cursor
217 Describes the current cursor location of the "Rcvbuf" for data to be
218 received from the peer.
219 rxcons-Cursor
221 Describes the current cursor location of the "Peerbuf" for data sent to
222 peer and confirmed by the peer.
223 rxFlags
225 SMC socket connection flags set by and received from the peer.
226 txprod-Cursor
228 Describes the current cursor location of the "Peerbuf" for data sent to
229 peer.
230 txcons-Cursor
232 Describes the current cursor location of the "Rcvbuf" for data received
233 from the peer and confirmed to the peer.
234 txFlags
236 SMC socket connection flags set locally and sent to the peer.
237 txprep-Cursor
239 Describes the current cursor location of the "Sndbuf" for data to be
240 sent. The data is to be moved to the "Peerbuf".
241 txsent-Cursor
243 Describes the current cursor location of the "Sndbuf" for data sent.
244 The data was moved to the "Peerbuf".
245 txfin-Cursor
247 Describes the current cursor location of the "Sndbuf" for data sent and
248 send completion confirmed. The data was moved to the "Peerbuf" and
249 completion was confirmed.
250 Role
252 CLNT The link group of the SMC socket is used for client connections.
253 SERV The link group of the SMC socket is used for server connections.
255 IB-Device
257 Name of the RoCE device used by the link group to which the SMC socket
258 belongs.
259 Port
261 Port of the RoCE device used by the link group to which the SMC socket
262 belongs.
263 Linkid
265 Unique link ID of the link within the link group to which the SMC
266 socket belongs.
267 GID
269 Gid of the RoCE port used by the link group to which the SMC socket
270 belongs.
271 Peer-GID
273 Gid of the Foreign RoCE port used by the link group to which the SMC
274 socket belongs.
275 VLAN
277 tbd.
278
280 Successful smcss commands return 0 and display the requested socket
281 state table or link group information. If an error occurs, smcss
282 writes a message to stderr and completes with a return code other than
283 0.
284
286 af_smc(7), smc_rnics(8), smc_run(8), smc_pnet(8)
287smc-tools June 2018 SMCSS(8)