{ "mode": "man", "parameter": "dcb-ets", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/dcb-ets/8/json", "generated": "2026-06-13T22:08:56Z", "synopsis": "dcb [ OPTIONS ] ets { COMMAND | help }\ndcb ets show dev DEV [ willing ] [ ets-cap ] [ cbs ] [ tc-tsa ] [ reco-tc-tsa ] [ pg-bw ] [\ntc-bw ] [ reco-tc-bw ] [ prio-tc ] [ reco-prio-tc ]\ndcb ets set dev DEV [ willing { on | off } ] [ { tc-tsa | reco-tc-tsa } TSA-MAP ] [ { pg-bw |\ntc-bw | reco-tc-bw } BW-MAP ] [ { prio-tc | reco-prio-tc } PRIO-MAP ]\nTSA-MAP := [ TSA-MAP ] TSA-MAPPING\nTSA-MAPPING := { TC | all }:{ strict | cbs | ets | vendor }\nBW-MAP := [ BW-MAP ] BW-MAPPING\nBW-MAPPING := { TC | all }:INTEGER\nPRIO-MAP := [ PRIO-MAP ] PRIO-MAPPING\nPRIO-MAPPING := { PRIO | all }:TC\nTC := { 0 .. 7 }\nPRIO := { 0 .. 7 }", "sections": { "NAME": { "content": "dcb-ets - show / manipulate ETS (Enhanced Transmission Selection) settings of the DCB (Data\nCenter Bridging) subsystem\n", "subsections": [] }, "SYNOPSIS": { "content": "dcb [ OPTIONS ] ets { COMMAND | help }\n\n\ndcb ets show dev DEV [ willing ] [ ets-cap ] [ cbs ] [ tc-tsa ] [ reco-tc-tsa ] [ pg-bw ] [\ntc-bw ] [ reco-tc-bw ] [ prio-tc ] [ reco-prio-tc ]\n\ndcb ets set dev DEV [ willing { on | off } ] [ { tc-tsa | reco-tc-tsa } TSA-MAP ] [ { pg-bw |\ntc-bw | reco-tc-bw } BW-MAP ] [ { prio-tc | reco-prio-tc } PRIO-MAP ]\n\nTSA-MAP := [ TSA-MAP ] TSA-MAPPING\n\nTSA-MAPPING := { TC | all }:{ strict | cbs | ets | vendor }\n\nBW-MAP := [ BW-MAP ] BW-MAPPING\n\nBW-MAPPING := { TC | all }:INTEGER\n\nPRIO-MAP := [ PRIO-MAP ] PRIO-MAPPING\n\nPRIO-MAPPING := { PRIO | all }:TC\n\nTC := { 0 .. 7 }\n\nPRIO := { 0 .. 7 }\n\n", "subsections": [] }, "DESCRIPTION": { "content": "dcb ets is used to configure Enhanced Transmission Selection attributes through Linux DCB\n(Data Center Bridging) interface. ETS permits configuration of mapping of priorities to traf‐\nfic classes, traffic selection algorithm to use per traffic class, bandwidth allocation, etc.\n\nTwo DCB TLVs are related to the ETS feature: a configuration and recommendation values. Rec‐\nommendation values are named with a prefix reco-, while the configuration ones have plain\nnames.\n\n", "subsections": [] }, "PARAMETERS": { "content": "For read-write parameters, the following describes only the write direction, i.e. as used\nwith the set command. For the show command, the parameter name is to be used as a simple key‐\nword without further arguments. This instructs the tool to show the value of a given parame‐\nter. When no parameters are given, the tool shows the complete ETS configuration.\n\n", "subsections": [ { "name": "ets-cap", "content": "A read-only property that shows the number of supported ETS traffic classes.\n\n\ncbs A read-only property that is enabled if the driver and the hardware support the CBS\nTransmission Selection Algorithm.\n\n\nwilling { on | off }\nWhether local host should accept configuration from peer TLVs.\n\n\nprio-tc PRIO-MAP\nreco-prio-tc PRIO-MAP\nPRIO-MAP uses the array parameter syntax, see dcb(8) for details. Keys are priorities,\nvalues are traffic classes. For each priority sets a TC where traffic with that prior‐\nity is directed to.\n\n\ntc-tsa TSA-MAP\nreco-tc-tsa TSA-MAP\nTSA-MAP uses the array parameter syntax, see dcb(8) for details. Keys are TCs, values\nare Transmission Selection Algorithm (TSA) keywords described below. For each TC sets\nan algorithm used for deciding how traffic queued up at this TC is scheduled for\ntransmission. Supported TSAs are:\n\nstrict - for strict priority, where traffic in higher-numbered TCs always takes prece‐\ndence over traffic in lower-numbered TCs.\nets - for Enhanced Traffic Selection, where available bandwidth is distributed among\nthe ETS-enabled TCs according to the weights set by tc-bw and reco-tc-bw, respec‐\ntively.\ncbs - for Credit Based Shaper, where traffic is scheduled in a strict manner up to the\nlimit set by a shaper.\nvendor - for vendor-specific traffic selection algorithm.\n\n\ntc-bw BW-MAP\nreco-tc-bw BW-MAP\nBW-MAP uses the array parameter syntax, see dcb(8) for details. Keys are TCs, values\nare integers representing percent of available bandwidth given to the traffic class in\nquestion. The value should be 0 for TCs whose TSA is not ets, and the sum of all val‐\nues shall be 100. As an exception to the standard wording, a configuration with no ets\nTCs is permitted to sum up to 0 instead.\n\n\npg-bw BW-MAP\nThe precise meaning of pg-bw is not standardized, but the assumption seems to be that\nthe same scheduling process as on the transmit side is applicable on receive side as\nwell, and configures receive bandwidth allocation for ets ingress traffic classes\n(priority groups).\n\n" }, { "name": "EXAMPLE & USAGE", "content": "Configure ETS priomap in a one-to-one fashion:\n\n\n# dcb ets set dev eth0 prio-tc 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7\n\nSet TSA and transmit bandwidth configuration:\n\n\n# dcb ets set dev eth0 tc-tsa all:strict 0:ets 1:ets 2:ets \\\ntc-bw all:0 0:33 1:33 2:34\n\nShow what was set:\n\n\n# dcb ets show dev eth0 prio-tc tc-tsa tc-bw\nprio-tc 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7\ntc-tsa 0:ets 1:ets 2:ets 3:strict 4:strict 5:strict 6:strict 7:strict\ntc-bw 0:33 1:33 2:34 3:0 4:0 5:0 6:0 7:0\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 19 October 2020 DCB-ETS(8)", "subsections": [] } }, "summary": "dcb-ets - show / manipulate ETS (Enhanced Transmission Selection) settings of the DCB (Data Center Bridging) subsystem", "flags": [], "examples": [], "see_also": [ { "name": "dcb", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/dcb/8/json" } ] }