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 ar‐
29 gument, 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 -h, --help
56 displays usage information.
57 -R, --smcr
60 displays additional SMC-R specific information. Shows SMC-R
61 sockets only.
62 -v, --version
65 displays program version.
66 -W, --wide
69 do not truncate IP addresses.
70
73 State
74 The state of the socket. The state can be one of these values:
75 INIT The SMC socket is being initialized. It is not connected nor
77 listening yet.
78 CLOSED The SMC socket is closed. It is not connected nor listening any‐
80 more.
81 LISTEN The SMC socket is a listening socket, waiting for incoming con‐
83 nection requests.
84 ACTIVE The SMC socket has an established connection. In this state,
86 the TCP connection is fully established, rendezvous processing
87 has been completed, and SMC peers can exchange data via RDMA.
88 PEERCLW1
90 No further data will be sent to the peer.
91 PEERCLW2
93 No further data will be sent to or received from the peer.
94 APPLCLW1
96 No further data will be received from the peer.
97 APPLCLW2
99 No further data will be received from or sent to the peer.
100 APPLFINCLW
102 The peer has closed the socket.
103 PEERFINCLW
105 The socket is closed locally.
106 PEERABORTW
108 The socket was abnormally closed locally.
109 PROCESSABORT
111 The peer has closed the socket abnormally.
112 UID
114 User ID of the SMC socket.
115 Inode
117 Inode attribute of the socket.
118 Local Address
120 Address and port number of the local end of the SMC socket. The dis‐
121 played address is truncated when it ends with '..'. -W, --wide can be
122 used to display addresses untruncated.
123 Peer Address
125 Address and port number of the remote end of the socket. Analogous to
126 "Local Address".
127 Intf
129 When the socket is explicitly bound with setsockopt option SO_BINDTODE‐
130 VICE then Intf shows the interface number of the Ethernet device to
131 which the socket is bound.
132 Mode
134 SMCD The SMC socket uses SMC-D for data exchange.
135 SMCR The SMC socket uses SMC-R for data exchange.
137 TCP The SMC socket uses the TCP protocol for data exchange, because
139 an SMC connection could not be established.
140 In case of an error during connection setup, respective error codes
142 will be displayed in the format <local>/<remote>.
143 Linux error codes:
145 0x01010000 Out of memory
147 0x02010000 Timeout while waiting for confirm link message over RDMA
149 device
150 0x02020000 Timeout while waiting for RDMA device to be added
152 0x03000000 Configuration error
154 0x03010000 Peer does not support SMC
156 0x03020000 Connection uses IPsec
158 0x03030000 No SMC devices found (R and D)
160 0x03030001 No ISM device for SMC-D found
162 0x03030002 No RDMA device for SMC-R found
164 0x03030003 Hardware has no ISMv2 support
166 0x03030004 Peer sent no SMCv2 extension
168 0x03030005 Peer sent no SMC-Dv2 extension
170 0x03030006 Peer sent no ISMv2 SEID
172 0x03030007 No SMC-Dv2 device found, but required
174 0x03040000 SMC modes mismatch (R or D)
176 0x03050000 Peer has eyecatcher in RMBE
178 0x03060000 Fastopen sockopt not supported
180 0x03070000 IP prefix / subnet mismatch
182 0x03080000 Error retrieving VLAN ID of IP device
184 0x03090000 Error while registering VLAN ID on ISM device
186 0x030a0000 No active SMC-R link in link group
188 0x030b0000 SMC-R link from server not found
190 0x030c0000 SMC version mismatch
192 0x030d0000 SMC-D connection limit reached
194 0x04000000 Synchronization error
196 0x05000000 Peer declined during handshake
198 0x09990000 Internal error
200 0x09990001 rtoken handling failed
202 0x09990002 RDMA link failed
204 0x09990003 RMB registration failed
206 ShutD
209 <-> The SMC socket has not been shut down.
210 R-> The SMC socket is shut down one-way and cannot receive data.
212 <-W The SMC socket is shut down one-way and cannot send data.
214 R-W The SMC socket is shut down in both ways and cannot receive or
216 send data.
217 Token
219 Unique ID of the SMC socket connection.
220 Sndbuf
222 Size of the to-be-sent window of the SMC socket connection.
223 Rcvbuf
225 Size of the receiving window of the SMC socket connection (filled by
226 peer).
227 Peerbuf
229 Size of the peer receiving window of the SMC socket connection (to fill
230 during RDMA-transfer).
231 rxprod-Cursor
233 Describes the current cursor location of the "Rcvbuf" for data to be
234 received from the peer.
235 rxcons-Cursor
237 Describes the current cursor location of the "Peerbuf" for data sent to
238 peer and confirmed by the peer.
239 rxFlags
241 SMC socket connection flags set by and received from the peer.
242 txprod-Cursor
244 Describes the current cursor location of the "Peerbuf" for data sent to
245 peer.
246 txcons-Cursor
248 Describes the current cursor location of the "Rcvbuf" for data received
249 from the peer and confirmed to the peer.
250 txFlags
252 SMC socket connection flags set locally and sent to the peer.
253 txprep-Cursor
255 Describes the current cursor location of the "Sndbuf" for data to be
256 sent. The data is to be moved to the "Peerbuf".
257 txsent-Cursor
259 Describes the current cursor location of the "Sndbuf" for data sent.
260 The data was moved to the "Peerbuf".
261 txfin-Cursor
263 Describes the current cursor location of the "Sndbuf" for data sent and
264 send completion confirmed. The data was moved to the "Peerbuf" and
265 completion was confirmed.
266 Role
268 CLNT The link group of the SMC socket is used for client connections.
269 SERV The link group of the SMC socket is used for server connections.
271 IB-Device
273 Name of the RoCE device used by the link group to which the SMC socket
274 belongs.
275 Port
277 Port of the RoCE device used by the link group to which the SMC socket
278 belongs.
279 Linkid
281 Unique link ID of the link within the link group to which the SMC
282 socket belongs.
283 GID
285 Gid of the RoCE port used by the link group to which the SMC socket be‐
286 longs.
287 Peer-GID
289 Gid of the Foreign RoCE port used by the link group to which the SMC
290 socket belongs.
291 VLAN
293 tbd.
294
296 Successful smcss commands return 0 and display the requested socket
297 state table or link group information. If an error occurs, smcss
298 writes a message to stderr and completes with a return code other than
299 0.
300
302 af_smc(7), smc_chk(8) smc_rnics(8), smc_run(8), smc_pnet(8), smcd(8),
303 smcr(8)
304smc-tools June 2018 SMCSS(8)