Contents

Data buffer commands· 1

buffer packet-drop alarm enable· 1

buffer packet-drop alarm interval 1

buffer threshold alarm enable· 2

buffer threshold alarm interval 3

buffer usage threshold· 4

buffer usage threshold headroom·· 4

buffer usage threshold headroom queue· 5

buffer usage threshold queue (interface view) 6

buffer usage threshold queue (system view) 7

burst-mode enable· 7

display buffer usage· 8

display buffer usage interface· 9

 

Data buffer commands

Inappropriate data buffer changes can cause system problems. Before manually changing data buffer settings, make sure you understand its impact on your device. As a best practice, use the burst-mode enable command if the system requires large buffer spaces. The burst-mode enable command and the buffer apply command are mutually exclusive. If you have configured the data buffer by using one command, you must execute the undo form of the command before using the other command.

 

buffer packet-drop alarm enable

Use buffer packet-drop alarm enable to enable packet-drop alarms.

Use undo buffer packet-drop alarm enable to disable packet-drop alarms.

Syntax

buffer packet-drop alarm enable

undo buffer packet-drop alarm enable

Default

Packet-drop alarms are disabled.

 Views

System view

Predefined user roles

network-admin

Usage guidelines

The device generates and reports packet-drop alarms to a network management system (such as IMC) for displaying the data buffer usage.

This command does not take effect only on the Headroom buffer.

 

Examples

# Enable packet-drop alarms.

<Sysname> system-view

[Sysname] buffer packet-drop alarm enable

Related commands

buffer usage threshold queue (interface view)

buffer usage threshold queue (system view)

buffer packet-drop alarm interval

buffer packet-drop alarm interval

Use buffer packet-drop alarm interval to set the interval for sending packet-drop alarms.

Use undo buffer packet-drop alarm interval to restore the default.

Syntax

buffer packet-drop alarm interval interval

undo buffer packet-drop alarm interval

Default

The interval for sending packet-drop alarms is 5 seconds.

 Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for sending packet-drop alarms, in the range of 0 to 60 seconds. The value of 0 indicates that packet-drop alarms are sent immediately after they are generated.

 Usage guidelines

This command takes effect only when packet-drop alarms are enabled.

 

Examples

# Set the interval for sending packet-drop alarms to 20 seconds.

<Sysname> system-view

[Sysname] buffer packet-drop alarm interval 20

Related commands

buffer packet-drop alarm enable

buffer threshold alarm enable

Use buffer threshold alarm enable to enable threshold-crossing alarms.

Use undo buffer threshold alarm enable to disable threshold-crossing alarms.

Syntax

buffer threshold alarm { egress | headroom | ingress } enable

undo buffer threshold alarm { egress | headroom | ingress } enable

Default

Threshold-crossing alarms are disabled.

 Views

System view

Predefined user roles

network-admin

Parameters

ingress: Specifies the ingress buffer.

headroom: Specifies the Headroom buffer.

egress: Specifies the egress buffer.

Usage guidelines

The device generates and reports threshold-crossing alarms to a network management system (such as IMC) for displaying the data buffer usage.

The alarm threshold for the Headroom buffer is fixed at 100% and is not configurable.

 

Examples

# Enable threshold-crossing alarms.

<Sysname> system-view

[Sysname] buffer threshold alarm ingress enable

Related commands

buffer usage threshold queue (interface view)

buffer usage threshold queue (system view)

buffer threshold alarm interval

Use buffer threshold alarm interval to set the interval for sending threshold-crossing alarms.

Use undo buffer threshold alarm interval to restore the default.

Syntax

buffer threshold alarm { egress | headroom | ingress } interval interval

undo buffer threshold alarm { egress | headroom | ingress } interval

Default

The interval for sending threshold-crossing alarms is 5 seconds.

 Views

System view

Predefined user roles

network-admin

Parameters

ingress: Specifies the ingress buffer.

headroom: Specifies the Headroom buffer.

egress: Specifies the egress buffer.

interval: Specifies the interval for sending threshold-crossing alarms, in the range of 0 to 60 seconds. 0 indicates that threshold-crossing alarms are sent immediately after they are generated.

 Usage guidelines

This command takes effect only when threshold-crossing alarms are enabled.

 

Examples

# Set the interval for sending threshold-crossing alarms to 20 seconds.

<Sysname> system-view

[Sysname] buffer threshold alarm ingress interval 20

Related commands

buffer threshold alarm enable

buffer usage threshold queue (interface view)

buffer usage threshold queue (system view)

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

buffer usage threshold slot slot-number ratio ratio

undo buffer usage threshold slot slot-number

Default

The per-interface buffer usage threshold is 100%.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number.

ratio ratio: Specifies the buffer usage threshold in percentage, in the range of 1 to 100.

Usage guidelines

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

# Set the per-interface buffer usage threshold to 50% for card 3.

<Sysname> system-view

[Sysname] buffer usage threshold slot 3 ratio 50

Related commands

display buffer usage interface

buffer usage threshold headroom

Use buffer usage threshold headroom to set the global per-queue alarm threshold for the Headroom buffer.

Use undo buffer usage threshold headroom to restore the default.

Syntax

buffer usage threshold headroom slot slot-number ratio ratio

undo buffer usage threshold headroom slot-number ratio

Default

The global per-queue alarm threshold for the Headroom buffer is 100%.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number.

ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.

 Usage guidelines

This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global alarm threshold for the Headroom buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).

This command is supported only for interface cards.

 

Examples

#  Set the global per-queue alarm threshold to 50% for slot 1.

<Sysname> system-view

[Sysname] buffer usage threshold headroom slot 1 ratio 50

Related commands

buffer threshold alarm enable

buffer usage threshold headroom queue

Use buffer usage threshold headroom queue to set the Headroom buffer alarm threshold for a queue on an interface.

Use undo buffer usage threshold headroom queue to restore the default.

Syntax

buffer usage threshold headroom queue queue-id ratio ratio

undo buffer usage threshold headroom queue queue-id ratio

Default

The global per-queue alarm threshold for the Headroom buffer is used.

Views

Interface view

Predefined user roles

network-admin

Parameters

queue-id: Specifies a queue by its ID in the range of 0 to 7.

ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.

 Usage guidelines

This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).

 

Examples

# Set the Headroom buffer alarm threshold to 50% for queue 1 on HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname–HundredGigE1/0/1] buffer usage threshold headroom queue 1 ratio 50

Related commands

buffer threshold alarm enable

buffer usage threshold queue (interface view)

Use buffer usage threshold queue to set the ingress or egress buffer alarm threshold for a queue on an interface.

Use undo buffer usage threshold queue to restore the default.

Syntax

buffer { egress | ingress } usage threshold queue queue-id ratio ratio

undo buffer { egress | ingress } usage threshold queue queue-id ratio

Default

The global per-queue alarm threshold for the ingress or egress buffer is used.

Views

Interface view

Predefined user roles

network-admin

Parameters

ingress: Specifies the ingress buffer.

egress: Specifies the egress buffer.

queue-id: Specifies a queue by its ID in the range of 0 to 7.

ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.

 Usage guidelines

This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the alarm threshold for the ingress or egress buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).

 

Examples

# Set the ingress buffer alarm threshold to 50% for queue 1 on HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname–HundredGigE1/0/1] buffer ingress usage threshold queue 1 ratio 50

Related commands

buffer threshold alarm enable

buffer usage threshold queue (system view)

Use buffer usage threshold queue to set the global ingress or egress buffer alarm threshold for a queue.

Use undo buffer usage threshold queue to restore the default.

Syntax

buffer { egress | ingress } usage threshold slot slot-number  queue queue-id ratio ratio

undo buffer { egress | ingress } usage threshold slot slot-number queue queue-id ratio

Default

The global ingress or egress buffer alarm threshold for a queue is 100%.

Views

System view

Predefined user roles

network-admin

Parameters

ingress: Specifies the ingress buffer.

egress: Specifies the egress buffer.

slot slot-number: Specifies a card by its slot number.

queue-id: Specifies a queue by its ID in the range of 0 to 7.

ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.

 Usage guidelines

This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global ingress or egress alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).

 

Examples

#  Set the global ingress alarm threshold to 50% for queue 1 in slot 1.

<Sysname> system-view

[Sysname] buffer ingress usage threshold slot 1 queue 1 ratio 50

Related commands

buffer threshold alarm enable

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

Usage guidelines

The Burst feature is especially useful for reducing packet losses under the following circumstances:

·     Broadcast or multicast traffic is intensive, resulting in bursts of traffic.

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

 

Examples

# Enable the Burst feature.

<Sysname> system-view

[Sysname] burst-mode enable

display buffer usage

Use display buffer usage to display buffer usage.

Syntax

display buffer usage [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

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

Examples

# Display buffer usage.

<Sysname> display buffer usage

Egress total-shared cell buffer usage on slot 1 :

XPE 0

Total:    4033 KB

Used:       0 KB

Free:    4033 KB

XPE 1

Total:    4033 KB

Used:       0 KB

Free:    4033 KB

XPE 2

Total:    4033 KB

Used:       0 KB

Free:    4033 KB

XPE 3

Total:    4033 KB

Used:       0 KB

Free:    4033 KB

                                          5sec    1min    5min

------------------------------------------------------------------

Ten-GigabitEthernet1/0/1             XPE 0   0%      0%      0%

                                     XPE 1   0%      0%      0%

                                     XPE 2   0%      0%      0%

                                     XPE 3   0%      0%      0%

Ten-GigabitEthernet1/0/2             XPE 0   0%      0%      0%

                                     XPE 1   0%      0%      0%

                                     XPE 2   0%      0%      0%

                                     XPE 3   0%      0%      0%

Ten-GigabitEthernet1/0/3             XPE 0   0%      0%      0%

                                     XPE 1   0%      0%      0%

                                     XPE 2   0%      0%      0%

                                     XPE 3   0%      0%      0%

Table 1 Command output

Field	Description
Egress total-shared cell buffer usage on slot	Usage of cell resources in the shared area on a card.
XPE	Type of the data buffer.
Total	Total size of the data buffer.
Used	Size of used data buffer.
Free	Size of free data buffer.
5sec	Percentage of the buffer that the port used for the last 5 seconds.
1min	Percentage of the buffer that the port used for the last 1 minute.
5min	Percentage of the buffer that the port used for the last 5 minutes.

‌

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

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.

Examples

# Display brief buffer usage statistics for HundredGigE 1/0/1.

<Sysname> display buffer usage interface hundredgige 1/0/1

Interface              QueueID Total       Used        Threshold(%) Violations

--------------------------------------------------------------------------------

HGE1/0/1               0       838860800   0           100          0

                       1       838860800   0           100          0

                       2       838860800   0           100          0

                       3       838860800   0           100          0

                       4       838860800   0           100          0

                       5       838860800   0           100          0

                       6       838860800   0           100          0

                       7       838860800   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 HundredGigE 1/0/1.

[Sysname] display buffer usage interface hundredgige 1/0/1 verbose

HGE1/0/1

  Ingress:

    QueueID: 0

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 3                            Violations: 4

      Shared: 1 cell 5 bytes                     Headroom: 6 cell 30 bytes

      Xoff threshold: 36 cell 55000 bytes        Is dynamic: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   HeadroomUsed(%): 0

      HeadroomFree: 0 cell 0 bytes               HeadroomPeak: 0 cell 0 bytes

      UsedPeakTime: 2022-04-19 20:20:43          HeadroomPeakTime: 2022-04-19 20:20:43

…

    QueueID: 7

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 3                            Violations: 4

      Shared: 1 cell 5 bytes                     Headroom: 6 cell 30 bytes

      Xoff threshold: 36 cell 55000 bytes        Is dynamic: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   HeadroomUsed(%): 0

      HeadroomFree: 0 cell 0 bytes               HeadroomPeak: 0 cell 0 bytes

      UsedPeakTime: 2022-04-19 21:20:43          HeadroomPeakTime: 2022-04-19 21:20:43

  Egress:

    QueueID: 0

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 22                           Violations: 12

      TailDropThreshold: 1 cell 13 bytes         Is dynamic: 0

      DeadlockCount: 0                           DeadlockRecover: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   UsedPeakTime: -

…

    QueueID: 7

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 22                           Violations: 12

      TailDropThreshold: 1 cell 13 bytes         Is dynamic: 0

      DeadlockCount: 0                           DeadlockRecover: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   UsedPeakTime: -

Table 3 Command output

Field	Description
Ingress	Usage statistics for the ingress buffer.
Egress	Usage statistics for the egress buffer.
Total	Data buffer size allowed for a queue, in the number of cell resources.
Used	Data buffer size that has been used by a queue, in the number of cell resources.
Threshold(%)	Buffer usage threshold for a queue, which is configured by using the buffer usage threshold queue command.
Violations	Number of threshold violations for a queue. The value of this field is reset upon a switch reboot.
Shared	Number of cell resources and bytes in the shared area used by a queue
Headroom	Number of cell resources and bytes 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.
XoffThres	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 commands to configure back pressure frame triggering thresholds, see PFC commands in Layer 2—LAN Switching Command Reference
TailDropThres	Tail drop threshold, in the number of cell resources calculated according to the ratio value set in the buffer queue shared command.
IsDynamic	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.
Used(%)	Buffer usage in percentage.
Free	Free buffer in the number of cell resources and bytes.
UsedPeak	Peak used buffer in the number of cell resources and bytes during the time between two executions of the display buffer usage interface command.
HeadroomUsed(%)	Headroom area usage in percentage for the ingress buffer.
HeadroomFree	Free Headroom area in the number of cell resources and bytes for the ingress buffer.
HeadroomPeak	Peak used Headroom area in the number of cell resources and bytes during the time between two executions of the display buffer usage interface command.
UsedPeakTime	Peak time for buffer use. This field displays a hyphen (-) if the buffer is not used.
HeadroomPeakTime	Peak time for Headroom buffer use. This field displays a hyphen (-) if the Headroom buffer is not used.
DeadlockCount	Number of times the device entered the PFC deadlock state in the egress buffer.
DeadlockRecover	Number of times the device released the PFC deadlock state in the egress buffer.