SMC_PNET(8)

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)