dcb-buffer(8)

1DCB-BUFFER(8)                        Linux                       DCB-BUFFER(8)
2
3
4

NAME

6       dcb-buffer  -  show  / manipulate port buffer settings of the DCB (Data
7       Center Bridging) subsystem
8

SYNOPSIS

10       dcb [ OPTIONS ] buffer { COMMAND | help }
11
12
13       dcb buffer show dev DEV [ prio-buffer ] [ buffer-size ] [ total-size ]
14
15       dcb buffer set dev DEV [ prio-buffer PRIO-MAP ] [ buffer-size SIZE-MAP
16               ]
17
18       PRIO-MAP := [ PRIO-MAP ] PRIO-MAPPING
19
20       PRIO-MAPPING := { PRIO | all }:BUFFER
21
22       SIZE-MAP := [ SIZE-MAP ] SIZE-MAPPING
23
24       SIZE-MAPPING := { BUFFER | all }:SIZE
25
26       PRIO := { 0 .. 7 }
27
28       BUFFER := { 0 .. 7 }
29
30       SIZE := { INTEGER | INTEGERK | INTEGERM | ... }
31
32

DESCRIPTION

34       dcb buffer is used to configure assignment of traffic to port buffers
35       based on traffic priority, and sizes of those buffers. It can be also
36       used to inspect the current configuration, as well as total device mem‐
37       ory that the port buffers take.
38
39

PARAMETERS

41       For read-write parameters, the following describes only the write di‐
42       rection, i.e. as used with the set command. For the show command, the
43       parameter name is to be used as a simple keyword without further argu‐
44       ments. This instructs the tool to show the value of a given parameter.
45       When no parameters are given, the tool shows the complete buffer con‐
46       figuration.
47
48
49       total-size
50              A read-only property that shows the total device memory taken up
51              by port buffers. This might be more than a simple sum of indi‐
52              vidual buffer sizes if there are any hidden or internal buffers.
53
54
55       prio-buffer PRIO-MAP
56              PRIO-MAP uses the array parameter syntax, see dcb(8) for de‐
57              tails. Keys are priorities, values are buffer indices. For each
58              priority sets a buffer where traffic with that priority is di‐
59              rected to.
60
61
62       buffer-size SIZE-MAP
63              SIZE-MAP uses the array parameter syntax, see dcb(8) for de‐
64              tails. Keys are buffer indices, values are sizes of that buffer
65              in bytes.  The sizes can use the notation documented in section
66              PARAMETERS at tc(8).  Note that the size requested by the tool
67              can be rounded or capped by the driver to satisfy the require‐
68              ments of the device.
69
70

EXAMPLE & USAGE

72       Configure the priomap in a one-to-one fashion:
73
74
75       # dcb buffer set dev eth0 prio-buffer 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7
76
77       Set sizes of all buffers to 10KB, except for buffer 6, which will have
78       the size 1MB:
79
80
81       # dcb buffer set dev eth0 buffer-size all:10K 6:1M
82
83       Show what was set:
84
85
86       # dcb buffer show dev eth0
87       prio-buffer 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7
88       buffer-size 0:10Kb 1:10Kb 2:10Kb 3:10Kb 4:10Kb 5:10Kb 6:1Mb 7:10Kb
89       total-size 1222Kb
90
91

EXIT STATUS

93       Exit status is 0 if command was successful or a positive integer upon
94       failure.
95
96

REPORTING BUGS

102       Report any bugs to the Network Developers mailing list <net‐
103       dev@vger.kernel.org> where the development and maintenance is primarily
104       done.  You do not have to be subscribed to the list to send a message
105       there.
106
107

AUTHOR

109       Petr Machata <me@pmachata.org>
110
111
112
113iproute2                       12 November 2020                  DCB-BUFFER(8)