cgdcbxd(8) [centos man page]

CGDCBXD(8)							 libcgroup Manual							CGDCBXD(8)

NAME

       cgdcbxd - control group dcb event net_prio daemon

SYNOPSIS

       cgdcbxd [options]

DESCRIPTION

       cgdcbxd	is a daemon used to monitor DCB netlink events and manage the net_prio control group subsystem. The daemon keeps the hierarchy and
       priority mappings in sync with DCBX Application events.

       When a DCB netlink event is received cgdcbxd parses the application TLV and identifies new, updated, and deleted  application  tuples.  The
       DCBX application TLV uses the selector, protocol ID and priority fields to identify and set application priority. The selector field speci-
       fies the protocol ID type supported types are

       Ethertype = 1
       TCP or SCTP = 2
       UDP or DCCP = 3
       TCP, SCTP UDP, and DCCP = 4

       The protocol ID field specifies the port or ethertype depending on the selector field and the priority gives a priority value  (0-7).  Used
       to set the net_prio.ifpriomap.

       When  a new application tuple is identified cgdcbxd creates a control group under the net_prio subsystem using the directory cgdcbx-<selec-
       tor>-<protocolID>.

       The <selector> field uses the IEEE selector values listed above for both CEE DCBX and IEEE DCBX versions.

       This control group will be managed by cgdcbx and the ifpriomap will be kept in sync with the  application  TLV.	If  a  DCB  netlink  event
       removes the application selector-protocolID tuple then cgdcbx removes the control group.

       This  may  be  used with cgrulesengd to create configuration rules that map applications and users to DCBX selector-protocolID tuples. Note
       protocol ID and selector values use the well-known protocol type and port or ethertype defined  by  the	IANA  (Internet  Assigned  Numbers
       Authority) the application are not required to use the well-known ports this is only used to identify the application.

OPTIONS

       -h     Display help.

       -n     Don't fork the daemon, stay in the foreground.

       -v     Show version

FILES

       /etc/cgrules.conf
       the default libcgroup configuration file

SOURCES

       o      IEEE   802.1Qaz	(http://www.ieee802.org/1/pages/dcbridges.html)  o  IANA  (http://www.iana.org/assignments/service-names-port-num-
	      bers/service-names-port-numbers.xml)

NOTES

       Support for the net_prio subsystem was added in the 3.3 Linux kernel.

Signals
       SIGUSR1 dumps list of managed interfaces and control groups with priomaps.

SEE ALSO

       cgrulesengd(8), cgrules.conf(5) lldpad(8), lldptool(8),

AUTHOR

       John Fastabend <john.r.fastabend@intel.com>

Linux								    2012-01-16								CGDCBXD(8)

lldptool(8)							       Linux							       lldptool(8)

NAME

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

SYNOPSIS

       lldptool -t -i ethx -V ETS-CFG <-c CONFIG_ARG ...>

	   CONFIG_ARG := { enableTx | willing | tsa | up2tc | numtcs | tcbw }

       lldptool -T -i ethx -V ETS-CFG CONFIG_ARG=value ...

	   CONFIG_ARG :=

	    enableTx = {yes|no} |

	    willing = {yes|no} |

	    tsa = tc:{ets|strict|vendor},... |

	    up2tc = priority:tc,... |

	    tcbw = bw1,bw2,...

       lldptool -t -i ethx -V ETS-REC <-c CONFIG_ARG ...>

       lldptool -T -i ethx -V ETS-REC CONFIG_ARG=value ...

	   CONFIG_ARG :=

	    enableTx = {yes|no} |

	    tsa = tc:{ets|strict|vendor},... |

	    up2tc = priority:tc,... |

	    tcbw = bw1,bw2,...

DESCRIPTION

       The  Enhanced  Transmission  Selection  (ETS)  feature has a recommendation TLV and a configuration TLV configured with ETS-REC and ETS-CFG
       respectively.

ARGUMENTS

       enableTx
	      Enables the ETS TLV to be transmitted

       willing
	      Sets the ETS-CFG willing bit

       tsa    Transmission selection algorithm, sets a comma seperated list of traffic classes to the  corresponding  selection  algorithm.  Valid
	      algorithms include "ets", "strict" and "vendor".

       up2tc  Comma seperated list mapping user priorities to traffic classes.

       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.

       numtcs Displays the number of ETS supported traffic classes.

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 DCBX (CIN or CEE) the ETS-CFG and ETS-REC TLVs are disabled if a legacy DCBX TLV is received and no valid IEEE DCBX TLVs
       are received. The hardware DCBX mode will also be set to the legacy mode 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.	See lldpad(8) for more information
       about the operation of the DCBX selection mechanism.

       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. The net_prio cgroup can be used to assign application traffic to specific priorities.  See the
       kernel documentation and cgdcbxd(8) for net_prio cgroup information.

EXAMPLE &; USAGE
       Configure willing bit for interface eth2
	      lldptool -T -i eth2 -V ETS-CFG willing=yes

       Configure traffic classes for ETS and strict priority on eth2
	      lldptool -T -i eth2 -V ETS-CFG tsa=0:ets,1:ets,2:ets,3:ets,4:strict,5:strict

       Configure 1:1 mapping from priority to traffic classes on eth2
	      lldptool -T -i eth2 -V ETS-CFG up2tc=0:0,1:1,2:2,3:3,4:4,5:5,6:6,7:7

       Display local configured ETS-CFG parameters for tcbw
	      lldptool -t -i eth2 -V ETS-CFG -c tcbw

       Display last transmitted ETS-CFG TLV
	      lldptool -t -i eth2 -V ETS-CFG

       Configure ETS-CFG and ETS-REC for default DCB on eth2
	      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

	      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

SOURCE

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

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.

SEE ALSO

       lldptool(8), lldptool-app(8), lldpad(8), tc-mqprio(8),

AUTHOR

       John Fastabend

open-lldp							   February 2010						       lldptool(8)