|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | OPTIONS | OBJECTS | COMMANDS | ARRAY PARAMETERS | EXIT STATUS | SEE ALSO | REPORTING BUGS | AUTHOR | COLOPHON |
|
|
|
DCB(8) Linux DCB(8)
dcb - show / manipulate DCB (Data Center Bridging) settings
dcb [ OPTIONS ] { app | buffer | ets | maxrate | pfc } { COMMAND |
help }
dcb [ -force ] -batch filename
dcb [ OPTIONS ] help
-n, --netns <NETNS>
switches dcb to the specified network namespace NETNS.
-V, --Version
Print the version of the dcb utility and exit.
-b, --batch <FILENAME>
Read commands from provided file or standard input and
invoke them. First failure will cause termination of dcb.
-f, --force
Don't terminate dcb on errors in batch mode. If there were
any errors during execution of the commands, the
application return code will be non zero.
-i, --iec
When showing rates, use ISO/IEC 1024-based prefixes (Ki,
Mi, Bi) instead of the 1000-based ones (K, M, B).
-j, --json
Generate JSON output.
-N, --Numeric
If the subtool in question translates numbers to symbolic
names in some way, suppress this translation.
-p, --pretty
When combined with -j generate a pretty JSON output.
-s, --statistics
If the object in question contains any statistical
counters, shown them as part of the "show" output.
app - Configuration of application priority table
buffer - Configuration of port buffers
ets - Configuration of ETS (Enhanced Transmission Selection)
maxrate
- Configuration of per-TC maximum transmit rate
pfc - Configuration of PFC (Priority-based Flow Control)
A COMMAND specifies the action to perform on the object. The set
of possible actions depends on the object type. As a rule, it is
possible to show objects and to invoke topical help, which prints
a list of available commands and argument syntax conventions.
Like commands, specification of parameters is in the domain of
individual objects (and their commands) as well. However, much of
the DCB interface revolves around arrays of fixed size that
specify one value per some key, such as per traffic class or per
priority. There is therefore a single syntax for adjusting
elements of these arrays. It consists of a series of KEY:VALUE
pairs, where the meaning of the individual keys and values depends
on the parameter.
The elements are evaluated in order from left to right, and the
latter ones override the earlier ones. The elements that are not
specified on the command line are queried from the kernel and
their current value is retained.
As an example, take a made-up parameter tc-juju, which can be set
to charm traffic in a given TC with either good luck or bad luck.
KEY can therefore be 0..7 (as is usual for TC numbers in DCB), and
VALUE either of none, good, and bad. An example of changing a juju
value of TCs 0 and 7, while leaving all other intact, would then
be:
# dcb foo set dev eth0 tc-juju 0:good 7:bad
A special key, all, is recognized which sets the same value to all
array elements. This can be combined with the usual single-element
syntax. E.g. in the following, the juju of all keys is set to
none, except 0 and 7, which have other values:
# dcb foo set dev eth0 tc-juju all:none 0:good 7:bad
Exit status is 0 if command was successful or a positive integer
upon failure.
dcb-app(8), dcb-apptrust(8), dcb-buffer(8), dcb-ets(8),
dcb-maxrate(8), dcb-pfc(8), dcb-rewr(8)
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.
Petr Machata <me@pmachata.org>
This page is part of the iproute2 (utilities for controlling
TCP/IP networking and traffic) project. Information about the
project can be found at
⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
If you have a bug report for this manual page, send it to
netdev@vger.kernel.org, shemminger@osdl.org. This page was
obtained from the project's upstream Git repository
⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
2025-08-11. (At that time, the date of the most recent commit
that was found in the repository was 2025-08-08.) If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page,
or you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a
mail to man-pages@man7.org
iproute2 19 October 2020 DCB(8)
Pages that refer to this page: dcb-app(8), dcb-apptrust(8), dcb-buffer(8), dcb-dcbx(8), dcb-ets(8), dcb-maxrate(8), dcb-pfc(8), dcb-rewr(8)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|