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

NAME

6       smcd-linkgroup - Print information about SMC-D linkgroups
7
8       smcr-linkgroup - Print information about SMC-R linkgroups and links
9
10

SYNOPSIS

12       smcd [ OPTIONS ] linkgroup  { COMMAND | help }
13
14
15       smcd linkgroup [ show ] [ all | LG-ID ]
16
17       smcr [ OPTIONS ] linkgroup  { COMMAND | help }
18
19
20       smcr linkgroup { show | link-show } [ all | LG-ID ] [ netdev NETDEV ] [
21               ibdev IBDEV ]
22
23

DESCRIPTION

25       The smcd linkgroup command displays SMC-D linkgroups and their proper‐
26       ties.  The smcr linkgroup command displays SMC-R linkgroups, links and
27       their properties.
28
29
30   smcd,smcr linkgroup show
31       inspect the linkgroup properties
32
33
34       all (default)
35              Show all the linkgroups.
36
37
38       LG-ID  Show the linkgroup with the ID LG-ID
39
40
41       netdev NETDEV
42              SMC-R only: list linkgroups making use of the given network de‐
43              vice only.
44
45
46       ibdev IBDEV
47              SMC-R only: list only linkgroups of the given RoCE device.
48
49
50   smcr linkgroup link-show
51       SMC-R only: Inspect the link properties
52
53
54       all (default)
55              Show all the links in the linkgroups.
56
57
58       LG-ID  Show links of the linkgroup(SMC-R) or the linkgroup(SMC-R/SMC-D)
59              with the id LG-ID
60
61
62       netdev NETDEV
63              List only links of the linkgroups making use of the given net‐
64              work device.
65
66
67       ibdev IBDEV
68              List only links of the linkgroups of the given RoCE device.
69
70

OUTPUT

72   LG-ID
73       ID of the linkgroup.
74
75   LG-Role
76       Role of the linkgroup.
77
78       SERV   The linkgroup has a SERVER role.
79
80       CLNT   The linkgroup has a CLIENT role.
81
82   LG-Type
83       Linkgroup type of the linkgroup.
84
85       NONE   The linkgroup has the initial type.
86
87       SINGLE The linkgroup has only a single link, i.e.  the local and the
88              peer system can offer one device port only for this linkgroup,
89              which means a link outage on any side cannot be covered.
90
91       SYM    The linkgroup has two symmetric links, i.e.  the local and the
92              peer system can offer two device ports for this linkgroup, which
93              means a link outage on any side can be covered.
94
95       ASYMP  The linkgroup has asymmetric links, i.e.  the peer system can
96              offer one device port only for this linkgroup, which means a
97              link outage on the peer side cannot be covered.
98
99       ASYML  The linkgroup has asymmetric links, i.e.  the local system can
100              offer one device port only for this linkgroup, which means a
101              link outage on the local side cannot be covered.
102
103   VLAN
104       VLAN the linkgroup belongs to.
105
106   #Conns
107       Number of connections(sockets) running on the link/linkgroup.
108
109   PNET-ID
110       PNET-ID of the linkgroup. "*" means PNET-ID is set by the user.
111
112   Net-Dev
113       Network device name corresponding to the link.
114
115   Link-State
116       The state of the link.
117
118       LINK_UNUSED
119              The link is not in use and in initial state.
120
121       LINK_INACTIVE
122              The link is inactive and will go away.
123
124       LINK_ACTIVATING
125              The link is being activated with the peer.
126
127       LINK_ACTIVE
128              The link is active and operates on an established link with the
129              peer.  Data is being exchanged via RDMA.
130
131   Link-UID
132       Unique identifier of the link. This identifier consists of linkgroup id
133       and link id.
134
135   Peer-UID
136       Unique identifier of the link on peer side. This identifier consists of
137       linkgroup id and link id.
138
139   IB-Dev
140       Name of the RoCE device used by the link.
141
142   IB-P
143       Port of the RoCE device used by the link.
144
145   Local-GID
146       GID of the RoCE port used by the link.
147
148   Peer-GID
149       GID of the peer RoCE port used by the link.
150
151

EXAMPLES

153       1. Show all SMC-D linkgroups:
154         # smcd linkgroup show all
155
156       2. Show all SMC-D linkgroups with linkgroup id 50:
157         # smcd linkgroup show 50
158
159       3. Show all SMC-R links:
160         # smcr linkgroup link-show all
161
162       4. Show all SMC-R links with linkgroup id 40:
163         # smcr linkgroup link-show 40
164
165       5. Show all SMC-R links on RoCE device "mlx4_0":
166         # smcr linkgroup link-show ibdev mlx4_0
167
168       6. Shows all SMC-R links on network device "eth0":
169         # smcr linkgroup link-show netdev eth0
170
171

SEE ALSO

173       smcd(8), smcr(8)
174
175
176
177smc-tools                          June 2020                 SMCD-LINKGROUP(8)
Impressum