NAME¶

smc_pnet - create, destroy, and change the SMC PNET table

SYNOPSIS¶

smc_pnet { -a | --add <pnetid> } { -I | --interface <ethernet-interface> }

smc_pnet { -a | --add <pnetid> } { -D | --ibdevice <infiniband-or-ISM-device> } [ -P | --ibport <infiniband-port> ]

smc_pnet { -a | --add <pnetid> } { -I | --interface <ethernet-interface> } { -D | --ibdevice <infiniband-or-ISM-device> } [ -P | --ibport <infiniband-port> ]

smc_pnet { -s | --show <pnetid> }

smc_pnet { -d | --delete <pnetid> }

smc_pnet { -f | --flush }

smc_pnet { -v | --version }

smc_pnet { -h | --help }

DESCRIPTION¶

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. Any Ethernet interface can be combined with the RDMA-capable network interface card (RNIC) or a DMA-capable ISM device, if they belong to the same Converged Ethernet fabric. To configure mapping of a RoCE Adapter port or an ISM device to a standard Ethernet interface, both devices need to have the same PNET ID; either hardware-defined or user-defined using the pnet table. Hardware-defined PNET IDs cannot be overwritten. The Ethernet interface or the RNIC or a DMA-capable ISM device may not be present while creating a pnet table entry. Such pnet table entries will be applied once the corresponding interface or device comes online. The entry will still remain in the pnet table when the interface or device is removed. The entire pnet table is not persistent across reboots.

The smc_pnet command configures the pnet table.

OPTIONS¶

By default, smc_pnet shows all entries of the pnet table.

<pnetid>

defines a name for a grouping of Ethernet interface and RNICs or ISM devices. A PNET ID consists of up to 16 alphanumeric uppercase characters without blanks.

-a, --add

creates a new PNET ID definition to the pnet table (if it does not already exist). Only one PNET ID can be defined for a certain Ethernet interface, a certain InfiniBand device port or a certain ISM device. Adding more than one PNET ID fails. Hardware defined PNET IDs cannot be overwritten.

-s, --show

shows a certain PNET ID definition in the pnet table.

-d, --delete

deletes an existing PNET ID definition from the pnet table.

-f, --flush

removes all PNET ID definitions from the pnet table.

-I, --interface <ethernet-interface>

specifies the name of the Ethernet interface to be added for a certain PNET ID definition.

-D, --ibdevice <infiniband-or-ISM-device>

specifies the ID of the InfiniBand device or ISM device.

-P, --ibport <infiniband-port>

specifies the port number of the InfiniBand device port. Valid numbers are 1 or 2. The default value is 1.

-v, --version

displays smc_pnet program version.

-h, --help

displays a brief smc_pnet usage information.

EXAMPLES¶

Define PNET ID ABC for the ethernet device names encf500 and bond0, and define PNET ID ABC for the InfiniBand device ID 0001:00:00.0 (port 2) and the ISM device ID 0004:00:00.0:

$ 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

Show all pnet table 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

Define PNET ID XYZ for the ethernet interface name vlan0201 and the InfiniBand
device ID 0001:00:00.0 (port 1):

$ smc_pnet -a XYZ -I vlan0201 -D 0001:00:00.0 -P 1

Show all entries for PNET ID XYZ:

$ smc_pnet -s XYZ
XYZ vlan0201 n/a 255
XYZ n/a 0001:00:00.0 1

Delete all pnet table entries with PNET ID named ABC:

$ smc_pnet -d ABC

Delete all entries in the pnet table:

$ smc_pnet -f

RETURN CODES¶

Successful smc_pnet commands return 0. If an error occurs, smc_pnet writes a message to stderr and completes with a return code other than 0.

SEE ALSO¶

af_smc(7), smc_chk(8) smc_rnics(8), smc_run(8), smcd(8), smcr(8), smcss(8)