{ "content": [ { "type": "text", "text": "# dcb-app (man)\n\n## NAME\n\ndcb-app - show / manipulate application priority table of the DCB (Data Center Bridging) sub‐ system\n\n## SYNOPSIS\n\ndcb [ OPTIONS ] app { COMMAND | help }\ndcb app { show | flush } dev DEV [ default-prio ] [ ethtype-prio ] [ stream-port-prio ]\n[ dgram-port-prio ] [ port-prio ] [ dscp-prio ]\ndcb ets { add | del | replace } dev DEV [ default-prio PRIO-LIST ] [ ethtype-prio ET-\nMAP ] [ stream-port-prio PORT-MAP ] [ dgram-port-prio PORT-MAP ] [ port-prio PORT-MAP\n] [ dscp-prio DSCP-MAP ]\nPRIO-LIST := [ PRIO-LIST ] PRIO\nET-MAP := [ ET-MAP ] ET-MAPPING\nET-MAPPING := ET:PRIO\nPORT-MAP := [ PORT-MAP ] PORT-MAPPING\nPORT-MAPPING := PORT:PRIO\nDSCP-MAP := [ DSCP-MAP ] DSCP-MAPPING\nDSCP-MAPPING := { DSCP | all }:PRIO\nET := { 0x600 .. 0xffff }\nPORT := { 1 .. 65535 }\nDSCP := { 0 .. 63 }\nPRIO := { 0 .. 7 }\n\n## DESCRIPTION\n\ndcb app is used to configure APP table, or application priority table in the DCB (Data Center\nBridging) subsystem. The APP table is used to assign priority to traffic based on value in\none of several headers: EtherType, L4 destination port, or DSCP. It also allows configuration\nof port-default priority that is chosen if no other prioritization rule applies.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **COMMANDS** (2 subsections)\n- **PARAMETERS** (1 subsections)\n- **EXIT STATUS**\n- **SEE ALSO**\n- **REPORTING BUGS**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "dcb-app", "section": "", "mode": "man", "summary": "dcb-app - show / manipulate application priority table of the DCB (Data Center Bridging) sub‐ system", "synopsis": "dcb [ OPTIONS ] app { COMMAND | help }\ndcb app { show | flush } dev DEV [ default-prio ] [ ethtype-prio ] [ stream-port-prio ]\n[ dgram-port-prio ] [ port-prio ] [ dscp-prio ]\ndcb ets { add | del | replace } dev DEV [ default-prio PRIO-LIST ] [ ethtype-prio ET-\nMAP ] [ stream-port-prio PORT-MAP ] [ dgram-port-prio PORT-MAP ] [ port-prio PORT-MAP\n] [ dscp-prio DSCP-MAP ]\nPRIO-LIST := [ PRIO-LIST ] PRIO\nET-MAP := [ ET-MAP ] ET-MAPPING\nET-MAPPING := ET:PRIO\nPORT-MAP := [ PORT-MAP ] PORT-MAPPING\nPORT-MAPPING := PORT:PRIO\nDSCP-MAP := [ DSCP-MAP ] DSCP-MAPPING\nDSCP-MAPPING := { DSCP | all }:PRIO\nET := { 0x600 .. 0xffff }\nPORT := { 1 .. 65535 }\nDSCP := { 0 .. 63 }\nPRIO := { 0 .. 7 }", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [], "examples": [], "see_also": [ { "name": "dcb", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/dcb/8/json" } ], "section_outline": [ { "name": "NAME", "lines": 3, "subsections": [] }, { "name": "SYNOPSIS", "lines": 33, "subsections": [] }, { "name": "DESCRIPTION", "lines": 23, "subsections": [] }, { "name": "COMMANDS", "lines": 8, "subsections": [ { "name": "add", "lines": 3 }, { "name": "replace", "lines": 7 } ] }, { "name": "PARAMETERS", "lines": 36, "subsections": [ { "name": "EXAMPLE & USAGE", "lines": 29 } ] }, { "name": "EXIT STATUS", "lines": 3, "subsections": [] }, { "name": "SEE ALSO", "lines": 3, "subsections": [] }, { "name": "REPORTING BUGS", "lines": 5, "subsections": [] }, { "name": "AUTHOR", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "dcb-app - show / manipulate application priority table of the DCB (Data Center Bridging) sub‐\nsystem\n", "subsections": [] }, "SYNOPSIS": { "content": "dcb [ OPTIONS ] app { COMMAND | help }\n\n\ndcb app { show | flush } dev DEV [ default-prio ] [ ethtype-prio ] [ stream-port-prio ]\n[ dgram-port-prio ] [ port-prio ] [ dscp-prio ]\n\ndcb ets { add | del | replace } dev DEV [ default-prio PRIO-LIST ] [ ethtype-prio ET-\nMAP ] [ stream-port-prio PORT-MAP ] [ dgram-port-prio PORT-MAP ] [ port-prio PORT-MAP\n] [ dscp-prio DSCP-MAP ]\n\nPRIO-LIST := [ PRIO-LIST ] PRIO\n\nET-MAP := [ ET-MAP ] ET-MAPPING\n\nET-MAPPING := ET:PRIO\n\nPORT-MAP := [ PORT-MAP ] PORT-MAPPING\n\nPORT-MAPPING := PORT:PRIO\n\nDSCP-MAP := [ DSCP-MAP ] DSCP-MAPPING\n\nDSCP-MAPPING := { DSCP | all }:PRIO\n\nET := { 0x600 .. 0xffff }\n\nPORT := { 1 .. 65535 }\n\nDSCP := { 0 .. 63 }\n\nPRIO := { 0 .. 7 }\n\n", "subsections": [] }, "DESCRIPTION": { "content": "dcb app is used to configure APP table, or application priority table in the DCB (Data Center\nBridging) subsystem. The APP table is used to assign priority to traffic based on value in\none of several headers: EtherType, L4 destination port, or DSCP. It also allows configuration\nof port-default priority that is chosen if no other prioritization rule applies.\n\nDCB APP entries are 3-tuples of selector, protocol ID, and priority. Selector is an enumera‐\ntion that picks one of the prioritization namespaces. Currently it mostly corresponds to con‐\nfigurable parameters described below. Protocol ID is a value in the selector namespace. E.g.\nfor EtherType selector, protocol IDs are the individual EtherTypes, for DSCP they are indi‐\nvidual code points. The priority is the priority that should be assigned to traffic that\nmatches the selector and protocol ID.\n\nThe APP table is a set of DCB APP entries. The only requirement is that duplicate entries are\nnot added. Notably, it is valid to have conflicting priority assignment for the same selector\nand protocol ID. For example, the set of two APP entries (DSCP, 10, 1) and (DSCP, 10, 2),\nwhere packets with DSCP of 10 should get priority of both 1 and 2, form a well-defined APP\ntable. The dcb app tool allows low-level management of the app table by adding and deleting\nindividual APP 3-tuples through add and del commands. On the other other hand, the command\nreplace does what one would typically want in this situation--first adds the new configura‐\ntion, and then removes the obsolete one, so that only one prioritization is in effect for a\ngiven selector and protocol ID.\n\n", "subsections": [] }, "COMMANDS": { "content": "show Display all entries with a given selector. When no selector is given, shows all APP\ntable entries categorized per selector.\n\n\nflush Remove all entries with a given selector. When no selector is given, removes all APP\ntable entries.\n\n", "subsections": [ { "name": "add", "content": "del Add and, respectively, remove individual APP 3-tuples to and from the DCB APP table.\n\n" }, { "name": "replace", "content": "Take the list of entries mentioned as parameter, and add those that are not present in\nthe APP table yet. Then remove those entries, whose selector and protocol ID have been\nmentioned as parameter, but not with the exact same priority. This has the effect of,\nfor the given selector and protocol ID, causing that the table only contains the pri‐\nority (or priorities) given as parameter.\n\n" } ] }, "PARAMETERS": { "content": "The following table shows parameters in a way that they would be used with add, del and re‐‐\nplace commands. For show and flush, the parameter name is to be used as a simple keyword\nwithout further arguments.\n\n\ndefault-prio PRIO-LIST\nThe priority to be used for traffic the priority of which is otherwise unspecified.\nThe argument is a list of individual priorities. Note that default-prio rules are con‐\nfigured as triplets (EtherType, 0, PRIO). dcb app translates these rules to the sym‐\nbolic name default-prio and back.\n\n\nethtype-prio ET-MAP\nET-MAP uses the array parameter syntax, see dcb(8) for details. Keys are EtherType\nvalues. Values are priorities to be assigned to traffic with the matching EtherType.\n\n\nstream-port-prio PORT-MAP\ndgram-port-prio PORT-MAP\nport-prio PORT-MAP\nPORT-MAP uses the array parameter syntax, see dcb(8) for details. Keys are L4 destina‐\ntion port numbers that match on, respectively, TCP and SCTP traffic, UDP and DCCP\ntraffic, and either of those. Values are priorities that should be assigned to match‐\ning traffic.\n\n\ndscp-prio DSCP-MAP\nDSCP-MAP uses the array parameter syntax, see dcb(8) for details. Keys are DSCP\npoints, values are priorities assigned to traffic with matching DSCP. DSCP points can\nbe written either direcly as numeric values, or using symbolic names specified in\n/etc/iproute2/rtdsfield (however note that that file specifies full 8-bit dsfield\nvalues, whereas dcb app will only use the higher six bits). dcb app show will simi‐\nlarly format DSCP values as symbolic names if possible. The command line option -N\nturns the show translation off.\n\n", "subsections": [ { "name": "EXAMPLE & USAGE", "content": "Prioritize traffic with DSCP 0 to priority 0, 24 to 3 and 48 to 6:\n\n\n# dcb app add dev eth0 dscp-prio 0:0 24:3 48:6\n\nAdd another rule to configure DSCP 24 to priority 2 and show the result:\n\n\n# dcb app add dev eth0 dscp-prio 24:2\n# dcb app show dev eth0 dscp-prio\ndscp-prio 0:0 CS3:2 CS3:3 CS6:6\n# dcb -N app show dev eth0 dscp-prio\ndscp-prio 0:0 24:2 24:3 48:6\n\nReconfigure the table so that the only rule for DSCP 24 is for assignment of priority 4:\n\n\n# dcb app replace dev eth0 dscp-prio 24:4\n# dcb app show dev eth0 dscp-prio\ndscp-prio 0:0 24:4 48:6\n\nFlush all DSCP rules:\n\n\n# dcb app flush dev eth0 dscp-prio\n# dcb app show dev eth0 dscp-prio\n(nothing)\n\n" } ] }, "EXIT STATUS": { "content": "Exit status is 0 if command was successful or a positive integer upon failure.\n\n", "subsections": [] }, "SEE ALSO": { "content": "dcb(8)\n\n", "subsections": [] }, "REPORTING BUGS": { "content": "Report any bugs to the Network Developers mailing list where the de‐\nvelopment and maintenance is primarily done. You do not have to be subscribed to the list to\nsend a message there.\n\n", "subsections": [] }, "AUTHOR": { "content": "Petr Machata \n\n\n\niproute2 6 December 2020 DCB-ETS(8)", "subsections": [] } } } }