# dcb-buffer

## NAME



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


## SYNOPSIS



           **dcb**[ _OPTIONS_ ] **buffer**{ _COMMAND_ | _help_ }
    
           **dcb buffer show dev** DEV [ **prio-buffer**] [ **buffer-size**] [ **total-**
                   **size**]
    
           **dcb buffer set dev** DEV [ **prio-buffer** _PRIO-MAP_ ] [ **buffer-size**
                   _SIZE-MAP_ ]
    
           _PRIO-MAP_ := [ _PRIO-MAP_ ] _PRIO-MAPPING_
    
           _PRIO-MAPPING_ := { _PRIO_ | **all**}**:**_BUFFER_
    
           _SIZE-MAP_ := [ _SIZE-MAP_ ] _SIZE-MAPPING_
    
           _SIZE-MAPPING_ := { _BUFFER_ | **all**}**:**_SIZE_
    
           _PRIO_ := { **0**.. **7**}
    
           _BUFFER_ := { **0**.. **7**}
    
           _SIZE_ := { _INTEGER_ | _INTEGER_**K** | _INTEGER_**M** | _..._ }
    


## DESCRIPTION



           **dcb buffer** is used to configure assignment of traffic to port
           buffers based on traffic priority, and sizes of those buffers. It
           can be also used to inspect the current configuration, as well as
           total device memory that the port buffers take.
    


## PARAMETERS



           For read-write parameters, the following describes only the write
           direction, i.e. as used with the **set** command. For the **show**
           command, the parameter name is to be used as a simple keyword
           without further arguments. This instructs the tool to show the
           value of a given parameter. When no parameters are given, the tool
           shows the complete buffer configuration.
    
           **total-size**
                  A read-only property that shows the total device memory
                  taken up by port buffers. This might be more than a simple
                  sum of individual buffer sizes if there are any hidden or
                  internal buffers.
    
           **prio-buffer** _PRIO-MAP_
                  _PRIO-MAP_ uses the array parameter syntax, see dcb(8) for
                  details. Keys are priorities, values are buffer indices.
                  For each priority sets a buffer where traffic with that
                  priority is directed to.
    
           **buffer-size** _SIZE-MAP_
                  _SIZE-MAP_ uses the array parameter syntax, see dcb(8) for
                  details. Keys are buffer indices, values are sizes of that
                  buffer in bytes.  The sizes can use the notation documented
                  in section PARAMETERS at tc(8).  Note that the size
                  requested by the tool can be rounded or capped by the
                  driver to satisfy the requirements of the device.
    


## EXAMPLE & USAGE



           Configure the priomap in a one-to-one fashion:
    
           # dcb buffer set dev eth0 prio-buffer 0:0 1:1 2:2 3:3 4:4 5:5 6:6
           7:7
    
           Set sizes of all buffers to 10KB, except for buffer 6, which will
           have the size 1MB:
    
           # dcb buffer set dev eth0 buffer-size all:10K 6:1M
    
           Show what was set:
    
           # dcb buffer show dev eth0
           prio-buffer 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7
           buffer-size 0:10Kb 1:10Kb 2:10Kb 3:10Kb 4:10Kb 5:10Kb 6:1Mb 7:10Kb
           total-size 1222Kb
    


## EXIT STATUS



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


* * *