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.

   #Links
       Number of links (SMC-R)/link groups (SMC-D) on the 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)

smc-tools                                           June 2020                                     SMCD-DEVICE(8)