目  录

1 数据缓冲区

1.1 数据缓冲区配置命令

1.1.1 buffer apply

1.1.2 buffer packet-drop alarm enable

1.1.3 buffer packet-drop alarm interval

1.1.4 buffer queue guaranteed (interface view)

1.1.5 buffer queue shared (interface view)

1.1.6 buffer threshold alarm enable

1.1.7 buffer threshold alarm interval

1.1.8 buffer usage threshold

1.1.9 buffer usage threshold headroom

1.1.10 buffer usage threshold null-queue

1.1.11 buffer usage threshold queue (interface view)

1.1.12 burst-mode enable

1.1.13 display buffer

1.1.14 display buffer usage

1.1.15 display buffer usage interface

1.1.16 port buffer usage threshold headroom null-queue

1.1.17 port buffer usage threshold null-queue

1.2 TCB

1.2.1 buffer transient-capture enable

1.2.2 display buffer transient-capture packet-drop

 

1 数据缓冲区

1.1  数据缓冲区配置命令

1.1.1  buffer apply

buffer apply命令用来应用用户对数据缓冲区所做的配置。

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

【命令】

buffer apply

undo buffer apply

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【使用指导】

用户对数据缓冲区进行配置后，必须使用buffer apply命令进行应用，这些配置才能生效。

配置被应用后就不能被修改，需要先取消应用，再修改、应用，新的配置才能生效。

对于S12500G-AF系列交换机，仅SF系列接口板支持此功能。

【举例】

# 应用用户对数据缓冲区所做的配置。

<Sysname> system-view

[Sysname] buffer apply

1.1.2  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

mdc-admin

【使用指导】

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

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

【举例】

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

<Sysname> system-view

[Sysname] buffer packet-drop alarm enable

【相关命令】

·     buffer usage threshold queue (interface view)

·     buffer packet-drop alarm interval

1.1.3  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

mdc-admin

【参数】

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

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] buffer packet-drop alarm interval 20

【相关命令】

·     buffer packet-drop alarm enable

1.1.4  buffer queue guaranteed (interface view)

buffer queue guaranteed命令用来配置队列最多可使用的固定区域的大小。

undo buffer queue guaranteed命令用来取消指定队列最多可使用的固定区域的大小的配置。

【命令】

buffer egress cell queue queue-id guaranteed ratio ratio

undo buffer egress cell queue queue-id guaranteed

【缺省情况】

缺省情况下，所有队列最多可使用的固定区域大小均为13%。

【视图】

接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

cell：表示cell资源。

packet：表示packet资源。

queue-id：表示队列编号，取值范围为0～7。

ratio ratio：队列的最大固定区域占用比，以百分数形式表示。该参数的取值范围为0～100。

【使用指导】

缺省情况下，所有队列均分固定区域，但用户也可以使用该命令调整指定队列最多可使用的固定区域的比例，其它未配置的队列则均分剩余的固定区域。

配置该命令后，系统就给队列预留指定大小的空间，即便该队列没有报文存储需求，其他队列也不能抢占。所有队列所配置的固定区域大小之和，不应超过可配置的总固定区域大小，否则配置失败。

【举例】

# 配置发送缓冲区中接口Ten-GigabitEthernet3/0/1下的队列0最多可使用固定区域cell资源的比例为20%。

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] buffer egress cell queue 0 guaranteed ratio 20

1.1.5  buffer queue shared (interface view)

buffer queue shared命令用来配置队列最多可使用的共享区域的大小。

undo buffer queue shared命令用来取消指定队列最多可使用的共享区域的大小的配置。

【命令】

buffer egress cell queue queue-id shared ratio ratio

undo buffer egress cell queue queue-id shared

【缺省情况】

所有队列最多可使用的共享区域大小均为20%。

【视图】

接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

cell：表示cell资源。

queue-id：表示队列编号，取值范围为0～7。

ratio ratio：队列的最大共享区域占用比，以百分数形式表示。该参数的取值范围为0～100。

【使用指导】

缺省情况下，所有队列均分共享区域，但用户也可以使用该命令调整指定队列最多可使用的共享区域的比例，其它未配置的队列最多可使用的共享区域的比例仍遵循缺省值。最终，各队列最多可使用的共享区域的大小将由芯片根据buffer shared配置，以及实际需要收发报文的数量决定。

【举例】

# 配置发送缓冲区中接口Ten-GigabitEthernet3/0/1下队列0最多可使用共享区域cell资源的比例为20%。

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] buffer egress cell queue 0 shared ratio 20

1.1.6  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

mdc-admin

【参数】

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

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

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

【使用指导】

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

对于SE系列接口板，仅发送数据缓冲区支持生成数据缓冲区超门限告警信息。

【举例】

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

<Sysname> system-view

[Sysname] buffer threshold alarm ingress enable

【相关命令】

·     buffer usage threshold headroom

·     buffer usage threshold queue (interface view)

1.1.7  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

mdc-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 headroom

·     buffer usage threshold queue (interface view)

1.1.8  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

（IRF模式）

buffer usage threshold chassis chassis-number slot slot-number ratio ratio

undo buffer usage threshold chassis chassis-number slot slot-number

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

slot slot-number：指定接口板所在的槽位号。slot-number表示接口板所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：指定成员设备上的指定接口板。chassis-number表示设备在IRF中的成员编号，slot-number表示接口板所在的槽位号。（IRF模式）

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

【使用指导】

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

【举例】

# 配置3号槽位接口板上所有接口的数据缓冲区使用门限值为50%。（独立运行模式）

<Sysname> system-view

[Sysname] buffer usage threshold slot 3 ratio 50

# 配置2号成员设备的3号槽位接口板上所有接口的数据缓冲区使用门限值为50%。（IRF模式）

<Sysname> system-view

[Sysname] buffer usage threshold chassis 2 slot 3 ratio 50

1.1.9  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 slot-number ratio

（IRF模式）

buffer usage threshold headroom chassis chassis-number slot slot-number ratio ratio

undo buffer usage threshold headroom chassis chassis-number slot slot-number ratio

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

slot slot-number：配置指定单板上所有接口每个队列的Headroom缓冲区使用门限值。slot-number表示单板所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：配置指定成员设备上指定单板上所有接口每个队列的Headroom缓冲区使用门限值。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（IRF模式）

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

# 配置成员设备1上的slot 2的所有接口下每个队列的Headroom缓冲区使用门限值为50%。（IRF模式）

<Sysname> system-view

[Sysname] buffer usage threshold headroom chassis 1 slot 2 ratio 50

【相关命令】

·     buffer threshold alarm enable

1.1.10  buffer usage threshold null-queue

buffer usage threshold null-queue命令用来配置全局所有接口的接收或发送数据缓冲区使用门限值。

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

【命令】

（独立运行模式）

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

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

（IRF模式）

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

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

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

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

slot slot-number：配置指定单板上所有接口的数据缓冲区使用门限值。slot-number表示单板所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：配置指定成员设备上的所有接口的数据缓冲区使用门限值。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（IRF模式）

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

【使用指导】

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

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

同时配置本命令和接口缓冲区使用门限值时，接口下配置的门限值优先生效。多次执行本命令，最后一次生效。

【举例】

# 配置slot 1所有接口接收数据缓冲区使用门限值为50%。（独立运行模式）

<Sysname> system-view

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

# 配置成员设备1上的slot 2所有接口的接收数据缓冲区使用门限值为50%。（IRF模式）

<Sysname> system-view

[Sysname] buffer ingress usage threshold chassis 1 slot 2 interface ratio 50

【相关命令】

·     buffer threshold alarm enable

·     port buffer usage threshold null-queue

1.1.11  buffer usage threshold queue (interface view)

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

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

【命令】

buffer egress usage threshold queue queue-id ratio ratio

undo buffer egress usage threshold queue queue-id ratio

【缺省情况】

接口队列发送数据缓冲区使用门限值均为100%。

【视图】

接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

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

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

【使用指导】

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

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

【举例】

# 配置接口Ten-GigabitEthernet3/0/1队列1的发送数据缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] buffer egress usage threshold queue 1 ratio 50

【相关命令】

·     buffer threshold alarm enable

1.1.12  burst-mode enable

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

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

【命令】

（独立运行模式）

burst-mode enable slot slot-number

undo burst-mode enable slot slot-number

（IRF模式）

burst-mode enable chassis chassis-number slot slot-number

undo burst-mode enable chassis chassis-number slot slot-number

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

slot slot-number：开启指定单板的数据缓冲区自动分配功能，slot-number表示单板所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：开启指定成员设备上指定单板的数据缓冲区自动分配功能，chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（IRF模式）

【使用指导】

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

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

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

【举例】

# 开启指定slot 1数据缓冲区自动分配功能。

<Sysname> system-view

[Sysname] burst-mode enable slot 1

# 开启指定成员设备1指定slot 1数据缓冲区自动分配功能。（IRF模式）

<Sysname> system-view

[Sysname] burst-mode enable chassis 1 slot 1

1.1.13  display buffer

display buffer命令用来显示数据缓冲区的大小。

【命令】

（独立运行模式）

display buffer [ slot slot-number ] [ queue [ queue-id ] ]

（IRF模式）

display buffer [ chassis chassis-number slot slot-number ] [ queue [ queue-id ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

slot slot-number：表示接口板所在的槽位号。不指定该参数时，表示所有接口板。（独立运行模式）

chassis chassis-number slot slot-number：表示IRF中指定成员设备上的指定接口板。不指定该参数时，表示IRF中的所有接口板。（IRF模式）

queue queue-id：显示队列最多可使用的固定区域的大小以及队列最多可使用的共享区域的大小，queue-id的取值范围为0～7。指定queue-id时，显示指定队列的相关信息；不指定queue-id时，显示所有队列的相关信息。未指定本参数时，显示共享区域的大小。

【举例】

# 显示数据缓冲区的大小。（独立运行模式）

<Sysname> display buffer

Slot  Type    Eg(Total-shared , Shared)

1     packet  95 , 100

1     cell    55 , 33

          Eg: Size of the sending buffer

Total-shared: Size of the shared buffer for all ports

      Shared: Size of the maximum shared buffer per port

        Unit: Ratio

# 显示队列最多可使用的固定区域的大小以及队列最多可使用的共享区域的大小。（独立运行模式）

<Sysname> display buffer queue

Slot  Queue        Type    Eg(Guaranteed , Shared)

1     0-7          packet  11 , 60

1     0-7          cell    12 , 100

          Eg: Size of the sending buffer

  Guaranteed: Size of the minimum guaranteed buffer per queue

      Shared: Size of the maximum shared buffer per queue

        Unit: Ratio

# 显示指定chassis、指定slot上的数据缓冲区的大小。（IRF模式）

<Sysname> display buffer chassis 1 slot 2

Slot      Type          In(Total-shared , Shared)        Eg(Total-shared , Shared)

1/2       packet        24 , 2                           36 , 2

1/2       cell          50 , 25                          -- , --

 

          In: Size of the receiving buffer

          Eg: Size of the sending buffer

Total-shared: Size of the shared buffer for all ports

      Shared: Size of the maximum shared buffer per port

        Unit: Ratio

# 显示指定chassis、指定slot上的队列最多可使用的固定区域的大小以及队列最多可使用的共享区域的大小。（IRF模式）

<Sysname> display buffer chassis 1 slot 2 queue

Slot      Queue          Type       In(Guaranteed , Shared)     Eg(Guaranteed , Shared)

1/2       0-7            packet     256 , 128                   256 , 128

1/2       0-1,3-4,6-7    cell       256 , 128                   256 , 128

1/2       2,5            cell       512 , 128                   -- , --

 

        In: Size of the receiving buffer

        Eg: Size of the sending buffer

Guaranteed: Size of the minimum guaranteed buffer per queue

    Shared: Size of the maximum shared buffer per queue

      Unit: Byte

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

字段	描述
Type	缓冲区类型，包括packet资源和cell资源
Queue	队列ID，范围为0～7
Eg	Egress，出方向的数据缓冲区配置
(Total-shared , Shared)	Total-shared表示所有端口共享区域的大小。如果显示为“--”字符串，则表示设备不支持该缓冲区 Shared表示每个端口专用的共享区域的大小。如果显示为“--”字符串，则表示设备不支持该数据缓冲
(Guaranteed , Shared)	Guaranteed表示每个队列最多可使用的固定区域的大小。如果显示为“--”字符串，则表示设备不支持该数据缓冲区 Shared表示每个队列最多可使用的共享区域的大小。如果显示为“--”字符串，则表示设备不支持该数据缓冲区
Unit	数据缓冲区的单位，为%

‌

1.1.14  display buffer usage

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

【命令】

（独立运行模式）

display buffer usage [ slot slot-number ]

（IRF模式）

display buffer usage [ chassis chassis-number slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

slot slot-number：表示接口板所在的槽位号。不指定该参数时，表示所有接口板。（独立运行模式）

chassis chassis-number slot slot-number：表示IRF中指定成员设备上的指定接口板。不指定该参数时，表示IRF中的所有接口板。（IRF模式）

【举例】

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

<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-2 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.15  display buffer usage interface

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

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

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

【举例】

# 显示接口Ten-GigabitEthernet3/0/1的数据缓冲区简要使用统计信息。

<Sysname> display buffer usage interface ten-gigabitethernet 3/0/1

Interface              QueueID Total       Used        Threshold(%) Violations

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

GE1/0/1                0       9418032     0           30           0

                       1       9418032     0           30           0

                       2       9418032     0           30           0

                       3       9418032     0           30           0

                       4       9418032     0           30           0

                       5       9418032     0           30           0

                       6       9418032     0           30           0

                       7       9418032     0           30           0

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

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

‌

# 显示接口Ten-GigabitEthernet3/0/1的数据缓冲区详细使用统计信息。

<Sysname> display buffer usage interface ten-gigabitethernet 3/0/1 verbose

XGE3/0/1

  Ingress:

    QueueID: 0

      Total: --                Used: 2                  Threshold(%): 3

      Violations: 4            Shared: 5                Headroom: 6

      XoffThres: 7             IsDynamic: 1

      Used(%): 6               Free: 15                 UsedPeak: 17

      HeadroomUsed(%): 3       HeadroomFree: 19         HeadroomPeak: 20

    QueueID: 1

      Total: --                Used: 4                  Threshold(%): 6

      Violations: 8            Shared: 10               Headroom: 12

      XoffThres: 14            IsDynamic: 1

      Used(%): 12              Free: 30                 UsedPeak: 34

      HeadroomUsed(%): 6       HeadroomFree: 38         HeadroomPeak: 40

    QueueID: 2

      Total: --                Used: 6                  Threshold(%): 9

      Violations: 12           Shared: 15               Headroom: 18

      XoffThres: 21            IsDynamic: 1

      Used(%): 18              Free: 45                 UsedPeak: 51

      HeadroomUsed(%): 9       HeadroomFree: 57         HeadroomPeak: 60

    QueueID: 3

      Total: --                Used: 8                  Threshold(%): 12

      Violations: 16           Shared: 20               Headroom: 24

      XoffThres: 28            IsDynamic: 1

      Used(%): 24              Free: 60                 UsedPeak: 68

      HeadroomUsed(%): 12      HeadroomFree: 76         HeadroomPeak: 80

    QueueID: 4

      Total: --                Used: 10                 Threshold(%): 15

      Violations: 20           Shared: 25               Headroom: 30

      XoffThres: 35            IsDynamic: 1

      Used(%): 30              Free: 75                 UsedPeak: 85

      HeadroomUsed(%): 15      HeadroomFree: 95         HeadroomPeak: 100

    QueueID: 5

      Total: --                Used: 12                 Threshold(%): 18

      Violations: 24           Shared: 30               Headroom: 36

      XoffThres: 42            IsDynamic: 1

      Used(%): 36              Free: 90                 UsedPeak: 102

      HeadroomUsed(%): 18      HeadroomFree: 114        HeadroomPeak: 120

    QueueID: 6

      Total: --                Used: 14                 Threshold(%): 21

      Violations: 28           Shared: 35               Headroom: 42

      XoffThres: 49            IsDynamic: 1

      Used(%): 42              Free: 105                UsedPeak: 119

      HeadroomUsed(%): 21      HeadroomFree: 133        HeadroomPeak: 140

    QueueID: 7

      Total: --                Used: 16                 Threshold(%): 24

      Violations: 32           Shared: 40               Headroom: 48

      XoffThres: 56            IsDynamic: 1

      Used(%): 48              Free: 120                UsedPeak: 136

      HeadroomUsed(%): 24      HeadroomFree: 152        HeadroomPeak: 160

  Egress:

    QueueID: 0

      Total: 9                 Used: 10                 Threshold(%): 11

      Violations: 12           TailDropThres: 13        IsDynamic: 1

      DeadlockCount: 21        DeadlockRecover: 22

      Used(%): 2               Free: 23                 UsedPeak: 25

    QueueID: 1

      Total: 18                Used: 20                 Threshold(%): 22

      Violations: 24           TailDropThres: 26        IsDynamic: 1

      DeadlockCount: 42        DeadlockRecover: 44

      Used(%): 4               Free: 46                 UsedPeak: 50

    QueueID: 2

      Total: 27                Used: 30                 Threshold(%): 33

      Violations: 36           TailDropThres: 39        IsDynamic: 1

      DeadlockCount: 63        DeadlockRecover: 66

      Used(%): 6               Free: 69                 UsedPeak: 75

    QueueID: 3

      Total: 36                Used: 40                 Threshold(%): 44

      Violations: 48           TailDropThres: 52        IsDynamic: 1

      DeadlockCount: 84        DeadlockRecover: 88

      Used(%): 8               Free: 92                 UsedPeak: 100

    QueueID: 4

      Total: 45                Used: 50                 Threshold(%): 55

      Violations: 60           TailDropThres: 65        IsDynamic: 1

      DeadlockCount: 105       DeadlockRecover: 110

      Used(%): 10              Free: 115                UsedPeak: 125

    QueueID: 5

      Total: 54                Used: 60                 Threshold(%): 66

      Violations: 72           TailDropThres: 78        IsDynamic: 1

      DeadlockCount: 126       DeadlockRecover: 132

      Used(%): 12              Free: 138                UsedPeak: 150

    QueueID: 6

      Total: 63                Used: 70                 Threshold(%): 77

      Violations: 84           TailDropThres: 91        IsDynamic: 1

      DeadlockCount: 147       DeadlockRecover: 154

      Used(%): 14              Free: 161                UsedPeak: 175

    QueueID: 7

      Total: 72                Used: 80                 Threshold(%): 88

      Violations: 96           TailDropThres: 104       IsDynamic: 1

      DeadlockCount: 168       DeadlockRecover: 176

      Used(%): 16              Free: 184                UsedPeak: 200

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

字段	描述
Ingress	接收数据缓冲区的统计数据
Egress	发送数据缓冲区的统计数据
QueueID	显示指定队列对数据缓冲区的使用统计信息
Total	队列可用的数据缓冲区大小，单位为字节
Used	队列已使用的数据缓冲区大小，单位为字节
Threshold(%)	（暂不支持）队列的数据缓冲区使用门限值，该值与队列所在接口的缓冲区使用门限值保持一致
Violations	（暂不支持）队列超量使用缓冲区的计数，表示队列使用缓冲区超过设定门限值的次数 该字段在设备重启时，会清零重新计数
Shared	队列已使用共享数据缓冲区的cell资源个数
Headroom	队列已使用Headroom缓冲区的cell资源个数。开启PFC功能的端口上某优先级队列进入PFC XOFF状态后，端口会发送XOFF帧通知对端设备暂停向本端发送对应优先级报文，如果对端设备未收到XOFF帧时已发出了流量，则端口会使用Headroom缓冲区缓存这部分流量
XoffThres	反压帧触发门限值： ·     当用户配置为动态时显示的数值为具体配置的百分比 ·     当用户配置为静态门限时显示的数值为具体配置的cell资源个数
TailDropThres	尾丢弃门限值，该值由buffer queue shared命令配置的占用比计算得到
IsDynamic	对于入方向，该字段取值如下： ·     0：表示反压帧触发门限为静态 ·     1：表示反压帧触发门限为动态 对于出方向，该字段取值为1，表示尾丢弃门限为动态
Used(%)	队列缓存使用率
Free	队列缓存可用量，单位为Byte
UsedPeak	（暂不支持）队列缓存使用历史峰值，即本次执行display命令与上次执行display命令之间这段时间的峰值，单位为Byte
HeadroomUsed(%)	入方向队列HEADROOM使用率
HeadroomFree	入方向队列HEADROOM可用量，单位为Byte
HeadroomPeak	（暂不支持）入方向队列HEADROOM使用历史峰值，即本次执行display命令与上次执行display命令之间这段时间的峰值，单位为Byte
DeadlockCount	出方向队列DEADLOCK发生次数
DeadlockRecover	出方向队列DEADLOCK恢复次数

‌

‌

1.1.16  port buffer usage threshold headroom null-queue

port buffer usage threshold headroom null-queue命令用来配置端口级Headroom缓冲区使用门限值。

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

【命令】

port buffer usage threshold headroom null-queue ratio ratio

undo port buffer usage threshold headroom null-queue ratio

【缺省情况】

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

【视图】

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

【使用指导】

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

同时配置全局Headroom缓冲区使用门限值和接口Headroom缓冲区使用门限值时，接口下配置的门限值优先生效。在同一接口下，多次执行本命令，最后一次生效。

【举例】

# 配置端口级Ten-GigabitEthernet3/0/1的Headroom缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname–Ten-GigabitEthernet3/0/1] port buffer usage threshold headroom null-queue ratio 50

【相关命令】

·     buffer threshold alarm enable

·     buffer usage threshold headroom

1.1.17  port buffer usage threshold null-queue

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

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

【命令】

port buffer { egress | ingress } usage threshold null-queue ratio ratio

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

【缺省情况】

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

【视图】

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

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

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

【使用指导】

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

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

同时配置全局所有接口缓冲区使用门限值和接口缓冲区使用门限值时，接口下配置的门限值优先生效。在同一接口下，多次执行本命令，最后一次生效。

【举例】

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

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port buffer ingress usage threshold null-queue ratio 50

【相关命令】

·     buffer threshold alarm enable

·     buffer usage threshold null-queue

1.2  TCB

1.2.1  buffer transient-capture enable

buffer transient-capture enable命令用来开启并配置TCB功能。

undo buffer transient-capture enable命令用来关闭TCB功能。

【命令】

系统视图：

（独立运行模式）

buffer transient-capture global [ slot slot-number ] { egress | ingress } enable [ no-local-analysis ] [ acl { ipv4-acl-number | name ipv4-acl-name } ] [ start-threshold start-threshold-value stop-threshold stop-threshold-value ] [ frozen-number frozen-number frozen-timer timer-value ] [ pre-sample-rate pre-sample-rate post-sample-rate post-sample-rate ] [ poll-frequency frequency-value ]

undo buffer transient-capture global [ slot slot-number ] enable

（IRF模式）

buffer transient-capture global [ chassis chassis-number slot slot-number ] { egress | ingress } enable [ no-local-analysis ] [ acl { ipv4-acl-number | name ipv4-acl-name } ] [ start-threshold start-threshold-value stop-threshold stop-threshold-value ] [ frozen-number frozen-number frozen-timer timer-value ] [ pre-sample-rate pre-sample-rate post-sample-rate post-sample-rate ] [ poll-frequency frequency-value ]

undo buffer transient-capture global [ chassis chassis-number slot slot-number ] enable

接口视图：

buffer transient-capture { egress [ queue queue-id ] | ingress } enable [ no-local-analysis ] [ acl { ipv4-acl-number | name ipv4-acl-name } ] [ start-threshold start-threshold-value stop-threshold stop-threshold-value ] [ frozen-number frozen-number frozen-timer timer-value ] [ pre-sample-rate pre-sample-rate post-sample-rate post-sample-rate ] [ poll-frequency frequency-value ]

undo buffer transient-capture enable

【缺省情况】

TCB功能处于关闭状态。

【视图】

系统视图

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

global：表示开启并配置全局TCB功能。仅系统视图下支持指定本参数。

slot slot-number：指定单板。slot-number为单板所在的槽位号。如果不指定本参数，则表示指定主用主控板。（独立运行模式）

chassis chassis-number slot slot-number：指定单板。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。如果不指定本参数，则表示指定Master设备主用主控板。（IRF模式）

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

queue-id：表示队列编号，取值范围为0～7。仅接口视图下支持指定本参数。如果未指定本参数，表示开启并配置本接口下发送缓冲区中所有队列的TCB功能。

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

no-local-analysis：表示不对抓包数据进行本地分析，直接上报原始数据和丢包原因。缺省情况下，会对抓包数据进行本地分析，然后上报。

acl：表示TCB功能引用IPv4高级ACL，仅对命中规则的流量开启TCB功能。如果未指定本参数，表示不引用ACL，即对所有流量开启TCB功能。

·     ipv4-acl-number：通过编号引用IPv4高级ACL，取值范围为3000～3999。

·     name ipv4-acl-name：通过名称引用IPv4高级ACL。ipv4-acl-name表示ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。

start-threshold-value：表示开始抓包的队列长度门限值，单位为字节。取值范围为1～67108352，缺省值为2500。配置值需大于stop-threshold-value。

stop-threshold-value：表示停止抓包的队列长度门限值，单位为字节。取值范围为1～67108352，缺省值为1500。配置值需小于start-threshold-value。

frozen-number：表示抓包数量，达到本门限值时进入冻结状态。取值范围为3～1024，缺省值为256。

timer-value：表示抓包时间，达到本门限值时进入冻结状态。取值范围为1～400，缺省值为400。

pre-sample-rate：表示TCB功能处于预触发状态时的采样率。取值范围为1～16，缺省值为16。例如取值范围为1～16，配置值表示每16个报文中采样报文的个数，配置为16则表示全部采样。

post-sample-rate：表示TCB功能处于触发状态时的采样率。取值范围为1～16，缺省值为16。例如取值范围为1～16，配置值表示每16个报文中采样报文的个数，配置为16则表示全部采样。

frequency-value：表示数据上报频次，单位为次/分钟。取值范围为1～600，缺省值为20。

【使用指导】

在系统视图下开启并配置全局TCB功能对指定slot上所有支持TCB功能的接口生效，设备将持续监控接口下的队列，当队列发生丢包时，可通过gRPC方式将接口、队列、丢包原因等信息上报网管。

在接口视图下开启并配置TCB功能后，设备将持续监控该接口下的队列，当队列发生丢包时，可通过gRPC方式将接口、队列、丢包原因等信息上报网管。

使用接口视图下的命令开启TCB功能时，每个芯片仅支持在其中的一个接口下开启TCB功能。

只有对TCP或UDP报文本地分析时TCB的显示命令才显示丢包信息。

系统视图和接口视图下均可开启并配置TCB功能，但两种配置方式互斥。如果当前已经使用一种方式开启了TCB功能，需要在该方式下关闭TCB功能后，才能使用另一种方式配置。

【举例】

# 对slot 1上支持TCB功能的所有接口的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析，进入预触发状态的队列长度门限值为10000字节，退出预触发状态的队列长度门限值为5000字节，抓包数量为1000，抓包时间为400微妙，预触发状态时的采样率为10，触发状态时的采样率为10，数据上报频次为30次/分钟。（独立运行模式）

<Sysname> system-view

[Sysname] buffer transient-capture global slot 1 egress enable no-local-analysis acl 3000 start-threshold 10000 stop-threshold 5000 frozen-number 1000 frozen-timer 400 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30

# 对接口Ten-GigabitEthernet3/0/1的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析，进入预触发状态的队列长度门限值为10000字节，退出预触发状态的队列长度门限值为5000字节，抓包数量为1000，抓包时间为400微妙，预触发状态时的采样率为10，触发状态时的采样率为10，数据上报频次为30次/分钟。

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] buffer transient-capture egress enable no-local-analysis acl 3000 start-threshold 10000 stop-threshold 5000 frozen-number 1000 frozen-timer 400 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30

1.2.2  display buffer transient-capture packet-drop

display buffer transient-capture packet-drop命令用来显示TCB捕获的丢包信息。

【命令】

（独立运行模式）

display buffer transient-capture packet-drop slot slot-number { ethernet | ipv4 | ipv6 }

（IRF模式）

display buffer transient-capture packet-drop chassis chassis-number slot slot-number { ethernet | ipv4 | ipv6 }

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

ethernet：显示TCB捕获的以太网报文的丢包信息。

ipv4：显示TCB捕获的IPv4报文的丢包信息。

ipv6：显示TCB捕获的IPv6报文的丢包信息。

slot slot-number：指定单板。slot-number为单板所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：指定单板。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（IRF模式）

【使用指导】

执行本命令后，设备将按照发生丢包事件的时间由近及远罗列所有丢包事件，其中包含丢包数量、丢包发生时间、被丢弃报文特征、所属队列和接口，以及丢包原因。

【举例】

# 显示chassis 1 slot 1上TCB捕获的IPv4报文的丢包信息。（IRF模式）

<Sysname> display buffer transient-capture packet-drop chassis 1 slot 1 ipv4

TCB STATUS: EgressPort XGE3/0/1

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

No.  Time  SMAC  DMAC  VLAN  SIP  DIP  SPort  DPort  Queue  IfName  Reason

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

Total Drop Packets in Ring Buffer of XPE 0:2047

0  8a44900  0010-9400-0005  0010-9400-0002  100  192.168.1.2  192.168.0.1  0  0  0  XGE3/0/1  2

Total Drop Packets in Ring Buffer of XPE 1:2047

0  8a44800  0010-9400-0005  0010-9400-0002  100  192.168.1.2  192.168.0.1  0  0  0  XGE3/0/1  2

Total Drop Packets in Ring Buffer of XPE 2:2047

0  8a44800  0010-9400-0005  0010-9400-0002  100  192.168.1.2  192.168.0.1  0  0  0  XGE3/0/1  2

Total Drop Packets in Ring Buffer of XPE 3:2047

0  8a44800  0010-9400-0005  0010-9400-0002  100  192.168.1.2  192.168.0.1  0  0  0  XGE3/0/1  2

表1-5 display buffer transient-capture packet-drop命令显示信息描述表

字段	描述
TCB STATUS	TCB状态 ·     EgressPort XGE3/0/1：表示当前开启的是接口TCB功能，以及功能开启的方向和接口编号 ·     Global：表示当前开启的是全局TCB功能
No.	编号
Time	丢包发生时间，为UNIX时间戳格式，即1970年1月1日0点0时0秒的相对时间。例如： ·     1970年1月1日0点0时0秒实际显示为0 ·     1970年1月1日1点0时0秒实际显示为E10
SMAC	源MAC地址
DMAC	目的MAC地址
VLAN	VLAN ID
SIP	源IP地址
DIP	目的IP地址
SPort	源端口号
DPort	目的端口号
Queue	队列编号
IfName	接口名称
Reason	丢包原因（多个原因时，为以下数字的或运算组合）： ·     1：入队列丢弃 ·     2：出队列丢弃 ·     4：加权随机丢弃 ·     8：CELL资源不足丢弃
Total packets dropped on XPE0	XPE0上的总丢报数，XPE表示设备支持的缓冲区类型