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

       The SMC protocol requires grouping of standard Ethernet and RoCE networks or ISM  devices.   Such  groups
       are  called  PhysicalNetworks  (PNETs). The mapping is configured within a table called pnettable. Any
       available Ethernet interface can be combined with an available 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 smc_pnet command configures the pnet table.

DefinePNETIDABCfortheethernetdevicenamesencf500andbond0,anddefinePNETIDABCfortheInfiniBanddeviceID0001:00:00.0(port2)andtheISMdeviceID0004: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

       Showallpnettableentries:

           $ 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

       DefinePNETIDXYZfortheethernetinterfacenamevlan0201andtheInfiniBanddeviceID0001:00:00.0(port1):

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

       ShowallentriesforPNETIDXYZ:

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

       DeleteallpnettableentrieswithPNETIDnamedABC:

           $ smc_pnet -d ABC

       Deleteallentriesinthepnettable:

           $ smc_pnet -f

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

       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.

       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.

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

smc-tools                                         January 2017                                       SMC_PNET(8)

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 }