目  录

1 数据缓冲区

1.1 数据缓冲区配置命令

1.1.1 buffer packet-drop alarm enable

1.1.2 buffer packet-drop alarm interval

1.1.3 buffer threshold alarm enable

1.1.4 buffer threshold alarm interval

1.1.5 buffer usage threshold

1.1.6 buffer usage threshold headroom

1.1.7 buffer usage threshold headroom queue

1.1.8 buffer usage threshold queue (interface view)

1.1.9 buffer usage threshold queue (system view)

1.1.10 burst-mode enable

1.1.11 display buffer usage

1.1.12 display buffer usage interface

 

1 数据缓冲区

1.1  数据缓冲区配置命令

数据缓冲区的配置比较复杂，而且对设备的转发功能有重要的影响，建议用户不要轻易修改数据缓冲区的参数。在需要较大的缓存空间时，建议使用Burst功能来自动分配缓冲区。

burst-mode enable与buffer apply命令互斥，用户在开启Burst功能后，不能应用手工配置数据缓冲区的相应配置，反之亦然。如果已经使用某一种方式进行了配置，则必须先取消该方式的配置之后，才能使用另外一种方式进行配置。

1.1.1  buffer packet-drop alarm enable

buffer packet-drop alarm enable命令用来开启数据缓冲区丢包告警功能。

undo buffer packet-drop alarm enable命令用来关闭数据缓冲区丢包告警功能。

【命令】

buffer packet-drop alarm enable

undo buffer packet-drop alarm enable

【缺省情况】

数据缓冲区丢包告警功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

开启数据缓冲区丢包告警功能后，设备会生成数据缓冲区丢包告警信息，并将告警信息周期性的发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

本功能对Headroom数据缓冲区不起作用。

【举例】

# 开启数据缓冲区丢包告警功能。

<Sysname> system-view

[Sysname] buffer packet-drop alarm enable

【相关命令】

·     buffer usage threshold queue (interface view)

·     buffer usage threshold queue (system view)

·     buffer packet-drop alarm interval

1.1.2  buffer packet-drop alarm interval

buffer packet-drop alarm interval命令用来配置数据缓冲区丢包告警发送周期。

undo buffer packet-drop alarm interval命令用来恢复缺省情况。

【命令】

buffer packet-drop alarm interval interval

undo buffer packet-drop alarm interval

【缺省情况】

数据缓冲区丢包告警发送周期为5秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval：数据缓冲区丢包告警发送周期，取值范围为0～60，单位为秒，0表示出现丢包时立即发送告警信息。

【使用指导】

必须开启数据缓冲区丢包告警功能，否则，数据缓冲区丢包告警发送周期的配置不会生效。

【举例】

# 配置数据缓冲区丢包告警发送周期为20秒。

<Sysname> system-view

[Sysname] buffer packet-drop alarm interval 20

【相关命令】

·     buffer packet-drop alarm enable

1.1.3  buffer threshold alarm enable

buffer threshold alarm enable命令用来开启数据缓冲区超门限告警功能。

undo buffer threshold alarm enable命令用来关闭数据缓冲区超门限告警功能。

【命令】

buffer threshold alarm { egress | headroom | ingress } enable

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

【缺省情况】

数据缓冲区超门限告警功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

headroom：表示对Headroom数据缓冲区进行配置。

ingress：表示对接收数据缓冲区进行配置。

【使用指导】

开启数据缓冲区超门限告警功能后，设备会生成数据缓冲区超门限告警信息，并将告警信息周期性的发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

Headroom缓冲区不支持配置其使用门限值，缺省门限值为100%。

【举例】

# 开启接收数据缓冲区超门限告警功能。

<Sysname> system-view

[Sysname] buffer threshold alarm ingress enable

【相关命令】

·     buffer usage threshold queue (interface view)

·     buffer usage threshold queue (system view)

1.1.4  buffer threshold alarm interval

buffer threshold alarm interval命令用来配置数据缓冲区超门限告警发送周期。

undo buffer threshold alarm interval命令用来恢复缺省情况。

【命令】

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

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

【缺省情况】

数据缓冲区超门限告警发送周期为5秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

headroom：表示对Headroom数据缓冲区进行配置。

ingress：表示对接收数据缓冲区进行配置。

interval：数据缓冲区超门限告警发送周期，取值范围为0～60，单位为秒。0表示出现数据缓冲区超门限使用时立即发送告警信息。

【使用指导】

必须开启数据缓冲区超门限告警功能，否则，数据缓冲区超门限告警发送周期的配置不会生效。

【举例】

# 配置接收数据缓冲区超门限告警发送周期为20秒。

<Sysname> system-view

[Sysname] buffer threshold alarm ingress interval 20

【相关命令】

·     buffer threshold alarm enable

·     buffer usage threshold queue (interface view)

·     buffer usage threshold queue (system view)

 

1.1.5  buffer usage threshold

buffer usage threshold命令用来配置接口的数据缓冲区使用门限值。

undo buffer usage threshold命令用来恢复缺省情况。

【命令】

buffer usage threshold slot slot-number ratio ratio

undo buffer usage threshold slot slot-number

【缺省情况】

设备上接口的数据缓冲区使用门限值为100。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：指定设备编号，取值只能为1。

ratio ratio：以百分比形式配置接口的数据缓冲区使用门限值，ratio的取值为1～100。

【使用指导】

配置接口的数据缓冲区使用门限后，设备会自动记录接口对缓冲区的使用情况。当接口上某一队列中需要处理的报文增多，造成该接口对数据缓冲区的使用比率超过设定的门限值时，系统会为该队列增加一次超量使用缓冲区的计数。

通过display buffer usage interface命令，可以查看接口的数据缓冲区使用统计信息。

【举例】

# 配置设备上所有接口的数据缓冲区使用门限值为50%

<Sysname> system-view

[Sysname] buffer usage threshold slot 1 ratio 50

【相关命令】

·     display buffer usage interface

·      

1.1.6  buffer usage threshold headroom

buffer usage threshold headroom命令用来配置全局Headroom缓冲区使用门限值。

undo buffer usage threshold headroom命令用来恢复缺省情况。

【命令】

buffer usage threshold headroom slot slot-number ratio ratio

undo buffer usage threshold headroom slot-number ratio

【缺省情况】

全局所有接口下每个队列的Headroom缓冲区使用门限值均为100%。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：指定设备编号，取值只能为1。

ratio ratio：以百分比形式配置设备Headroom缓冲区使用门限值，ratio的取值范围为1～100。

【使用指导】

仅开启数据缓冲区超门限告警功能后，Headroom缓冲区使用门限值的配置才会生效。超门限使用Headroom缓冲区时，设备会生成告警信息，并将告警信息发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备Headroom缓冲区的使用情况。

本命令仅支持在接口板上下发。

【举例】

# 配置slot 1上所有接口下每个队列的Headroom缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] buffer usage threshold headroom slot 1 ratio 50

【相关命令】

·     buffer threshold alarm enable

1.1.7  buffer usage threshold headroom queue

buffer usage threshold headroom queue命令用来配置接口Headroom缓冲区使用门限值。

undo buffer usage threshold headroom queue命令用来恢复缺省情况。

【命令】

buffer usage threshold headroom queue queue-id ratio ratio

undo buffer usage threshold headroom queue queue-id ratio

【缺省情况】

接口Headroom缓冲区与全局Headroom缓冲区使用门限值相同。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

queue-id：配置接口指定队列Headroom缓冲区使用门限值，queue-id的取值范围为0～7。

ratio ratio：以百分比形式配置指定队列的Headroom缓冲区使用门限值，ratio的取值范围为1～100。

【使用指导】

仅开启数据缓冲区超门限告警功能后，Headroom缓冲区使用门限值的配置才会生效。超门限使用Headroom缓冲区时，设备会生成告警信息，并将告警信息发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备Headroom缓冲区的使用情况。

【举例】

# 配置接口HundredGigE1/0/1队列1的Headroom缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

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

【相关命令】

·     buffer threshold alarm enable

1.1.8  buffer usage threshold queue (interface view)

buffer usage threshold queue命令用来配置接口队列接收或发送数据缓冲区使用门限值。

undo buffer usage threshold queue命令用来恢复缺省情况。

【命令】

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

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

【缺省情况】

接口队列接收或发送数据缓冲区与全局队列接收或发送数据缓冲区使用门限值相同。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

ingress：表示对接收数据缓冲区进行配置。

queue-id：配置接口指定队列的数据缓冲区使用门限值，queue-id的取值范围为0～7。

ratio ratio：以百分比形式配置指定接口队列的数据缓冲区使用门限值，ratio的取值范围为1～100。

【使用指导】

本命令配置的数据缓冲区不包括Headroom缓冲区。

仅开启数据缓冲区超门限告警功能后，接口队列接收或发送数据缓冲区使用门限值的配置才会生效。超门限使用数据缓冲区时，设备会生成告警信息，并将告警信息发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备接收或发送数据缓冲区的使用情况。

【举例】

# 配置接口HundredGigE1/0/1队列1的接收数据缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

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

【相关命令】

·     buffer threshold alarm enable

1.1.9  buffer usage threshold queue (system view)

buffer usage threshold queue命令用来配置全局队列接收或发送数据缓冲区使用门限值。

undo buffer usage threshold queue命令用来恢复缺省情况。

【命令】

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

【缺省情况】

全局所有接口下每个队列的接收或发送数据缓冲区使用门限值均为100%。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

ingress：表示对接收数据缓冲区进行配置。

slot slot-number：指定设备编号，取值只能为1。

queue-id:配置设备指定队列数据缓冲区使用门限值，queue-id的取值范围为0～7。

ratio ratio：以百分比形式配置设备队列的数据缓冲区使用门限值，ratio的取值范围为1～100。

【使用指导】

本命令配置的数据缓冲区不包括Headroom缓冲区。

仅开启数据缓冲区超门限告警功能后，全局队列接收或发送数据缓冲区使用门限值的配置才会生效。超门限使用数据缓冲区时，设备会生成告警信息，并将告警信息发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

【举例】

# 配置slot 1队列1的接收数据缓冲区使用门限值为50%。

<Sysname> system-view

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

【相关命令】

·     buffer threshold alarm enable

1.1.10  burst-mode enable

burst-mode enable命令用来开启数据缓冲区自动分配功能。

undo burst-mode enable命令用来关闭数据缓冲区自动分配功能。

【命令】

burst-mode enable

undo burst-mode enable

【缺省情况】

数据缓冲区自动分配功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

在下列情况下，开启数据缓冲区自动分配功能可以提高报文缓存功能和降低报文丢包率：

·     广播或者组播报文流量密集，瞬间突发大流量的网络环境中；

·     报文从高速链路进入设备，由低速链路转发出去；或者报文从相同速率的多个接口同时进入设备，由一个相同速率的接口转发出去。

【举例】

# 开启数据缓冲区自动分配功能。

<Sysname> system-view

[Sysname] burst-mode enable

1.1.11  display buffer usage

display buffer usage命令用来显示数据缓冲区的使用率。

【命令】

display buffer usage [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：指定设备编号，取值只能为1。

【举例】

# 显示数据缓冲区的使用率。

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

表1-1 display buffer usage命令显示信息描述表

字段	描述
Egress total-shared cell buffer usage on slot	表示在指定成员设备上cell缓冲区共享区域的使用率
Unit	芯片编号
XPE	设备支持的缓冲区类型 ‌
Block1	端口所在区域，本设备前面板上的端口所在区域固定为1 ‌
Total	缓冲区容量
Used	已使用的缓冲区容量
Free	可用缓冲区容量
5sec	过去5秒内该端口使用的缓冲区百分比例
1min	过去1分钟内该端口使用的缓冲区百分比例
5min	过去5分钟内该端口使用的缓冲区百分比例

‌

1.1.12  display buffer usage interface

display buffer usage interface命令用来显示接口的数据缓冲区使用统计信息。

【命令】

display buffer usage interface [ interface-type [ interface-number ] ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface-type interface-number：指定接口，interface-type为接口类型，interface-number为接口编号。未指定interface-type参数时，显示设备上所有以太网接口的数据缓冲区使用统计信息；已指定interface-type但未指定interface-number时，显示设备上所有指定类型的以太网接口的数据缓冲区使用统计信息。

verbose：显示详细信息。如果不指定本参数，则显示简要信息。

【举例】

# 显示接口HundredGigE1/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

表1-2 display buffer usage interface命令显示信息描述表

字段	描述
Interface	接口名称
QueueID	队列编号
Total	队列可用的数据缓冲区大小，单位为Byte
Used	队列已使用的数据缓冲区大小，单位为Byte
Threshold(%)	队列的数据缓冲区使用门限值，该值与队列所在接口的缓冲区使用门限值保持一致
Violations	队列超量使用缓冲区的计数，表示队列使用缓冲区超过设定门限值的次数 该字段仅在设备重启时，才会清零后重新计数

‌

# 显示接口HundredGigE1/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: -

表1-3 display buffer usage interface verbose命令显示信息描述表

字段	描述
Ingress	接收数据缓冲区的统计数据
Egress	发送数据缓冲区的统计数据
QueueID	显示指定队列对数据缓冲区的使用统计信息
Total	队列可用的数据缓冲区大小，单位为cell资源个数
Used	队列已使用的数据缓冲区大小，单位为cell资源个数
Threshold(%)	队列的数据缓冲区使用门限值，该值与队列所在接口的缓冲区使用门限值保持一致
Violations	队列超量使用缓冲区的计数，表示队列使用缓冲区超过设定门限值的次数 该字段在设备重启时，会清零重新计数
Shared	队列已使用共享数据缓冲区的cell资源个数
Headroom	队列已使用Headroom缓冲区的cell资源个数。开启PFC功能的端口上某优先级队列进入PFC XOFF状态后，端口会发送XOFF帧通知对端设备暂停向本端发送对应优先级报文，如果对端设备未收到XOFF帧时已发出了流量，则端口会使用Headroom缓冲区缓存这部分流量
Xoffthres	反压帧触发门限值： ·     当用户配置为动态时显示的数值为具体配置的百分比 ·     当用户配置为静态门限时显示的数值为具体配置的cell资源个数 配置命令的详细介绍请参见“二层技术-以太网交换命令参考”中的“PFC命令”
TailDropThres	尾丢弃门限值
Is dynamic	对于入方向，该字段取值如下： ·     0：表示反压帧触发门限为静态 ·     1：表示反压帧触发门限为动态 对于出方向，该字段取值为1，表示尾丢弃门限为动态
Used(%)	队列已使用的数据缓冲区大小，单位为%
Free	队列剩余可使用的数据缓冲区大小，单位为字节
UsedPeak	队列曾使用的数据缓冲区峰值大小，单位为字节
HeadroomUsed(%)	队列已使用的Headroom数据缓冲区大小，单位为%
HeadroomFree	队列剩余可使用的Headroom数据缓冲区大小，单位为字节
HeadroomPeak	队列曾使用的Headroom数据缓冲区峰值大小，单位为字节
UsedPeakTime	队列曾使用的数据缓冲区峰值出现的时间，未使用数据缓冲区时显示为-
HeadroomPeakTime	队列曾使用的Headroom数据缓冲区峰值出现的时间，未使用Headroom数据缓冲区时显示为-
DeadlockCount	PFC死锁次数
DeadlockRecover	PFC死锁恢复次数

‌