Section 8 · System administration
smcd-linkgroup.8
Package: smc-tools
SMCD-LINKGROUP
NAME
SYNOPSIS
DESCRIPTION
OUTPUT
EXAMPLES
SEE ALSO
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-TypeType 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. VLANThe VLAN to which the link group belongs.#ConnsNumber of connections(sockets) running on the link or link group.PNET-IDPNET ID of the link group. Asterisk "*" means PNET ID is set by the user.Net-DevNetwork device name corresponding to the link.Link-StateThe 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
smcd(8), smcr(8)