Man Linux: Main Page and Category List


       dcbtool  -  manage  the  Data  Center  Bridging (DCB) settings of a DCB


       dcbtool -h
       dcbtool -v
       dcbtool [-rR]
       dcbtool [-rR] [command] [command arguments]


       dcbtool is used to query and set the DCB  settings  of  a  DCB  capable
       Ethernet  interface.   It  connects  to the client interface of dcbd 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
       dcbd as they arrive.


       -h     show the dcbtool usage message

       -v     shows dcbtool version information

       -r     display  the  raw  dcbd client interface messages as well as the
              readable output.

       -R     display only the raw dcbd client interface messages


       help   shows the dcbtool usage message

       ping   test command.  The dcbd daemon  responds  with  "PPONG"  if  the
              client interface is operational.

              displays dcbtool license information

       quit   exit from interactive mode

       The  following  commands  interact  with  the dcbd daemon to manage the
       daemon and DCB features on DCB capable interfaces.

       dcbd general configuration commands:

       <gc|go> dcbx
              get  the  configured  or  operational   version   of   the   DCB
              capabilities  exchange  protocol.   If different, the configured
              version will take effect (and become  the  operational  version)
              after dcbd is restarted.

       sc dcbx v:[1|2]
              set  the version of the DCB capabilities exchange protocol which
              will be used the next time dcbd is started.   Information  about
              version 1 can be found at:
              Information about version 2 can be found at:

       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

              application specific data

              logical link status

       subtype can be:

       0|fcoe Fiber Channel over Ethernet (FCoE)

       args can include:

              controls feature enable

              controls whether the feature is advertised via DCBX to the peer

              controls   whether   the   feature  is  willing  to  change  its
              operational configuration based on what  is  received  from  the

       [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),
              advertise(a) and willing(w) arguments are not required.

       Feature specific arguments for pg:

              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
              allocations or f (priority group ID  15)  for  the  unrestricted
              priority group.

              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
              bandwidth must equal 100%.

              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 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.

              Priority  to  traffic  class  mapping.   From  left   to   right
              (priorities  0-7),  x  is  the  traffic class (0-7) to which the
              priority is mapped.

       Feature specific arguments for pfc:

              Enable/disable  priority  flow  control.   From  left  to  right
              (priorities   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>:

              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>:

              For testing purposes, the logical link status may be set to 0 or
              1.  This setting is not persisted in the configuration file.


       Enable DCB on interface eth2

       dcbtool sc eth2 dcb on

       Assign  priorites  0-3  to  priority group 0, priorites 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


       dcbtool - DCB configuration utility
       Copyright(c) 2007-2009 Intel Corporation.    Portions  of  dcbtool  are
       based on:


              (c) 2004-2008, Jouni Malinen <>

       This program is free software; you can redistribute it and/or modify it
       under the terms and conditions  of  the  GNU  General  Public  License,
       version 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".


       Contact        Information:        e1000-eedc        Mailing       List
       <> Intel Corporation,  5200  N.E.  Elam
       Young Parkway, Hillsboro, OR 97124-6497

                                 June 29, 2009                      dcbtool(8)