smcd-device - Man Page

Name

smcd-device — Print information about SMC-D devices

smcr-device — Print information about SMC-R devices

Synopsis

smcd [ OPTIONS ] device { COMMAND | help }

smcd device [ show ] [ all ]

smcr [ OPTIONS ] device { COMMAND | help }

smcr device [ show ] [ all ] [ netdev NETDEV ] [ ibdev IBDEV ]

Description

The smcd device command displays SMC-D devices and their properties.  The smcr device command displays SMC-R devices and their properties.

smcd,smcr device show

inspect the device properties

all (default)

List all devices.

netdev NETDEV

SMC-R only: limit the command output to the device with the specified network device name.

ibdev IBDEV

SMC-R only: limit the command output to the device port with the specified RoCE device name.

Output

Net-Dev

Network device name.

IB-Dev

RoCE (InfiniBand) device name.

Ib-P

InfiniBand port of the RoCE device. According to the InfiniBand conventions, the port count starts at 1. Consequently, devices where each port is represented as a separate device will indicate the port as the first port for all ports.

IB-State

State of the RoCE device port.

INACTIVE

The RoCE device port is inactive.

ACTIVE

The RoCE device port is active.

Type

Type of the underlying PCI device.

RoCE_Express

Underlying used device is RoCE Express.

RoCE_Express2

Underlying used device is RoCE Express 2.

ISM

Underlying used device is ISM.

Crit / InUse

Show whether the device is critical i.e. without failover possibility(SMC-R) or whether the device is in use.(SMC-D)

Yes

For SMC-R, there is at least one link group running on the device with state "SINGLE" or locally "ASYMMETRIC" which means one or more link groups without a failover device in case of a link failure. In case of SMC-D, there is at least one link group running on the  ISM device.

No

For SMC-R, there is no link group running on the device with state "SINGLE" or locally "ASYMMETRIC" which means the link group(s)  have a fallback device in case of a failure. In case of SMC-D, there is no link group running on the ISM device.

Fid

Function ID of the PCI device.

PCI-Id

ID of the PCI device.

Pchid

Physical channel ID of the PCI device.

Pnet-Id

PNET ID of the device. Leading asterisk "*" means PNET ID is set by the user. (e.g "*PNET-ID")

Examples

1. Show all SMC-D devices:
# smcd device show all

2. Show all SMC-R devices:
# smcr devices show all

3. Show all SMC-R devices with RoCE (InfiniBand) device name "mlx4_0":
# smcr device show ibdev mlx4_0

4. Show all SMC-R devices with network device name "eth0":
# smcr device show netdev eth0

See Also

smcd(8), smcr(8)

Referenced By

smcd(8), smcr(8).

The man page smcr-device(8) is an alias of smcd-device(8).

June 2020 smc-tools Linux Programmer's Manual