smc_pnet man page

smc_pnet ā€” create, destroy, and change the SMC PNET table.

Synopsis

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

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

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

smc_pnet {--flush|-f}

smc_pnet {--version|-v}

smc_pnet {--help|-h}

Description

The SMC protocol requires grouping of standard Ethernet and RoCE networks. Such groups are called Physical Networks (PNETs). The mapping is configured within a table called pnet table. Any available Ethernet interface can be combined with an available RDMA-capable network interface card (RNIC), if they belong to the same Converged Ethernet fabric. To configure mapping of a RoCE Adapter port to a standard Ethernet interface, an entry in the pnet table must be created.

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 RNIC. A pnetid name consists of up to 16 alphanumeric uppercase characters without blanks.

-a, --add

creates a new pnetid definition to the pnet table (if it does not already exist). Only one pnetid can be defined for a certain Ethernet interface and for a certain infiniband device port. Adding an ethernet interface or an infiniband device port more than once fails.

-s, --show

shows a certain pnetid definition in the pnet table.

-d, --delete

deletes an existing pnetid definition from the pnet table.

-f, --flush

removes all pnetid definitions from the pnet table.

-I, --interface <ethernet-interface>

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

-D, --ibdevice <infiniband-device>

specifies the name of the Infiniband 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

Create a pnetid ABC with ethernet interface name encf500, infiniband device name mlx4_0 and port number 2:

$ smc_pnet -a ABC -I encf500 -D mlx4_0 -P 2

Delete a pnet table entry with pnetid named ABC:

$ smc_pnet -d ABC

Show the mapping of ethernet interface name and infiniband device port for pnetid ABC:

$ smc_pnet -s ABC
ABC encf500 mlx4_0 2

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_rnics(8), smc_run(8), smcss(8)

Referenced By

af_smc(7), smc_run(8), smcss(8).

January 2017 smc-tools Linux Programmer's Manual