1SMC_PNET(8) Linux Programmer's Manual SMC_PNET(8)
3
7 smc_pnet - create, destroy, and change the SMC PNET table.
8
11 smc_pnet { -a | --add <pnetid> } { -I | --interface <ethernet-inter‐
12 face> }
13 smc_pnet { -a | --add <pnetid> } { -D | --ibdevice <infiniband-or-ISM-
15 device> } [ -P | --ibport <infiniband-port> ]
16 smc_pnet { -a | --add <pnetid> } { -I | --interface <ethernet-inter‐
18 face> } { -D | --ibdevice <infiniband-or-ISM-device> } [ -P | --ibport
19 <infiniband-port> ]
20 smc_pnet { -s | --show <pnetid> }
22 smc_pnet { -d | --delete <pnetid> }
24 smc_pnet { -f | --flush }
26 smc_pnet { -v | --version }
28 smc_pnet { -h | --help }
30
33 The SMC protocol requires grouping of standard Ethernet and RoCE net‐
34 works or ISM devices. Such groups are called Physical Networks
35 (PNETs). The mapping is configured within a table called pnet table.
36 Any available Ethernet interface can be combined with an available
37 RDMA-capable network interface card (RNIC) or a DMA-capable ISM device,
38 if they belong to the same Converged Ethernet fabric. To configure map‐
39 ping of a RoCE Adapter port or an ISM device to a standard Ethernet
40 interface, both devices need to have the same pnetid; either hardware-
41 defined or user-defined using the pnet table. Hardware-defined pnetids
42 cannot be overwritten.
43 The smc_pnet command configures the pnet table.
45
48 By default, smc_pnet shows all entries of the pnet table.
49 <pnetid>
51 defines a name for a grouping of Ethernet interface and RNICs or
52 ISM devices. A pnetid name consists of up to 16 alphanumeric
53 uppercase characters without blanks.
54 -a, --add
56 creates a new pnetid definition to the pnet table (if it does
57 not already exist). Only one pnetid can be defined for a cer‐
58 tain Ethernet interface, a certain InfiniBand device port or a
59 certain ISM device. Adding more than one pnetid fails. Hardware
60 defined pnetids cannot be overwritten.
61 -s, --show
63 shows a certain pnetid definition in the pnet table.
64 -d, --delete
66 deletes an existing pnetid definition from the pnet table.
67 -f, --flush
69 removes all pnetid definitions from the pnet table.
70 -I, --interface <ethernet-interface>
72 specifies the name of the Ethernet interface to be added for a
73 certain pnetid definition.
74 -D, --ibdevice <infiniband-or-ISM-device>
76 specifies the ID of the InfiniBand device or ISM device.
77 -P, --ibport <infiniband-port>
79 specifies the port number of the InfiniBand device port. Valid
80 numbers are 1 or 2. The default value is 1.
81 -v, --version
83 displays smc_pnet program version.
84 -h, --help
86 displays a brief smc_pnet usage information.
87
90 Define pnetid ABC for the ethernet device names encf500 and bond0, and
91 define pnetid ABC for the InfiniBand device ID 0001:00:00.0 (port 2)
92 and the ISM device ID 0004:00:00.0:
93 $ smc_pnet -a ABC -I encf500
95 $ smc_pnet -a ABC -I bond0
96 $ smc_pnet -a ABC -D 0001:00:00:00.0 -P 2
97 $ smc_pnet -a ABC -D 0004:00:00:00.0
98 Show all pnet table entries:
100 $ smc_pnet
102 ABC encf500 n/a 255
103 ABC bond0 n/a 255
104 ABC n/a 0001:00:00.0 2
105 ABC n/a 0004:00:00.0 1
106 Define pnetid XYZ for the ethernet interface name vlan0201 and the InfiniBand
108 device ID 0001:00:00.0 (port 1):
109 $ smc_pnet -a XYZ -I vlan0201 -D 0001:00:00.0 -P 1
111 Show all entries for pnetid XYZ:
113 $ smc_pnet -s XYZ
115 XYZ vlan0201 n/a 255
116 XYZ n/a 0001:00:00.0 1
117 Delete all pnet table entries with pnetid named ABC:
119 $ smc_pnet -d ABC
121 Delete all entries in the pnet table:
123 $ smc_pnet -f
125
127 Successful smc_pnet commands return 0. If an error occurs, smc_pnet
128 writes a message to stderr and completes with a return code other than
129 0.
130
132 af_smc(7), smc_rnics(8), smc_run(8), smcss(8)
133smc-tools January 2017 SMC_PNET(8)