mirror of
https://git.proxmox.com/git/mirror_iproute2
synced 2025-08-14 16:24:31 +00:00
89d11ea596
The Linux DCBX object is a 1-byte bitfield of flags that configure whether the DCBX protocol is implemented in the device or in the host, and which version of the protocol should be used. Add a tool to access the per-port Linux DCBX object. For example: # dcb dcbx set dev eni1np1 host ieee # dcb dcbx show dev eni1np1 host ieee Signed-off-by: Petr Machata <me@pmachata.org> Signed-off-by: David Ahern <dsahern@kernel.org>
109 lines
2.7 KiB
Groff
109 lines
2.7 KiB
Groff
.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, respecively, 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>
|