dcbtool(8)dcbtool(8)NAMEdcbtool - manage the Data Center Bridging (DCB) settings of a CEE DCB
interface
SYNOPSISdcbtool-h
dcbtool-v
dcbtool [-rR]
dcbtool [-rR] [command] [command arguments]
DESCRIPTIONdcbtool is used to query and set the DCB settings of a Converged
Enhanced Ethernet (CEE) DCB capable Ethernet interface. It connects to
the client interface of lldpad to perform these operations. dcbtool
will operate in interactive mode if it is executed without a command.
In interactive mode, dcbtool also functions as an event listener and
will print out events received from lldpad as they arrive. It will use
libreadline for interactive input when available. 802.1Qaz DCBX is not
controllable from dcbtool instead lldptool can be used in this case.
OPTIONS-h show the dcbtool usage message
-v shows dcbtool version information
-r display the raw lldpad client interface messages as well as the
readable output.
-R display only the raw lldpad client interface messages
COMMANDS
help shows the dcbtool usage message
ping test command. lldpad responds with "PPONG" if the client inter‐
face is operational.
license
displays dcbtool license information
quit exit from interactive mode
The following commands interact with lldpad to manage the daemon and
DCB features on DCB capable interfaces.
dcbtool general configuration commands:
<gc|go> dcbx
Get the configured or operational legacy version of the DCBX
protocol which will be supported by lldpad. The configured ver‐
sion, if different from the operational version, will take
effect after lldpad is restarted.
sc dcbx v:[cin|cee|force-cin|force-cee]
Set the legacy version of DCBX which will be supported by lldpad
the next time it is started.
Information about the CIN version can be found at:
<http://download.intel.com/technology/eedc/dcb_cep_spec.pdf>
Information about the CEE version can be found at:
<http://www.ieee802.org/1/files/public/docs2008/az-wadekar-dcbx-
capability-exchange-discovery-protocol-1108-v1.01.pdf>
The dcbx setting is a global setting and changes only take
effect when lldpad is restarted. The default DCBX version used
is the IEEE standard version. If a pre-IEEE DCBX version is
received (per port) which matches the dcbx setting, then lldpad
will fall back to the configured global dcbx setting. If the
dcbx setting is set to either 'force-cin' or 'force-cee' then
any port doing DCBX will start out in the corresponding legacy
DCBX mode.
DCB per-interface commands:
gc <ifname> <feature>
get configuration of feature on interface ifname.
go <ifname> <feature>
get operational status of feature on interface ifname.
gp <ifname> <feature>
get peer configuration of feature on interface ifname.
sc <ifname> <feature> <args>
set the configuration of feature on interface ifname.
feature may be one of the following:
dcb DCB state of the port
pg priority groups
pfc priority flow control
app:<subtype>
application specific data
ll:<subtype>
logical link status
subtype can be:
0|fcoe Fiber Channel over Ethernet (FCoE)
1|iscsi
Internet Small Computer System Interface (iSCSI)
2|fip FCoE Initialization Protocol (FIP)
args can include:
e:<0|1>
controls feature enable
a:<0|1>
controls whether the feature is advertised via DCBX to the peer
w:<0|1>
controls whether the feature is willing to change its opera‐
tional configuration based on what is received from the peer
[feature specific args]
arguments specific to a DCB feature
Feature specific arguments for dcb:
on|off enable or disable DCB for the interface. The go and gp commands
are not needed for the dcb feature. Also, the enable(e), adver‐
tise(a) and willing(w) arguments are not required.
Feature specific arguments for pg:
pgid:xxxxxxxx
Priority group ID for the 8 priorities. From left to right
(priorities 0-7), x is the corresponding priority group ID
value, which can be 0-7 for priority groups with bandwidth allo‐
cations or f (priority group ID 15) for the unrestricted prior‐
ity group.
pgpct:x,x,x,x,x,x,x,x
Priority group percentage of link bandwidth. From left to right
(priority groups 0-7), x is the percentage of link bandwidth
allocated to the corresponding priority group. The total band‐
width must equal 100%.
uppct:x,x,x,x,x,x,x,x
Priority percentage of priority group bandwidth. From left to
right (priorities 0-7), x is the percentage of priority group
bandwidth allocated to the corresponding priority. The sum of
percentages for priorities which belong to the same priority
group must total 100% (except for priority group 15).
strict:xxxxxxxx
Strict priority setting. From left to right (priorities 0-7), x
is 0 or 1. 1 indicates that the priority may utilize all of the
bandwidth allocated to its priority group.
up2tc:xxxxxxxx
Priority to traffic class mapping. From left to right (priori‐
ties 0-7), x is the traffic class (0-7) to which the priority is
mapped.
Feature specific arguments for pfc:
pfcup:xxxxxxxx
Enable/disable priority flow control. From left to right (pri‐
orities 0-7), x is 0 or 1. 1 indicates that the corresponding
priority is configured to transmit priority pause.
Feature specific arguments for app:<subtype>:
The app features uses global enable and willing bits for all
subtypes. To remove or add subtypes to the TLV set the advertise
bit.
appcfg:xx
xx is a hexadecimal value representing an 8 bit bitmap where 1
bits indicate the priorities which frames for the applications
specified by subtype should use. The lowest order bit maps to
priority 0.
Feature specific arguments for ll:<subtype>:
status:[0|1]
For testing purposes, the logical link status may be set to 0 or
1. Changes to the logical link status are not saved in the con‐
figuration file.
EXAMPLES
Enable DCB on interface eth2
dcbtool sc eth2 dcb on
Assign priorities 0-3 to priority group 0, priorities 4-6 to priority
group 1 and priority 7 to the unrestricted priority. Also, allocate
25% of link bandwidth to priority group 0 and 75% to group 1.
dcbtool sc eth2 pg pgid:0000111f pgpct:25,75,0,0,0,0,0,0
Enable transmit of Priority Flow Control for priority 3 and assign FCoE
to priority 3.
dcbtool sc eth2 pfc pfcup:00010000
dcbtool sc eth2 app:0 appcfg:08
SEE ALSOlldpad(8), lldptool(8), lldptool-dcbx(8), lldptool-ets(8), lldptool-
pfc(8), lldptool-app(8)COPYRIGHTdcbtool - DCB configuration utility
Copyright(c) 2007-2012 Intel Corporation. Portions of dcbtool are
based on:
hostapd-0.5.7
Copyright
(c) 2004-2008, Jouni Malinen <j@w1.fi>
LICENSE
This program is free software; you can redistribute it and/or modify it
under the terms and conditions of the GNU General Public License, ver‐
sion 2, as published by the Free Software Foundation.
This program is distributed in the hope it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
The full GNU General Public License is included in this distribution in
the file called "COPYING".
SUPPORT
Contact Information: open-lldp Mailing List <lldp-devel@open-lldp.org>
March 23, 2012 dcbtool(8)