Priority-based Flow Control Commands
This section lists and describes the commands that can be used to configure Priority-based Flow Control (PFC) in a Data Center Bridging (DCB) environment.It includes the following commands:
priority-flow-control accept-peer-config
Use this command to enable willing mode for PFC on the interface.
If willing is enabled, then by default advertise mode is also enabled.
Use the no form of this command to disable willing mode.
Command Syntax
priority-flow-control accept-peer-config
no priority-flow-control accept-peer-config
Parameters
None
Default
By default, willing mode for PFC on the interface is disabled. If willing is enabled, then by default advertise mode is also enabled.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface xe1
(config-if)#priority-flow-control accept-peer-config
priority-flow-control advertise-local-config
Use this command to enable advertising mode for PFC on the interface.
Use the no form of this command to disable advertising mode.
Command Syntax
priority-flow-control advertise-local-config
no priority-flow-control advertise-local-config
Parameters
None
Default
By default, advertising mode for PFC on the interface is disabled. If willing is enabled, then by default advertise mode is also enabled.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface xe1
(config-if)#priority-flow-control advertise-local-config
priority-flow-control enable
Use this command to enable Priority-based Flow Control (PFC) on a switch (bridge).
Use the no form of this command to disable PFC.
Command Syntax
priority-flow-control enable bridge <1-32>
no priority-flow-control bridge <1-32>
Parameters
<1-32>
Bridge ID.
Default
By default, PFC is disabled.
Command Mode
Configure mode
Default
PFC is disabled by default.
Applicability
This command was introduced before OcNOS version 1.3. This command is applicable for L3 interface from OcNOS version 6.6.1
Example
#configure terminal
(config)#priority-flow-control enable bridge 32
#configure terminal
(config)#no priority-flow-control bridge 32
priority-flow-control cap
Use this command to configure a priority-flow-control cap for the number of priorities allowed on an interface.
Use the no parameter along with this command to return the value to its default level.
Command Syntax
priority-flow-control cap <0-8>
no priority-flow-control cap
Parameters
<0-8>
Select a cap value. Zero indicates that there is no limitations.
Default
By default, priority-flow-control cap value is 8.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface xe2
(config-if)#priority-flow-control cap 7
priority-flow-control enable priority
Use this command to enable the PFC at the interface level for a specific priority.
Use the no parameter along with this command to disable PFC for a priority.
Command Syntax
priority-flow-control enable priority <0-7> (<0-7>(<0-7>(<0-7> (<0-7>(<0-7>(<0-7>(<0-7>|)|)|)|)|)|)|)
no priority-flow-control enable priority <0-7> (<0-7>(<0-7>(<0-7>(<0-7>(<0-7>(<0-7>(<0-7>|)|)|)|)|)|)|)
Parameter
<0-7>
Traffic-priority value. You can specify up to seven priorities.
Default
None
Command Mode
Interface mode
Default
PFC is disabled by default.
Applicability
This command was introduced before OcNOS version 1.3.
Examples
(config)#interface xe1
(config-if)#priority-flow-control enable priority 1 2 3 4 5 6 7
(config)#interface xe1
(config-if)#no priority-flow-control enable priority 2 3 4
priority-flow-control link-delay-allowance
Use this command to set PFC link delay allowance on an interface. This command provides allowance for round-trip propagation delay of the link in bits; moreover, it is one of the factors that determines when to trigger PAUSE.
Use the no parameter along with this command to unset PFC link delay allowance on an interface.
Command Syntax
priority-flow-control link-delay-allowance <0-4294967296>
no priority-flow-control link-delay-allowance
Parameter
<0-4294967296>
Link characteristics that affect the link delay (for example, link length).
Note: The range value is determined by the board type: for Tomahawk 3, it is 8,388,608; for Trident 3, it is 4,194,304; and for all other boards, the default value is 524,288.
Command Mode
Interface mode
Default
Default value is zero.
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#priority-flow-control link-delay-allowance 5
(config)#interface xe1
(config-if)#no priority-flow-control link-delay-allowance
priority-flow-control mode
Use this command to enable Priority-based Flow Control (PFC) on an interface.
Ues the no form of this command to disable PFC on an interface.
Command Syntax
priority-flow-control mode (on | auto)
no priority-flow-control
Parameters
auto
Negotiate PFC capabilities.
on
Force-enable PFC, overriding negotiation.
Default
By default, PFC is disabled.
Command Mode
Interface mode
Default
PFC is disabled by default.
Applicability
This command was introduced before OcNOS version 1.3. This command is applicable for L3 interface from OcNOS version 6.6.1
Example
#configure terminal
(config)#interface xe1
(config-if)#priority-flow-control mode auto
show priority-flow-control details
Use this command to display the PFC details for a specified interface.
Command Syntax
show priority-flow-control details ((all|interface IFNAME)|(bridge <1-32>))
Parameters
IFNAME
Name of the input or output interface.
<1-32>
Specify a bridge ID.
all
Display PFC enabled L2 and L3 interfaces
Default
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show priority-flow-control details interface xe1
bridge : 2
priority flow control : on
interface : xe1
Admin Configuration
mode advertise willing cap link priorities
delay
allowance
================================================================================
on on off 5 128 2 3 4 5
Operational Configuration
state cap link priorities
delay
allowance
================================================================================
on 5 128 2 3 4 5
Table 1-50: Show priority-flow control details output
Entry | Description |
|---|
bridge | The bridge number to which this interface is associated (1-32). |
priority flow control | Show whether priority flow control is either on or off. |
interface | The interface name. |
Admin Configuration | The configuration as entered on this device. |
mode | The priority flow control operating mode – on, off, or auto. |
advertise | Status of advertisement of the configuration to the peer device. |
willing | The willingness of the local interface to learn the PFC configuration from the peer. Values are either on or off. |
cap | Cap is a limit set that specifies the maximum number of PFC priorities. |
link delay allowance | The allowance made for round-trip propagation delay of the link in bits. |
Priorities | Shows the PFCs that have been to be used on the priorities. |
Operational Configuration | The actual configuration that exists between this device and its PFC peer. |
state | Shows whether PFC is functioning. Values are on, off, or auto. |
cap | Cap is the limit that specifies the maximum number of PFC priorities. |
link delay allowance | The allowance being used for round-trip propagation delay of the link in bits. |
priorities | The PFCs actually being used by this device and its peer. |
show priority-flow-control statistics
Use this command to display statistics about the number of PFC Pause frames sent and received for a specified interface or bridge. If you do not specify a bridge or interface, this commands shows statistics for the bridge.
Command Syntax
show priority-flow-control statistics ((all|interface IFNAME)| (bridge <1-32>))
Parameters
<1-32>
Specify bridge ID.
IFNAME
Name of the input or output interface.
all
Display PFC enabled L2 and L3 interfaces
Default
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show priority-flow-control statistics interface xe1
bridge : 2
interface : xe1
pause sent pause received
==============================
59680614996248372055834574861