lldptool-ets(8)

1lldptool(8)                          Linux                         lldptool(8)
2
3
4

NAME

6       ETS-{CFG|REC} - Show / manipulate ETS TLV configuration
7

SYNOPSIS

9       lldptool -t -i ethx -V ETS-CFG <-c CONFIG_ARG ...>
10
11
12           CONFIG_ARG := { enableTx | willing | tsa | up2tc | numtcs | tcbw }
13
14
15       lldptool -T -i ethx -V ETS-CFG CONFIG_ARG=value ...
16
17           CONFIG_ARG :=
18
19            enableTx = {yes|no} |
20
21            willing = {yes|no} |
22
23            tsa = tc:{ets|strict|vendor},... |
24
25            up2tc = priority:tc,... |
26
27            tcbw = bw1,bw2,...
28
29
30       lldptool -t -i ethx -V ETS-REC <-c CONFIG_ARG ...>
31
32
33       lldptool -T -i ethx -V ETS-REC CONFIG_ARG=value ...
34
35           CONFIG_ARG :=
36
37            enableTx = {yes|no} |
38
39            tsa = tc:{ets|strict|vendor},... |
40
41            up2tc = priority:tc,... |
42
43            tcbw = bw1,bw2,...
44
45

DESCRIPTION

47       The  Enhanced Transmission Selection (ETS) feature has a recommendation
48       TLV and a configuration TLV configured with ETS-REC and ETS-CFG respec‐
49       tively.
50

ARGUMENTS

52       enableTx
53              Enables the ETS TLV to be transmitted
54
55       willing
56              Sets the ETS-CFG willing bit
57
58       tsa    Transmission selection algorithm, sets a comma separated list of
59              traffic classes to the corresponding selection algorithm.  Valid
60              algorithms include "ets", "strict" and "vendor".
61
62
63       up2tc  Comma separated list mapping user priorities to traffic classes.
64
65
66       tcbw   Comma  separated  list  of bandwidths for each traffic class the
67              first value being assigned to traffic class 0 and the second  to
68              traffic  class 1 and so on. Undefined bandwidths are presumed to
69              be 0.
70
71
72       numtcs Displays the number of ETS supported traffic classes.
73
74

Theory of Operations

76       IEEE 802.1Qaz is enabled by default on hardware that supports this mode
77       indicated by support for the DCBNL interface. Kernel config option CON‐
78       FIG_DCB. The ETS-CFG TLV is advertised by default with  the  attributes
79       indicated  by  querying  the  hardware for its current configuration. A
80       valid configuration is to map all priorities to a single traffic  class
81       and  use  the  link  strict  selection algorithm. This is equivalent to
82       being in a non-DCB enabled mode.
83
84       To support legacy DCBX (CIN or CEE) the ETS-CFG and  ETS-REC  TLVs  are
85       disabled  if  a legacy DCBX TLV is received and no valid IEEE DCBX TLVs
86       are received. The hardware DCBX mode will also be  set  to  the  legacy
87       mode  and  IEEE mode is disabled. This allows switches to be configured
88       and end nodes will then be configured accordingly without any  configu‐
89       ration  required  on  the end node.  See lldpad(8) for more information
90       about the operation of the DCBX selection mechanism.
91
92       Mapping applications and protocols to traffic classes is  required  for
93       ETS  to  be  useful.  User space programs can encode the priority of an
94       application with the SO_PRIORITY option. The  net_prio  cgroup  can  be
95       used  to  assign  application  traffic to specific priorities.  See the
96       kernel documentation and cgdcbxd(8) for net_prio cgroup information.
97
98

EXAMPLE & USAGE

100       Configure willing bit for interface eth2
101              lldptool -T -i eth2 -V ETS-CFG willing=yes
102
103       Configure traffic classes for ETS and strict priority on eth2
104              lldptool       -T        -i        eth2        -V        ETS-CFG
105              tsa=0:ets,1:ets,2:ets,3:ets,4:strict,5:strict
106
107       Configure 1:1 mapping from priority to traffic classes on eth2
108              lldptool        -T        -i        eth2        -V       ETS-CFG
109              up2tc=0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7
110
111       Display local configured ETS-CFG parameters for tcbw
112              lldptool -t -i eth2 -V ETS-CFG -c tcbw
113
114       Display last transmitted ETS-CFG TLV
115              lldptool -t -i eth2 -V ETS-CFG
116
117       Configure ETS-CFG and ETS-REC for default DCB on eth2
118              lldptool       -T        -i        eth2        -V        ETS-CFG
119              tsa=0:ets,1:ets,2:ets,3:ets,4:ets,5:ets,6:ets,7:ets
120              up2tc=0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7
121              tcbw=12,12,12,12,13,13,13,13
122
123              lldptool        -T        -i        eth2        -V       ETS-REC
124              tsa=0:ets,1:ets,2:ets,3:ets,4:ets,5:ets,6:ets,7:ets
125              up2tc=0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7
126              tcbw=12,12,12,12,13,13,13,13
127
128

SOURCE

130       o      IEEE 802.1Qaz (http://www.ieee802.org/1/pages/dcbridges.html)
131
132

NOTES

134       Support for tc-mqprio was added in 2.6.38 on older kernels other mecha‐
135       nisms may need to be used to map applications to traffic classes.
136
137

AUTHOR

143       John Fastabend
144
145
146
147
148open-lldp                        February 2010                     lldptool(8)