Provided by: iproute2_6.1.0-1ubuntu2_amd64 bug

NAME

       dcb-app  -  show / manipulate application priority table of the DCB (Data Center Bridging)
       subsystem

SYNOPSIS

       dcb [ OPTIONS ] app { COMMAND | help }

       dcb app  {  show  |  flush  }  dev DEV [ default-prio ] [ ethtype-prio ] [ stream-port-
               prio ] [ dgram-port-prio ] [ port-prio ] [ dscp-prio ]

       dcb ets  {  add  |  del  |  replace  }  dev DEV [ default-prio PRIO-LIST ] [ ethtype-prio
               ET-MAP ] [ stream-port-prio PORT-MAP ] [ dgram-port-prio PORT-MAP ] [ port-prio
               PORT-MAP ] [ dscp-prio DSCP-MAP ]

       PRIO-LIST := [ PRIO-LIST ] PRIO

       ET-MAP := [ ET-MAP ] ET-MAPPING

       ET-MAPPING := ET:PRIO

       PORT-MAP := [ PORT-MAP ] PORT-MAPPING

       PORT-MAPPING := PORT:PRIO

       DSCP-MAP := [ DSCP-MAP ] DSCP-MAPPING

       DSCP-MAPPING := { DSCP | all }:PRIO

       ET := { 0x600 .. 0xffff }

       PORT := { 1 .. 65535 }

       DSCP := { 0 .. 63 }

       PRIO := { 0 .. 7 }

DESCRIPTION

       dcb app is used to configure APP table, or application priority table in the DCB (Data
       Center Bridging) subsystem. The APP table is used to assign priority to traffic based on
       value in one of several headers: EtherType, L4 destination port, or DSCP. It also allows
       configuration of port-default priority that is chosen if no other prioritization rule
       applies.

       DCB APP entries are 3-tuples of selector, protocol ID, and priority. Selector is an
       enumeration that picks one of the prioritization namespaces. Currently it mostly
       corresponds to configurable parameters described below. Protocol ID is a value in the
       selector namespace. E.g. for EtherType selector, protocol IDs are the individual
       EtherTypes, for DSCP they are individual code points. The priority is the priority that
       should be assigned to traffic that matches the selector and protocol ID.

       The APP table is a set of DCB APP entries. The only requirement is that duplicate entries
       are not added. Notably, it is valid to have conflicting priority assignment for the same
       selector and protocol ID. For example, the set of two APP entries (DSCP, 10, 1) and (DSCP,
       10, 2), where packets with DSCP of 10 should get priority of both 1 and 2, form a well-
       defined APP table. The dcb app tool allows low-level management of the app table by adding
       and deleting individual APP 3-tuples through add and del commands. On the other other
       hand, the command replace does what one would typically want in this situation--first adds
       the new configuration, and then removes the obsolete one, so that only one prioritization
       is in effect for a given selector and protocol ID.

COMMANDS

       show   Display all entries with a given selector. When no selector is given, shows all APP
              table entries categorized per selector.

       flush  Remove all entries with a given selector. When no selector is given, removes all
              APP table entries.

       add
       del    Add and, respectively, remove individual APP 3-tuples to and from the DCB APP
              table.

       replace
              Take the list of entries mentioned as parameter, and add those that are not present
              in the APP table yet. Then remove those entries, whose selector and protocol ID
              have been mentioned as parameter, but not with the exact same priority. This has
              the effect of, for the given selector and protocol ID, causing that the table only
              contains the priority (or priorities) given as parameter.

PARAMETERS

       The following table shows parameters in a way that they would be used with add, del and
       replace commands. For show and flush, the parameter name is to be used as a simple keyword
       without further arguments.

       default-prio PRIO-LIST
              The priority to be used for traffic the priority of which is otherwise unspecified.
              The argument is a list of individual priorities. Note that default-prio rules are
              configured as triplets (EtherType, 0, PRIO).  dcb app translates these rules to the
              symbolic name default-prio and back.

       ethtype-prio ET-MAP
              ET-MAP uses the array parameter syntax, see dcb(8) for details. Keys are EtherType
              values. Values are priorities to be assigned to traffic with the matching
              EtherType.

       stream-port-prio PORT-MAP
       dgram-port-prio PORT-MAP
       port-prio PORT-MAP
              PORT-MAP uses the array parameter syntax, see dcb(8) for details. Keys are L4
              destination port numbers that match on, respectively, TCP and SCTP traffic, UDP and
              DCCP traffic, and either of those. Values are priorities that should be assigned to
              matching traffic.

       dscp-prio DSCP-MAP
              DSCP-MAP uses the array parameter syntax, see dcb(8) for details. Keys are DSCP
              points, values are priorities assigned to traffic with matching DSCP. DSCP points
              can be written either directly as numeric values, or using symbolic names specified
              in /etc/iproute2/rt_dsfield (however note that that file specifies full 8-bit
              dsfield values, whereas dcb app will only use the higher six bits).  dcb app show
              will similarly format DSCP values as symbolic names if possible. The command line
              option -N turns the show translation off.

EXAMPLE & USAGE

       Prioritize traffic with DSCP 0 to priority 0, 24 to 3 and 48 to 6:

       # dcb app add dev eth0 dscp-prio 0:0 24:3 48:6

       Add another rule to configure DSCP 24 to priority 2 and show the result:

       # dcb app add dev eth0 dscp-prio 24:2
       # dcb app show dev eth0 dscp-prio
       dscp-prio 0:0 CS3:2 CS3:3 CS6:6
       # dcb -N app show dev eth0 dscp-prio
       dscp-prio 0:0 24:2 24:3 48:6

       Reconfigure the table so that the only rule for DSCP 24 is for assignment of priority 4:

       # dcb app replace dev eth0 dscp-prio 24:4
       # dcb app show dev eth0 dscp-prio
       dscp-prio 0:0 24:4 48:6

       Flush all DSCP rules:

       # dcb app flush dev eth0 dscp-prio
       # dcb app show dev eth0 dscp-prio
       (nothing)

EXIT STATUS

       Exit status is 0 if command was successful or a positive integer upon failure.

SEE ALSO

       dcb(8)

REPORTING BUGS

       Report any bugs to the Network Developers mailing list <netdev@vger.kernel.org> where the
       development and maintenance is primarily done.  You do not have to be subscribed to the
       list to send a message there.

AUTHOR

       Petr Machata <me@pmachata.org>