smc_pnet - Create network mapping table

Use the smc_pnet command to map a RoCE adapter port to an Ethernet interface.

The SMC-R protocol requires grouping of standard Ethernet and RoCE networks. 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.

Note: The mapping of a RoCE adapter port 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 <PNET_ID> 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. A PNET ID consists of up to 16 alphanumeric uppercase characters without blanks.
-I <Ethernet_IF> or --interface <Ethernet_IF>: specifies the name of the Ethernet interface for a new PNET.
-D <RoCE_device> or --ibdevice <RoCE_device>: specifies the name of the RoCE device for a new PNET.
-P <RoCE_port> or --ibport <RoCE_port>: Optional: specifies the port number of the RoCE device port. Valid values are 1 or 2. The default value is 1.
-s <PNET_ID> or --show <PNET_ID>: displays the PNET table entry with the specified ID.
-d <PNET_ID> 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, Ethernet interface name encf500, Infiniband device name mlx4_0, and port number 2:
```
# smc_pnet -a ABC -I eth0 -D mlx4_0 -P 2
```
To delete a PNET table entry with PNET ID ABC:
```
# smc_pnet -d ABC
```
To show the mapping of Ethernet interface name and Infiniband device port for PNET ID ABC:
```
# smc_pnet -s ABC
ABC eth0 mlx4_0 2
```
To delete all entries in the PNET table:
```
# smc_pnet -f
```

For command return codes, see the man page.