| SMCD-LINKGROUP(8) | Linux Programmer's Manual | SMCD-LINKGROUP(8) |
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.
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¶
| June 2020 | smc-tools |