目  录

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 threshold alarm enable

1.1.5 buffer threshold alarm interval

1.1.6 buffer total-shared

1.1.7 buffer usage threshold headroom

1.1.8 buffer usage threshold null-queue

1.1.9 buffer usage threshold queue (interface view)

1.1.10 burst-mode enable

1.1.11 display buffer

1.1.12 port buffer usage threshold headroom null-queue

1.1.13 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  数据缓冲区配置命令

IRF物理端口下不支持配置数据缓冲区系列命令。

1.1.1  buffer apply

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

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

【命令】

buffer apply

undo buffer apply

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【使用指导】

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

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

仅对于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 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等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

【举例】

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

<Sysname> system-view

[Sysname] buffer threshold alarm ingress enable

【相关命令】

·     buffer usage threshold headroom

·     buffer usage threshold queue (interface view)

1.1.5  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.6  buffer total-shared

buffer total-shared命令用来配置数据缓冲区中共享区域的大小。

undo buffer total-shared命令用来取消数据缓冲区中共享区域的大小的配置。

【命令】

（独立运行模式）

buffer { egress | ingress } [ slot slot-number ] { cell | packet } total-shared { ratio ratio | size }

undo buffer { egress | ingress } [ slot slot-number ] { cell | packet } total-shared

（IRF模式）

buffer { egress | ingress } [ chassis chassis-number slot slot-number ] { cell | packet } total-shared { ratio ratio | size }

undo buffer { egress | ingress } [ chassis chassis-number slot slot-number ] { cell | packet } total-shared

【缺省情况】

在未配置本命令的情况下，使用display buffer命令可以查看其缺省值。

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

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

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

cell：表示cell资源。

packet：表示packet资源。

ratio ratio：缓冲区中共享区域所占的比例，以百分数形式表示。该参数的取值范围为0～100。

【使用指导】

接口卡上整个数据缓冲区的大小是固定的，用户配置共享区域的大小后，其余部分将自动成为固定区域。

【举例】

# 配置当前设备cell资源中的共享区域所占比例为50%。

<Sysname> system-view

[Sysname] buffer egress cell total-shared ratio 50

1.1.7  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.8  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.9  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.10  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.11  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.12  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.13  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功能。

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

【举例】

# 对slot 1上支持TCB功能的所有接口的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析，进入预触发状态的队列长度门限值为10000字节，退出预触发状态的队列长度门限值为5000字节，抓包数量为1000，抓包时间为500微妙，预触发状态时的采样率为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 500 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30

# 对接口Ten-GigabitEthernet3/0/1的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析，进入预触发状态的队列长度门限值为10000字节，退出预触发状态的队列长度门限值为5000字节，抓包数量为1000，抓包时间为500微妙，预触发状态时的采样率为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 500 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-2 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表示设备支持的缓冲区类型