Show Commands

show interface switchport

To display interface switchport information, use the show interface switchport command.

show interface [if-identifier] switchport

Syntax Description

if-identifier

(Optional) Identifier of an interface. Examples are ethernet 3/22 or port channel 120.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

5.1(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display VTP interface switchport information on the device:

switch# show interface switchport
Name: Ethernet8/11
  Switchport: Enabled
  Switchport Monitor: Not enabled
  Operational Mode: trunk
  Access Mode VLAN: 1 (default)
  Trunking Native Mode VLAN: 1 (default)
  Trunking VLANs Enabled: 1,10,20-30
  Pruning VLANs Enabled: 2-1001
  Administrative private-vlan primary host-association: none
  Administrative private-vlan secondary host-association: none
  Administrative private-vlan primary mapping: none
  Administrative private-vlan secondary mapping: none
  Administrative private-vlan trunk native VLAN: none
  Administrative private-vlan trunk encapsulation: dot1q
  Administrative private-vlan trunk normal VLANs: none
  Administrative private-vlan trunk private VLANs: none
  Operational private-vlan: none
switch#

Related Commands

Command

Description

feature vtp

Enables VTP on the device.

vtp domain

Configures the VTP domain name.

vtp version

Configures the VTP version.

show interface trunk

To display interface trunk information, use the show interface trunk command.

show interface [if-identifier] trunk

Syntax Description

if-identifier

(Optional) Identifier of an interface. Examples are ethernet 3/22 or port channel 120.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

5.1(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display VTP interface trunk information on the device:

switch# show interface trunk
 
--------------------------------------------------------------------------------
Port          Native  Status        Port
              Vlan                  Channel
--------------------------------------------------------------------------------
Eth1/33       1       trunking      --
Eth1/34       1       trunking      --
 
--------------------------------------------------------------------------------
Port          Vlans Allowed on Trunk
--------------------------------------------------------------------------------
Eth1/33       1,10
Eth1/34       1,10
 
--------------------------------------------------------------------------------
Port          Vlans Err-disabled on Trunk
--------------------------------------------------------------------------------
Eth1/33       none
Eth1/34       none
 
--------------------------------------------------------------------------------
Port          STP Forwarding
--------------------------------------------------------------------------------
Eth1/33       1,10
Eth1/34       1,10
 
--------------------------------------------------------------------------------
Port          VTP in spanning tree forwarding state and not pruned
--------------------------------------------------------------------------------
Eth1/33       1
Eth1/34       1
switch#

Related Commands

Command

Description

feature vtp

Enables VTP on the device.

vtp domain

Configures the VTP domain name.

vtp version

Configures the VTP version.

show interface vlan

To display information about specified VLANs, use the show interface vlan command.

show interface vlan vlan-id [ brief | description | private-vlan mapping | status ]

Syntax Description

vlan-id

Number of the VLAN. The range of values is from 1 to 4096.

brief

(Optional) Displays a brief description about a specified VLAN.

description

(Optional) Displays a detailed description about a specified VLAN.

private-vlan mapping

(Optional) Displays information about the private VLAN mapping, if any, for a specified VLAN.

status

(Optional) Displays information about the status for a specified VLAN.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.2(1)

Display of configured static MAC addresses for Layer 3 port channels added.

Usage Guidelines

You can use this command to display information about a specified VLAN, including the private VLANs.

The information is gathered at 1-minute intervals.

When you specify a primary VLAN, the device displays all secondary VLANs mapped to the specified primary VLAN.

The device displays the output for the private-vlan mapping keyword only when you specify a primary private VLAN. If you specify a secondary private VLAN and enter the private-vlan mapping keyword, the output is blank.


Note


To display more statistics for the specified VLAN, use the show interface vlan counters and show vlan counters commands.To display more information about private VLANs, see the show interface private-vlan commands.

You can configure a VLAN network interface with a static MAC address, and this command will display that configured MAC address. See the mac-address command for information on configuring a VLAN network interface with a static MAC address.

This command does not require a license.

Examples

This example shows how to display information about the specified VLAN. This command displays statistical information gathered on the VLAN at 1-minute intervals:

switch# show interface vlan 5
Vlan5 is administratively down, line protocol is down
  Hardware is EtherSVI, address is  0000.0000.0000
  MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec,
   reliability 255/255, txload 1/255, rxload 1/255
  Encapsulation ARPA, loopback not set
  Keepalive not supported
  ARP type: ARPA
  Last clearing of "show interface" counters 01:21:55
  1 minute input rate 0 bytes/sec, 0 packets/sec
  1 minute output rate 0 bytes/sec, 0 packets/sec
  L3 Switched:
    input: 0 pkts, 0 bytes - output: 0 pkts, 0 bytes
  L3 in Switched:
    ucast: 0 pkts, 0 bytes - mcast: 0 pkts, 0 bytes
  L3 out Switched:
    ucast: 0 pkts, 0 bytes - mcast: 0 pkts, 0 bytes

This example shows how to display a brief description for a specified VLAN. This displays shows the secondary VLAN and type, if configured, and the status:

switch# show interface vlan 5 brief
-------------------------------------------------------------------------------
Interface      Secondary VLAN(Type)                    Status     Reason
-------------------------------------------------------------------------------
Vlan5          --                                      down       none
This example shows how to display the description for a specified VLAN:
switch# show interface vlan 100 description
------------------------------------------
Interface    Description
------------------------------------------
Vlan100

This example shows how to display information about the private VLAN mapping, if any, for a specified VLAN:

switch# show interface vlan 200 private-vlan mapping
Interface Secondary VLAN
--------- ----------------------------------------------------------------
vlan200   201  202

This example shows how to display the status for a specified VLAN:

switch# show interface vlan 5 status
------------------------------------------
Interface          Status         Protocol
------------------------------------------
Vlan5              admin down         shut

Related Commands

Command

Description

show interface switchport

Displays information about the switch ports, including those configured for private VLANs,

show interface vlan counters

Displays the statistics for VLANs.

show interface vlan counters

To display the statistics for a specified VLAN, use the show interface vlan counters command.

show interface vlan vlan-id counters [ detailed [all] | snmp ]

Syntax Description

vlan-id

VLAN or range of VLANs for which you want to display statistics . The range is from 1 to 4096.

detailed

(Optional) Displays nonzero counters for the specified interface.

all

(Optional) Displays all the detailed information for the particular VLAN, including statistics per byte .

snmp

(Optional) Displays the MIB values .

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

You can use this command to display information about the received octets, unicast packets, multicast packets, and broadcast packets as well as the transmitted octets, unicast packets, multicast packets, and broadcast packets for all VLANs, including private VLANs.

This command does not require a license.

Examples

This example shows how to display the statistics for a specified VLAN:

switch# show interface vlan 9 counters
--------------------------------------------------------------------------------
Port              InOctets   InUcastPkts   InMcastPkts   InBcastPkts
--------------------------------------------------------------------------------
Vlan9                    0             0             0            --
--------------------------------------------------------------------------------
Port             OutOctets  OutUcastPkts  OutMcastPkts  OutBcastPkts
--------------------------------------------------------------------------------
Vlan9                    0             0             0            --

This example shows how to display only the nonzero counters for a specified VLAN:

switch# show interface vlan 2 counters detailed
Vlan2
  counters:
  l3_average_input_bits                        9947168160
  l3_average_input_packets                       20723267
  l3_routed_bytes_in                          39054410460
  l3_routed_pkts_in                             650906841
  l3_ucast_bytes_in                           39054410460
  l3_ucast_pkts_in                              650906841

This example shows how to display all detailed statistics for a specified VLAN:

switch(config)# show interface vlan 9 counters detailed all
Vlan9
  counters:
   0.             l3_ipv4_ucast_bytes_in = 0
   1.              l3_ipv4_ucast_pkts_in = 0
   2.             l3_ipv4_mcast_bytes_in = 0
   3.              l3_ipv4_mcast_pkts_in = 0
   4.             l3_ipv6_ucast_bytes_in = 0
   5.              l3_ipv6_ucast_pkts_in = 0
   6.             l3_ipv6_mcast_bytes_in = 0
   7.              l3_ipv6_mcast_pkts_in = 0
   8.            l3_ipv4_ucast_bytes_out = 0
   9.             l3_ipv4_ucast_pkts_out = 0
  10.            l3_ipv4_mcast_bytes_out = 0
  11.             l3_ipv4_mcast_pkts_out = 0
  12.            l3_ipv6_ucast_bytes_out = 0
  13.             l3_ipv6_ucast_pkts_out = 0
  14.            l3_ipv6_mcast_bytes_out = 0
  15.             l3_ipv6_mcast_pkts_out = 0
  16.             l3_average_input_bytes = 0
  17.           l3_average_input_packets = 0
  18.            l3_average_output_bytes = 0
  19.          l3_average_output_packets = 0
  20.                 l3_routed_bytes_in = 0
  21.                  l3_routed_pkts_in = 0
  22.                  l3_ucast_bytes_in = 0
  23.                   l3_ucast_pkts_in = 0
  24.                  l3_mcast_bytes_in = 0
  25.                   l3_mcast_pkts_in = 0
  26.                l3_routed_bytes_out = 0
  27.                 l3_routed_pkts_out = 0
  28.                 l3_ucast_bytes_out = 0
  29.                  l3_ucast_pkts_out = 0
  30.                 l3_mcast_bytes_out = 0
  31.                  l3_mcast_pkts_out = 0

This example shows how to display the MIB values for a specified VLAN:

switch(config)# show interface vlan 9 counters snmp
-------------------------------------------------------------------------------
Port              InOctets   InUcastPkts   InMcastPkts   InBcastPkts
-------------------------------------------------------------------------------
Vlan9                    0             0             0            --
-------------------------------------------------------------------------------
Port             OutOctets  OutUcastPkts  OutMcastPkts  OutBcastPkts
-------------------------------------------------------------------------------
Vlan9                    0             0             0            --
Ethernet2/28               0000.0000.0000  0019.076c.4dc7
Ethernet2/29               0000.0000.0000  0019.076c.4dc8
Ethernet2/30               0000.0000.0000  0019.076c.4dc9

Related Commands

Command

Description

clear counters

Clears counters on the interfaces.

show mac address-table

To display the information about the MAC address table, use the show mac address-table command.

show mac address-table [num] [ dynamic | static ] [ address mac-address | count | interface { type slot /port | port-channel number } | vlan vlan-id ]

Syntax Description

num

(Optional) MAC address table for a specified module.

Note    When you use this argument, the system displays all the entries on that module as specified by any of the following optional arguments. When you do not use this argument, the system displays only the primary entries on all modules.

dynamic

(Optional) Displays information about the dynamic MAC address table entries only.

static

(Optional) Displays information about the static MAC address table entries only.

address mac-address

(Optional) Displays information about the MAC address table for a specific MAC address.

count

(Optional) Displays the number of MAC address entries for dynamic and static.

interface type slot/port

(Optional) Specifies the interface. Use either t he type of interface, the slot number, or the port number.

port-channel number

(Optional) Specifies the port-channel number. The range is from 1 to 4096.

vlan vlan-id

(Optional) Displays information for a specific VLAN only; the range of valid values is from 1 to 4094.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1.2

This command was enhanced to display vPC information.

Usage Guidelines

A primary entry is a MAC address learned on that interface.


Note


Use the show mac address-table command without the num argument to display only the primary entries on all modules. When you use the num argument, the device displays all the entries on that module as specified by additional optional arguments.

The device maintains static MAC address entries saved in the startup-config file across reboots and flushes the dynamic entries.

The MAC address table for each virtual device context (VDC) is separate and distinct.


Note


To display the MAC address for the VDC, use the show vdc command.

The show mac address-table command is enhanced to display information about MAC addresses on virtual port channels (vPCs). See the Cisco NX-OS Interfaces Configuration Guide for information on vPCs.

This command does not require a license.

Examples


Note


In the following examples, NTFY means notify.

This example shows how to display the information about the entries for the Layer 2 MAC address table:

switch# show mac address-table
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+----------------
G     -    0018.bad8.3fbd    static       -     False  False sup-eth1(R)
* 3        1234.dd56.ee89    static       -     False  False Eth2/1

This example shows how to display the information about the entries for the Layer 2 MAC address table when you have enabled and configured the vPC feature:

switch# show mac address-table
Legend: 
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+----------------
G     -    0018.bad8.447d    static       -     False  False sup-eth1(R)
* 1        0000.0300.0300    dynamic   0        False  False Eth1/2
* 1        0000.0300.0301    dynamic   0        False  False Eth1/2
* 1        0000.0300.0302    dynamic   0        False  False Eth1/2
* 1        0000.0300.0303    dynamic   0        False  False Eth1/2
* 1        0000.0300.0304    dynamic   0        False  False Eth1/2
  2        ac00.0000.0021    dynamic   0        False  False VPC Peer-Link
  2        ac00.0000.0022    dynamic   0        False  False VPC Peer-Link
  2        ac00.0000.0023    dynamic   0        False  False VPC Peer-Link

This example shows how to display the information about the entries for the Layer 2 MAC address table for a specific module:

switch# show mac address-table 2
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+----------------
G     -    0018.bad8.3fbd    static       -     False  False sup-eth1(R)
* 3        1234.dd56.ee89    static       -     False  False Eth2/1
3          0000.23bd.4fda    dynamic     70     False  False Eth1/1

This example shows how to display the information about the entries for the Layer 2 MAC address table for a specific MAC address:

switch# show mac address-table address 0018.bad8.3fbd
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+----------------
G     -    0018.bad8.3fbd    static       -     False  False sup-eth1(R)

This example shows how to display the information about the dynamic entries for the Layer 2 MAC address table:

switch# show mac address-table dynamic
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+---------------- 
* 3        0010.fcbc.3fbd    dynamic    1265    False  False Eth2/12
* 3        1234.dd56.ee89    dynamic    850     False  False Eth2/1

This example shows how to display the information about the Layer 2 MAC address table for a specific interface:

switch# show mac address-table interface ethernet 2/13
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+----------------
* 1       1234.dd56.ee89    dynamic    0       False  False Eth2/13

This example shows how to display the static entries in the Layer 2 MAC address table:

switch# show mac address-table static
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+----------------
G     -    0018.bad8.3fbd    static       -     False  False sup-eth1(R)
* 3        1234.dd56.ee89    static       -     False  False Eth2/1

This example shows how to display the entries in the Layer 2 MAC address table for a specific VLAN:

switch# show mac address-table vlan 3
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC
        age - seconds since last seen
   VLAN     MAC Address      Type      age     Secure  NTFY   Ports
---------+-----------------+--------+---------+------+------+----------------
* 3        1234.dd56.ee89    static       -     False  False Eth2/1

Related Commands

Command

Description

mac address-table static

Adds static entries to the MAC address table or configures a static MAC address with IGMP snooping disabled for that address.

show mac address-table aging-time

To display information about the timeout values for the MAC address table, use the show mac-address-table aging-time command.

show mac address-table aging-time [ vlan vlan-id ]

Syntax Description

vlan vlan-id

(Optional) Displays information for a specific VLAN only; the range of valid values is from 1 to 4094.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

You can configure the MAC address aging time per VLAN or for the entire device. The valid range is from 120 to 918000. Entering 0 disables the MAC aging time.

This command does not require a license.

Examples

This example shows how to display MAC address aging times:

switch# show mac address-table aging-time
Vlan    Aging Time
----    ----------
1       1800
50      1200
100     1800 

Related Commands

Command

Description

mac address-table aging-time

Configures the aging time for entries in the Layer 2 table.

show running-config spanning-tree

To display the running configuration for the Spanning Tree Protocol (STP), use the show running-config spanning-tree command.

show running-config spanning-tree [all]

Syntax Description

all

(Optional) Displays current STP operating information including the default settings.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

This command provides information about the Spanning Tree Protocol.


Note


The display output differs slightly depending on whether you are running Rapid Per VLAN Spanning Tree (Rapid PVST+) or Multiple Spanning Tree (MST).

This command does not require a license.

Examples

This example shows how to display information about the running STP configuration when you are running MST:

switch# show running-config spanning-tree
spanning-tree mode mst

This example shows how to display detailed information about the running STP configuration when you are running MST:

switch# show running-config spanning-tree all
spanning-tree mode mst
no spanning-tree port type edge default
no spanning-tree port type network default
spanning-tree bridge assurance
no spanning-tree loopguard default
spanning-tree mst simulate pvst global
no snmp-server enable traps bridge topologychange
no snmp-server enable traps bridge newroot
no snmp-server enable traps stpx inconsistency
no snmp-server enable traps stpx loop-inconsistency
no snmp-server enable traps stpx root-inconsistency
spanning-tree mst hello-time 2
spanning-tree mst forward-time 15
spanning-tree mst max-age 20
spanning-tree mst max-hops 20
spanning-tree mst 0 priority 32768
spanning-tree mst configuration
  name
  revision 0
  instance 0 vlan 1-4094
configure interface Ethernet8/1
  spanning-tree port-priority 128

Related Commands

Command

Description

show spanning-tree

Displays information about STP.

show running-config vlan

To display the running configuration for a specified VLAN, use the show running-config vlan command.

show running-config vlan vlan-id

Syntax Description

vlan-id

Number of the VLAN or range of VLANs. Valid numbers range from 1 to 4096.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

This command provides information about the specified VLAN, including private VLANs.

The display varies with your configuration. If you configure the name, shutdown status, or suspended status, these settings.

This command does not require a license.

Examples

This example shows how to display the running configuration for VLAN 50:

switch(config)# show running-config vlan 50
version 4.0(1)
vlan 50

Related Commands

Command

Description

show vlan

Displays information about all the VLANs on the device.

show running-config vtp

To display the running configuration for the VLAN Trunking Protocol (VTP), use the show running-config vtp command.

show running-config vtp

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.1(2)

This command was introduced.

Usage Guidelines

This command provides information about VTP.

This command does not require a license.

Examples

This example shows how to display the running configuration for VTP:

switch(config)# show running-config vtp
version 4.1(2)
feature vtp
vtp mode transparent
vtp domain accounting

Related Commands

Command

Description

show vtp status

Displays information about VTP on the device.

show spanning-tree

To display information about the Spanning Tree Protocol (STP), use the show spanning-tree command.

show spanning-tree [ blockedports | inconsistentports | pathcost method ]

Syntax Description

blockedports

(Optional) Displays the alternate ports blocked by STP.

inconsistentports

(Optional) Displays the ports that are in an inconsistent STP state.

pathcost method

(Optional) Displays whether the short or long path-cost method is used.

Note    The method type differs for Rapid Per VLAN Spanning Tree (Rapid PVST+) and Multiple Spanning Tree (MST):- With Rapid PVST+, this value is configurable and the default is short.- With MST, this value is nonconfigurable and the operational value is always long.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1(3)

This command was enhanced to display when a port is part of a virtual port channel (vPC).

4.1.2

This command was enhanced to display vPC information.

Usage Guidelines

The STP port type displays only when you have configured the port as either an STP edge port or an STP network port. If you have not configured the STP port type, no port type displays.


Note


The display output differs slightly depending on whether you are running Rapid PVST+ or MST.

This command does not require a license.

Examples

This example shows how to display STP when you are running Rapid PVST+:

switch# show spanning-tree
VLAN0001
  Spanning tree enabled protocol rstp
  Root ID    Priority    32769
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32769  (priority 32768 sys-id-ext 1)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 
VLAN0002
  Spanning tree enabled protocol rstp
  Root ID    Priority    32770
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32770  (priority 32768 sys-id-ext 2)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 
VLAN0003
  Spanning tree enabled protocol rstp
  Root ID    Priority    32771
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32771  (priority 32768 sys-id-ext 3)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 
VLAN0004
  Spanning tree enabled protocol rstp
  Root ID    Priority    32772
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32772  (priority 32768 sys-id-ext 4)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 

This example shows how to display STP information when you are running MST:

switch# show spanning-tree
MST0000
  Spanning tree enabled protocol mstp
  Root ID    Priority    32768
             Address     0018.bad8.fc150
             Cost        0
             Port         258 (Ethernet 2/2)
             Hello Time   2 sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32768 (priority 32768 sys-id-ext 0)
             Address     0018.bad8.239d
             Hello Time   2 sec  Max Age 20 sec  Forward Delay 15 sec
Interface         Role Sts Cost       Prio.Nbr   Type
---------------- ----- --- ---------  --------   ------------------------------------
Eth2/1            Altn  BKN 20000     128.257    Network, P2p   BA_Inc.
Eth2/2            Root  FWD 20000     128.258    Edge, P2p
Eth3/48           Desg  FWD 20000     128.43228  P2p

This example shows how to display the blocked ports in spanning tree:

switch(config)# show spanning-tree blockedports
Name                 Blocked Interfaces List
-------------------- ------------------------------------
VLAN0001             Eth8/2
VLAN0002             Eth8/2
VLAN0003             Eth8/2
VLAN0004             Eth8/2
VLAN0005             Eth8/2
VLAN0006             Eth8/2
VLAN0007             Eth8/2
VLAN0008             Eth8/2
VLAN0009             Eth8/2
VLAN0010             Eth8/2

This example shows how to determine if any ports are in any STP-inconsistent state:

switch#  
show spanning-tree inconsistentports 
Name                 Interface              Inconsistency
-------------------- ---------------------- ------------------
MST0000              Eth8/1                 Bridge Assurance Inconsistent
MST0000              Eth8/2                 Bridge Assurance Inconsistent

This example shows how to display the path-cost method when you are running Rapid PVST+:

switch(config)# show spanning-tree pathcost method
Spanning tree default pathcost method used is short

This example shows how to display the path-cost method when you are running MST:

switch(config)# show spanning-tree pathcost method
Spanning tree default pathcost method used is short (Operational value is long)

show spanning-tree describes the fields that are shown in the examples.

Table 1 show spanning-tree Command Output Options

Field

Definition and Options

Role

Current port STP role. Valid values are as follows:

  • Desg (designated)
  • Root
  • Altn (alternate)
  • Back (backup)

State

Current port STP state. Valid values are as follows:

  • BLK (blocking)
  • DIS (disabled)
  • LRN (learning)
  • FWD (forwarding)

Type

Status information; valid values are as follows:

  • P2p/Shr—The interface is considered as a point-to-point interface by the spanning tree.
  • vPC—The port-channel interface is part of a VPC domain.
  • vPC peer-link—The port-channel interface is part of a VPC peer link.
  • Edge—The port is configured as an STP edge port (either globally using the default command or directly on the interface) and no BPDU has been received.
  • Network—The port is configured as an STP network port (either globally using the default command or directly on the interface).
  • *ROOT_Inc, *LOOP_Inc, *PVID_Inc, *BA_Inc, and *TYPE_Inc—The port is in a broken state (BKN*) for an inconsistency. The port would be Root inconsistent, Loopguard inconsistent, PVID inconsistent, Bridge Assurance inconsistent, or Type inconsistent.

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays a brief summary of STP information.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree active

To display Spanning Tree Protocol (STP) information on STP-active interfaces only, use the show spanning-tree active command.

show spanning-tree active [ brief | detail ]

Syntax Description

brief

(Optional) Displays a brief summary of STP interface information.

detail

(Optional) Displays a detailed summary of STP interface information.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1.2

This command was enhanced to display vPC information.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display STP information on the STP active interfaces:

switch# show spanning-tree active
VLAN0001
  Spanning tree enabled protocol rstp
  Root ID    Priority    32769
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32769  (priority 32768 sys-id-ext 1)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 
VLAN0002
  Spanning tree enabled protocol rstp
  Root ID    Priority    32770
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32770  (priority 32768 sys-id-ext 2)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 
VLAN0003
  Spanning tree enabled protocol rstp
  Root ID    Priority    32771
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32771  (priority 32768 sys-id-ext 3)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 
VLAN0004
  Spanning tree enabled protocol rstp
  Root ID    Priority    32772
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32772  (priority 32768 sys-id-ext 4)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays a brief summary of STP information.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration about specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree bridge

To display the status and configuration of the Spanning-Tree Protocol (STP) local bridge, use the show spanning-tree bridge command.

show spanning-tree bridge [ address | brief | detail | forward-time | hello-time | id | max-age | priority [system-id] | protocol ]

Syntax Description

address

(Optional) Displays the MAC address for the STP local bridge.

brief

(Optional) Displays a brief summary of the status and configuration for the STP bridge.

detail

(Optional) Displays a detailed summary of the status and configuration for the STP bridge.

forward-time

(Optional) Displays the STP forward delay interval for the bridge.

hello-time

(Optional) Displays the STP hello time for the bridge.

id

(Optional) Displays the STP bridge identifier for the bridge.

max-age

(Optional) Displays the STP maximum-aging time for the bridge.

priority

(Optional) Displays the bridge priority for this bridge.

system-id

(Optional) Displays the bridge priority with the system ID extension for this bridge.

protocol

(Optional) Displays which STP protocol is active, Rapid Per VLAN Spanning Tree (Rapid PVST+) or Multiple Spanning Tree (MST) on the device.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display STP information for the bridge:

switch(config)# show spanning-tree bridge
                                                   Hello  Max  Fwd
MST Instance                 Bridge ID              Time  Age  Dly  Protocol
---------------- --------------------------------- -----  ---  ---  --------
MST0000             32768 (32768,0) 0018.bad7.fc15    2    20   15  mstp

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree brief

Displays a brief summary of STP information.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree brief

To display a brief summary of the Spanning Tree Protocol (STP) status and configuration on the device, use the show spanning-tree brief command.

show spanning-tree brief [active]

Syntax Description

active

(Optional) Displays information about the STP active interfaces only .

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1(2)

This command was enhanced to display vPC information.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a brief summary of STP information:

switch(config)# show spanning-tree brief
VLAN0001
  Spanning tree enabled protocol rstp
  Root ID    Priority    32769
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32769  (priority 32768 sys-id-ext 1)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 
VLAN0002
  Spanning tree enabled protocol rstp
  Root ID    Priority    32770
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32770  (priority 32768 sys-id-ext 2)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree detail

To display detailed information on the Spanning Tree Protocol (STP) status and configuration on the device, use the show spanning-tree detail command.

show spanning-tree detail [active]

Syntax Description

active

(Optional) Displays information about the STP active interfaces only .

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1.2

This command was enhanced to display vPC information.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display detailed information about the STP configuration:

switch(config)# show spanning-tree detail
VLAN0001 is executing the rstp compatible Spanning Tree protocol
  Bridge Identifier has priority 32768, sysid 1, address 0022.5579.7641
  Configured hello time 2, max age 20, forward delay 15
  Current root has priority 32769, address 000d.eca3.9f01
  Root port is 4105 (port-channel10), cost of root path is 4
  Topology change flag not set, detected flag not set
  Number of topology changes 1 last change occurred 20:24:36 ago
          from port-channel10
  Times:  hold 1, topology change 35, notification 2
          hello 2, max age 20, forward delay 15 
  Timers: hello 0, topology change 0, notification 0
 Port 4105 (port-channel10, vPC Peer-link) of VLAN0001 is root forwarding 
   Port path cost 2, Port priority 128, Port Identifier 128.4105
   Designated root has priority 32769, address 000d.eca3.9f01
   Designated bridge has priority 32769, address 0022.5579.7341
   Designated port id is 128.4105, designated path cost 2
   Timers: message age 16, forward delay 0, hold 0
   Number of transitions to forwarding state: 1
   Link type is point-to-point by default
   BPDU: sent 36729, received 36739
 Port 4115 (port-channel20, vPC) of VLAN0001 is designated forwarding 
   Port path cost 1, Port priority 128, Port Identifier 128.4115
   Designated root has priority 32769, address 000d.eca3.9f01
   Designated bridge has priority 32769, address 0022.5579.7341
   Designated port id is 128.4115, designated path cost 2
   Timers: message age 0, forward delay 0, hold 0
   Number of transitions to forwarding state: 0
   Link type is point-to-point by default
   BPDU: sent 0, received 0
 Port 4125 (port-channel30, vPC) of VLAN0001 is root forwarding 
   Port path cost 1, Port priority 128, Port Identifier 128.4125
   Designated root has priority 32769, address 000d.eca3.9f01
   Designated bridge has priority 32769, address 000d.eca3.9f01
   Designated port id is 128.4125, designated path cost 0
   Timers: message age 0, forward delay 0, hold 0
   Number of transitions to forwarding state: 0
   Link type is point-to-point by default
   BPDU: sent 0, received 0

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays brief summary information about STP.

show spanning-tree interface

Displays the STP interface status and configuration about specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree interface

To display information about the Spanning Tree Protocol (STP) interface status and configuration of specified interfaces, use the show spanning-tree interface command.

show spanning-tree interface { ethernet slot /port | port-channel channel-number } [ active [ brief | detail ] | brief [active] | cost | detail [active] | edge | inconsistency | priority | rootcost | state ]

Syntax Description

ethernet slot/port

Displays the Ethernet interface and slot or port number. The range is from 1 to 253.

port-channel channel-number

Port channel number. The range is from 1 to 4096.

active

(Optional) Displays information about the STP active interfaces only on the specified interfaces.

brief

(Optional) Displays a brief summary about the specified STP interfaces .

detail

(Optional) Displays detailed information about the specified STP interfaces .

cost

(Optional) Displays the STP path cost for the specified interfaces.

edge

(Optional) Displays the STP-type edge port information for the specified interfaces.

inconsistency

(Optional) Displays the port STP inconsistency state for the specified interfaces.

priority

(Optional) Displays the STP port priority for the specified interfaces.

rootcost

(Optional) Displays the path cost to the root for specified interfaces.

state

Current port STP state. Valid values are as follows:

  • BLK (blocking)
  • DIS (disabled)
  • LRN (learning)
  • FWD (forwarding)

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1.2

This command was enhanced to display vPC information.

Usage Guidelines

The STP port type displays only when you have configured the port as either an STP edge port or an STP network port. If you have not configured the STP port type, no port type displays.

If you specify an interface that is not running STP, the device returns an error message.

When you are running MST, this command displays the PVST simulation setting.


Note


If you are running MST, use the show spanning-tree mst command to show more detail on the specified interfaces.

This command does not require a license.

Examples

This example shows how to display STP information about a specified interface when you are running Rapid PVST+:

switch(config)# show spanning-tree interface ethernet 8/2
Vlan             Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
VLAN0001         Altn BLK 20000     128.1025 P2p
VLAN0002         Desg FWD 20000     128.1025 P2p

This example shows how to display STP information about a specified interface when you are running MST:

switch(config)# show spanning-tree interface ethernet 2/50
Mst Instance     Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
MST0000          Desg FWD 20000     128.1281 P2p

This example shows how to display detailed STP information about a specified interface when you are running Rapid PVST+:

switch(config)# show spanning-tree interface ethernet 8/1 detail
Port 1025 (Ethernet8/1) of VLAN0001 is alternate blocking
   Port path cost 20000, Port priority 128, Port Identifier 128.1025
   Designated root has priority 28672, address 0018.bad8.239d
   Designated bridge has priority 28672, address 0018.bad8.239d
   Designated port id is 128.1281, designated path cost 0
   Timers: message age 15, forward delay 0, hold 0
   Number of transitions to forwarding state: 1
   Link type is point-to-point by default
   The port type is network by default.
   BPDU: sent 4657, received 188
 Port 1025 (Ethernet8/1) of VLAN0002 is designated forwarding
   Port path cost 20000, Port priority 128, Port Identifier 128.1025
   Designated root has priority 32770, address 0018.bad7.fc15
   Designated bridge has priority 32770, address 0018.bad7.fc15
   Designated port id is 128.1025, designated path cost 0
   Timers: message age 0, forward delay 0, hold 0
   Number of transitions to forwarding state: 1
   Link type is point-to-point by default   The port type is network by default.
   BPDU: sent 4838, received 0

This example shows how to display detailed STP information about a specified interface when you are running MST:

switch(config)# show spanning-tree interface ethernet 10/1 detail
Port 1281 (Ethernet10/1) of MST0000 is designated forwarding
   Port path cost 20000, Port priority 128, Port Identifier 128.1281
   Designated root has priority 28672, address 0018.bad8.239d
   Designated bridge has priority 28672, address 0018.bad8.239d
   Designated port id is 128.1281, designated path cost 0
   Timers: message age 0, forward delay 0, hold 0
   Number of transitions to forwarding state: 1
   Link type is point-to-point by default, Internal
   PVST Simulation is enabled by default
   BPDU: sent 290, received 0

This example shows how to display detailed STP information about a specified port-channel interface when you are running a virtual port channel (vPC):

switch(config)# show spanning-tree interface port-channel 10
Vlan             Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
VLAN0001         Root FWD 2         128.4105 (vPC peer-link) P2p 
VLAN0002         Root FWD 2         128.4105 (vPC peer-link) P2p 
VLAN0003         Root FWD 2         128.4105 (vPC peer-link) P2p 
VLAN0004         Root FWD 2         128.4105 (vPC peer-link) P2p 

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays brief summary information about STP.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree mst

To display information about the Multiple Spanning Tree (MST ) status and configuration, use the show spanning-tree mst command.

show spanning-tree mst [ instance-id [ detail | interface { ethernet slot /port | port-channel channel-number } [detail] ] ] | [ configuration [digest] ] | [detail] | [ interface ethernet slot /port | port-channel channel-number [detail] ]

Syntax Description

instance-id

(Optional) MST instance that you want to display.

detail

(Optional) Displays detailed MST information.

interface

Displays the interface or range of interfaces that you want to display.

ethernet slot/port

Displays the Ethernet interface and slot or port number. The range is from 1 to 253.

port-channel channel-number

Displays the port-channel number. The range is from 1 to 4096.

configuration

(Optional) Displays current MST regional information. Displays VLAN-to-instance mapping of all VLANs.

digest

(Optional) Displays information about the MD5 digest.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1.2

This command was enhanced to display vPC information.

Usage Guidelines

If you are not running in Spanning Tree Protocol (STP) Multiple Spanning Tree (MST) mode but are running in STP Rapid Per VLAN Spanning Tree (Rapid PVST+) mode, when you enter this command, the device returns the following message:

ERROR: Switch is not in mst mode

See Table 1-1 for information on valid values for fields.

This command does not require a license.

Examples

This example shows how to display STP information about MST instance information for the VLAN ports that are currently active:

switch# show spanning-tree mst
##### MST0    vlans mapped:   1-4094
Bridge        address 0018.bad7.fc15  priority      32768 (32768 sysid 0)
Root          this switch for the CIST
Regional Root this switch
Operational   hello time 2 , forward delay 15, max age 20, txholdcount 6
Configured    hello time 2 , forward delay 15, max age 20, max hops    20
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Eth8/1           Desg FWD 20000     128.1025 P2p
Eth8/2           Desg FWD 20000     128.1026 P2p

This example shows how to display STP information about a specific MST instance:

switch)# show spanning-tree mst 0
##### MST0    vlans mapped:   1-4094
Bridge        address 0018.bad7.fc15  priority      32768 (32768 sysid 0)
Root          this switch for the CIST
Regional Root this switch
Operational   hello time 2 , forward delay 15, max age 20, txholdcount 6
Configured    hello time 2 , forward delay 15, max age 20, max hops    20
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Eth8/1           Desg FWD 20000     128.1025 P2p
Eth8/2           Desg FWD 20000     128.1026 P2p

This example shows how to display detailed STP information about the MST protocol:

switch)# show spanning-tree mst detail
##### MST0    vlans mapped:   1-4094
Bridge        address 0018.bad7.fc15  priority      32768 (32768 sysid 0)
Root          this switch for the CIST
Regional Root this switch
Operational   hello time 2 , forward delay 15, max age 20, txholdcount 6
Configured    hello time 2 , forward delay 15, max age 20, max hops    20
Eth8/1 of MST0 is designated forwarding
Port info             port id       128.1025  priority    128  cost   20000
Designated root       address 0018.bad7.fc15  priority  32768  cost   0
Design. regional root address 0018.bad7.fc15  priority  32768  cost   0
Designated bridge     address 0018.bad7.fc15  priority  32768  port id 128.1025
Timers: message expires in 0 sec, forward delay 0, forward transitions 1
Bpdus sent 1379, received 3
Eth8/2 of MST0 is designated forwarding
Port info             port id       128.1026  priority    128  cost   20000
Designated root       address 0018.bad7.fc15  priority  32768  cost   0
Design. regional root address 0018.bad7.fc15  priority  32768  cost   0
Designated bridge     address 0018.bad7.fc15  priority  32768  port id 128.1026
Timers: message expires in 0 sec, forward delay 0, forward transitions 1
Bpdus sent 1380, received 2

This example shows how to display STP information about specified MST interfaces:

switch)# show spanning-tree mst interface ethernet 8/2
Eth8/2 of MST0 is designated forwarding
Port Type: normal         (default)           port guard : none        (default)
Link type: point-to-point (auto)              bpdu filter: disable     (default)
Boundary : internal                           bpdu guard : disable     (default)
Bpdus sent 1423, received 2
Instance Role Sts Cost      Prio.Nbr Vlans mapped
-------- ---- --- --------- -------- -------------------------------
0        Desg FWD 20000     128.1026 1-4094

This example shows how to display information about the MST configuration:

switch)# show spanning-tree mst configuration
Name:       [mst-bldg-sj6/3]
Revision:   1       Instances Configured: 3
Instance    Vlans mapped
---------   --------------------------------------------------
0	       1
2000	       2-2000
4094       2001-4094
----------------------------------------------------------------  
                                       

This example shows how to display the MD5 digest included in the current MST configuration:

switch)# show spanning-tree mst configuration digest
Name      [mst-config]
Revision  10    Instances configured 25
Digest          0x40D5ECA178C657835C83BBCB16723192
Pre-std Digest  0x27BF112A75B72781ED928D9EC5BB4251

Related Commands

Command

Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays brief summary information about STP.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree root

To display the status and configuration of the Spanning Tree Protocol (STP) root bridge, use the show spanning-tree root command.

show spanning-tree root [ address | brief | cost | detail | forward-time | hello-time | id | max-age | port | priority [system-id] ]

Syntax Description

address

(Optional) Displays the MAC address for the STP root bridge.

brief

(Optional) Displays a brief summary of the status and configuration for the the root bridge.

cost

(Optional) Displays the path cost from the root to this bridge.

detail

(Optional) Displays detailed information about the status and configuration for the root bridge.

forward-time

(Optional) Displays the STP forward delay interval for the root bridge.

hello-time

(Optional) Displays the STP hello time for the root bridge.

id

(Optional) Displays the STP bridge identifier for the root bridge.

max-age

(Optional) Displays the STP maximum-aging time for the root bridge.

port

(Optional) Displays which port is the root port.

priority

(Optional) Displays the bridge priority for the root bridge.

system-id

(Optional) Displays the bridge identifier with the system ID extension for the root bridge.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information for the root bridge:

switch(config)# show spanning-tree root
MST Instance           Root ID          Cost  Time Age Dly  Root Port
---------------- -------------------- ------ ----- --- ---  ----------------
MST0000          32768 0018.bad7.fc15       0    2   20  15  This bridge is root

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays a brief summary about STP information.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree summary

To display summary Spanning Tree Protocol (STP) information on the device, use the show spanning-tree summary command.

show spanning-tree summary [totals]

Syntax Description

totals

(Optional) Displays totals only of STP information.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

5.2(1)

Updated the example to display information for STP-lite. For more information about STP-lite, see the Cisco NX-OS FCoE Configuration Guide for Cisco Nexus 7000 and Cisco MDS 9500.

4.0

This command was introduced.

Usage Guidelines

The display output for this command differs when you are running Rapid Per VLAN Spanning Tree (Rapid PVST+) or Multiple Spanning Tree (MST).

This command does not require a license.

Examples

This example shows how to display a summary of STP information about the device when you are running Rapid PVST+:

switch(config)# show spanning-tree summary
Switch is in rapid-pvst mode 
Root bridge for: VLAN0001
Port Type Default                        is disable
Edge Port [PortFast] BPDU Guard Default  is disabled
Edge Port [PortFast] BPDU Filter Default is disabled
Bridge Assurance                         is enabled
Loopguard Default                        is disabled
Pathcost method used                     is short
Name                   Blocking Listening Learning Forwarding STP Active
---------------------- -------- --------- -------- ---------- ----------
VLAN0001                     1         0        0          1          2
VLAN0002                     2         0        0          0          2
VLAN0003                     2         0        0          0          2
---------------------- -------- --------- -------- ---------- ----------
3 vlans                      5         0        0          1          6
STP-lite running in the following VLAN instances
------------------------------------------------
VLAN0002
VLAN0003

This example shows how to display a summary of STP information about the device when you are running MST:

switch(config)# show spanning-tree summary
Switch is in mst mode (IEEE Standard)
Root bridge for: MST0000
Port Type Default                        is disable
Edge Port [PortFast] BPDU Guard Default  is disabled
Edge Port [PortFast] BPDU Filter Default is disabled
Bridge Assurance                         is enabled
Loopguard Default                        is disabled
Pathcost method used                     is long
PVST Simulation                          is enabled
Name                   Blocking Listening Learning Forwarding STP Active
---------------------- -------- --------- -------- ---------- ----------
MST0000                      0         0        0          2          2
---------------------- -------- --------- -------- ---------- ----------
1 mst                        0         0        0          2          2

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays a brief summary about STP information.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree vlan

Displays STP information about specified VLANs.

show spanning-tree vlan

To display Spanning Tree Protocol (STP) information for specified VLANs, use the show spanning-tree vlan command.

show spanning-tree vlan vlan-id [ active [ brief | detail ] | blockedports | bridge [address] | brief | detail | forward-time | hello-time | id | max-age | priority [system-id] | protocol | brief [active] | detail | inconsistentports | interface { ethernet slot /port | port-channel channel-number } [ active [ b rief | detail ] ] | brief [active] | cost | detail [active] | edge | inconsistency | priority | rootcost | state ] | root [ address | brief | cost | detail | forward-time | hello-time | id | max-age | port | priority [system-id] ] | summary

Syntax Description

vlan-id

VLAN or range of VLANs that you want to display. The range is from 1 to 4096.

active

(Optional) Displays information on STP VLANs and active ports.

brief

(Optional) Displays a brief summary of STP information for the specified VLANs.

detail

(Optional) Displays detailed STP information for the specified VLANs.

blockedports

(Optional) Displays the STP alternate ports in the blocked state for the specified VLANs.

bridge

(Optional) Displays the status and configuration of the bridge for the specified VLANs.

address

(Optional) Displays the MAC address for the specified STP bridge for the specified VLANs.

forward-time

(Optional) Displays the STP forward delay interval for the bridge for the specified VLANs.

hello-time

(Optional) Displays the STP hello time for the bridge for the specified VLANs.

id

(Optional) Displays the STP bridge identifier for the specified VLANs.

max-age

(Optional) Displays the STP maximum-aging time for the specified VLANs.

priority

(Optional) Displays the STP priority for the specified VLANs.

system-id

(Optional) Displays the bridge identification with the system ID added for the specified VLANs.

protocol

(Optional) Displays which STP protocol is active on the device.

inconsistentports

(Optional) Displays the ports that are in an inconsistent STP state for specified VLANs.

ethernet slot/port

Displays the Ethernet interface and slot or port number. The range is from 1 to 253.

port-channel channel-number

Displays the port channel interface. The range is from 1 to 4096.

cost

(Optional) Displays the STP path cost for the specified VLANs.

edge

(Optional) Displays the STP-type edge port information for the specified interface for the specified VLANs.

inconsistency

(Optional) Displays the STP port inconsistency state for the specified interface for the specified VLANs.

priority

(Optional) Displays the STP priority for the specified VLANs.

rootcost

(Optional) Displays the path cost to the root for specified interfaces for the specified VLANs.

state

Current port STP state. Valid values are as follows:

  • BLK (blocking)
  • DIS (disabled)
  • LRN (learning)
  • FWD (forwarding)

port

(Optional) Displays information about the root port for the specified VLANs,

summary

(Optional) Displays summary STP information about the specified VLANs.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

4.1.2

This command was enhanced to display vPC information.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display STP information about VLAN 4:

switch# show spanning-tree vlan 4
VLAN0004
  Spanning tree enabled protocol rstp
  Root ID    Priority    32772
             Address     000d.eca3.9f01
             Cost        4
             Port        4105 (port-channel10)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
  Bridge ID  Priority    32772  (priority 32768 sys-id-ext 4)
             Address     0022.5579.7641
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec
Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po10             Root FWD 2         128.4105 (vPC peer-link) P2p 
Po20             Desg FWD 1         128.4115 (vPC) P2p 
Po30             Root FWD 1         128.4125 (vPC) P2p 

Related Commands

Command

Description

show spanning-tree mst

Displays information about the MST STP.

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about the STP active interfaces only.

show spanning-tree bridge

Displays the bridge ID, timers, and protocol for the local bridge on the device.

show spanning-tree brief

Displays brief summary information about STP.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree root

Displays the status and configuration of the root bridge for the STP instance to which this device belongs.

show spanning-tree summary

Displays summary information about STP.

show startup-config vlan

To display VLAN configuration information in the startup configuration, use the show startup-config vlan command.

show startup-config vlan vlan-id

Syntax Description

vlan-id

Number of VLAN or range of VLANs. Valid numbers range from 1 to 4096.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.1(2)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the VLAN information in the startup configuration:

switch(config)# show startup-config vlan
version 4.1(2)
vlan 1
ip arp inspection vlan 1

Related Commands

Command

Description

show vlan

Displays information about all the VLANs on the device.

show startup-config vtp

To display VLAN Trunking Protocol (VTP) configuration information in the startup configuration, use the show startup-config vtp command.

show startup-config vtp

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Command History

Release

Modification

4.1(2)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the VTP information in the startup configuration:

switch(config)# show startup-config vtp
version 4.1(2)
feature vtp
vtp mode transparent
vtp domain accounting

Related Commands

Command

Description

show vtp status

Displays information about VTP on the device.

show system vlan reserved

To display the system reserved VLAN range, use the show system vlan reserved command.

show system vlan reserved

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

network-operator

vdc-admin

vdc-operator

Command History

Release

Modification

5.2(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the system reserved VLAN range:

switch# show system vlan reserved
 
system current running vlan reservation: 3968-4095
switch#

Related Commands

Command

Description

system vlan reserve

Configures the reserved VLAN range.

write erase all

Reverts to the default reserved VLAN range.

show vlan

To display VLAN information, use the show vlan command.

show vlan [ all-ports | brief | name name | summary ]

Syntax Description

all-ports

(Optional) Displays all ports on VLANs.

brief

(Optional) Displays only a single line for each VLAN, naming the VLAN, status, and ports.

name name

(Optional) Displays information about a single VLAN that is identified by the VLAN name; valid values are an ASCII string fro m 1 to 32 char acters.

summary

(Optional) Displays the number of existing VLANs on the device.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

5.1(1)

Changed the command output.

4.0

This command was introduced.

Usage Guidelines

This command displays information for all VLANs, including private VLANs, on the device.

Each access port can belong to only one VLAN. Trunk ports can be on multiple VLANs.


Note


Although a port can be associated with a VLAN as an access VLAN, a native VLAN, or one of the trunk allowed ports, the display under Ports for this commands lists only access VLANs.

If you shut down a VLAN using the state suspend or the state active command, these values appear in the Status field:

  • suspended—The VLAN is suspended.
  • active—The VLAN is active.

If you shut down a VLAN using the shutdown command, these values appear in the Status field:

  • act/lshut—The VLAN status is active but shut down locally.
  • sus/lshut—The VLAN status is suspended but shut down locally.

If a VLAN is shut down internally, these values appear in the Status field:

  • act/ishut—The VLAN status is active but shut down internally.
  • sus/ishut—The VLAN status is suspended but shut down internally.

If a VLAN is shut down locally and internally, the value that is displayed in the Status field is act/ishut or sus/ishut. If a VLAN is shut down locally only, the value that is displayed in the Status field is act/lshut or sus/lshut.

Examples

This example shows how to display information for all VLANs on the device:

switch# show vlan
VLAN Name                             Status    Ports
---- -------------------------------- --------- -------------------------------
1    default                          active    Eth5/1, Eth5/2, Eth5/3, Eth5/4
                                                Eth5/5, Eth5/6, Eth5/7, Eth5/8
                                                Eth5/9, Eth5/10, Eth5/11
                                                Eth5/12, Eth5/13, Eth5/14
                                                Eth5/15, Eth5/16, Eth5/17
                                                Eth5/18, Eth5/19, Eth5/20
                                                Eth5/21, Eth5/22, Eth5/23
                                                Eth5/24, Eth5/25, Eth5/26
                                                Eth5/27, Eth5/28, Eth5/29
                                                Eth5/30, Eth5/31, Eth5/32
                                                Eth7/1
10   VLAN0010                         active
VLAN Type  Vlan-mode
---- ----- ----------
1    enet  CE
10   enet  FABRICPATH
Remote SPAN VLANs
-------------------------------------------------------------------------------
Primary  Secondary  Type             Ports
-------  ---------  ---------------  -------------------------------------------
switch#

This example shows how to display the VLANs and all ports for each VLAN:

switch# 
show vlan all-ports
VLAN Name                             Status    Ports
---- -------------------------------- --------- -------------------------------
1    default                          active    Po5, Po37, Po50, Eth2/1, Eth2/2
                                                Eth2/3, Eth2/5, Eth2/7, Eth2/8
                                                Eth2/9, Eth2/10, Eth2/15
                                                Eth2/21, Eth2/22, Eth2/23
                                                Eth2/24, Eth2/25, Eth2/26
                                                Eth2/27, Eth2/28, Eth2/46
                                                Eth2/47, Eth2/48
5    VLAN0005                         active
6    VLAN0006                         active
7    VLAN0007                         active
8    test                             active
9    VLAN0009                         active
10   VLAN0010                         active
50   VLAN0050                         active    Eth2/6
100  trunked                          active
200  VLAN0200                         active
201  VLAN0201                         active
202  VLAN0202                         active

This example shows how to display the VLAN name, status, and associated ports only:

switch# 
show vlan brief
VLAN Name                             Status    Ports
---- -------------------------------- --------- -------------------------------
1    default                          active    Eth2/5, Eth2/7, Eth2/8, Eth2/9
                                                Eth2/10, Eth2/15, Eth2/47
                                                Eth2/48
5    VLAN0005                         active
6    VLAN0006                         active
7    VLAN0007                         active
8    test                             active
9    VLAN0009                         active
10   VLAN0010                         active
50   VLAN0050                         active    Eth2/6
100  trunked                          active.

This example shows how to display the VLAN information for a specific VLAN by name:

switch# 
show vlan name test
VLAN Name                             Status    Ports
---- -------------------------------- --------- -------------------------------
8    test                             active
VLAN Type
---- -----
8    enet
Remote SPAN VLAN
----------------
Disabled
Primary  Secondary  Type             Ports
-------  ---------  ---------------  -------------------------------------------100 

This example shows how to display information about the number of VLANs configured on the device:

switch# show vlan summary
Number of existing VLANs           : 9
 Number of existing user VLANs     : 9
 Number of existing extended VLANs : 0

Related Commands

Command

Description

show interface switchport

Displays information about the switch ports, including those switch ports in private VLANs,

show vlan private-vlan

Displays private VLAN information.

show vlan counters

To display the statistics for a specified VLAN or for all VLANs, use the show vlan counters command.

show vlan [ id vlan-id ] counters

Syntax Description

id

(Optional) Displays the VLAN ID that you want to clear .

vlan-id

Number of the VLAN that you want to clear . The range is from 1 to 4096.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

This command displays the counters for all the VLANs, including the private VLANs, on the device.

If you omit the VLAN ID, the system displays statistics for all the VLANs on the device. This command displays:

  • Transmitted and received unicast, multicast, and routed packets and octets
  • Information about Layer 2, IPv4, and IPv6 unicast, multicast, and unknown packets and octets

Separate VLAN ranges with a hyphen, and separate VLANs with a comma and no spaces in between. For example, you can enter the following:

switch# show vlan id 1-4,3,7,5-20

This command does not require a license.

Examples

This example shows how to display statistics for VLAN 9:

switch(config)# show vlan id 9 counters
Vlan Id                             :10 
L2 IPv4 Unicast Octets              :0 
L2 IPv4 Unicast Packets             :0 
L2 IPv4 Multicast Octets            :0 
L2 IPv4 Multicast Packets           :0 
L2 IPv6 Unicast Octets              :0 
L2 IPv6 Unicast Packets             :0 
L2 IPv6 Multicast Octets            :0 
L2 IPv6 Multicast Packets           :0 
L2 Unicast Octets                   :25600000 
L2 Unicast Packets                  :400000 
L2 Multicast Octets                 :0 
L2 Multicast Packets                :0 
L2 Broadcast Octets                 :12800000 
L2 Broadcast Packets                :200000 
L2 Unknown Unicast Octets           :19200000 
L2 Unknown Unicast Packets          :300000 
L3 Routed Octets In                 :0 
L3 Routed Packets In                :0 
L3 Routed Octets Out                :0 
L3 Routed Packets Out               :0 
L3 Multicast Octets In              :0 
L3 Multicast Packets In             :0 
L3 Multicast Octets Out             :0 
L3 Multicast Packets Out            :0 
L3 Unicast Octets In                :0 
L3 Unicast Packets In               :0 
L3 Unicast Octets Out               :0 
L3 Unicast Packets Out              :0 

Related Commands

Command

Description

clear vlan counters

Clears the counters for all or specified VLANs on the device.

show vlan dot1q tag native

To display the status of tagging on the native VLANs, use the show vlan dot1q tag native command.

show vlan dot1q tag native

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the status of native VLAN tagging on the device:

switch# show vlan dot1q tag native
vlan dot1q native tag is disabled

Related Commands

Command

Description

vlan dot1q tag native

Enables 802.1Q tagging for all the VLANs in a trunk on the device.

show vlan id

To display information and statistics for an individual VLAN or a range of VLANs, use the show vlan id command.

show vlan id [counters]

Syntax Description

id

Number of the VLAN or range of VLANs. The range is from 1 to 4096.

counters

Displays the statistics about specified VLANs.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use this command to display information and statistics about an individual VLAN or a range of VLANs, including private VLANs.

When you use the counters argument, this command displays the following statistics for the individual VLAN or range of VLANs:

  • Transmitted and received unicast, multicast, and routed packets and octets
  • Information on Layer 2, IPv4, and IPv6 unicast, multicast, and unknown packets and octets

Note


You can also display information about individual VLANs by using the show vlan name command.

This command does not require a license.

Examples

This example shows how to display information for VLAN 50:

switch# show vlan id 50

VLAN Name                             Status    Ports
---- -------------------------------- --------- -------------------------------
50   VLAN0050                         active    Eth2/6
VLAN Type
---- -----
50   enet
Remote SPAN VLAN
----------------
Disabled
Primary  Secondary  Type             Ports
-------  ---------  ---------------  -------------------------------------------

This example shows how to display statistics for VLAN 10:

switch(config)# show vlan id 10 counters
Vlan Id                             :10 
L2 IPv4 Unicast Octets              :0 
L2 IPv4 Unicast Packets             :0 
L2 IPv4 Multicast Octets            :0 
L2 IPv4 Multicast Packets           :0 
L2 IPv6 Unicast Octets              :0 
L2 IPv6 Unicast Packets             :0 
L2 IPv6 Multicast Octets            :0 
L2 IPv6 Multicast Packets           :0 
L2 Unicast Octets                   :25600000 
L2 Unicast Packets                  :400000 
L2 Multicast Octets                 :0 
L2 Multicast Packets                :0 
L2 Broadcast Octets                 :12800000 
L2 Broadcast Packets                :200000 
L2 Unknown Unicast Octets           :19200000 
L2 Unknown Unicast Packets          :300000 
L3 Routed Octets In                 :0 
L3 Routed Packets In                :0 
L3 Routed Octets Out                :0 
L3 Routed Packets Out               :0 
L3 Multicast Octets In              :0 
L3 Multicast Packets In             :0 
L3 Multicast Octets Out             :0 
L3 Multicast Packets Out            :0 
L3 Unicast Octets In                :0 
L3 Unicast Packets In               :0 
L3 Unicast Octets Out               :0 
L3 Unicast Packets Out              :0 

Related Commands

Command

Description

clear vlan counters

Clears the counters for all or specified VLANs on the device.

show vlan private-vlan

To display private VLAN information, use the show vlan private-vlan command.

show vlan [ id vlan-id ] private-vlan [type]

Syntax Description

id

(Optional) Displays the VLAN or range of VLANs. The range is from 1 to 4096.

vlan-id

(Optional) Private VLAN information for the specified VLAN. The range is from 1 to 4096.

type

(Optional) Displays the private VLAN type (primary, isolated, or community).

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display information about all private VLANs on the device:

switch(config)# show vlan private-vlan
Primary  Secondary  Type             Ports
-------  ---------  ---------------  ------------------------
200      201        isolated         Eth2/26, Eth2/27
200      202        community        Eth2/26, Eth2/28

This example shows how to display information for a specific private VLAN:

switch(config)# show vlan id 202 private-vlan
Primary  Secondary  Type             Ports
-------  ---------  ---------------  ---------------------------
200      202        community        Eth2/26, Eth2/28

This example shows how to display information about the types of all private VLANs on the device:

switch(config)# show vlan private-vlan type
Vlan Type
---- -----------------
200  primary
201  isolated
202  community

This example shows how to display information on the type for the specified private VLAN:

switch(config)# show vlan id 202 private-vlan type
Vlan Type
---- -----------------
202  community

Related Commands

Command

Description

show interface switchport

Displays information about the switch ports, including those switch ports in private VLANs.

show interface private-vlan mapping

Displays information about the private VLAN mapping between the primary and secondary VLANs so that both VLANs share the same primary VLAN interface.

show vlan

Displays information about all the VLANs on the device.

show vtp counter

To display the Virtual Trunking Protocol (VTP) statistics information, use the show vtp counter command.

show vtp counter

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

5.1(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display statistics information about VTP on the device:

switch# show vtp counter
VTP statistics:
Summary advertisements received    : 544
Subset advertisements received     : 270
Request advertisements received    : 0
Summary advertisements transmitted : 260
Subset advertisements transmitted  : 5
Request advertisements transmitted : 274
Number of config revision errors   : 0
Number of config digest errors     : 270
Number of V1 summary errors        : 0
 
VTP pruning statistics:
 
Trunk            Join Transmitted Join Received    Summary advts received from
                                                   non-pruning-capable device
---------------- ---------------- ---------------- ---------------------------
Ethernet1/31        12977            12982            542
switch#

Related Commands

Command

Description

feature vtp

Enables VTP on the device.

vtp domain

Configures the VTP domain name.

vtp version

Configures the VTP version.

show vtp devices

To display information about all VLAN Trunking Protocol (VTP) version 3 devices in the domain, use the show vtp devices command.

show vtp devices [conflicts]

Syntax Description

conflicts

(Optional) Displays information about conflicts.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

7.1(1)D1(0)

This command was introduced.

Usage Guidelines

The show vtp devices displays information about all VTP version 3 devices in the domain. The optional conflicts keyword displays information about VTP version 3 devices with conflicting primary servers.

The show vtp devices command does not display information when the switch is in transparent or off mode.

This command does not require a license.

Examples

This example shows how to display information about all VTP version 3 devices in the domain:

switch# show vtp devices
Gathering information from the domain, please wait.
VTP Database Conf switch ID      Primary Server Revision   System Name
             lict     
------------ ---- -------------- -------------- ---------- ---------------------- 
VLAN         Yes  00b0.8e50.d000 000c.0412.6300 12354      main.cisco.com
MST          No   00b0.8e50.d000 0004.AB45.6000 24         main.cisco.com
VLAN         Yes  000c.0412.6300=000c.0412.6300 67         qwerty.cisco.com

Related Commands

Command

Description

feature vtp

Enables VTP on the device.

vtp version

Configures the VTP version.

show vtp interface

To display the Virtual Trunking Protocol (VTP) interface status and configuration, use the show vtp interface command.

show vtp interface [if-identifier]

Syntax Description

if-identifier

(Optional) Identifier of an interface. Examples are ethernet 3/22 or port channel 120.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

5.1(1)

This command was introduced.

Usage Guidelines

If a single interface is specified, the information for that interface alone is presented to the user; otherwise, the command applies to all currently active interfaces.

This command does not require a license.

Examples

This example shows how to display the VTP interface status and configuration on the device:

switch# show vtp interface ethernet 3/22
 
 Interface         VTP Status
--------------------------------
Ethernet3/22        Enabled
switch#
 
switch# show vtp interface
 
 Interface         VTP Status
--------------------------------
Ethernet1/8         Enabled
Ethernet3/2         Disabled
Ethernet3/22        Enabled
switch#

Related Commands

Command

Description

show vtp counters

Displays VTP statistics information.

show interface pruning

Displays interface trunk VTP pruning information.

show interface counters

Displays information about the statistics for the specified VLANs.

show vtp password

To display a Virtual Trunking Protocol (VTP) password, use the show vtp password command.

show vtp password

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

5.1(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display a VTP password on the device:

switch# show vtp password squ1rrel
VTP password:
switch#

Related Commands

Command

Description

feature vtp

Enables VTP on the device.

vtp domain

Configures the VTP domain name.

vtp version

Configures the VTP version.

show vtp status

To display the Virtual Trunking Protocol (VTP) information, use the show vtp status command.

show vtp status

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.1(2)

This command was introduced.

Usage Guidelines

This command is not available if VTP is not enabled.


Note


You cannot enable or configure VTP pruning or V2 modes.

This command does not require a license.

Examples

This example shows how to display information about VTP on the device:

switch# show vtp status
VTP Status Information
----------------------
VTP Version                     : 2 (capable)
Configuration Revision          : 1
Maximum VLANs supported locally : 1005
Number of exisiting VLANs       : 17
VTP Operating Mode              : Server
VTP Domain Name                 :
VTP Pruning Mode                : Disabled (Operationally Disabled)
VTP V2 Mode                     : Disabled
MD5 Digest                      : 0x8D 0x0D 0xB4 0xE8 0xC3 0x3C 0x7F 0x99
Configuration last modified by 0.0.0.0 at 6-30-10 18:05:13
VTP version running             : 1
switch#

Related Commands

Command

Description

feature vtp

Enables VTP on the device.

vtp domain

Configures the VTP domain name.

vtp version

Configures the VTP version.

shutdown (VLAN configuration)

To shut down the local traffic on a VLAN, use the shutdown command. To return a VLAN to its default operational state, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Command Default

no shutdown

Command Modes

VLAN configuration submode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

You cannot shut down, or disable, VLAN 1 or VLANs 1006 to 4094.

Once you shut down a VLAN, the traffic ceases to flow on that VLAN. Access ports on that VLAN are also brought down; trunk ports continue to carry traffic for the other VLANs allowed on that port. However, the interface associations for the specified VLAN remain, and when you reenable, or recreate, that specified VLAN, the device automatically reinstates all the original ports to that VLAN.

To find out if a VLAN has been shut down internally, check the Status field in the show vlan command output. If a VLAN is shut down internally, one of these values appears in the Status field:

  • act/lshut—VLAN status is active and shut down internally.
  • sus/lshut—VLAN status is suspended and shut down internally.

Note


If the VLAN is suspended and shut down, you use both the no shutdown and state active commands to return the VLAN to the active state.

This command does not require a license.

Examples

This example shows how to restore local traffic on VLAN 2 after you have shut down, or disabled, the VLAN:

switch(config)# vlan 2
switch(config-vlan)# no shutdown
switch(config-vlan)#

Related Commands

Command

Description

show vlan

Displays VLAN information.

show forwarding consistency l2

To display information about discrepant, missing, or extra MAC addresses between the supervisor and the module, use the show forwarding consistency l2 command.

show forwarding consistency l2 module

Syntax Description

module

Module number that you are comparing with the supervisor MAC address table.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.1(2)

This command was introduced.

Usage Guidelines

Optimally, all the MAC address tables on each module match the MAC address table on the supervisor.

This command does not require a license.

Examples

This example shows how to display hardware information about all the MAC addresses for VLAN 1 on module 2:

switch# show forwarding consistency l2 9
Legend:         * - primary entry, G - Gateway MAC, (R) - Routed MAC        age - seconds since last seen
Missing entries in the MAC Table  VLAN       MAC Address       Type        age    Secure  NTFY   Ports ---------+-----------------+--------+---------+------+------+----------------------------------
G     -    0018.bad7.e115    static       -     False  False   sup-eth1(R)
* 1        0001.1234.5600    static       -     False  False   Eth9/25G 
2          0018.bad7.e115    static       -     False  False   sup-eth1(R)G
3          0018.bad7.e115    static       -     False  False   sup-eth1(R)
Extra and Discrepant entries in the MAC Table
   VLAN     MAC Address      Type      age     Secure  NTFY    Ports ---------+-----------------+--------+---------+------+------+----------------
G     -     0018.bad7.dc15    static       -     False  False   sup-eth1(R)
* 1         0001.1234.5601    static       -     False  False    Eth9/25

Related Commands

Command

Description

show mac address-table

Displays information about the MAC address table.

show hardware mac address-table

To display information about the hardware MAC addresses, use the show hardware mac address-table command.

show hardware mac address table module

address mac-address [ interface { ethernet slot-port | port-channel channel-number } ] [ vlan vlan-id ]

dynamic [ address mac-address ] [ interface { ethernet slot /port | port-channel channel-number } ] [ vlan vlan-id ]

interface { ethernet slot /port | port-channel channel-number } [ address mac-address ] [ vlan vlan-id ]

static [ address mac-address ] [ interface { ethernet slot /port | port-channel channel-number } ] [ vlan vlan-id ]

vlan vlan-id [ address mac-address ] [ interface { ethernet slot /port | port-channel channel-number } ]

Syntax Description

module

Module number.

address macaddress

(Optional) Specifies the MAC address in the format of X.X.X, XX-XX-XX-XX-XX-XX, XX:XX:XX:XX:XX:XX, XXXX.XXXX.XXXX.

interface

(Optional) Specifies the interface.

ethernet slot/port

Displays the Ethernet interface. Use either t he type of interface, the slot number, or the port number. The range is from 1 to 253.

port-channel channel-number

Displays the port channel interface and port-channel number. The range is from 1 to 4096.

vlan vlan-id

(Optional) Specifies the VLAN number .

dynamic

(Optional) Specifies dynamic entries only .

static

(Optional) Specifies static entries only .

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

The fields are as follows:

  • Valid—Entry is valid in the hardware.
  • PI—Primary entry.
  • BD—Bridge domain.
  • MAC—MAC address.
  • Index—Destination index; identifies the port on which the MAC address was learned.
  • Static—Statically configured entry. The hardware does not modify this entry. This entry is not be aged by the line card process.
  • SW—3-bit software value associated with this entry.
  • Modified—MAC address entry that was modified by the hardware since the last notification. This value is set when index value changes.
  • Age byte—Age timer value when the last packet arrived with this entry’s MAC address as the source MAC address.
  • Tmr sel—Age timer used for updating the age for this entry. Based on the aging value configured for the VLAN, one of the four timers is used for updating the age.
  • GM—Gateway MAC address.
  • Secure—Secured MAC address.
  • TRAP—When this bit is set, the system drops any packet received with this source MAC address as this entry’s trap bit MAC address.
  • NTFY—Notify bit. When the Secured and Notify bits are both set, the system redirects packets to the supervisor when the hardware updates the index value.
  • RM—Router MAC address.
  • RMA—Router MAC address that is active.

Note


The RM and RMA fields are not supported on the Cisco Nexus 7000. Series device.
  • Capture bit—When this bit is set, any packet sent to this destination is copied by setting the CAP1 bit.
  • Fld—Flood bit. When this bit is set, any packet sent to this destination MAC causes the flood bit to be set in the result.
  • Always learn—Always learn. When this bit is set, the hardware modifies the index value irrespective of whether this bit entry is marked static or not.

This command does not require a license.

Examples

This example shows how to display hardware information about all the MAC addresses for VLAN 1 on module 2:

switch# show hardware mac address-table 2 vlan 1
Valid| PI| BD |      MAC      |  Index |Stat| SW| Modi| Age| Tmr| GM| Sec| TR | NT | RM | RMA | Cap|Fld| Always
     |   |    |               |        |  ic|   | fied|Byte| Sel|    |ure| AP | FY |    |     |TURE|   |  Learn
-----+---+----+---------------+--------+----+---+-----+----+----+----+----+---+----+----+-----+----+---+-------
  1    0    1  0100.0cff.fffe  0x00421    1   1    0   152   0     0   0    0    0    0     0   1    0      0

Related Commands

Command

Description

show mac address-table

Displays information about the MAC address table.

show interface mac-address

To display information about the MAC address and the burned-in MAC address, use the show interface mac-address command.

show interface [ type slot/port ] mac-address

Syntax Description

type slot/port

(Optional) T ype of interface, slot number, and port number.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

If you do not specify the interface, the system displays all the MAC addresses. This command displays both the burned-in MAC address and the configured MAC address.

This command does not require a license.

Examples

This example shows how to display information about all the MAC addresses for the device:

switch# show interface mac-address
-----------------------------------------------------------------------------
Interface                  Mac-Address     Burn-in Mac-Address
-----------------------------------------------------------------------------
mgmt0                      0019.076c.1a78  0019.076c.1a78
Ethernet2/1                0000.0000.0000  0019.076c.4dac
Ethernet2/2                0000.0000.0000  0019.076c.4dad
Ethernet2/3                0000.0000.0000  0019.076c.4dae
Ethernet2/4                0000.0000.0000  0019.076c.4daf
Ethernet2/5                0000.0000.0000  0019.076c.4db0
Ethernet2/6                0000.0000.0000  0019.076c.4db1
Ethernet2/7                0000.0000.0000  0019.076c.4db2
Ethernet2/8                0000.0000.0000  0019.076c.4db3
Ethernet2/9                0000.0000.0000  0019.076c.4db4
Ethernet2/10               0000.0000.0000  0019.076c.4db5
Ethernet2/11               0000.0000.0000  0019.076c.4db6
Ethernet2/12               0000.0000.0000  0019.076c.4db7
Ethernet2/13               0000.0000.0000  0019.076c.4db8
Ethernet2/14               0000.0000.0000  0019.076c.4db9
Ethernet2/15               0000.0000.0000  0019.076c.4dba
Ethernet2/16               0000.0000.0000  0019.076c.4dbb
Ethernet2/17               0000.0000.0000  0019.076c.4dbc
Ethernet2/18               0000.0000.0000  0019.076c.4dbd
Ethernet2/19               0000.0000.0000  0019.076c.4dbe
Ethernet2/20               0000.0000.0000  0019.076c.4dbf
Ethernet2/21               0000.0000.0000  0019.076c.4dc0
Ethernet2/22               0000.0000.0000  0019.076c.4dc1
Ethernet2/23               0000.0000.0000  0019.076c.4dc2
Ethernet2/24               0000.0000.0000  0019.076c.4dc3
Ethernet2/25               0000.0000.0000  0019.076c.4dc4
Ethernet2/26               0000.0000.0000  0019.076c.4dc5
Ethernet2/27               0000.0000.0000  0019.076c.4dc6
Ethernet2/28               0000.0000.0000  0019.076c.4dc7
Ethernet2/29               0000.0000.0000  0019.076c.4dc8
Ethernet2/30               0000.0000.0000  0019.076c.4dc9
Ethernet2/31               0000.0000.0000  0019.076c.4dca
Ethernet2/32               0000.0000.0000  0019.076c.4dcb
Ethernet2/33               0000.0000.0000  0019.076c.4dcc
Ethernet2/34               0000.0000.0000  0019.076c.4dcd
Ethernet2/35               0000.0000.0000  0019.076c.4dce
Ethernet2/36               0000.0000.0000  0019.076c.4dcf
Ethernet2/37               0000.0000.0000  0019.076c.4dd0
Ethernet2/38               0000.0000.0000  0019.076c.4dd1
Ethernet2/39               0000.0000.0000  0019.076c.4dd2
Ethernet2/40               0000.0000.0000  0019.076c.4dd3
Ethernet2/41               0000.0000.0000  0019.076c.4dd4
Ethernet2/42               0000.0000.0000  0019.076c.4dd5
Ethernet2/43               0000.0000.0000  0019.076c.4dd6
Ethernet2/44               0000.0000.0000  0019.076c.4dd7
Ethernet2/45               0000.0000.0000  0019.076c.4dd8
Ethernet2/46               0000.0000.0000  0019.076c.4dd9
Ethernet2/47               0000.0000.0000  0019.076c.4dda
Ethernet2/48               0000.0000.0000  0019.076c.4ddb
port-channel5              0000.0000.0000  0000.0000.0000
port-channel20             0000.0000.0000  0000.0000.0000
port-channel30             0000.0000.0000  0000.0000.0000
port-channel50             0000.0000.0000  0000.0000.0000

Related Commands

Command

Description

show mac address-table

Displays information about the MAC address table.

mac address-table static

Adds static entries to the MAC-address table or configures a static MAC address with IGMP snooping disabled for that address.

show interface private-vlan mapping

To display information about the private VLAN mapping for the primary VLAN interfaces, use the show interface private-vlan mapping command.

show interface private-vlan mapping

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

You can use this command to display the primary and secondary VLAN mapping that allows both VLANs to share the VLAN interface of the primary VLAN.

This command does not require a license.

Examples

This example shows how to display information about the primary and secondary private VLAN mapping:

switch# show interface private-vlan mapping
switch(config)# show interface private-vlan mapping
Interface Secondary VLAN Type
--------- -------------- -----------------
vlan200   201            isolated
vlan200   202            community

Related Commands

Command

Description

show interface switchport

Displays information about the switchports, including those in private VLANs.

show vlan private-vlan

Displays information about all private VLANs on the device.

show interface pruning

To display interface trunk Virtual Trunking Protocol (VTP) pruning information, use the show interface pruning command.

show interface pruning

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Any command mode

Supported User Roles

network-admin

vdc-admin

Command History

Release

Modification

5.1(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to display interface trunk VTP pruning information on the device:

switch# show interface pruning
Port            Vlans pruned for lack of request by neighbor
Ethernet1/33    10
Ethernet1/34    10
 
Port                Vlan traffic requested of neighbor
Ethernet1/33        1 <<<<<
Ethernet1/34        1 <<<<<
switch#

Related Commands

Command

Description

feature vtp

Enables VTP on the device.

vtp domain

Configures the VTP domain name.

vtp version

Configures the VTP version.