1SMCD-DEVICE(8)             Linux Programmer's Manual            SMCD-DEVICE(8)
2
3
4

NAME

6       smcd-device - Print information about SMC-D devices
7
8       smcr-device - Print information about SMC-R devices
9
10

SYNOPSIS

12       smcd [ OPTIONS ] device  { COMMAND | help }
13
14
15       smcd device [ show ] [ all ]
16
17       smcr [ OPTIONS ] device  { COMMAND | help }
18
19
20       smcr device [ show ] [ all ] [ netdev NETDEV ] [ ibdev IBDEV ]
21
22

DESCRIPTION

24       The smcd device command displays SMC-D devices and their properties.
25       The smcr device command displays SMC-R devices and their properties.
26
27
28   smcd,smcr device show
29       inspect the device properties
30
31
32       all (default)
33              List all devices.
34
35
36       netdev NETDEV
37              SMC-R only: limit the command output to the device with the
38              specified network device name.
39
40
41       ibdev IBDEV
42              SMC-R only: limit the command output to the device port with the
43              specified RoCE device name.
44
45

OUTPUT

47   Net-Dev
48       Network device name.
49
50   IB-Dev
51       RoCE (InfiniBand) device name.
52
53   IB-P
54       InfiniBand port of the RoCE device. According to the InfiniBand conven‐
55       tions, the port count starts at 1. Consequently, devices where each
56       port is represented as a separate device will indicate the port as the
57       first port for all ports.
58
59   IB-State
60       State of the RoCE device port.
61
62       INACTIVE
63              The RoCE device port is inactive.
64
65       ACTIVE The RoCE device port is active.
66
67   Type
68       Type of the underlying PCI device.
69
70       RoCE_Express
71              Underlying used device is RoCE Express.
72
73       RoCE_Express2
74              Underlying used device is RoCE Express 2.
75
76       ISM    Underlying used device is ISM.
77
78   Crit / InUse
79       Show whether the device is critical i.e. without failover possibil‐
80       ity(SMC-R) or whether the device is in use.(SMC-D)
81
82       Yes    For SMC-R, there is at least one link group running on the de‐
83              vice with state "SINGLE" or locally "ASYMMETRIC" which means one
84              or more link groups without a failover device in case of a link
85              failure.  In case of SMC-D, there is at least one link group
86              running on the ISM device.
87
88       No     For SMC-R, there is no link group running on the device with
89              state "SINGLE" or locally "ASYMMETRIC" which means the link
90              group(s) have a fallback device in case of a failure.  In case
91              of SMC-D, there is no link group running on the ISM device.
92
93   FID
94       Function ID of the PCI device.
95
96   PCI-ID
97       ID of the PCI device.
98
99   PCHID
100       Physical channel ID of the PCI device.
101
102   #Links
103       Number of links (SMC-R)/link groups (SMC-D) on the device.
104
105   PNET-ID
106       PNET ID of the device. Leading asterisk "*" means PNET ID is set by the
107       user. (e.g "*PNET-ID")
108
109

EXAMPLES

111       1. Show all SMC-D devices:
112         # smcd device show all
113
114       2. Show all SMC-R devices:
115         # smcr devices show all
116
117       3. Show all SMC-R devices with RoCE (InfiniBand) device name "mlx4_0":
118         # smcr device show ibdev mlx4_0
119
120       4. Show all SMC-R devices with network device name "eth0":
121         # smcr device show netdev eth0
122

SEE ALSO

124       smcd(8), smcr(8)
125
126
127
128smc-tools                          June 2020                    SMCD-DEVICE(8)
Impressum