SMC-LINKGROUP(8)

NAME
smc-linkgroup - Print information about SMC linkgroups and links

SYNOPSIS

smc [ OPTIONS ] linkgroup { COMMAND | help }

smc linkgroup { show | link-show } [ all | LG-ID ] [ type TYPE ] [ netdev NETDEV ] [ ibdev IBDEV ]
TYPE := [ smcr | smcd ]

DESCRIPTION
The smc linkgroup command displays linkgroups, links and their properties. Links can be listed only for SMC-R linkgroups. The command operates with type smcr per default on all command levels.

  smc linkgroup show - look at the linkgroup properties

all (default)
    Show all the linkgroups.

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

type TYPE
    List only linkgroups of the given type.

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

ibdev IBDEV
    List only linkgroups of the given RoCE (infiniband) device.

  smc linkgroup link-show - look at the link properties (SMC-R only)

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

LG-ID
    Show links of the linkgroup with the id LG-ID

type TYPE
    List only links of the linkgroups of the given type.

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 (InfiniBand) 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 linkgroups of the type smcd:
# smc linkgroup show all type smcd
2. Show all links of the linkgroups with type smcr:
# smc linkgroup link-show all type smcr
3. Show all links with linkgroup id 40:
# smc linkgroup link-show 40
4. Show all links on RoCE device "mlx4_0":
# smc linkgroup link-show ibdev mlx4_0
5. Shows all links on network device "eth0":
# smc linkgroup link-show netdev eth0

SEE ALSO
smcd(8), smcr(8)