SMC_PNET(8)

NAME
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.

AUTHOR
This man page was written by
Ursula Braun <ubraun@linux.vnet.ibm.com>
Copyright (c) IBM Corp. 2017
Published under the terms and conditions of the EPL
(Eclipse Public License).

SEE ALSO
af_smc(7), smc_run(8) smcss(8)