SMC_RNICS(8)

NAME
smc_rnics - list, enable and disable (R)NICS as used by SMC-R and SMC-D

SYNOPSIS
smc_rnics [-ahrv] [-d FID] [-e FID] [FID]

DESCRIPTION
The SMC protocol requires an (R)NIC for the (R)DMA traffic. Use smc_rnics to handle, and to identify hotplugged (R)NICs.

OPTIONS
By default, smc_rnics shows all enabled (R)NICs in the system.

FID Limit output to the specified function ID (FID).

-a, --all
    Include disabled and unknown devices in output

-d, --disable FID
    Set (R)NIC FID offline.

-e, --enable FID
    Set (R)NIC FID online. Note that devices other than (R)NICs are not displayed by default and therefore, once enabled, will not appear in further output unless option -a or -r is specified.

-h, --help
    Display a brief smc_rnics usage information.

-I, --IB-dev
    Display IB device information.

-r, --rawids
    Display raw PCI vendor/device, PFT, and VFN codes in columns. Note that this will also include unknown devices.

-v, --version
    Display version information.

OUTPUT

  FID
Function ID.

  Power
Indicates whether the PCI slot is on (1) or off (0). See option -e on how to enable a device that is offline.

  PCI_ID
PCI ID in BDF (Bus:Device.Function) notation.

  PCHID
Physical channel identifier, or virtual channel identifier (VCHID) for ISM devices.

  Type
Device type in human readable form. Currently just a single device type is supported that actually is not an RDMA capabe network adapter: ISM. The following RDMA capable network adapters are supported:
Type | IBM Z Adapter Name
Integrated_Network | IBM Integrated Network Adapter 100G
Network_Express | Network Express
RoCE_Express3 | RoCE Express 3
RoCE_Express2 | RoCE Express 2
RoCE_Express | RoCE Express
See option -r to switch to display of PCI vendor and device instead.

  PFT
PCI Function Type. Display hexadecimal value with option -r or mapped name with option -a.

  VF
Virtual Function. Indicates if the FID is a virtual function within the adapter.

  VFN
Virtual Function number. Indicates the virtual function within the adapter.

  PPrt
Corresponding physical port of an RNIC, if applicable. Starts counting at 0.

  IPrt
Corresponding Infiniband port of an RNIC, if applicable. Starts counting at 1.

  PNET_ID
Physical network ID. Has an asterisk * appended if defined via smc_pnet.

  Net-Dev
Network interface in Linux, if applicable.

  IB-Dev
Infiniband interface in Linux, if applicable.

RETURN CODES
On success, smc_rnics returns 0. If an error occurs, a return code other than 0 is returned.

SEE ALSO
af_smc(7), smc_pnet(8), smc_run(8), smcd(8), smcr(8), smcss(8)