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 and device codes in column. 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. See option -r to switch to display of PCI vendor and device instead.

  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)