smc_rnics - list RoCE Express PCI functions and control their online state

Red Hat Enterprise Linux 9.2 LPAR mode z/VM guest KVM guest

Use smc_rnics to list RoCE Express PCI functions and to set these PCI functions online or offline.

Setting a PCI function offline on Linux® in LPAR mode or in a DPM partition also deconfigures it in the partition.

Syntax

smc_rnics syntax

where:

-a or --all: lists all PCI functions, regardless of their online state. By default, only online PCI functions are listed.
-r or --rawids: displays the type as raw vendor and device IDs.
-I or --IB-dev: lists the PCI functions with their RDMA properties. Because RDMA is based on the InfiniBand (IB) communications standard, this parameter and output table columns with RDMA information use IB terminology. The default list shows the network device properties.
-e or --enable <fid>: sets the specified PCI function online. In the command, <fid> is the function ID in hexadecimal notation. Leading zeroes can be omitted.
-d or --disable <fid>: sets the specified PCI function offline. In the command, <fid> is the function ID in hexadecimal notation. Leading zeroes can be omitted.
-h or --help: displays help information for the smc_rnics command. To view the man page, issue man smc_rnics.
-v or --version: displays the version of the smc_rnics command.

Examples

This example lists the online PCI functions.

# smc_rnics
  FID Power PCI_ID       PCHID Type          PPrt PNET_ID Net-Dev
-------------------------------------------------------------------
  8ca 1     0008:00:00.0 01c8  RoCE_Express2 0    NET25   eno8
  8ea 1     0009:00:00.0 01c8  RoCE_Express2 1    NET26   eno9

This example lists online and offline PCI functions.

# smc_rnics -a
  FID Power PCI_ID       PCHID Type          PPrt PNET_ID Net-Dev
-------------------------------------------------------------------
  50a 0
  8ca 1     0008:00:00.0 01c8  RoCE_Express2 0    NET25   eno8
  8ea 1     0009:00:00.0 01c8  RoCE_Express2 1    NET26   eno9

This example sets the PCI function with FID 0x050a online.
```
# smc_rnics -e 50a
```

This example lists the online PCI functions with their RDMA properties.

# smc_rnics -I
  FID Power PCI_ID       PCHID Type          IPrt PNET_ID IB-Dev
-------------------------------------------------------------------
  50a 1     000a:00:00.0 01c8  RoCE_Express2 1    NET26   mlx5_0
  8ca 1     0008:00:00.0 01c8  RoCE_Express2 1    NET25   mlx5_1
  8ea 1     0009:00:00.0 01c8  RoCE_Express2 1    NET26   mlx5_2