This command is used to display information about the state of Spanning Tree Protocol (STP) ports.

Syntax   stp-port-state-show

vlan vlan-id

Displays the VLAN identifier for the STP instance.

ports port-list

Displays STP ports.

stp-state Disabled|Discarding|Learning|Forwarding

Displays the forwarding state.

role Disabled|Root|Designated|

Displays the port role.

selected-role Disabled|Root|Designated|Alternate|

Displays the selected port role.

state new-info|proposing|proposed|agreed|agreed|learn|learning|forward|forwarding|reselect|selected|reroot|rcvd-bpdu|rcvd-msg|rcvd-tc|rcvd-tc-ack

Displays the port state machine state.

designated-priority designated-priority-string

Displays the designated priority vector.

port-priority port-priority-string ]

Displays the port priority vector.

message-priority message-priority-string

Displays the message priority vector.

info-is disabled|received|mine|aged

Displays the origin of the port information.

designated-times designated-times-string

Displays the designated times: age, max age, hello, forward delay

port-times port-times-string

Displays the port times: age, max age, hello, forward delay.

message-times message-times-string

Displays the message times: age, max age, hello, forward delay.

hello-timer hello-timer-number

Displays the hello time value.

topology-timer topology-timer-number

Displays the topology timer value.

forward-timer forward-timer-number

Displays the forward timer value.

rcvd-info-timer rcvd-info-timer-number

Displays the received info timer value.

recent-root-timer recent-root-timer-number

Displays the recent root timer value.

recent-backup-timer recent-backup-timer-number

Displays the recent backup timer value.

edge-delay-timer edge-delay-timer-number

Displays the edge delay timer value.

migration-timer migration-timer-number

Displays the migration timer value.

sm-table-bits sm-table-bits-number

Displays the state machine table state.

sm-table sm-table-string

Displays the state machine table description

vlag-peer-port vlag-peer-port-number

Displays the VLAG peer port if it is an active-active VLAG.


Displays the STP peer state.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.


Display output in ascending order.


Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.


Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.


Display the number of entries in the output. This is useful with vRouter show commands.


Display full values in the output instead of scaled approximate values.


Display integer values instead of mapped values


Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None.

Access   CLI

History   Command introduced in Version 2.4.1.

Usage   STP is a standard inter-switch protocol is used to ensure that an ad hoc network topology is loop-free at Layer 2, on a per VLAN basis. If your network connections form loops, and STP is disabled, packets recirculate between the switches and causes a decrease in network performance. If you are certain that your network is loop-free, you do not need to enable STP. One drawback of STP is that it does not allow for Layer 2 multipathing and may result in suboptimal utilization of available network links. Therefore, a fabric of Pluribus Networks switches does not use STP within the boundaries of the fabric. The use of STP is recommended for ad hoc networks that interoperate in a heterogeneous, multi-vendor switch environment. Use this command to enable or disable STP on the network.

Examples  To display STP port state information, use the following command:

CLI network-admin@switch > stp-port-state-show

See Also