- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
04-Data buffer commands | 65.51 KB |
Data buffer commands
buffer usage threshold
Use buffer usage threshold to set a per-interface buffer usage threshold.
Use undo buffer usage threshold to restore the default.
Syntax
In standalone mode:
buffer usage threshold slot slot-number ratio ratio
undo buffer usage threshold slot slot-number
In IRF mode:
buffer usage threshold chassis chassis-number slot slot-number ratio ratio
undo buffer usage threshold chassis chassis-number slot slot-number
Default
The per-interface buffer usage threshold is 100%.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
slot slot-number: Specifies a card by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
ratio ratio: Specifies the buffer usage threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when the packet statistics collection mode is queue (configured by using the statistic mode queue command).
After you configure this command, the switch automatically records buffer usage for each interface. When a queue on an interface uses more buffer space than the set threshold, the system counts one threshold violation for the queue.
To display the buffer usage statistics for interfaces, use the display buffer usage interface command.
Examples
# (In standalone mode.) Set the per-interface buffer usage threshold to 50% for card 3.
<Sysname> system-view
[Sysname] buffer usage threshold slot 3 ratio 50
# (In IRF mode.) Set the per-interface buffer usage threshold to 50% for card 3 on IRF member device 2.
<Sysname> system-view
[Sysname] buffer usage threshold chassis 2 slot 3 ratio 50
Related commands
display buffer usage interface
burst-mode enable
Use burst-mode enable to enable the Burst feature.
Use undo burst-mode enable to disable the Burst feature.
Syntax
burst-mode enable
undo burst-mode enable
Default
The Burst feature is disabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
The Burst feature is especially useful for reducing packet losses under the following circumstances:
· Traffic enters a device from a high-speed interface and goes out of a low-speed interface.
· Traffic enters a device from multiple same-rate interfaces and goes out of an interface with the same rate.
The Burst feature takes effect only on known unicast packets.
Examples
# Enable the Burst feature.
<Sysname> system-view
[Sysname] burst-mode enable
display buffer
Use display buffer to display buffer size settings.
Syntax
In standalone mode:
display buffer [ slot slot-number ]
In IRF mode:
display buffer [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays buffer size settings for all cards. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays buffer size settings for all cards of the IRF fabric. (In IRF mode.)
Examples
# (In IRF mode.) Display buffer size settings for slot 0 in chassis 1.
<Sysname> display buffer chassis 1 slot 0
Slot Type Eg(Total-shared)
1/0 cell --
Eg: Size of the sending buffer
Total-shared: Size of the shared buffer for all ports
Unit: Ratio
display buffer usage
Use display buffer usage to display buffer usage.
Syntax
In standalone mode:
display buffer usage [ slot slot-number ]
In IRF mode:
display buffer usage [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays buffer usage for all cards. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays buffer usage for all cards of the IRF fabric. (In IRF mode.)
Examples
# Display buffer usage.
<Sysname> display buffer usage
Ingress buffer usage on slot 3 :
Chip0
core0:
Total: 761856 BD
Used: 0 BD
Free: 761856 BD
core1:
Total:1048576 BD
Used: 0 BD
Free:1048576 BD
Table 1 Command output
Field |
Description |
Total |
Total size of the data buffer. |
Used |
Size of used data buffer. |
Free |
Size of free data buffer. |
display buffer usage interface
Use display buffer usage interface to display buffer usage statistics for interfaces.
Syntax
display buffer usage interface [ interface-type [ interface-number ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface-type [ interface-number ]: Specifies an interface by its type and number. If you do not specify the interface-type argument, this command displays buffer usage statistics for all Ethernet interfaces. If you specify the interface-type argument without the interface-number argument, this command displays buffer usage statistics for all Ethernet interfaces of the specified type.
verbose: Displays detailed buffer usage statistics. If you do not specify this keyword, the command displays brief buffer usage statistics. This keyword is available only for H-series cards on the S12500X-AF switch.
Examples
# Display brief buffer usage statistics for FortyGigE 1/0/1.
<Sysname> display buffer usage interface fortygige 1/0/1
Interface QueueID Total Used Threshold(%) Violations
--------------------------------------------------------------------------------
FGE1/0/1 0 761856 0 100 0
1 761856 0 100 0
2 761856 0 100 0
3 761856 0 100 0
4 761856 0 100 0
5 761856 0 100 0
6 761856 0 100 0
7 761856 0 100 0
Table 2 Command output
Field |
Description |
Total |
Data buffer size in bytes allowed for a queue. |
Used |
Data buffer size in bytes that has been used by a queue. |
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
# Display detailed buffer usage statistics for FortyGigE 1/0/1.
<Sysname> display buffer usage interface fortygige 1/0/1 verbose
FortyGigE1/0/1
Ingress:
QueueID: 0
Total: -- Used: 2 Threshold(%): 3
Violations: 4 Shared: 5 Headroom: 6
Xoff threshold: 7 Is dynamic: 8
QueueID: 1
Total: -- Used: 4 Threshold(%): 6
Violations: 8 Shared: 10 Headroom: 12
Xoff threshold: 14 Is dynamic: 16
QueueID: 2
Total: -- Used: 6 Threshold(%): 9
Violations: 12 Shared: 15 Headroom: 18
Xoff threshold: 21 Is dynamic: 24
QueueID: 3
Total: -- Used: 8 Threshold(%): 12
Violations: 16 Shared: 20 Headroom: 24
Xoff threshold: 28 Is dynamic: 32
QueueID: 4
Total: -- Used: 10 Threshold(%): 15
Violations: 20 Shared: 25 Headroom: 30
Xoff threshold: 35 Is dynamic: 40
QueueID: 5
Total: -- Used: 12 Threshold(%): 18
Violations: 24 Shared: 30 Headroom: 36
Xoff threshold: 42 Is dynamic: 48
QueueID: 6
Total: -- Used: 14 Threshold(%): 21
Violations: 28 Shared: 35 Headroom: 42
Xoff threshold: 49 Is dynamic: 56
QueueID: 7
Total: -- Used: 16 Threshold(%): 24
Violations: 32 Shared: 40 Headroom: 48
Xoff threshold: 56 Is dynamic: 64
Egress:
QueueID: 0
Total: 9 Used: 10 Threshold(%): 11
Violations: 12 TailDropThreshold: 13 Is dynamic: 14
QueueID: 1
Total: 18 Used: 20 Threshold(%): 22
Violations: 24 TailDropThreshold: 26 Is dynamic: 28
QueueID: 2
Total: 27 Used: 30 Threshold(%): 33
Violations: 36 TailDropThreshold: 39 Is dynamic: 42
QueueID: 3
Total: 36 Used: 40 Threshold(%): 44
Violations: 48 TailDropThreshold: 52 Is dynamic: 56
QueueID: 4
Total: 45 Used: 50 Threshold(%): 55
Violations: 60 TailDropThreshold: 65 Is dynamic: 70
QueueID: 5
Total: 54 Used: 60 Threshold(%): 66
Violations: 72 TailDropThreshold: 78 Is dynamic: 84
QueueID: 6
Total: 63 Used: 70 Threshold(%): 77
Violations: 84 TailDropThreshold: 91 Is dynamic: 98
QueueID: 7
Total: 72 Used: 80 Threshold(%): 88
Violations: 96 TailDropThreshold: 104 Is dynamic: 112
Table 3 Command output
Field |
Description |
Total |
Data buffer size in bytes allowed for a queue. |
Used |
Data buffer size in bytes that has been used by a queue. |
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
Shared |
Number of cell resources in the shared area used by a queue. A cell resource is 1024 bytes. |
Headroom |
Number of cell resources in the Headroom area used by a queue. When a queue on an interface enabled with PFC enters PFC XOFF state, the interface sends XOFF frames to notify the peer interface to stop sending packets to that queue. Packets sent by the peer interface before it receives XOFF frames are stored in the Headroom area. |
Xoff threshold |
Back pressure frame triggering threshold. If a dynamic back pressure frame triggering threshold is configured, this field displays a percentage value. If a static back pressure frame triggering threshold is configured, this field displays an absolute value. For information about configuring back pressure frame triggering thresholds, see Ethernet interface commands in Layer 2—LAN Switching Command Reference. |
Is dynamic |
For the inbound direction, this field can be one of the following values: · 0—Indicates a static back pressure frame triggering threshold. · 1—Indicates a dynamic back pressure frame triggering threshold. For the outbound direction, this field can only be 1, which indicates a dynamic tail drop threshold. |