forked from ibm-s390-linux/smc-tools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
smc-device.8
162 lines (142 loc) · 3.03 KB
/
smc-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
.\" smc-device.8
.\"
.\"
.\" Copyright IBM Corp. 2020
.\" Author(s): Guvenc Gulce <guvenc@linux.ibm.com>
.\" ----------------------------------------------------------------------
.\"
.TH SMC-DEVICE 8 "June 2020" "smc-tools" "Linux Programmer's Manual"
.SH NAME
smc-device \- Print information about SMC devices
.SH "SYNOPSIS"
.sp
.ad l
.in +8
.ti -8
.B smc
.RI "[ " OPTIONS " ]"
.B device
.RI " { " COMMAND " | "
.BR help " }"
.sp
.ti -8
.BR "smc device"
.RI "["
.B "show"
.RI "] ["
.B "all"
.RI "] [ "
.B type
.IR TYPE " ] [ "
.B netdev
.IR NETDEV " ] [ "
.B ibdev
.IR IBDEV " ]
.ti -8
.IR TYPE " := [ "
.BR smcr " | "
.BR smcd " ]"
.SH "DESCRIPTION"
The
.B smc device
command displays SMC devices and their properties. Devices can be
listed for SMC-R and SMC-D. The command operates with SMC-R type
per default on all command levels.
.SS smc device show - look at the device properties
.TP
.B all (default)
Show all the devices.
.TP
.BI type " TYPE"
List only the devices of the given type.
.TP
.BI netdev " NETDEV"
List only the device with the given network device name.
.TP
.BI ibdev " IBDEV"
List only the device ports with the given RoCE (InfiniBand) 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.
.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
RoCE_Express3
Underlying used device is RoCE Express 3.
.TP
.I
ISM
Underlying used device is ISM.
.SS "Crit"
Show whether the device is critical i.e. without failover possibility.
.TP
.I
Yes
In case of SMC-R, there is at least one linkgroup running on the
device with state "SINGLE" or locally "ASYMMETRIC" which
means the linkgroups do not have any fail-over device in case of
a failure.
In case of SMC-D, there is at least one linkgroup running on the
ISM device.
.TP
.I
No
In case of SMC-R, there is no linkgroup running on the device with
state "SINGLE" or locally "ASYMMETRIC" which means the linkgroup(s)
have a fallback device in case of a failure.
In case of SMC-D, there is no linkgroup running on the ISM device.
.SS "FID"
Functional 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)/linkgroups(SMC-D) on the device.
.SS "PNET-ID"
PNET-ID of the device. "*" means PNET-ID is set by the user.
.SH "EXAMPLES"
.br
1. Show all devices of the type smcd:
.br
\fB# smc device show all type smcd\fP
.br
2. Show all devices of the type smcr:
.br
\fB# smc devices show all type smcr\fP
.br
3. Shows all devices with RoCE (InfiniBand) device name "mlx4_0":
.br
\fB# smc device show ibdev mlx4_0\fP
.br
4. Shows all devices with network device name "eth0":
.br
\fB# smc device show netdev eth0\fP
.br
.SH SEE ALSO
.br
.BR smcd (8),
.BR smcr (8)