smc_pnet - Create network mapping table

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

Use the smc_pnet command to map a RoCE adapter port or ISM device to a standard Ethernet interface.

The SMC-R protocol requires grouping of standard Ethernet and RoCE networks or ISM devices. Such groups are called physical networks (PNETs). Within the same Converged Ethernet fabric, any available Ethernet interface can be combined with an available RDMA-capable network interface card or a DMA-capable ISM device.

Note: The mapping of a RoCE adapter port or ISM device to a standard Ethernet interface can be defined in the IOCDS or it can be defined as an entry in a PNET table. Only use the smc_pnet command if the IOCDS does not contain the required PNET IDs. IOCDS specifications override PNET table entries that are created with smc_pnet.

Figure 1. smc_pnet syntax

Enter smc_pnet without parameters to display all entries in the PNET table.

-a or --add <PNET_ID>: creates a new entry in the PNET table and allocates the specified ID, if it does not already exist. Only one entry can be defined for a specific Ethernet interface and a specific Infiniband device port or ISM device. A PNET ID consists of up to 16 alphanumeric uppercase characters without blanks.
-I or --interface <Ethernet_IF>: specifies the name of the Ethernet interface for a new PNET.
-D or --ibdevice <device>: specifies the name of the Infiniband device or ISM device for a new PNET.
-P or --ibport <IB_port>: Optional: specifies the port number of the Infiniband device port. Valid values are 1 or 2. The default value is 1.
-s or --show <PNET_ID>: displays the PNET table entry with the specified ID.
-d or --delete <PNET_ID>: deletes the PNET table entry with the specified ID.
-f or --flush: removes all entries from the PNET table.
-h or --help: displays help information for the command.
-v or --version: displays the version number of smc_pnet.

Examples

To create a PNET with ID ABC for the Ethernet interface names encf500 and bond0, and add Infiniband device with ID 0001:00:0.0 on port number 2 and ISM device with ID 0004:00:00.0 on port 1:
```
# smc_pnet −a ABC −I encf500
# smc_pnet −a ABC −I bond0
# smc_pnet −a ABC −D 0001:00:00:00.0 −P 2
# smc_pnet −a ABC −D 0004:00:00:00.0
```

To show all PNET entries:

# smc_pnet
ABC encf500 n/a 255
ABC bond0 n/a 255
ABC n/a 0001:00:00.0 2
ABC n/a 0004:00:00.0 1

To define PNET ID XYZ for the Ethernet interface name vlan0201 and the InfiniBand device ID 0001:00:00.0 on port 1:
```
# smc_pnet −a XYZ −I vlan0201 −D 0001:00:00.0 −P 1
```

To show all entries for PNET ID XYZ:

# smc_pnet −s XYZ
XYZ vlan0201 n/a 255
XYZ n/a 0001:00:00.0 1

To delete a PNET table entry with PNET ID ABC:
```
# smc_pnet -d ABC
```
To delete all entries in the PNET table:
```
# smc_pnet -f
```

For command return codes, see the man page.