| .TH DCB-DCBX 8 "13 December 2020" "iproute2" "Linux" |
| .SH NAME |
| dcb-dcbx \- show / manipulate port DCBX (Data Center Bridging eXchange) |
| .SH SYNOPSIS |
| .sp |
| .ad l |
| .in +8 |
| |
| .ti -8 |
| .B dcb |
| .RI "[ " OPTIONS " ] " |
| .B dcbx |
| .RI "{ " COMMAND " | " help " }" |
| .sp |
| |
| .ti -8 |
| .B dcb dcbx show dev |
| .RI DEV |
| |
| .ti -8 |
| .B dcb dcbx set dev |
| .RI DEV |
| .RB "[ " host " ]" |
| .RB "[ " lld-managed " ]" |
| .RB "[ " cee " ]" |
| .RB "[ " ieee " ]" |
| .RB "[ " static " ]" |
| |
| .SH DESCRIPTION |
| |
| Data Center Bridging eXchange (DCBX) is a protocol used by DCB devices to |
| exchange configuration information with directly connected peers. The Linux DCBX |
| object is a 1-byte bitfield of flags that configure whether DCBX is implemented |
| in the device or in the host, and which version of the protocol should be used. |
| .B dcb dcbx |
| is used to access the per-port Linux DCBX object. |
| |
| There are two principal modes of operation: in |
| .B host |
| mode, DCBX protocol is implemented by the host LLDP agent, and the DCB |
| interfaces are used to propagate the negotiate parameters to capable devices. In |
| .B lld-managed |
| mode, the configuration is handled by the device, and DCB interfaces are used |
| for inspection of negotiated parameters, and can also be used to set initial |
| parameters. |
| |
| .SH PARAMETERS |
| |
| When used with |
| .B dcb dcbx set, |
| the following keywords enable the corresponding configuration. The keywords that |
| are not mentioned on the command line are considered disabled. When used with |
| .B show, |
| each enabled feature is shown by its corresponding keyword. |
| |
| .TP |
| .B host |
| .TQ |
| .B lld-managed |
| The device is in the host mode of operation and, respectively, the lld-managed |
| mode of operation, as described above. In principle these two keywords are |
| mutually exclusive, but |
| .B dcb dcbx |
| allows setting both and lets the driver handle it as appropriate. |
| |
| .TP |
| .B cee |
| .TQ |
| .B ieee |
| The device supports CEE (Converged Enhanced Ethernet) and, respectively, IEEE |
| version of the DCB specification. Typically only one of these will be set, but |
| .B dcb dcbx |
| does not mandate this. |
| |
| .TP |
| .B static |
| indicates the engine supports static configuration. No actual negotiation is |
| performed, negotiated parameters are always the initial configuration. |
| |
| .SH EXAMPLE & USAGE |
| |
| Put the DCB engine into the "host" mode of operation, and use IEEE-standardized |
| DCB interfaces: |
| |
| .P |
| # dcb dcbx set dev eth0 host ieee |
| |
| Show what was set: |
| |
| .P |
| # dcb dcbx show dev eth0 |
| .br |
| host ieee |
| |
| .SH EXIT STATUS |
| Exit status is 0 if command was successful or a positive integer upon failure. |
| |
| .SH SEE ALSO |
| .BR dcb (8) |
| |
| .SH REPORTING BUGS |
| Report any bugs to the Network Developers mailing list |
| .B <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. |
| |
| .SH AUTHOR |
| Petr Machata <me@pmachata.org> |