1
2SMC_PNET(8) Linux Programmer's Manual SMC_PNET(8)
3
4
5
7 smc_pnet - create, destroy, and change the SMC PNET table.
8
9
11 smc_pnet {--add|-a} {--interface|-I} <ethernet-interface> {--ibde‐
12 vice|-D} <infiniband-device> [ {--ibport|-P<infiniband-port> ] }
13 <pnetid>
14
15 smc_pnet {--show|-s}<pnetid>
16
17 smc_pnet {--delete|-d}<pnetid>
18
19 smc_pnet {--flush|-f}
20
21 smc_pnet {--version|-v}
22
23 smc_pnet {--help|-h}
24
25
27 The SMC protocol requires grouping of standard Ethernet and RoCE net‐
28 works. Such groups are called Physical Networks (PNETs). The mapping
29 is configured within a table called pnet table. Any available Ethernet
30 interface can be combined with an available RDMA-capable network inter‐
31 face card (RNIC), if they belong to the same Converged Ethernet fabric.
32 To configure mapping of a RoCE Adapter port to a standard Ethernet
33 interface, an entry in the pnet table must be created.
34
35 The smc_pnet command configures the pnet table.
36
37
39 By default, smc_pnet shows all entries of the pnet table.
40
41 <pnetid>
42 defines a name for a grouping of Ethernet interface and RNIC. A
43 pnetid name consists of up to 16 alphanumeric uppercase charac‐
44 ters without blanks.
45
46 -a, --add
47 creates a new pnetid definition to the pnet table (if it does
48 not already exist). Only one pnetid can be defined for a cer‐
49 tain Ethernet interface and for a certain infiniband device
50 port. Adding an ethernet interface or an infiniband device port
51 more than once fails.
52
53 -s, --show
54 shows a certain pnetid definition in the pnet table.
55
56 -d, --delete
57 deletes an existing pnetid definition from the pnet table.
58
59 -f, --flush
60 removes all pnetid definitions from the pnet table.
61
62 -I, --interface <ethernet-interface>
63 specifies the name of the Ethernet interface to be added for a
64 certain pnetid definition.
65
66 -D, --ibdevice <infiniband-device>
67 specifies the name of the Infiniband device.
68
69 -P, --ibport <infiniband-port>
70 specifies the port number of the Infiniband device port. Valid
71 numbers are 1 or 2. The default value is 1.
72
73 -v, --version
74 displays smc_pnet program version.
75
76 -h, --help
77 displays a brief smc_pnet usage information.
78
79
81 Create a pnetid ABC with ethernet interface name encf500, infiniband
82 device name mlx4_0 and port number 2:
83
84 $ smc_pnet -a ABC -I encf500 -D mlx4_0 -P 2
85
86 Delete a pnet table entry with pnetid named ABC:
87
88 $ smc_pnet -d ABC
89
90 Show the mapping of ethernet interface name and infiniband device port
91 for pnetid ABC:
92
93 $ smc_pnet -s ABC
94 ABC encf500 mlx4_0 2
95
96 Delete all entries in the pnet table
97
98 $ smc_pnet -f
99
101 Successful smc_pnet commands return 0. If an error occurs, smc_pnet
102 writes a message to stderr and completes with a return code other than
103 0.
104
106 af_smc(7), smc_rnics(8), smc_run(8), smcss(8)
107
108
109
110smc-tools January 2017 SMC_PNET(8)