forked from ibm-s390-linux/smc-tools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
smcd-device.8
166 lines (152 loc) · 3.34 KB
/
smcd-device.8
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
.\" smcd-device.8
.\"
.\"
.\" Copyright IBM Corp. 2020
.\" Author(s): Guvenc Gulce <[email protected]>
.\" ----------------------------------------------------------------------
.\"
.TH SMCD-DEVICE 8 "June 2020" "smc-tools" "Linux Programmer's Manual"
.SH NAME
smcd-device \- Print information about SMC-D devices
smcr-device \- Print information about SMC-R devices
.SH "SYNOPSIS"
.sp
.ad l
.in +8
.ti -8
.B smcd
.RI "[ " OPTIONS " ]"
.B device
.RI " { " COMMAND " | "
.BR help " }"
.sp
.ti -8
.BR "smcd device"
.RI "["
.B "show"
.RI "] ["
.B "all"
.RI "] "
.ti -8
.B smcr
.RI "[ " OPTIONS " ]"
.B device
.RI " { " COMMAND " | "
.BR help " }"
.sp
.ti -8
.BR "smcr device"
.RI "["
.B "show"
.RI "] ["
.B "all"
.RI "] [ "
.B netdev
.IR NETDEV " ] [ "
.B ibdev
.IR IBDEV " ]
.SH "DESCRIPTION"
The
.B smcd device
command displays SMC-D devices and their properties.
The
.B smcr device
command displays SMC-R devices and their properties.
.SS smcd,smcr device show
inspect the device properties
.TP
.B all (default)
List all devices.
.TP
.BI netdev " NETDEV"
.B SMC-R
only: limit the command output to the device with the specified network device name.
.TP
.BI ibdev " IBDEV"
.B SMC-R
only: limit the command output to the device port with the specified RoCE device name.
.SH OUTPUT
.SS "Net-Dev"
Network device name.
.SS "IB-Dev"
RoCE (InfiniBand) device name.
.SS "IB-P"
InfiniBand port of the RoCE device. According to the InfiniBand conventions, the port count starts at 1. Consequently, devices where each port is represented as a separate device will indicate the port as the first port for all ports.
.SS "IB-State"
State of the RoCE device port.
.TP
.I
INACTIVE
The RoCE device port is inactive.
.TP
.I
ACTIVE
The RoCE device port is active.
.SS "Type"
Type of the underlying PCI device.
.TP
.I
RoCE_Express
Underlying used device is RoCE Express.
.TP
.I
RoCE_Express2
Underlying used device is RoCE Express 2.
.TP
.I
ISM
Underlying used device is ISM.
.SS "Crit / InUse"
Show whether the device is critical i.e. without failover possibility(SMC-R) or
whether the device is in use.(SMC-D)
.TP
.I
Yes
For SMC-R, there is at least one link group running on the
device with state "SINGLE" or locally "ASYMMETRIC" which
means one or more link groups without a failover device in case of a link failure.
In case of SMC-D, there is at least one link group running on the
ISM device.
.TP
.I
No
For SMC-R, there is no link group running on the device with
state "SINGLE" or locally "ASYMMETRIC" which means the link group(s)
have a fallback device in case of a failure.
In case of SMC-D, there is no link group running on the ISM device.
.SS "FID"
Function ID of the PCI device.
.SS "PCI-ID"
ID of the PCI device.
.SS "PCHID"
Physical channel ID of the PCI device.
.SS "#Links"
Number of links (SMC-R)/link groups (SMC-D) on the device.
.SS "PNET-ID"
PNET ID of the device. Leading asterisk "*" means PNET ID is set by the user. (e.g "*PNET-ID")
.SH "EXAMPLES"
.br
.HP 2
1. Show all SMC-D devices:
.br
\fB# smcd device show all\fP
.br
.HP 2
2. Show all SMC-R devices:
.br
\fB# smcr devices show all\fP
.br
.HP 2
3. Show all SMC-R devices with RoCE (InfiniBand) device name "mlx4_0":
.br
\fB# smcr device show ibdev mlx4_0\fP
.br
.HP 2
4. Show all SMC-R devices with network device name "eth0":
.br
\fB# smcr device show netdev eth0\fP
.br
.SH SEE ALSO
.br
.BR smcd (8),
.BR smcr (8)