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

NAME

6       smcd-linkgroup - Print information about SMC-D link groups
7
8       smcr-linkgroup - Print information about SMC-R link groups 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 link groups and their proper‐
26       ties.  The smcr linkgroup command displays SMC-R link groups and links
27       with their properties.
28
29
30   smcd,smcr linkgroup show
31       inspect the link group properties
32
33
34       all (default)
35              Show all link groups.
36
37
38       LG-ID  Show the link group with the ID LG-ID
39
40
41       netdev NETDEV
42              SMC-R only: list the link groups for the specified network de‐
43              vice.
44
45
46       ibdev IBDEV
47              SMC-R only: list the link groups for the specified RoCE device.
48
49
50   smcr linkgroup link-show
51       SMC-R only: Inspect the link properties
52
53
54       all (default)
55              List all links of all link groups.
56
57
58       LG-ID  Show links of the link group with the id.  LG-ID
59
60
61       netdev NETDEV
62              List the links of the link groups for the specified network de‐
63              vice.
64
65
66       ibdev IBDEV
67              List the links of the link groups for the specified RoCE device.
68
69

OUTPUT

71   LG-ID
72       ID of the link group.
73
74   LG-Role
75       Role of the link group.
76
77       SERV   The link group has a SERVER role.
78
79       CLNT   The link group has a CLIENT role.
80
81   LG-Type
82       Type of the link group.
83
84       NONE   The link group has the initial type.
85
86       SINGLE The link group has only a single link, i.e.  the local and the
87              peer system can offer one device port only for this link group,
88              which means a link outage on either side cannot be recovered.
89
90       SYM    The link group has two symmetric links, i.e.  the local and the
91              peer system can offer two device ports for this link group,
92              which means a link outage on either side can be recovered.
93
94       ASYMP  The link group has asymmetric links, i.e.  the peer system can
95              offer one device port only for this link group, which means a
96              link outage on the peer side cannot be recovered.
97
98       ASYML  The link group has asymmetric links, i.e.  the local system can
99              offer one device port only for this link group, which means a
100              link outage on the local side cannot be recovered.
101
102   VLAN
103       The VLAN to which the link group belongs.
104
105   #Conns
106       Number of connections(sockets) running on the link or link group.
107
108   PNET-ID
109       PNET ID of the link group. Asterisk "*" means PNET ID is set by the
110       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 link group
133       id and link id.
134
135   Peer-UID
136       Unique identifier of the link on the peer side. This identifier con‐
137       sists of link group 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 link groups:
154         # smcd linkgroup show all
155
156       2. Show all SMC-D link groups with link group 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 link group 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. Show 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