When you configure MST region–related parameters, MSTP launches a new spanning tree calculation process that may cause network topology instability. This is most likely to occur when you configure the VLAN-to-instance mapping table. The launch will occur only after the MST region–related parameters are activated with the active region-configuration command, or you enable the spanning tree feature with the stp enable command.

H3C recommends you to use the check region-configuration command to determine whether the MST region configurations to be activated are correct and that you run this command only if they are correct.

Related commands: instance, region-name, revision-level, vlan-mapping modulo, and check region-configuration.

Examples

# Map VLAN 2 to MSTI 1 and manually activate the MST region configuration.

<Sysname> system-view

[Sysname] stp region-configuration

[Sysname-mst-region] instance 1 vlan 2

[Sysname-mst-region] active region-configuration

check region-configuration

Syntax

check region-configuration

View

MST region view

Default level

2: System level

Parameters

None

Description

Use the check region-configuration command to display MST region pre-configuration information, including the region name, revision level, and VLAN-to-instance mapping settings.

Two or more spanning tree switches belong to the same MST region only if they are configured with the same format selector (0 by default, not configurable), MST region name, MST region revision level, and the same VLAN-to-instance mapping entries in the MST region, and if they are connected via a physical link.

H3C recommends that you use this command to determine whether the MST region configurations to be activated are correct and that you activate them only if they are correct.

Related commands: instance, region-name, revision-level, vlan-mapping modulo, and active region-configuration.

Examples

# Display MST region pre-configurations.

<Sysname> system-view

[Sysname] stp region-configuration

[Sysname-mst-region] check region-configuration

Admin Configuration

Format selector :0

Region name :00e0fc009512

Revision level :0

Configuration digest :0x41b5018aca57daa8dcfdba2984d99d06

Instance Vlans Mapped

0 1 to 9, 11 to 4094

15 10

Table 1 Output description

Field	Description
Format selector	Format selector of the MST region. The value is 0 and cannot be configured.
Region name	MST region name.
Revision level	Revision level of the MST region.
Instance Vlans Mapped	VLAN-to-instance mappings in the MST region.

display stp

Syntax

In standalone mode:

display stp [ instance instance-id | vlan vlan-id ] [ interface interface-list | slot slot-number ] [ brief ] [ | { begin | exclude | include } regular-expression ]

In IRF mode:

display stp [ instance instance-id | vlan vlan-id ] [ interface interface-list | chassis chassis-number slot slot-number ] [ brief ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

instance instance-id: Displays the status and statistics of an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the common internal spanning tree (CIST).

vlan vlan-id: Displays the spanning tree status and statistics of a VLAN specified by vlan-id. The value of vlan-id ranges from 1 to 4094.

interface interface-list: Displays the spanning tree status and statistics on the ports specified by a port list, in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] }&<1-10>, where &<1-10> indicates that you can specify up to 10 ports or port ranges.

slot slot-number: Displays the spanning tree status and statistics on the specified card. The slot-number argument represents the number of the slot that houses the card. Use this option when your switch is operating in standalone mode. If this option is not specified, this command displays the spanning tree status and statistics on the MPU. (in standalone mode)

chassis chassis-number slot slot-number: Displays the spanning tree status and statistics on the specified card of the specified IRF member switch. The chassis-number argument represents the ID of the IRF member switch. The slot-number argument represents the number of the slot that houses the card, which can be displayed with the display device command. Use this option when your switch is operating in IRF mode. If this option is not specified, this command displays the spanning tree status and statistics on all cards of all member switches in the IRF fabric. (in IRF mode)

brief: Displays brief spanning tree status and statistics.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp command to display the spanning tree status and statistics.

Based on the spanning tree status and statistics, you can analyze and maintain the network topology or check whether spanning tree is working normally.

In STP/RSTP mode, follow these guidelines:

· If you do not specify any port, this command displays the spanning tree information for all ports. The displayed information is sorted by port name.

· If you specify a port list, this command displays the spanning tree information for the specified ports. The displayed information is sorted by port name.

In MSTP mode, follow these guidelines:

· If you do not specify any MSTI or port, this command displays the spanning tree information of all MSTIs on all ports. The displayed information is sorted by MSTI ID and by port name in each MSTI.

· If you specify an MSTI but not a port, this command displays the spanning tree information on all ports in that MSTI. The displayed information is sorted by port name.

· If you specify some ports but not an MSTI, this command displays the spanning tree information of all MSTIs on the specified ports. The displayed information is sorted by MSTI ID and by port name in each MSTI.

· If you specify both an MSTI ID and a port list, this command displays the spanning tree information on the specified ports in the specified MSTI. The displayed information is sorted by port name.

In PVST mode, follow these guidelines:

· If you do not specify any VLAN or port, this command displays the spanning tree information of all VLANs on all ports. The displayed information is sorted by VLAN ID and by port name in each VLAN.

· If you specify a VLAN but not a port, this command displays the spanning tree information on all ports in that VLAN. The displayed information is sorted by port name.

· If you specify some ports but not any VLAN, this command displays the spanning tree information of all VLANs on the specified ports. The displayed information is sorted by VLAN ID and by port name in each VLAN.

· If you specify both a VLAN ID and a port list, this command displays the spanning tree information on the specified ports in the specified VLAN. The displayed information is sorted by port name.

Related commands: reset stp.

Examples

# In MSTP mode, display the brief spanning tree status and statistics of MSTI 0 on ports GigabitEthernet 3/0/1 through GigabitEthernet 3/0/4.

<Sysname> display stp instance 0 interface gigabitethernet 3/0/1 to gigabitethernet 3/0/4 brief

MSTID Port Role STP State Protection

0 GigabitEthernet3/0/1 DESI DISCARDING NONE

0 GigabitEthernet3/0/2 DESI FORWARDING NONE

0 GigabitEthernet3/0/3 DESI FORWARDING NONE

0 GigabitEthernet3/0/4 DESI FORWARDING NONE

# In PVST mode, display the brief spanning tree status and statistics of VLAN 2 on ports GigabitEthernet 3/0/1 through GigabitEthernet 3/0/4.

<Sysname> system-view

[Sysname] stp mode pvst

[Sysname] display stp vlan 2 interface gigabitethernet 3/0/1 to gigabitethernet 3/0/4 brief

VLAN Port Role STP State Protection

2 GigabitEthernet3/0/1 ALTE DISCARDING LOOP

2 GigabitEthernet3/0/2 DESI FORWARDING NONE

2 GigabitEthernet3/0/3 DESI FORWARDING NONE

2 GigabitEthernet3/0/4 DESI FORWARDING NONE

Table 2 display stp brief command output description

Field	Description
MSTID	MSTI ID in the MST region.
Port	Port name, corresponding to each MSTI or VLAN.
Role	Port role: · ALTE—The port is an alternate port. · BACK—The port is a backup port. · ROOT—The port is a root port. · DESI—The port is a designated port. · MAST—The port is a master port. · DISA—The port is disabled.
STP State	Spanning tree status on the port: · FORWARDING—The port can receive and send BPDUs, and also forward user traffic. · DISCARDING—The port can receive and send BPDUs, but cannot forward user traffic. · LEARNING—The port is in a transitional state. It can receive and send BPDUs, but cannot forward user traffic.
Protection	Protection type on the port: · ROOT—Root guard. · LOOP—Loop guard. · BPDU—BPDU guard. · BPDU/ROOT—BPDU guard and root guard. · NONE—No protection.

# In MSTP mode, display the spanning tree status and statistics of MSTI 0 on GigabitEthernet 3/0/2.

<Sysname> display stp instance 0 interface gigabitethernet 3/0/2

-------[CIST Global Info][Mode MSTP]-------

CIST Bridge :32768.000f-e200-2200

Bridge Times :Hello 2s MaxAge 20s FwDly 15s MaxHop 20

CIST Root/ERPC :0.00e0-fc0e-6554 / 200200

CIST RegRoot/IRPC :32768.000f-e200-2200 / 0

CIST RootPortId :128.48

BPDU-Protection :disabled

Bridge Config-

Digest-Snooping :disabled

TC or TCN received :2

Time since last TC :0 days 0h:5m:42s

----[Port2(GigabitEthernet3/0/2)][FORWARDING]----

Port Protocol :enabled

Port Role :CIST Designated Port

Port Priority :128

Port Cost(Legacy) :Config=auto / Active=200

Desg. Bridge/Port :32768.000f-e200-2200 / 128.2

Port Edged :Config=disabled / Active=disabled

Point-to-point :Config=auto / Active=true

Transmit Limit :10 packets/hello-time

Protection Type :None

MST BPDU Format :Config=auto / Active=legacy

Port Config-

Digest-Snooping :disabled

Rapid transition :false

Num of Vlans Mapped :1

PortTimes :Hello 2s MaxAge 20s FwDly 15s MsgAge 2s RemHop 20

BPDU Sent :186

TCN: 0, Config: 0, RST: 0, MST: 186

BPDU Received :0

TCN: 0, Config: 0, RST: 0, MST: 0

# Display the spanning tree status and statistics when the spanning tree feature is disabled.

<Sysname> display stp

Protocol Status :disabled

Protocol Std. :IEEE 802.1s

Version :0

Bridge-Prio. :32768

MAC address :000f-e200-8048

Max age(s) :20

Forward delay(s) :15

Hello time(s) :2

Max hops :20

Table 3 display stp command output description

Field	Description
CIST Bridge	The CIST bridge ID, which comprises the switch’s priority in the CIST and its MAC address. For example, in output information “32768.000f-e200-2200”, the value preceding the dot is the switch’s priority in the CIST, and the value following the dot is the switch’s MAC address.
Bridge ID	The bridge ID, which comprises the switch's priority in VLAN 1 and its MAC address. For example, in output information “32768.000f-e200-2200”, the value preceding the dot is the switch’s priority in VLAN 1, and the value following the dot is the switch’s MAC address.
Bridge Times	Major parameters for the bridge: · Hello—Hello timer. · MaxAge—Max age timer. · FWDly—Forward delay timer. · MaxHop—Max hops within the MST region.
CIST Root/ERPC	CIST root ID and external path cost (the path cost from the switch to the CIST root).
CIST RegRoot/IRPC	CIST regional root ID and internal path cost (the path cost from the switch to the CIST regional root).
CIST RootPortId	CIST root port ID. "0.0" indicates that the switch is the root and there is no root port.
BPDU-Protection	Global status of BPDU protection.
Bridge Config- Digest-Snooping	Global status of Digest Snooping.
TC or TCN received	Number of TC/TCN BPDUs received in the MSTI.
Time since last TC	Time since the latest topology change in the MSTI.
FORWARDING	The port is in forwarding state.
Port Protocol	The status of the spanning tree feature on the port.
Port Role	Port role, which can be Alternate, Backup, Root, Designated, Master, or Disabled.
Port Cost(Legacy)	Path cost of the port. The field in parentheses indicates the standard (legacy, dot1d-1998, or dot1t) used for port path cost calculation. · Config—Configured value. · Active—Actual value.
Desg. Bridge/Port	Designated bridge ID and port ID of the port. The port ID displayed is insignificant for a port which does not support port priority.
Port Edged	The port is an edge port or non-edge port. · Config—Configured value. · Active—Actual value.
Point-to-point	The port is connected to a point-to-point link or not. · Config—Configured value. · Active—Actual value.
Transmit Limit	The maximum number of packets sent within each hello time.
Protection Type	Protection type on the port: · Root—Root guard. · Loop—Loop guard. · BPDU—BPDU guard. · BPDU/ROOT—BPDU guard and root guard. · None—No protection.
MST BPDU Format	Format of the MST BPDUs that the port can send, which can be legacy or 802.1s. · Config—Configured value. · Active—Actual value.
Port Config- Digest-Snooping	The status of Digest Snooping on the port.
Rapid transition	The port rapidly transitions to the forwarding state or not in the MSTI.
PortTimes	Major parameters for the port: · Hello—Hello timer. · MaxAge—Max Age timer. · FWDly—Forward delay timer. · MsgAge—Message Age timer. · RemHop—Remaining hops.
BPDU Sent	Statistics on sent BPDUs.
BPDU Received	Statistics on received BPDUs.
Protocol Status	Spanning tree protocol status.
Protocol Std.	Spanning tree protocol standard.
Version	Spanning tree protocol version.
Bridge-Prio.	In MSTP mode, this field indicates the switch’s priority in the CIST. In PVST mode, this field indicates the switch’s priority in VLAN 1.
Max age(s)	Aging timer (in seconds) for BPDUs. In PVST mode, this field is the configuration in VLAN 1.
Forward delay(s)	Port state transition delay (in seconds). In PVST mode, this field is the configuration in VLAN 1.
Hello time(s)	Interval (in seconds) for the root bridge to send BPDUs. In PVST mode, this field is the configuration in VLAN 1.
Max hops	Maximum hops in the MSTI.

display stp abnormal-port

Syntax

display stp abnormal-port [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp abnormal-port command to display information about ports blocked by spanning tree protection functions.

Examples

# In MSTP mode, display information about ports blocked by spanning tree protection functions.

<Sysname> display stp abnormal-port

MSTID Blocked Port Reason

1 GigabitEthernet3/0/1 ROOT-Protected

2 GigabitEthernet3/0/2 LOOP-Protected

2 GigabitEthernet3/0/3 Formatcompatibility–Protected

Table 4 Output description

Field	Description
Blocked Port	Name of a blocked port, which corresponds to the related MSTI.
Reason	Reason that the port was blocked: · ROOT-Protected—Root guard function. · LOOP-Protected—Loop guard function. · Formatcompatibility-Protected—MSTP BPDU format incompatibility protection function. · InconsistentPortType-Protected—Port type inconsistent protection function. · InconsistentPvid-Protected—PVID inconsistent protection function.

Field

Description

Blocked Port

Name of a blocked port, which corresponds to the related MSTI.

Reason

Reason that the port was blocked:

· ROOT-Protected—Root guard function.

· LOOP-Protected—Loop guard function.

· Formatcompatibility-Protected—MSTP BPDU format incompatibility protection function.

· InconsistentPortType-Protected—Port type inconsistent protection function.

· InconsistentPvid-Protected—PVID inconsistent protection function.

display stp bpdu-statistics

Syntax

display stp bpdu-statistics [ interface interface-type interface-number [ instance instance-id ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface interface-type interface-number: Displays the BPDU statistics on a port specified by port type and number.

instance instance-id: Displays the BPDU statistics of an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp bpdu-statistics command to display the BPDU statistics on ports.

In MSTP mode, follow these guidelines:

· If you do not specify any MSTI or port, this command displays the BPDU statistics of all MSTIs on all ports. The displayed information is sorted by port name and by MSTI ID on each port.

· If you specify a port but not an MSTI, this command displays the BPDU statistics of all MSTIs on the port. The displayed information is sorted by MSTI ID.

· If you specify both an MSTI ID and a port, this command displays the BPDU statistics of the specified MSTI on the port.

In STP, RSTP, or PVST mode, follow these guidelines:

· If you do not specify any port, this command displays the BPDU statistics of on all ports. The displayed information is sorted by port name.

· If you specify a port, this command displays the BPDU statistics on the port.

Examples

# In MSTP mode, display the BPDU statistics of all MSTIs on GigabitEthernet 3/0/1.

<Sysname> display stp bpdu-statistics interface gigabitethernet 3/0/1

Port: GigabitEthernet 3/0/1

Instance-independent:

Type Count Last Updated

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

Invalid BPDUs 0

Looped-back BPDUs 0

MAX-aged BPDUs 0

TCN sent 0

TCN received 0

TCA sent 0

TCA received 2 10:33:12 01/13/2010

Config sent 0

Config received 0

RST sent 0

RST received 0

MST sent 4 10:33:11 01/13/2010

MST received 151 10:37:43 01/13/2010

Instance 0:

Type Count Last Updated

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

Timeout BPDUs 0

MAX-hoped BPDUs 0

TC detected 1 10:32:40 01/13/2010

TC sent 3 10:33:11 01/13/2010

TC received 0

Instance 1:

Type Count Last Updated

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

Timeout BPDUs 0

MAX-hoped BPDUs 0

TC detected 0

TC sent 0

TC received 0

Instance 2:

Type Count Last Updated

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

Timeout BPDUs 0

MAX-hoped BPDUs 0

TC detected 0

TC sent 0

TC received 0

Table 5 Output description

Field	Description
Port	Port name.
Instance-independent	Statistics not related to any particular MSTI.
Type	Statistical item.
Looped-back BPDUs	BPDUs sent and then received by the same port.
Max-Aged BPDUs	BPDUs whose max age was exceeded.
TCN Sent	TCN BPDUs sent.
TCN Received	TCN BPDUs received.
TCA Sent	TCA BPDUs sent.
TCA Received	TCA BPDUs received.
Config Sent	Configuration BPDUs sent.
Config Received	Configuration BPDUs received.
RST Sent	RSTP BPDUs sent.
RST Received	RSTP BPDUs received.
MST Sent	MSTP BPDUs sent.
MST Received	MSTP BPDUs received.
Instance	Statistical information for a particular MSTI.
Timeout BPDUs	Expired BPDUs.
Max-Hoped BPDUs	BPDUs whose maximum hops were exceeded.
TC Detected	TC BPDUs detected.
TC Sent	TC BPDUs sent.
TC Received	TC BPDUs received.

display stp down-port

Syntax

display stp down-port [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp down-port command to display information about ports shut down by spanning tree protection functions.

Examples

# Display information about ports shut down by spanning tree protection functions.

<Sysname> display stp down-port

Down Port Reason

GigabitEthernet3/0/1 BPDU-Protected

GigabitEthernet3/0/2 Formatfrequency-Protected

Table 6 Output description

Field	Description
Down Port	Name of a port shut down by the spanning tree protection functions.
Reason	Reason that the port was shut down: · BPDU-Protected—BPDU guard function. · Formatfrequency-Protected—MSTP BPDU format frequent change protection function.

Field

Description

Down Port

Name of a port shut down by the spanning tree protection functions.

Reason

Reason that the port was shut down:

· BPDU-Protected—BPDU guard function.

· Formatfrequency-Protected—MSTP BPDU format frequent change protection function.

display stp history

Syntax

In standalone mode:

display stp [ instance instance-id | vlan vlan-id ] history [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

In IRF mode:

display stp [ instance instance-id | vlan vlan-id ] history [ chassis chassis-number slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

0: Visit level

Parameters

instance instance-id: Displays the historical port role calculation information of an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

vlan vlan-id: Displays the historical port role calculation information of a VLAN specified by vlan-id. The value of vlan-id ranges from 1 to 4094.

slot slot-number: Displays the historical port role calculation information on the specified card. The slot-number argument represents the number of the slot that houses the card. Use this option when your switch is operating in standalone mode. If this option is not specified, this command displays the historical port role calculation information on all the cards. (in standalone mode)

chassis chassis-number slot slot-number: Displays the historical port role calculation information on the specified card of the specified IRF member switch. The chassis-number argument represents the ID of the IRF member switch. The slot-number argument represents the number of the slot that houses the card, which can be displayed with the display device command. Use this option when your switch is operating in IRF mode. If this option is not specified, this command displays the historical port role calculation information on all cards of all member switches in the IRF fabric. (in IRF mode)

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp history command to display the historical port role calculation information of the specified MSTI or all MSTIs.

In STP/RSTP mode, the displayed information is sorted by port role calculation time.

In MSTP mode, follow these guidelines:

· If you do not specify any MSTI, this command displays the historical port role calculation information of all MSTIs. The displayed information is sorted by MSTI ID and by port role calculation time in each MSTI.

· If you specify an MSTI, this command displays the historical port role calculation information of the specified MSTI by the sequence of port role calculation time.

In PVST mode, follow these guidelines:

· If you do not specify any VLAN, this command displays the historical port role calculation information of all VLANs. The displayed information is sorted by VLAN ID, and by port role calculation time in each VLAN.

· If you specify a VLAN, this command displays the historical port role calculation information of the specified VLAN by the sequence of port role calculation time.

Examples

# In MSTP mode, display the historical port role calculation information of the card on slot 1 in MSTI 2.

<Sysname> display stp instance 2 history slot 1

--------------- STP slot 1 history trace ---------------

------------------- Instance 2 ---------------------

Port GigabitEthernet3/0/1

Role change : ROOT->DESI (Aged)

Time : 2009/02/08 00:22:56

Port priority : 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.1

Port GigabitEthernet3/0/2

Role change : ALTER->ROOT

Time : 2009/02/08 00:22:56

Port priority : 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.2

Table 7 Output description

Field	Description
Port	Port name.
Role change	A role change of the port (“Age” means that the change was caused by expiration of the received configuration BPDU).
Time	Time of port role calculation.
Port priority	Port priority.

display stp ignored-vlan

Syntax

display stp ignored-vlan [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp ignored-vlan command to display VLAN Ignore-enabled VLANs.

Examples

# Display VLAN Ignore-enabled VLANs.

<Sysname> display stp ignored-vlan

STP-Ignored VLAN: 1 to 2

Table 8 Output description

Field	Description
STP-Ignored VLAN	List of VLAN Ignore-enabled VLANs. A value of NONE for this field indicates that no VLAN is enabled with the VLAN Ignore feature.

display stp region-configuration

Syntax

display stp region-configuration [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp region-configuration command to display effective configuration information of the MST region, including the region name, revision level, and user-configured VLAN-to-instance mappings.

Related commands: instance, region-name, revision-level, and vlan-mapping modulo.

Examples

# In MSTP mode, display effective MST region configuration information.

<Sysname> display stp region-configuration

Oper Configuration

Format selector :0

Region name :hello

Revision level :0

Configuration digest :0x5f762d9a46311effb7a488a3267fca9f

Instance Vlans Mapped

0 21 to 4094

1 1 to 10

2 11 to 20

# In PVST mode, display the effective MST region configuration information.

<Sysname> system-view

[Sysname] stp mode pvst

[Sysname] display stp region-configuration

Oper Configuration

Format selector :0

Region name :hello

Revision level :0

Configuration digest :0x5f762d9a46311effb7a488a3267fca9f

Instance Mode Vlans Mapped

0 default 3 to 4094

1 static 1

2 dynamic 2

Table 9 Output description

Field	Description
Format selector	Format selector defined by the spanning tree protocol.
Region name	MST region name.
Revision level	Revision level of the MST region, which can be configured by using the revision-level command.
Mode	The MSTI mode: · Default—The default instance MSTI 0. In PVST mode, the spanning tree feature is disabled. · Static—The static MSTI. · Dynamic—The dynamically assigned MSTI, which only exists in PVST mode.

display stp root

Syntax

display stp root [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp root command to display the root bridge information of all MSTIs.

Examples

# In MSTP mode, display the root bridge information of all spanning trees.

<Sysname> display stp root

MSTID Root Bridge ID ExtPathCost IntPathCost Root Port

0 0.00e0-fc0e-6554 200200 0 GigabitEthernet3/0/6

Table 10 Output description

Field	Description
ExtPathCost	External path cost. The switch automatically calculates the default path cost of a port, or alternatively, you can use the stp cost command to configure the path cost of a port.
IntPathCost	Internal path cost. The switch automatically calculates the default path cost of a port, or alternatively, you can use the stp cost command to configure the path cost of a port.
Root Port	Root port name (displayed only if a port of the switch is the root port of MSTIs).

display stp tc

Syntax

In standalone mode:

display stp [ instance instance-id | vlan vlan-id ] tc [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

In IRF mode:

display stp [ instance instance-id | vlan vlan-id ] tc [ chassis chassis-number slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

0: Visit level

Parameters

instance instance-id: Displays the statistics of TC/TCN BPDUs received and sent by all ports in an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

vlan vlan-id: Displays the statistics of TC/TCN BPDUs received and sent by all ports in a VLAN specified by vlan-id. The value of vlan-id ranges from 1 to 4094.

slot slot-number: Displays the statistics of TC/TCN BPDUs received and sent by all ports on the specified card. The slot-number argument represents the number of the slot that houses the card. Use this option when your switch is operating in standalone mode. If this option is not specified, this command displays the statistics of TC/TCN BPDUs received and sent by all ports on the MPU. (in standalone mode)

chassis chassis-number slot slot-number: Displays the statistics of TC/TCN BPDUs received and sent by all ports on the specified card of the specified IRF member switch. The chassis-number argument represents the ID of the IRF member switch. The slot-number argument represents the number of the slot that houses the card, which can be displayed with the display device command. Use this option when your switch is operating in IRF mode. If this option is not specified, this command displays the statistics of TC/TCN BPDUs received and sent by all ports on all cards of all member switches in the IRF fabric. (in IRF mode)

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display stp tc command to display the statistics of TC/TCN BPDUs received and sent by all ports in an MSTI or all MSTIs.

In STP/RSTP mode, the displayed information is sorted by port name.

In MSTP mode, follow these guidelines:

· If you do not specify any MSTI, this command displays the statistics of TC/TCN BPDUs received and sent by all ports in all MSTIs. The displayed information is sorted by instance ID and by port name in each MSTI.

· If you specify an MSTI, this command displays the statistics of TC/TCN BPDUs received and sent by all ports in the specified MSTI, in port name order.

In PVST mode, follow these guidelines:

· If you do not specify any VLAN, this command displays the statistics of TC/TCN BPDUs received and sent by all ports in all VLANs. The displayed information is sorted by VLAN ID and by port name in each VLAN.

· If you specify a VLAN, this command displays the statistics of TC/TCN BPDUs received and sent by all ports in the specified VLAN, in port name order.

Examples

# In MSTP mode, display the statistics of TC/TCN BPDUs received and sent by all ports in MSTI 0.

<Sysname> display stp instance 0 tc

-------------- STP slot 3 TC or TCN count -------------

MSTID Port Receive Send

0 GigabitEthernet3/0/1 6 4

0 GigabitEthernet3/0/2 0 2

Table 11 Output description

Field	Description
Port	Port name.
Receive	Number of TC/TCN BPDUs received on each port.
Send	Number of TC/TCN BPDUs sent by each port.

instance

Syntax

instance instance-id vlan vlan-list

undo instance instance-id [ vlan vlan-list ]

View

MST region view

Default level

2: System level

Parameters

instance-id: Specifies an MSTI ID. The value ranges from 0 to 47, where 0 represents the CIST.

vlan vlan-list: Specifies a VLAN list in the format of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where the vlan-id argument represents the VLAN ID ranging from 1 to 4094, and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges.

Description

Use the instance command to map a list of VLANs to the specified MSTI.

Use the undo instance command to remap the specified VLAN or all VLANs to the CIST (MSTI 0).

By default, all VLANs are mapped to the CIST.

If you specify no VLAN in the undo instance command, all VLANs mapped to the specified MSTI will be remapped to the CIST.

You cannot map the same VLAN to different MSTIs. If you map a VLAN that has been mapped to an MSTI to a new MSTI, the old mapping will be automatically removed.

In PVST mode, you can map multiple VLANs to the CIST, and only one VLAN to each remaining MSTI.

After configuring this command, run the active region-configuration command to activate the VLAN-to-instance mapping.

Related commands: display stp region-configuration, check region-configuration, and active region-configuration.

Examples

# Map VLAN 2 to MSTI 1.

<Sysname> system-view

[Sysname] stp region-configuration

[Sysname-mst-region] instance 1 vlan 2

region-name

Syntax

region-name name

undo region-name

View

MST region view

Default level

2: System level

Parameters

name: Specifies the MST region name, a string of 1 to 32 characters.

Description

Use the region-name command to configure the MST region name.

Use the undo region-name command to restore the default MST region name.

By default, the MST region name of the switch is its MAC address.

The MST region name, the VLAN-to-instance mapping table, and the MSTP revision level of a switch determine the switch's MST region.

After configuring this command, run the active region-configuration command to activate the configured MST region name.

Related commands: instance, revision-level, vlan-mapping modulo, display stp region-configuration, check region-configuration, and active region-configuration.

Examples

# Set the MST region name of the switch to hello.

<Sysname> system-view

[Sysname] stp region-configuration

[Sysname-mst-region] region-name hello

reset stp

Syntax

reset stp [ interface interface-list ]

View

User view

Default level

1: Monitor level

Parameters

interface interface-list: Clears the MSTP statistics of the ports specified in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] }&<1-10>, where &<1-10> indicates that you can specify up to 10 ports or port ranges. If this option is not specified, the command clears the spanning tree-related statistics on all ports.

Description

Use the reset stp command to clear the MSTP statistics.

The MSTP statistics includes the numbers of TCN BPDUs, configuration BPDUs, RST BPDUs and MST BPDUs sent/received through the specified ports.

Related commands: display stp.

Examples

# Clear the spanning tree-related statistics on ports GigabitEthernet 4/0/1 through GigabitEthernet 4/0/3.

<Sysname> reset stp interface gigabitethernet 4/0/1 to gigabitethernet 4/0/3

revision-level

Syntax

revision-level level

undo revision-level

View

MST region view

Default level

2: System level

Parameters

level: Specifies an MSTP revision level, ranging from 0 to 65535.

Description

Use the revision-level command to configure the MSTP revision level.

Use the undo revision-level command to restore the default MSTP revision level.

By default, the MSTP revision level is 0.

The MSTP revision level, the MST region name, and the VLAN-to-instance mapping table of a switch determine the switch's MST region. When the MST region name and VLAN-to-instance mapping table are both the same for two MST regions, they can still be differentiated by their MSTP revision levels.

After configuring this command, run the active region-configuration command to activate the configured MST region level.

Related commands: instance, region-name, vlan-mapping modulo, display stp region-configuration, check region-configuration, and active region-configuration.

Examples

# Set the MSTP revision level of the MST region to 5.

<Sysname> system-view

[Sysname] stp region-configuration

[Sysname-mst-region] revision-level 5

stp bpdu-protection

Syntax

stp bpdu-protection

undo stp bpdu-protection

View

System view

Default level

2: System level

Parameters

None

Description

Use the stp bpdu-protection command to enable the BPDU guard function.

Use the undo stp bpdu-protection command to disable the BPDU guard function.

By default, the BPDU guard function is disabled.

Examples

# Enable the BPDU guard function.

<Sysname> system-view

[Sysname] stp bpdu-protection

stp bridge-diameter

Syntax

stp [ vlan vlan-list ] bridge-diameter diameter

undo stp [ vlan vlan-list ] bridge-diameter

View

System view

Default level

2: System level

Parameters

diameter: Specifies the switched network diameter, ranging from 2 to 7.

Description

Use the stp bridge-diameter command to specify the network diameter, the maximum possible number of stations between any two terminal devices on the switched network.

Use the undo stp bridge-diameter command to restore the default.

By default, the network diameter of the switched network is 7.

An appropriate setting of hello time, forward delay, and max age can speed up network convergence. The values of these timers are related to the network size and you can set the timers by setting the network diameter. With the network diameter set to 7 (the default), the three timers will be set to their defaults.

To set the network diameter of an STP/RSTP/MSTP switched network, use this command without specifying any VLAN. To set the network diameter of a specified VLAN or multiple VLANs in a PVST switched network, use this command with a VLAN list specified.

In STP, RSTP, or MSTP mode, each MST region is considered as a network device, and the configured network diameter of the switched network is only effective for the CIST (or the common root bridge), not for MSTIs.

In PVST mode, the network diameter configuration takes effect only on the root bridge.

Related commands: stp timer forward-delay, stp timer hello, and stp timer max-age.

Examples

# Set the network diameter of the switched network to 5.

<Sysname> system-view

[Sysname] stp bridge-diameter 5

stp compliance

Syntax

stp compliance { auto | dot1s | legacy }

undo stp compliance

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

auto: Configures the ports to recognize the MSTP BPDU format automatically and determine the format of MSTP BPDUs to send.

dot1s: Configures the ports to receive and send only standard-format (802.1s-compliant) MSTP BPDUs.

legacy: Configures the ports to receive and send only compatible-format MSTP BPDUs.

Description

Use the stp compliance command to configure the mode the specified ports will use to recognize and send MSTP BPDUs.

Use the undo stp compliance command to restore the default.

By default, a port automatically recognizes the formats of received MSTP packets and determines the formats of MSTP packets to be sent based on the recognized formats.

Configured in Ethernet interface view, the setting takes effect on the interface only. Configured in port group view, the setting takes effect on all ports in the port group. Configured in Layer 2 aggregate interface view, the setting takes effect only on the aggregate interface. Configured on a member port in an aggregation group, the setting takes effect only after the port leaves the aggregation group. For more information about Ethernet link aggregation, see Layer 2—LAN Switching Configuration Guide.

Examples

# Configure GigabitEthernet 4/0/1 to receive and send only standard-format (802.1s) MSTP packets.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp compliance dot1s

stp config-digest-snooping

Syntax

stp config-digest-snooping

undo stp config-digest-snooping

View

System view, Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

None

Description

Use the stp config-digest-snooping command to enable Digest Snooping.

Use the undo stp config-digest-snooping command to disable Digest Snooping.

The feature is disabled by default.

Enable this feature both globally and on ports connected to other vendors' devices to make it effective. To minimize impact, enable the feature on all associated ports before you enable it globally, and disable the feature globally before you disable it on each associated port.

Configured in system view, the setting takes effect globally. Configured in Ethernet interface view, the setting takes effect on the interface only. Configured in port group view, the setting takes effect on all ports in the port group. Configured in Layer 2 aggregate interface view, the setting takes effect only on the aggregate interface. Configured on a member port in an aggregation group, the setting takes effect only after the port leaves the aggregation group. For more information about Ethernet link aggregation, see Layer 2—LAN Switching Configuration Guide.

Related commands: display stp.

Examples

# Enable Digest Snooping on GigabitEthernet 3/0/1 and then globally.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/0/1

[Sysname-GigabitEthernet3/0/1] stp config-digest-snooping

[Sysname-GigabitEthernet3/0/1] quit

[Sysname] stp config-digest-snooping

stp cost

Syntax

stp [ instance instance-id | vlan vlan-list ] cost cost

undo stp [ instance instance-id | vlan vlan-list ] cost

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

instance instance-id: Sets the path cost of the ports in an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

cost: Specifies the path cost of the port, with an effective range that depends on the path cost calculation standard adopted.

· With the IEEE 802.1d-1998 standard selected for path cost calculation, the cost argument ranges from 1 to 65,535.

· With the IEEE 802.1t standard selected for path cost calculation, the cost argument ranges from 1 to 200,000,000.

· With the private standard selected for path cost calculation, the cost argument ranges from 1 to 200,000.

Description

Use the stp cost command to set the path cost of the port or ports.

Use the undo stp cost command to restore the default.

By default, the switch automatically calculates the path costs of ports in each spanning tree based on the corresponding standard.

To set the path cost of an MSTP port in a specific MSTI, use this command with the MSTI specified. To set the path cost of a PVST port in a specific VLAN, use this command with the VLAN specified. To set the path cost of an MSTP port in the CIST or an STP/RSTP port, use this command without specifying any MSTI or VLAN.

Path cost is an important factor in spanning tree calculation. Setting different path costs for a port in MSTIs allows VLAN traffic flows to be forwarded along different physical links, achieving VLAN-based load balancing.

The path cost setting of a port can affect the role selection of the port. When the path cost of a port is changed, the system will re-calculate the role of the port and initiate a state transition.

Related commands: display stp.

Examples

# In MSTP mode, set the path cost of port GigabitEthernet 4/0/1 in MSTI 2 to 200.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp instance 2 cost 200

stp edged-port

Syntax

stp edged-port { enable | disable }

undo stp edged-port

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

enable: Configures the ports as edge ports.

disable: Configures the ports as non-edge ports.

Description

Use the stp edged-port enable command to configure Ethernet ports as edge ports.

Use the stp edged-port disable command to configure the ports as non-edge ports.

Use the undo stp edged-port command to restore the default.

By default, all ports are non-edge ports.

If a port directly connects to a user terminal rather than another device or a shared LAN segment, this port is regarded as an edge port. When the network topology changes, an edge port will not cause a temporary loop. You can enable the port to transition to the forwarding state rapidly by configuring it as an edge port. H3C recommends you to configure ports directly connecting to user terminals as edge ports.

Configuration BPDUs from other devices usually cannot reach an edge port, because the edge port does not connect to any other device. If a port receives a configuration BPDU when the BPDU guard function is disabled, the port functions as a non-edge port, even if you configure it as an edge port.

On a port, the loop guard function and the edge port settings are mutually exclusive.

Related commands: stp loop-protection.

Examples

# Configure GigabitEthernet 4/0/1 as an edge port.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp edged-port enable

stp enable

Syntax

In system view:

stp [ vlan vlan-list ] enable

undo stp [ vlan vlan-list ] enable

In Ethernet interface, Layer 2 aggregate interface, or port group view:

stp enable

undo stp enable

View

System view, Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

vlan vlan-list: Enables or disables the spanning tree feature for a VLAN list specified in the format of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where the vlan-id argument represents the VLAN ID ranging from 1 to 4094, and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges. If this option is not specified, this command enables or disables the spanning tree feature globally rather than for VLANs.

Description

Use the stp enable command to enable the spanning tree feature globally.

Use the undo stp enable command to disable the spanning tree feature.

By default, the spanning tree feature is enabled globally, in all VLANs, and on all ports.

When you enable the spanning tree feature, the switch works in STP, RSTP, MSTP, or PVST mode, depending on the spanning tree mode setting.

When the spanning tree feature is enabled, the switch dynamically maintains the spanning tree status of VLANs based on received configuration BPDUs. When the spanning tree feature is disabled, the switch stops maintaining the spanning tree status.

Related commands: stp mode.

Examples

# Globally enable the spanning tree feature.

<Sysname> system-view

[Sysname] stp enable

# In PVST mode, enable the spanning tree feature globally and in VLAN 2.

<Sysname> system-view

[Sysname] stp mode pvst

[Sysname] stp enable

[Sysname] stp vlan 2 enable

# In MSTP mode, disable the spanning tree feature on port GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] undo stp enable

stp ignored vlan

Syntax

stp ignored vlan vlan-list

undo stp ignored vlan vlan-list

View

System view

Default level

2: System level

Parameters

vlan vlan-list: Specifies a VLAN list in the format of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where the vlan-id argument represents the VLAN ID ranging from 1 to 4094, and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges.

Description

Use the stp ignored vlan command to enable VLAN Ignore for the specified VLANs.

Use the undo stp ignored vlan command to disable VLAN Ignore for the specified VLANs.

By default, VLAN Ignore is disabled for a VLAN.

Related commands: display stp ignored-vlan.

Examples

# Enable VLAN Ignore for VLAN 2.

<Sysname> system-view

[Sysname] stp ignored vlan 2

# Enable VLAN Ignore for VLAN 1 through VLAN 10.

<Sysname> system-view

[Sysname] stp ignored vlan 1 to 10

stp loop-protection

Syntax

stp loop-protection

undo stp loop-protection

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

None

Description

Use the stp loop-protection command to enable the loop guard function on the ports.

Use the undo stp loop-protection command to disable the loop guard function on the ports.

By default, the loop guard function is disabled.

On a port, the loop guard function is mutually exclusive with the edge port settings or the root guard function.

Related commands: stp edged-port and stp root-protection.

Examples

# Enable the loop guard function on GigabitEthernet 4/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp loop-protection

stp max-hops

Syntax

stp max-hops hops

undo stp max-hops

View

System view

Default level

2: System level

Parameters

hops: Sets the maximum hops, ranging from 1 to 40.

Description

Use the stp max-hops command to set the maximum hops of the MST region.

Use the undo stp max-hops command to restore the default.

By default, the maximum number of hops of an MST region is 20.

The maximum hops limit the size of the MST region.

Related commands: display stp.

Examples

# Set the maximum hops of the MST region to 35.

<Sysname> system-view

[Sysname] stp max-hops 35

stp mcheck

Syntax

stp mcheck

View

System view, Ethernet interface view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

None

Description

Use the stp mcheck command to perform the mCheck operation globally or on a port.

If a port on a device that runs MSTP, RSTP, or PVST mode connects to an STP device, the port will automatically transition to the STP mode. It cannot automatically transition back to the original mode when:

· The STP device is shut down or removed.

· The STP device transitions to the MSTP, RSTP, or PVST mode.

Then, you can perform an mCheck operation to forcibly transition the port to operation in the original mode.

The device works in STP, RSTP, MSTP, or PVST mode depending on the spanning tree mode setting.

The stp mcheck command is effective only when the device works in MSTP, RSTP, or PVST mode.

Configured in system view, the setting takes effect globally. Configured in Ethernet interface view, the setting takes effect only on the interface. Configured in Layer 2 aggregate interface view, the setting takes effect only on the aggregate interface. Configured on a member port in an aggregation group, the setting takes effect only after the port leaves the aggregation group.

Related commands: stp mode.

Examples

# Perform mCheck on GigabitEthernet 4/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp mcheck

stp mode

Syntax

stp mode { mstp | pvst | rstp | stp }

undo stp mode

View

System view

Default level

2: System level

Parameters

mstp: Configures the spanning tree switch to work in MSTP mode.

pvst: Configures the spanning tree switch to work in PVST mode.

rstp: Configures the spanning tree switch to work in RSTP mode.

stp: Configures the spanning tree switch to work in STP mode.

Description

Use the stp mode command to configure the spanning tree work mode.

Use the undo stp mode command to restore the default.

By default, a spanning tree switch works in MSTP mode.

MSTP mode is compatible with RSTP mode, RSTP mode is compatible with STP mode, and PVST mode is incompatible with any other mode.

Related commands: stp mcheck and stp enable.

Examples

# Configure the spanning tree switch to work in STP mode.

<Sysname> system-view

[Sysname] stp mode stp

stp no-agreement-check

Syntax

stp no-agreement-check

undo stp no-agreement-check

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

None

Description

Use the stp no-agreement-check command to enable No Agreement Check on the ports.

Use the undo stp no-agreement-check command to disable No Agreement Check on the ports.

By default, No Agreement Check is disabled.

This feature takes effect only after you enable it on the root port.

Examples

# Enable No Agreement Check on GigabitEthernet 4/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp no-agreement-check

stp pathcost-standard

Syntax

stp pathcost-standard { dot1d-1998 | dot1t | legacy }

undo stp pathcost-standard

View

System view

Default level

2: System level

Parameters

dot1d-1998: Configures the switch to calculate the default path cost for ports based on IEEE 802.1d-1998.

dot1t: Configures the switch to calculate the default path cost for ports based on IEEE 802.1t.

legacy: Configures the switch to calculate the default path cost for ports based on a private standard.

Description

Use the stp pathcost-standard command to specify a standard for the switch to use when calculating the default path costs for ports.

Use the undo stp pathcost-standard command to restore the default.

By default, the switch calculates the default path cost for ports based on a private standard.

If you change the standard that the switch uses in calculating the default path costs, you restore the path costs to the default.

Related commands: stp cost and display stp.

Examples

# Configure the switch to calculate the default path cost for ports based on IEEE 802.1d-1998.

<Sysname> system-view

[Sysname] stp pathcost-standard dot1d-1998

stp point-to-point

Syntax

stp point-to-point { auto | force-false | force-true }

undo stp point-to-point

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

auto: Specifies automatic detection of the link type.

force-false: Specifies the non-point-to-point link type.

force-true: Specifies the point-to-point link type.

Description

Use the stp point-to-point command to configure the link type of the ports.

Use the undo stp point-to-point command to restore the default.

By default, the setting is auto and the switch automatically detects whether a port connects to a point-to-point link.

When connecting to a non-point-to-point link, a port is incapable of rapid state transition.

You can configure the link type as point-to-point for a Layer 2 aggregate interface or a port that works in full duplex mode. H3C recommends that you use the default setting to let the switch automatically detect the port link type.

The stp point-to-point force-false or stp point-to-point force-true command configured on a port in MSTP or PVST mode is effective for all MSTIs or VLANs.

If the physical link to which the port connects is not a point-to-point link but you set it to be one, your configuration may bring a temporary loop.

Related commands: display stp.

Examples

# Configure the link connecting GigabitEthernet 4/0/1 as a point-to-point link.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp point-to-point force-true

stp port priority

Syntax

stp [ instance instance-id | vlan vlan-list ] port priority priority

undo stp [ instance instance-id | vlan vlan-list ] port priority

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

instance instance-id: Sets the priority of the ports in an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

priority: Specifies a port priority, ranging from 0 to 240 in steps of 16 (as in 0, 16, 32).

Description

Use the stp port priority command to set the priority of ports.

Use the undo stp port priority command to restore the default.

By default, the port priority is 128.

To set the priority of an MSTP port in a specific MSTI, use this command with the MSTI specified. To set the priority of a PVST port in a specific VLAN or multiple VLANs, use this command with a VLAN list specified. To set the priority of an MSTP port in the CIST or an STP/RSTP port, use this command without specifying any MSTI or VLAN.

Port priority affects the role of a port in a spanning tree.

The smaller the value, the higher the port priority. If all ports on your switch use the same priority value, the port priority depends on the port index. The smaller the index, the higher the priority.

Related commands: display stp.

Examples

# In MSTP mode, set the priority of port GigabitEthernet 4/0/1 to 16 in MSTI 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp instance 2 port priority 16

stp priority

Syntax

stp [ instance instance-id | vlan vlan-list ] priority priority

undo stp [ instance instance-id | vlan vlan-list ] priority

View

System view

Default level

2: System level

Parameters

instance instance-id: Sets the priority of the switch in an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

priority: Specifies a switch priority, ranging from 0 to 61440 in steps of 4096 (as in 0, 4096, 8192). You can set up to 16 priority values on the switch. The smaller the value, the higher the switch priority.

Description

Use the stp priority command to set the switch priority.

Use the undo stp priority command to restore the default priority.

By default, the switch priority is 32768.

To set the priority of an MSTP switch in a specific MSTI, use this command with the MSTI specified. To set the priority of a PVST switch in a specific VLAN or multiple VLANs, use this command with a VLAN list specified. To set the priority of an MSTP switch in the CIST or an STP/RSTP switch, use this command without specifying any MSTI or VLAN.

Examples

# Set the switch priority to 4096 in MSTI 1.

<Sysname> system-view

[Sysname] stp instance 1 priority 4096

stp region-configuration

Syntax

stp region-configuration

undo stp region-configuration

View

System view

Default level

2: System level

Parameters

None

Description

Use the stp region-configuration command to enter MST region view.

Use the undo stp region-configuration command to restore the default MST region configurations.

These are the default settings for the MST region:

· The MST region name of the switch is the MAC address of the switch.

· All VLANs are mapped to the CIST.

· The MSTP revision level is 0.

After you enter MST region view, you can configure the MST region-related parameters, including the region name, VLAN-to-instance mappings, and revision level.

Examples

# Enter MST region view.

<Sysname> system-view

[Sysname] stp region-configuration

[Sysname-mst-region]

stp root primary

Syntax

stp [ instance instance-id | vlan vlan-list ] root primary

undo stp [ instance instance-id | vlan vlan-list ] root

View

System view

Default level

2: System level

Parameters

instance instance-id: Configures the switch as the root bridge in an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

Description

Use the stp root primary command to configure the switch as the root bridge.

Use the undo stp root command to restore the default.

By default, the switch is not a root bridge.

To set an MSTP switch as the root bridge in a specific MSTI, use this command with the MSTI specified. To set a PVST switch as the root bridge in a specific VLAN or multiple VLANs, use this command with a VLAN list specified. To set an MSTP switch in the CIST or an STP/RSTP switch as the root bridge, use this command without specifying any MSTI or VLAN.

Once you specify the switch as the root bridge, you cannot change the switch priority.

Related commands: stp priority and stp root secondary.

Examples

# In MSTP mode, specify the switch as the root bridge of MSTI 1.

<Sysname> system-view

[Sysname] stp instance 1 root primary

stp root secondary

Syntax

stp [ instance instance-id | vlan vlan-list ] root secondary

undo stp [ instance instance-id | vlan vlan-list ] root

View

System view

Default level

2: System level

Parameters

instance instance-id: Configures the switch as a secondary root bridge in an MSTI specified by instance-id. The value of instance-id ranges from 0 to 47, where 0 represents the CIST.

Description

Use the stp root secondary command to configure the switch as a secondary root bridge.

Use the undo stp root command to restore the default.

By default, the switch is not a secondary root bridge.

To set an MSTP switch as a secondary root bridge in a specific MSTI, use this command with the MSTI specified. To set a PVST switch as a secondary bridge in a specific VLAN or multiple VLANs, use this command with a VLAN list specified. To set an MSTP switch in the CIST or an STP/RSTP switch as a secondary root bridge, use this command without specifying any MSTI or VLAN.

Once you specify the switch as a secondary root bridge, you cannot change the switch priority.

Related commands: stp priority and stp root primary.

Examples

# In MSTP mode, specify the switch as a secondary root bridge in MSTI 0.

<Sysname> system-view

[Sysname] stp instance 0 root secondary

stp root-protection

Syntax

stp root-protection

undo stp root-protection

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

None

Description

Use the stp root-protection command to enable the root guard function on the ports.

Use the undo stp root-protection command to disable the root guard function on the ports.

By default, the root guard function is disabled.

On a port, the loop guard function and the root guard function are mutually exclusive.

Related commands: stp loop-protection.

Examples

# Enable the root guard function for GigabitEthernet 4/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp root-protection

stp tc-protection

Syntax

stp tc-protection enable

stp tc-protection disable

View

System view

Default level

2: System level

Parameters

None

Description

Use the stp tc-protection enable command to enable the TC-BPDU attack guard function for the switch.

Use the stp tc-protection disable command to disable the TC-BPDU attack guard function for the switch.

By default, the TC-BPDU attack guard function is enabled.

With the TC-BPDU guard function, you can set the maximum number of immediate forwarding address entry flushes that the device can perform every a certain period of time (10 seconds). For TC-BPDUs received in excess of the limit, the device performs a forwarding address entry flush when the time period expires. This prevents frequent flushing of forwarding address entries.

Related commands: stp tc-protection threshold.

Examples

# Enable the TC-BPDU attack guard function for the switch.

<Sysname> system-view

[Sysname] stp tc-protection enable

stp tc-protection threshold

Syntax

stp tc-protection threshold number

undo stp tc-protection threshold

View

System view

Default level

2: System level

Parameters

number: Sets the maximum number of immediate forwarding address entry flushes that the switch can perform every a certain period of time (10 seconds). The argument ranges from 1 to 255.

Description

Use the stp tc-protection threshold command to configure the maximum number of forwarding address entry flushes that the switch can perform every a certain period of time (10 seconds).

Use the undo stp tc-protection threshold command to restore the default.

By default, the switch can perform a maximum of six forwarding address entry flushes every 10 seconds.

Related commands: stp tc-protection.

Examples

# Configure the switch to perform up to 10 forwarding address entry flushes every 10 seconds.

<Sysname> system-view

[Sysname] stp tc-protection threshold 10

stp tc-snooping

Syntax

stp tc-snooping

undo stp tc-snooping

View

System view

Default level

2: System level

Parameters

None

Description

Use the stp tc-snooping command to enable topology change (TC) snooping.

Use the undo stp tc-snooping command to disable TC snooping.

By default, TC snooping disabled.

TC snooping is supported on Ethernet interface cards only.

TC snooping and the spanning tree feature are mutually exclusive. Globally disable the spanning tree feature before you enable TC snooping.

TC snooping is ineffective on the ports on which BPDU tunneling is enabled for STP. For more information about BPDU tunneling, see Layer 2—LAN Switching Configuration Guide.

Related commands: stp enable.

Examples

# Globally disable the spanning tree feature and enable TC snooping.

<Sysname> system-view

[Sysname] undo stp enable

[Sysname] stp tc-snooping

stp timer forward-delay

Syntax

stp [ vlan vlan-list ] timer forward-delay time

undo stp [ vlan vlan-list ] timer forward-delay

View

System view

Default level

2: System level

Parameters

time: Sets the forward delay in centiseconds, ranging from 400 to 3000 in steps of 100 (as in 400, 500, 600).

Description

Use the stp timer forward-delay command to set the forward delay timer of the switch.

Use the undo stp timer forward-delay command to restore the default.

By default, the forward delay timer is 1500 centiseconds.

The forward delay timer determines the time interval of state transition. To prevent temporary loops, a spanning tree port goes through the learning (intermediate) state before it transitions from the discarding to the forwarding state. To stay synchronized with the remote device, the port has a wait period between transition states that is determined by the forward delay timer.

To set the forward delay in STP/RSTP/MSTP mode, use this command without any VLAN specified. To set the forward delay for a specific VLAN or multiple VLANs in PVST mode, use this command with a VLAN list specified.

H3C does not recommend you to set the forward delay with this command. Instead, you can specify the network diameter of the switched network by using the stp bridge-diameter command and let spanning tree protocols automatically calculate optimal settings of the forward delay timer. If the network diameter uses the default value, the forward delay timer also uses the default value.

Related commands: stp timer hello, stp timer max-age, and stp bridge-diameter.

Examples

# Set the forward delay timer to 2000 centiseconds.

<Sysname> system-view

[Sysname] stp timer forward-delay 2000

stp timer hello

Syntax

stp [ vlan vlan-list ] timer hello time

undo stp [ vlan vlan-list ] timer hello

View

System view

Default level

2: System level

Parameters

time: Sets the hello time in centiseconds, ranging from 100 to 1000 in steps of 100 (as in 100, 200, 300).

Description

Use the stp timer hello command to set the hello time of the switch.

Use the undo stp timer hello command to restore the default.

By default, the hello time is 200 centiseconds.

Hello time is the time interval at which spanning tree switches send configuration BPDUs to maintain spanning tree. If a switch fails to receive configuration BPDUs within the set period of time, a new spanning tree calculation process will be triggered due to timeout.

To set the hello time in STP/RSTP/MSTP mode, use this command without any VLAN specified. To set the hello time for a specific VLAN or multiple VLANs in PVST mode, use this command with a VLAN list specified.

H3C does not recommend you to set the hello time with this command. Instead, you can specify the network diameter of the switched network by using the stp bridge-diameter command and let spanning tree protocols automatically calculate optimal settings of the hello timer. If the network diameter uses the default value, the hello timer also uses the default value.

Related commands: stp timer forward-delay, stp timer max-age, and stp bridge-diameter.

Examples

# In MSTP mode, set the hello time to 400 centiseconds.

<Sysname> system-view

[Sysname] stp timer hello 400

# In PVST mode, set the hello time to 400 centiseconds for VLAN 400.

<Sysname> system-view

[Sysname] stp mode pvst

[Sysname] stp vlan 2 timer hello 400

stp timer max-age

Syntax

stp [ vlan vlan-list ] timer max-age time

undo stp [ vlan vlan-list ] timer max-age

View

System view

Default level

2: System level

Parameters

time: Sets the max age in centiseconds, ranging from 600 to 4000 in steps of 100 (as in 600, 700, 800).

Description

Use the stp timer max-age command to set the max age timer of the switch.

Use the undo stp timer max-age command to restore the default.

By default, the max age is 2000 centiseconds.

In the CIST of an MSTP network or each VLAN of a PVST network, the switch determines whether a configuration BPDU received on a port has expired, based on the max age timer. If yes, a new spanning tree calculation process starts. The max age timer is ineffective for MSTIs.

To set the max age timer in STP/RSTP/MSTP mode, use this command without any VLAN specified. To set the max age timer for a specific VLAN or multiple VLANs in PVST mode, use this command with a VLAN list specified.

H3C does not recommend you to set the max age timer with this command. Instead, you can specify the network diameter of the switched network by using the stp bridge-diameter command and let spanning tree protocols automatically calculate optimal settings of the max age timer. If the network diameter uses the default value, the max age timer also uses the default value.

Related commands: stp timer forward-delay, stp timer hello, and stp bridge-diameter.

Examples

# Set the max age timer to 1000 centiseconds.

<Sysname> system-view

[Sysname] stp timer max-age 1000

stp timer-factor

Syntax

stp timer-factor factor

undo stp timer-factor

View

System view

Default level

2: System level

Parameters

factor: Sets the timeout factor, ranging from 1 to 20.

Description

Use the stp timer-factor command to set the timeout factor, which decides the timeout time.

Timeout time = timeout factor × 3 × hello time.

Use the undo stp timer-factor command to restore the default.

By default, the timeout factor is 3.

After the network topology is stabilized, each non-root-bridge switch forwards configuration BPDUs to the surrounding devices at the interval of hello time to check whether any link is faulty. If a switch does not receive a BPDU from the upstream device within nine times the hello time, it will assume that the upstream device has failed and start a new spanning tree calculation process.

In a stable network, this kind of spanning tree calculation may occur because the upstream device is busy. You can avoid such unwanted spanning tree calculations by lengthening the timeout time, saving the network resources. H3C recommends you to set the timeout factor to 5, 6, or 7 for a stable network.

Related commands: stp timer hello.

Examples

# Set the timeout factor of the switch to 7.

<Sysname> system-view

[Sysname] stp timer-factor 7

stp transmit-limit

Syntax

stp transmit-limit limit

undo stp transmit-limit

View

Ethernet interface view, port group view, Layer 2 aggregate interface view

Default level

2: System level

Parameters

limit: Sets the maximum number of BPDUs the ports can send within each hello time, ranging from 1 to 255.

Description

Use the stp transmit-limit command to set the maximum transmission rate of the ports, which specifies the maximum number of BPDUs the ports can send within each hello time.

Use the undo stp transmit-limit command to restore the default.

By default, the maximum transmission rate of all ports is 10. Each port can send up to 10 BPDUs within each hello time.

A larger maximum transmission rate value requires more system resources. An appropriate maximum transmission rate setting can limit the speed at which a port sends BPDUs and prevent spanning tree protocols from using excessive bandwidth resources during network topology changes. H3C recommends you to use the default value.

Examples

# Set the maximum transmission rate of port GigabitEthernet 4/0/1 to 5.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] stp transmit-limit 5

vlan-mapping modulo

Syntax

vlan-mapping modulo modulo

View

MST region view

Default level

2: System level

Parameters

modulo: Sets the modulo value, ranging from 1 to 47.

Description

Use the vlan-mapping modulo command to map VLANs in the MST region to MSTIs according to the specified modulo value, quickly creating a VLAN-to-instance mapping table.

By default, all VLANs are mapped to the CIST (MSTI 0).

You cannot map the same VLAN to different MSTIs. If you map a VLAN that has been mapped to an MSTI to a new MSTI, the old mapping will be automatically removed.

This command maps each VLAN to the MSTI whose ID is (VLAN ID - 1) %modulo + 1, where (VLAN ID - 1) %modulo is the modulo operation for (VLAN ID - 1). If the modulo value is 15, for example, then VLAN 1 will be mapped to MSTI 1, VLAN 2 to MSTI 2, VLAN 15 to MSTI 15, VLAN 16 to MSTI 1, and so on.

Related commands: region-name, revision-level, display stp region-configuration, check region-configuration, and active region-configuration.

Examples

# Map VLANs to MSTIs as per modulo 8.

<Sysname> system-view

[Sysname] stp region-configuration

[Sysname-mst-region] vlan-mapping modulo 8

04-Layer 2 - LAN Switching Command Reference

active region-configuration

check region-configuration

display stp root

region-name

reset stp

revision-level

stp bpdu-protection

stp bridge-diameter

stp mcheck

stp mode

stp port priority

stp region-configuration

stp tc-protection threshold

stp timer hello

vlan-mapping modulo

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us