.TH lldptool 8 "February 2010" "open-lldp" "Linux"
.SH NAME
ETS-{CFG|REC} \- Show / manipulate ETS TLV configuration
.SH SYNOPSIS
.B lldptool -t -i ethx -V ETS-CFG
.RI <-c " " CONFIG_ARG " " ...>
.sp

.ti +4
.IR	CONFIG_ARG " := { "
.BR enableTx " | " willing " | " tsa " | " up2tc " | " numtcs " | " tcbw " }"
.sp

.B	lldptool -T -i ethx -V ETS-CFG
.RI CONFIG_ARG=value " " ...
.sp
.ti +4
.IR	CONFIG_ARG " := 
.sp
.BR		enableTx " = " {yes|no} " | "
.sp
.BR		willing " = " {yes|no} " | "
.sp
.BR		tsa " = " tc:{ets|strict|vendor},... " | "
.sp
.BR		up2tc " = " priority:tc,... " | "
.sp
.BR		tcbw " = " bw1,bw2,... 
.sp

.B	lldptool -t -i ethx -V ETS-REC
.RI <-c " " CONFIG_ARG " " ...>
.sp

.B	lldptool -T -i ethx -V ETS-REC
.RI CONFIG_ARG=value " " ...
.sp
.ti +4
.IR	CONFIG_ARG " := 
.sp
.BR		enableTx " = " {yes|no} " | "
.sp
.BR		tsa " = " tc:{ets|strict|vendor},... " | "
.sp
.BR		up2tc " = " priority:tc,... " | "
.sp
.BR		tcbw " = " bw1,bw2,... 
.sp
.SH DESCRIPTION
The Extended Transmission Selection (ETS) feature has a recommendation
TLV and a configuration TLV configured with ETS-REC and ETS-CFG respectively.
.SH ARGUMENTS
.TP
.B enableTx
Enables the ETS TLV to be transmitted
.TP
.B willing
Sets the ETS-CFG willing bit 
.TP
.B tsa 
Transmission selection algorithm, sets a comma separated list \
of traffic classes to the corresponding selection algorithm. Valid algorithms \
include "ets", "strict" and "vendor".
.sp
.TP
.B up2tc
Comma separated list mapping user priorities to traffic classes.
.sp
.TP
.B tcbw
Comma separated list of bandwiths for each traffic class the first value
being assigned to traffic class 0 and the second to traffic class 1 and so
on. Undefined bandwidths are presumed to be 0.
.sp
.TP
.B numtcs
Sets/Displays the number of ETS supported traffic classes.

.SH Theory of Operations

IEEE 802.1Qaz is enabled by default on hardware that supports this mode
indicated by support for the DCBNL interface. Kernel config option
CONFIG_DCB. The ETS-CFG TLV is advertised by default with the attributes
indicated by querying the hardware for its current configuration. A
valid configuration is to map all priorities to a single traffic class
and use the link strict selection algorithm. This is equivalent to
being in a non-DCB enabled mode.

To support legacy CEE DCBX the ETS-CFG and ETS-REC TLVs are disabled
if a CEE TLV is received and there are no valid IEEE 802.1Qaz TLVs
present. At this time the hardware DCBX mode will be set to CEE and
IEEE mode is disabled. This allows switches to be configured and
end nodes will then be configured accordingly without any configuration 
required on the end node.

Mapping applications and protocols to traffic classes is required for
ETS to be useful. User space programs can encode the priority of an
application with the SO_PRIORITY option. Low level drivers that support
priority to traffic class mappings may enable this mode by default. For
drivers that do not support this mode manual configuration can support
this mode of operation see \fItc-mqprio(8)\fR and \fItc-multiq\fR.
Additionally, tc qdiscs and filters can be used to map protocols to queues
see \fItc(8)\fR for more details along these lines. Finally, many drivers
have support for specific protocols ie Fiber Channel over Ethernet (FCoE).

.B 
.SH EXAMPLE & USAGE
.TP
Configure willing bit for interface \fIeth2\fR
.B lldptool -T -i eth2 -V ETS-CFG willing=yes
.TP
Configure traffic classes for ETS and strict priority on \fIeth2\fR
.B lldptool -T -i eth2 -V ETS-CFG tsa=0:ets,1:ets,2:ets,3:ets,4:strict,5:strict
.TP
Configure 1:1 mapping from priority to traffic classes on \fIeth2\fR
.B lldptool -T -i eth2 -V ETS-CFG up2tc=0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7
.TP
Display local configured ETS-CFG parameters for tcbw
.B lldptool -t -i eth2 -V ETS-CFG -c tcbw
.TP
Display last transmitted ETS-CFG TLV
.B lldptool -t -i eth2 -V ETS-CFG
.TP
Configure ETS-CFG and ETS-REC for default DCB on \fIeth2\fR
.B lldptool -T -i eth2 -V ETS-CFG tsa=0:ets,1:ets,2:ets,3:ets,4:ets,5:ets,6:ets,7:ets up2tc=0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7 tcbw=12,12,12,12,13,13,13,13

.B lldptool -T -i eth2 -V ETS-REC tsa=0:ets,1:ets,2:ets,3:ets,4:ets,5:ets,6:ets,7:ets up2tc=0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7 tcbw=12,12,12,12,13,13,13,13

.SH SOURCE
.TP
o
IEEE 802.1Qaz (http://www.ieee802.org/1/pages/dcbridges.html)

.SH NOTES
Support for tc-mqprio was added in 2.6.38 on older kernels other mechanisms may need to be used to map applications to traffic classes.

.SH SEE ALSO
.BR lldptool (8),
.BR lldptool-app (8),
.BR lldpad (8),
.BR tc-mqprio (8),

.SH AUTHOR
John Fastabend