1
2SMC_PNET(8)                Linux Programmer's Manual               SMC_PNET(8)
3
4
5

NAME

7       smc_pnet - create, destroy, and change the SMC PNET table
8
9

SYNOPSIS

11       smc_pnet  {  -a  | --add <pnetid> } { -I | --interface <ethernet-inter‐
12       face> }
13
14       smc_pnet { -a | --add <pnetid> } { -D | --ibdevice  <infiniband-or-ISM-
15       device> } [ -P | --ibport <infiniband-port> ]
16
17       smc_pnet  {  -a  | --add <pnetid> } { -I | --interface <ethernet-inter‐
18       face> } { -D | --ibdevice <infiniband-or-ISM-device> } [ -P |  --ibport
19       <infiniband-port> ]
20
21       smc_pnet { -s | --show <pnetid> }
22
23       smc_pnet { -d | --delete <pnetid> }
24
25       smc_pnet { -f | --flush }
26
27       smc_pnet { -v | --version }
28
29       smc_pnet { -h | --help }
30
31

DESCRIPTION

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 in‐
40       terface, both devices need to have the same PNET ID;  either  hardware-
41       defined  or  user-defined  using the pnet table.  Hardware-defined PNET
42       IDs cannot be overwritten.
43
44       The smc_pnet command configures the pnet table.
45
46

OPTIONS

48       By default, smc_pnet shows all entries of the pnet table.
49
50       <pnetid>
51              defines a name for a grouping of Ethernet interface and RNICs or
52              ISM devices.  A PNET ID consists of up to 16 alphanumeric upper‐
53              case characters without blanks.
54
55       -a, --add
56              creates a new PNET ID definition to the pnet table (if  it  does
57              not  already exist).  Only one PNET ID 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 PNET ID fails. Hard‐
60              ware defined PNET IDs cannot be overwritten.
61
62       -s, --show
63              shows a certain PNET ID definition in the pnet table.
64
65       -d, --delete
66              deletes an existing PNET ID definition from the pnet table.
67
68       -f, --flush
69              removes all PNET ID definitions from the pnet table.
70
71       -I, --interface <ethernet-interface>
72              specifies the name of the Ethernet interface to be added  for  a
73              certain PNET ID definition.
74
75       -D, --ibdevice <infiniband-or-ISM-device>
76              specifies the ID of the InfiniBand device or ISM device.
77
78       -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
82       -v, --version
83              displays smc_pnet program version.
84
85       -h, --help
86              displays a brief smc_pnet usage information.
87
88

EXAMPLES

90       Define PNET ID ABC for the ethernet device names encf500 and bond0, and
91       define  PNET  ID ABC for the InfiniBand device ID 0001:00:00.0 (port 2)
92       and the ISM device ID 0004:00:00.0:
93
94           $ 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
99       Show all pnet table entries:
100
101           $ 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
107       Define PNET ID XYZ for the ethernet interface name vlan0201 and the InfiniBand
108       device ID 0001:00:00.0 (port 1):
109
110           $ smc_pnet -a XYZ -I vlan0201 -D 0001:00:00.0 -P 1
111
112       Show all entries for PNET ID XYZ:
113
114           $ smc_pnet -s XYZ
115           XYZ vlan0201 n/a 255
116           XYZ n/a 0001:00:00.0 1
117
118       Delete all pnet table entries with PNET ID named ABC:
119
120           $ smc_pnet -d ABC
121
122       Delete all entries in the pnet table:
123
124           $ smc_pnet -f
125

RETURN CODES

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

SEE ALSO

132       af_smc(7), smc_chk(8) smc_rnics(8), smc_run(8), smcd(8),  smcr(8),  sm‐
133       css(8)
134
135
136
137smc-tools                        January 2017                      SMC_PNET(8)
Impressum