Rechercher une page de manuel
dcbtool
Langue: en
Version: February 17, 2009 (fedora - 06/07/09)
Section: 8 (Commandes administrateur)
NAME
dcbtool - manage the Data Center Bridging (DCB) settings of a DCB interfaceSYNOPSIS
dcbtool -hdcbtool -v
dcbtool [-rR]
dcbtool [-rR] [command] [command arguments]
DESCRIPTION
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.OPTIONS
- -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
COMMANDS
- help
- shows the dcbtool usage message
- ping
- test command. The dcbd daemon responds with "PONG" if the client interface is operational.
- license
- 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:
<http://download.intel.com/technology/eedc/dcb_cep_spec.pdf> Information about version 2 can be found at:
<http://www.ieee802.org/1/files/public/docs2008/az-wadekar-dcbx-capability-exchange-discovery-protocol-1108-v1.01.pdf>
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
- bcn
- backward congestion notification
subtype can be:
- 0|fcoe
- Fiber Channel over Ethernet (FCoE)
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 operational 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 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:
- 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 allocations or f (priority group ID 15) for the unrestricted priority 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 bandwidth 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 (priorities 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 (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>:
- 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. This setting is not persisted in the configuration file.
Feature specific arguments for bcn:
- rpadmin:xxxxxxxx
- Priorities for which a BCN reaction point should be enabled. From left to right (priorities 0-7), x is 0 or 1. A 1 indicates that the corresponding priorities is enabled.
- alpha:<0.0-1.0>
- alpha - floating point value between 0 and 1
- beta:<0.0-1.0>
- beta -floating point value between 0 and 1
- gd:<0.0-1.0>
- decrement coefficient - floating point value between 0 and 1
- gi:<0.0-1.0>
- increment coefficient - floating point value between 0 and 1
- tmax:<0-1000000>
- max time to backoff after BCN0
- td:<1-10000>
- drift interval
- rmin:<1-1000>
- default rate after first BCN0
- dw:<1-64>
- derived weight (1 = 0.125)
- rd:<1-100>
- drift factor
- ru:<1-100>
- rate unit
- wrtt:<0-10>
- RTT moving average weight
- ri:<0-10000>
- initial rate
EXAMPLES
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
LICENSE
dcbtool - DCB configuration utilityCopyright(c) 2008 Intel Corporation. Portions of dcbtool are based on:
- hostapd-0.5.7
- Copyright
- (c) 2004-2008, Jouni Malinen <j@w1.fi>
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, asrepreseting 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: e1000-eedc Mailing List <e1000-eedc@lists.sourceforge.net> Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre