dcb-dcbx - Man Page

show / manipulate port DCBX (Data Center Bridging eXchange)

Synopsis

dcb [ OPTIONS ] dcbx { COMMAND | help }

dcb dcbx show dev DEV

dcb dcbx set dev DEV [ host ] [ lld-managed ] [ cee ] [ ieee ] [ static ]

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. dcb dcbx is used to access the per-port Linux DCBX object.

There are two principal modes of operation: in 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 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.

Parameters

When used with 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 show, each enabled feature is shown by its corresponding keyword.

host
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 dcb dcbx allows setting both and lets the driver handle it as appropriate.

cee
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 dcb dcbx does not mandate this.

static

indicates the engine supports static configuration. No actual negotiation is performed, negotiated parameters are always the initial configuration.

Example & Usage

Put the DCB engine into the "host" mode of operation, and use IEEE-standardized DCB interfaces:

# dcb dcbx set dev eth0 host ieee

Show what was set:

# dcb dcbx show dev eth0
host ieee

Exit Status

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

See Also

dcb(8)

Reporting Bugs

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.

Author

Petr Machata <me@pmachata.org>

Info

13 December 2020 iproute2 Linux