smc_pnet - Create network mapping table

LPAR mode z/VM guest KVM guest

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

The SMC protocol requires grouping of standard Ethernet and RoCE networks or ISM devices. Such groups are called physical networks (PNETs). The mapping is configured within a table called PNET table. Within the same Converged Ethernet fabric, any available Ethernet interface can be combined with an available RDMA-capable network interface card (RNIC) 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.

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 or ISM device. 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 <IB_device> or --ibdevice <IB_device>: specifies the name of the Infiniband device or ISM device for a new PNET.
-P <IB_port> 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 <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 for the Ethernet interface names eth0 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 eth0
# 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 eth0 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.