SMCD-LINKGROUP(8)

NAME
smcd-linkgroup - Print information about SMC-D linkgroups smcr-linkgroup - Print information about SMC-R linkgroups 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 linkgroups and their properties. The smcr linkgroup command displays SMC-R linkgroups, links and their properties.

  smcd,smcr linkgroup show
inspect the linkgroup properties

all (default)
    Show all the linkgroups.

LG-ID
    Show the linkgroup with the ID LG-ID

netdev NETDEV
    SMC-R only: list linkgroups making use of the given network device only.

ibdev IBDEV
    SMC-R only: list only linkgroups of the given RoCE device.

  smcr linkgroup link-show
SMC-R only: Inspect the link properties

all (default)
    Show all the links in the linkgroups.

LG-ID
    Show links of the linkgroup(SMC-R) or the linkgroup(SMC-R/SMC-D) with the id LG-ID

netdev NETDEV
    List only links of the linkgroups making use of the given network device.

ibdev IBDEV
    List only links of the linkgroups of the given RoCE device.

OUTPUT

  LG-ID
ID of the linkgroup.

  LG-Role
Role of the linkgroup.

SERV
    The linkgroup has a SERVER role.

CLNT
    The linkgroup has a CLIENT role.

  LG-Type
Linkgroup type of the linkgroup.

NONE
    The linkgroup has the initial type.

SINGLE
    The linkgroup has only a single link, i.e. the local and the peer system can offer one device port only for this linkgroup, which means a link outage on any side cannot be covered.

SYM The linkgroup has two symmetric links, i.e. the local and the peer system can offer two device ports for this linkgroup, which means a link outage on any side can be covered.

ASYMP
    The linkgroup has asymmetric links, i.e. the peer system can offer one device port only for this linkgroup, which means a link outage on the peer side cannot be covered.

ASYML
    The linkgroup has asymmetric links, i.e. the local system can offer one device port only for this linkgroup, which means a link outage on the local side cannot be covered.

  VLAN
VLAN the linkgroup belongs to.

  #Conns
Number of connections(sockets) running on the link/linkgroup.

  PNET-ID
PNET-ID of the linkgroup. "*" 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 linkgroup id and link id.

  Peer-UID
Unique identifier of the link on peer side. This identifier consists of linkgroup 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 linkgroups:
# smcd linkgroup show all

2. Show all SMC-D linkgroups with linkgroup id 50:
# smcd linkgroup show 50

3. Show all SMC-R links:
# smcr linkgroup link-show all

4. Show all SMC-R links with linkgroup 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. Shows all SMC-R links on network device "eth0":
# smcr linkgroup link-show netdev eth0

SEE ALSO
smcd(8), smcr(8)