smc_pnet(8)

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   {--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

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

RETURN CODES

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

AUTHOR

106       This man page was written by
107       Ursula Braun <ubraun@linux.vnet.ibm.com>
108
109       Copyright (c) IBM Corp. 2017
110
111       Published under the terms and conditions of the EPL
112       (Eclipse Public License).
113
114