smcd-linkgroup - Man Page
Name
smcd-linkgroup — Print information about SMC-D link groups
smcr-linkgroup — Print information about SMC-R link groups and links
Synopsis
smcd [ OPTIONS ] linkgroup { COMMAND | help }
smcd linkgroup [ show ] [ all | Lg-Id ]
smcr [ OPTIONS ] linkgroup { COMMAND | help }
smcr linkgroup { show | link-show } [ all | Lg-Id ] [ netdev NETDEV ] [ ibdev IBDEV ]
Description
The smcd linkgroup command displays SMC-D link groups and their properties. The smcr linkgroup command displays SMC-R link groups and links with their properties.
smcd,smcr linkgroup show
inspect the link group properties
- all (default)
Show all link groups.
- LG-ID
Show the link group with the ID Lg-Id
- netdev NETDEV
SMC-R only: list the link groups for the specified network device.
- ibdev IBDEV
SMC-R only: list the link groups for the specified RoCE device.
smcr linkgroup link-show
SMC-R only: Inspect the link properties
- all (default)
List all links of all link groups.
- LG-ID
Show links of the link group with the id. Lg-Id
- netdev NETDEV
List the links of the link groups for the specified network device.
- ibdev IBDEV
List the links of the link groups for the specified RoCE device.
Output
Lg-Id
ID of the link group.
LG-Role
Role of the link group.
- SERV
The link group has a SERVER role.
- CLNT
The link group has a CLIENT role.
LG-Type
Type of the link group.
- NONE
The link group has the initial type.
- SINGLE
The link group has only a single link, i.e. the local and the peer system can offer one device port only for this link group, which means a link outage on either side cannot be recovered.
- SYM
The link group has two symmetric links, i.e. the local and the peer system can offer two device ports for this link group, which means a link outage on either side can be recovered.
- ASYMP
The link group has asymmetric links, i.e. the peer system can offer one device port only for this link group, which means a link outage on the peer side cannot be recovered.
- ASYML
The link group has asymmetric links, i.e. the local system can offer one device port only for this link group, which means a link outage on the local side cannot be recovered.
Vlan
The VLAN to which the link group belongs.
#Conns
Number of connections(sockets) running on the link or link group.
Pnet-Id
PNET ID of the link group. Asterisk "*" means PNET ID is set by the user.
Net-Dev
Network device name corresponding to the link.
Link-State
The state of the link.
- LINK_UNUSED
The link is not in use and in initial state.
- LINK_INACTIVE
The link is inactive and will go away.
- LINK_ACTIVATING
The link is being activated with the peer.
- LINK_ACTIVE
The link is active and operates on an established link with the peer. Data is being exchanged via RDMA.
Link-UID
Unique identifier of the link. This identifier consists of link group id and link id.
Peer-UID
Unique identifier of the link on the peer side. This identifier consists of link group id and link id.
IB-Dev
Name of the RoCE device used by the link.
Ib-P
Port of the RoCE device used by the link.
Local-GID
GID of the RoCE port used by the link.
Peer-GID
GID of the peer RoCE port used by the link.
Examples
1. Show all SMC-D link groups:
# smcd linkgroup show all
2. Show all SMC-D link groups with link group id 50:
# smcd linkgroup show 50
3. Show all SMC-R links:
# smcr linkgroup link-show all
4. Show all SMC-R links with link group ID 40:
# smcr linkgroup link-show 40
5. Show all SMC-R links on RoCE device "mlx4_0":
# smcr linkgroup link-show ibdev mlx4_0
6. Show all SMC-R links on network device "eth0":
# smcr linkgroup link-show netdev eth0
See Also
Referenced By
The man page smcr-linkgroup(8) is an alias of smcd-linkgroup(8).