forked from ibm-s390-linux/smc-tools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
smc-linkgroup.8
216 lines (185 loc) · 4.28 KB
/
smc-linkgroup.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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
.\" smc-linkgroup.8
.\"
.\"
.\" Copyright IBM Corp. 2020
.\" Author(s): Guvenc Gulce <[email protected]>
.\" ----------------------------------------------------------------------
.\"
.TH SMC-LINKGROUP 8 "June 2020" "smc-tools" "Linux Programmer's Manual"
.SH NAME
smc-linkgroup \- Print information about SMC linkgroups and links
.SH "SYNOPSIS"
.sp
.ad l
.in +8
.ti -8
.B smc
.RI "[ " OPTIONS " ]"
.B linkgroup
.RI " { " COMMAND " | "
.BR help " }"
.sp
.ti -8
.BR "smc linkgroup" " { " show " | " link-show " } ["
.B "all "
.RI "| " LG-ID " ] [ "
.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 linkgroup
command displays linkgroups, links and their properties. Links can be
listed only for SMC-R linkgroups. The command operates with type smcr
per default on all command levels.
.SS smc linkgroup show - look at the linkgroup properties
.TP
.B all (default)
Show all the linkgroups.
.TP
.I LG-ID
Show the linkgroup with the id
.I LG-ID
.TP
.BI type " TYPE"
List only linkgroups of the given type.
.TP
.BI netdev " NETDEV"
List linkgroups making use of the given network device only.
.TP
.BI ibdev " IBDEV"
List only linkgroups of the given RoCE (infiniband) device.
.SS smc linkgroup link-show - look at the link properties (SMC-R only)
.TP
.B all (default)
Show all the links of the linkgroups.
.TP
.I LG-ID
Show links of the linkgroup with the id
.I LG-ID
.TP
.BI type " TYPE"
List only links of the linkgroups of the given type.
.TP
.BI netdev " NETDEV"
List only links of the linkgroups making use of the given network device.
.TP
.BI ibdev " IBDEV"
List only links of the linkgroups of the given RoCE (InfiniBand) device.
.SH OUTPUT
.SS "LG-ID"
ID of the linkgroup.
.SS "LG-Role"
Role of the linkgroup.
.TP
.I
SERV
The linkgroup has a SERVER role.
.TP
.I
CLNT
The linkgroup has a CLIENT role.
.SS "LG-Type"
Linkgroup type of the linkgroup.
.TP
.I
NONE
The linkgroup has the initial type.
.TP
.I
SINGLE
The linkgroup has only a single link, i.e.
the local and the peer system can offer one device port only for this linkgroup,
which means a link outage on any side cannot be covered.
.TP
.I
SYM
The linkgroup has two symmetric links, i.e.
the local and the peer system can offer two device ports for this linkgroup,
which means a link outage on any side can be covered.
.TP
.I
ASYMP
The linkgroup has asymmetric links, i.e.
the peer system can offer one device port only for this linkgroup,
which means a link outage on the peer side cannot be covered.
.TP
.I
ASYML
The linkgroup has asymmetric links, i.e.
the local system can offer one device port only for this linkgroup,
which means a link outage on the local side cannot be covered.
.SS "VLAN"
VLAN the linkgroup belongs to.
.SS "#Conns"
Number of connections(sockets) running on the link/linkgroup.
.SS "PNET-ID"
PNET-ID of the linkgroup. "*" means PNET-ID is set by the user.
.SS "Net-Dev"
Network device name corresponding to the link.
.SS "Link-State"
The state of the link.
.TP
.I
LINK_UNUSED
The link is not in use and in initial state.
.TP
.I
LINK_INACTIVE
The link is inactive and will go away.
.TP
.I
LINK_ACTIVATING
The link is being activated with the peer.
.TP
.I
LINK_ACTIVE
The link is active and operates on an established link with the peer.
Data is being exchanged via RDMA.
.SS "Link-UID"
Unique identifier of the link. This identifier consists of linkgroup id and
link id.
.SS "Peer-UID"
Unique identifier of the link on peer side. This identifier consists of
linkgroup id and link id.
.SS "IB-Dev"
Name of the RoCE device used by the link.
.SS "IB-P"
Port of the RoCE device used by the link.
.SS "Local-GID"
GID of the RoCE port used by the link.
.SS "Peer-GID"
GID of the peer RoCE port used by the link.
.SH "EXAMPLES"
.br
1. Show all linkgroups of the type smcd:
.br
\fB# smc linkgroup show all type smcd\fP
.br
2. Show all links of the linkgroups with type smcr:
.br
\fB# smc linkgroup link-show all type smcr\fP
.br
3. Show all links with linkgroup id 40:
.br
\fB# smc linkgroup link-show 40\fP
.br
4. Show all links on RoCE device "mlx4_0":
.br
\fB# smc linkgroup link-show ibdev mlx4_0\fP
.br
5. Shows all links on network device "eth0":
.br
\fB# smc linkgroup link-show netdev eth0\fP
.br
.SH SEE ALSO
.br
.BR smcd (8),
.BR smcr (8)