Cisco Nexus 5000 Series Command Reference
Ethernet Show Commands
Downloads: This chapterpdf (PDF - 360.0KB) The complete bookPDF (PDF - 3.84MB) | Feedback

Ethernet Show Commands

Table Of Contents

Ethernet Show Commands

show interface brief

show interface capabilities

show interface debounce

show interface ethernet

show interface port-channel

show interface mac-address

show interface private-vlan mapping

show interface status err-disabled

show interface switchport

show interface transceiver

show interface vlan

show ip igmp snooping

show lacp

show mac address-table aging-time

show mac address-table count

show mac address-table notification

show mac address-table

show monitor session

show port-channel capacity

show port-channel compatibility-parameters

show port-channel database

show port-channel load-balance

show port-channel summary

show port-channel traffic

show port-channel usage

show resource

show running-config

show running-config spanning-tree

show running-config vlan

show spanning-tree

show spanning-tree active

show spanning-tree bridge

show spanning-tree brief

show spanning-tree detail

show spanning-tree interface

show spanning-tree mst

show spanning-tree root

show spanning-tree summary

show spanning-tree vlan

show startup-config

show tech-support port-channel

show udld

show vlan

show vlan dot1Q tag native

show vlan id

show vlan private-vlan

show vtp status


Ethernet Show Commands


This chapter describes the Cisco NX-OS Ethernet show commands available on Cisco Nexus 5000 Series switches.

show interface brief

To display a brief summary of the interface configuration information, use the show interface brief command.

show interface brief

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the summary configuration information of the specified interface:

switch# show interface brief 

--------------------------------------------------------------------------------
Ethernet      VLAN   Type Mode   Status  Reason                   Speed     Port
Interface                                                                   Ch #
--------------------------------------------------------------------------------
Eth1/1        1      eth  trunk  up      none                        10G(D) 4000
Eth1/2        1      eth  trunk  up      none                        10G(D) 4000
Eth1/3        1      eth  trunk  up      none                        10G(D) 4000
Eth1/4        1      eth  trunk  up      none                        10G(D) 4000
Eth1/5        1      eth  access down    SFP not inserted            10G(D) --
Eth1/6        1      eth  access down    SFP not inserted            10G(D) --
Eth1/7        1      eth  trunk  up      none                        10G(D) 10
Eth1/8        1      eth  trunk  up      none                        10G(D) 10
Eth1/9        1      eth  trunk  up      none                        10G(D) 10
Eth1/10       1      eth  trunk  up      none                        10G(D) 10
Eth1/11       1      eth  access down    SFP not inserted            10G(D) --
Eth1/12       1      eth  access down    SFP not inserted            10G(D) --
Eth1/13       1      eth  access down    SFP not inserted            10G(D) --
Eth1/14       1      eth  access down    SFP not inserted            10G(D) --
Eth1/15       1      eth  access down    SFP not inserted            10G(D) --
Eth1/16       1      eth  access down    SFP not inserted            10G(D) --
Eth1/17       1      eth  access down    SFP not inserted            10G(D) --
Eth1/18       1      eth  access down    SFP not inserted            10G(D) --
Eth1/19       1      eth  access down    SFP not inserted            10G(D) --
Eth1/20       1      eth  access down    SFP not inserted            10G(D) --
Eth1/21       1      eth  access down    SFP not inserted            10G(D) --
Eth1/22       1      eth  access down    SFP not inserted            10G(D) --
Eth1/23       1      eth  access down    Link not connected          10G(D) --
Eth1/24       1      eth  access down    Link not connected          10G(D) --
Eth1/25       1      eth  access down    SFP not inserted            10G(D) --
Eth1/26       1      eth  access down    SFP not inserted            10G(D) --
Eth1/27       1      eth  access down    SFP not inserted            10G(D) --
Eth1/28       1      eth  access down    SFP not inserted            10G(D) --
Eth1/29       1      eth  access down    SFP not inserted            10G(D) --
Eth1/30       1      eth  access down    SFP not inserted            10G(D) --
Eth1/31       1      eth  access down    SFP not inserted            10G(D) --
Eth1/32       1      eth  access down    SFP not inserted            10G(D) --
Eth1/33       1      eth  access down    SFP not inserted            10G(D) --
Eth1/34       1      eth  access down    SFP not inserted            10G(D) --
Eth1/35       1      eth  access down    SFP not inserted            10G(D) --
Eth1/36       1      eth  access down    SFP not inserted            10G(D) --
Eth1/37       1      eth  access down    SFP not inserted            10G(D) --
Eth1/38       1      eth  access down    SFP not inserted            10G(D) --
Eth1/39       1      eth  access down    SFP not inserted            10G(D) --
Eth1/40       1      eth  trunk  up      none                        10G(D) --
Eth2/1        1      eth  access down    SFP not inserted            10G(D) --
Eth2/2        1      eth  access up      none                        10G(D) --
Eth2/3        1      eth  access down    SFP not inserted            10G(D) --
Eth2/4        1      eth  access up      none                        10G(D) --
Eth2/5        1      eth  access up      none                        10G(D) --
Eth2/6        1      eth  access down    SFP not inserted            10G(D) --

--------------------------------------------------------------------------------
Port-channel VLAN  Type Mode   Status  Reason                    Speed  Protocol
Interface
--------------------------------------------------------------------------------
Po10         1     eth  trunk  up      none                       a-10G(D)  lacp
Po4000       1     eth  trunk  up      none                       a-10G(D)  lacp

--------------------------------------------------------------------------------
Port   VRF          Status IP Address                              Speed    MTU
--------------------------------------------------------------------------------
mgmt0  --           up     192.168.10.37                           100      1500

-------------------------------------------------------------------------------
Interface Secondary VLAN(Type)                    Status Reason
-------------------------------------------------------------------------------
Vlan1     --                                      down   Administratively down

switch#

Related Commands

Command
Description

interface ethernet

Configures an Ethernet IEEE 802.3 interface.


show interface capabilities

To display detailed information about the capabilities of an interface, use the show interface capabilities command.

show interface ethernet slot/port capabilities

Syntax Description

ethernet slot/port

Specifies an Ethernet interface slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

You can use the show interface capabilities command only for physical interfaces.

Examples

This example shows how to display the interface capabilities for a specific interface:

switch# show interface ethernet 1/1 capabilities 
Ethernet1/1
  Model:                 N5K-C5020P-BF-XL-SU
  Type (SFP capable):    SFP-H10GB-CU1M
  Speed:                 1000,10000
  Duplex:                full
  Trunk encap. type:     802.1Q
  Channel:               yes
  Broadcast suppression: percentage(0-100)
  Flowcontrol:           rx-(off/on),tx-(off/on)
  Rate mode:             none
  QOS scheduling:        rx-(6q1t),tx-(1p6q0t)
  CoS rewrite:           no
  ToS rewrite:           no
  SPAN:                  yes
  UDLD:                  yes
  Link Debounce:         yes
  Link Debounce Time:    yes
  MDIX:                  no
  Pvlan Trunk capable:   yes
  TDR capable:           no
  Port mode:             Switched
  FEX Fabric:            yes

switch#

Related Commands

Command
Description

interface ethernet

Configures an Ethernet IEEE 802.3 interface.


show interface debounce

To display the debounce time information for all interfaces, use the show interface debounce command.

show interface debounce

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the debounce status of all interfaces:

switch# show interface debounce 

--------------------------------------------------------------------------------
Port          Debounce time   Value(ms)
--------------------------------------------------------------------------------
Eth1/1        enable               100
Eth1/2        enable               100
Eth1/3        enable               100
Eth1/4        enable               100
Eth1/5        enable               100
Eth1/6        enable               100
Eth1/7        enable               100
Eth1/8        enable               100
Eth1/9        enable               100
Eth1/10       enable               100
Eth1/11       enable               100
Eth1/12       enable               100
Eth1/13       enable               100
Eth1/14       enable               100
Eth1/15       enable               100
Eth1/16       enable               100
Eth1/17       enable               100
Eth1/18       enable               100
Eth1/19       enable               100
Eth1/20       enable               100
Eth1/21       enable               100
Eth1/22       enable               100
Eth1/23       enable               100
Eth1/24       enable               100
Eth1/25       enable               100
Eth1/26       enable               100
Eth1/27       enable               100
Eth1/28       enable               100
Eth1/29       enable               100
Eth1/30       enable               100
Eth1/31       enable               100
Eth1/32       enable               100
--More--
switch#

Related Commands

Command
Description

link debounce

Enables the debounce timer on an interface.


show interface ethernet

To display information about the interface configuration, use the show interface ethernet command.

show interface ethernet slot/port [counters | description | status]

Syntax Description

slot/port

Ethernet interface slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

counters

(Optional) Displays information about the counters configured on an interface.

description

(Optional) Displays the description of an interface configuration.

status

(Optional) Displays the operational state of the interface.


Command Default

Displays all information for the interface.

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the detailed configuration of the specified interface:

switch# show interface ethernet 1/1 
Ethernet1/1 is up
  Hardware: 1000/10000 Ethernet, address: 000d.ece7.df48 (bia 000d.ece7.df48)
  MTU 1500 bytes, BW 10000000 Kbit, DLY 10 usec,
     reliability 255/255, txload 1/255, rxload 1/255
  Encapsulation ARPA
  Port mode is fex-fabric
  full-duplex, 10 Gb/s, media type is 1/10g
  Beacon is turned off
  Input flow-control is off, output flow-control is off
  Rate mode is dedicated
  Switchport monitor is off
  Last link flapped 09:03:57
  Last clearing of "show interface" counters never
  30 seconds input rate 2376 bits/sec, 0 packets/sec
  30 seconds output rate 1584 bits/sec, 0 packets/sec
  Load-Interval #2: 5 minute (300 seconds)
    input rate 1.58 Kbps, 0 pps; output rate 792 bps, 0 pps
  RX
    0 unicast packets  10440 multicast packets  0 broadcast packets
    10440 input packets  11108120 bytes
    0 jumbo packets  0 storm suppression packets
    0 runts  0 giants  0 CRC  0 no buffer
    0 input error  0 short frame  0 overrun   0 underrun  0 ignored
    0 watchdog  0 bad etype drop  0 bad proto drop  0 if down drop
    0 input with dribble  0 input discard
    0 Rx pause
  TX
    0 unicast packets  20241 multicast packets  105 broadcast packets
    20346 output packets  7633280 bytes
    0 jumbo packets
    0 output errors  0 collision  0 deferred  0 late collision
    0 lost carrier  0 no carrier  0 babble
    0 Tx pause
  1 interface resets

switch#

This example shows how to display the counters configured on a specified interface:

switch# show interface ethernet 1/1 counters 

--------------------------------------------------------------------------------
Port                InOctets       InUcastPkts      InMcastPkts      InBcastPkts
--------------------------------------------------------------------------------
Eth1/1              17193136                 0            16159                0
--------------------------------------------------------------------------------
Port               OutOctets      OutUcastPkts     OutMcastPkts     OutBcastPkts
--------------------------------------------------------------------------------
Eth1/1	           11576758                 0            28326              106
switch#

Related Commands

Command
Description

interface ethernet

Configures an Ethernet IEEE 802.3 interface.


show interface port-channel

To display the information about an EtherChannel interface configuration, use the show interface port-channel command.

show interface port-channel number[.subinterface-number] [brief | counters | description | status]

Syntax Description

number

EtherChannel number. The range is from 1 to 4096.

.subinterface-number

(Optional) Port-channel subinterface configuration. Use the EtherChannel number followed by a dot (.) indicator and the subinterface number. The format is portchannel-number.subinterface-number.

counters

(Optional) Displays information about the counters configured on the EtherChannel interface.

description

(Optional) Displays the description of the EtherChannel interface configuration.

status

(Optional) Displays the operational state of the EtherChannel interface.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the configuration information of a specified EtherChannel interface:

switch# show interface port-channel 21 
port-channel21 is up
  Hardware: Port-Channel, address: 000d.ece7.df72 (bia 000d.ece7.df72)
  MTU 1500 bytes, BW 10000000 Kbit, DLY 10 usec,
     reliability 255/255, txload 1/255, rxload 1/255
  Encapsulation ARPA
  Port mode is trunk
  full-duplex, 10 Gb/s
  Beacon is turned off
  Input flow-control is on, output flow-control is on
  Switchport monitor is off
  Members in this channel: Eth2/3
  Last clearing of "show interface" counters never
  30 seconds input rate 0 bits/sec, 0 packets/sec
  30 seconds output rate 352 bits/sec, 0 packets/sec
  Load-Interval #2: 5 minute (300 seconds)
    input rate 0 bps, 0 pps; output rate 368 bps, 0 pps
  RX
    0 unicast packets  0 multicast packets  0 broadcast packets
    0 input packets  0 bytes
    0 jumbo packets  0 storm suppression packets
    0 runts  0 giants  0 CRC  0 no buffer
    0 input error  0 short frame  0 overrun   0 underrun  0 ignored
    0 watchdog  0 bad etype drop  0 bad proto drop  0 if down drop
    0 input with dribble  0 input discard
    0 Rx pause
  TX
    0 unicast packets  15813 multicast packets  9 broadcast packets
    15822 output packets  1615917 bytes
    0 jumbo packets
    0 output errors  0 collision  0 deferred  0 late collision
    0 lost carrier  0 no carrier  0 babble
    0 Tx pause
  1 interface resets

switch#

Related Commands

Command
Description

interface port-channel

Configures an EtherChannel interface.


show interface mac-address

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

show interface [type slot/port | portchannel-no] mac-address

Syntax Description

type

(Optional) Interface for which MAC addresses should be displayed. The type can be either Ethernet or EtherChannel.

slot/port

Ethernet interface port number and slot number. The slot number is from 1 to 255, and the port number is from 1 to 128.

portchannel-no

EtherChannel number. The EtherChannel number is from 1 to 4096.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

If you do not specify an interface, the system displays all the MAC addresses.

Examples

This example shows how to display the information on MAC addresses for the entire switch:

switch# show interface mac-address 

----------------------------------------------------------------------------
Interface                  Mac-Address     Burn-in Mac-Address
----------------------------------------------------------------------------
Ethernet1/1                0005.9b78.6e7c  0005.9b78.6e48
Ethernet1/2                0005.9b78.6e7c  0005.9b78.6e49
Ethernet1/3                0005.9b78.6e7c  0005.9b78.6e4a
Ethernet1/4                0005.9b78.6e7c  0005.9b78.6e4b
Ethernet1/5                0005.9b78.6e7c  0005.9b78.6e4c
Ethernet1/6                0005.9b78.6e7c  0005.9b78.6e4d
Ethernet1/7                0005.9b78.6e7c  0005.9b78.6e4e
Ethernet1/8                0005.9b78.6e7c  0005.9b78.6e4f
Ethernet1/9                0005.9b78.6e7c  0005.9b78.6e50
Ethernet1/10               0005.9b78.6e7c  0005.9b78.6e51
Ethernet1/11               0005.9b78.6e7c  0005.9b78.6e52
Ethernet1/12               0005.9b78.6e7c  0005.9b78.6e53
Ethernet1/13               0005.9b78.6e7c  0005.9b78.6e54
Ethernet1/14               0005.9b78.6e7c  0005.9b78.6e55
Ethernet1/15               0005.9b78.6e7c  0005.9b78.6e56
Ethernet1/16               0005.9b78.6e7c  0005.9b78.6e57
Ethernet1/17               0005.9b78.6e7c  0005.9b78.6e58
Ethernet1/18               0005.9b78.6e7c  0005.9b78.6e59
Ethernet1/19               0005.9b78.6e7c  0005.9b78.6e5a
Ethernet1/20               0005.9b78.6e7c  0005.9b78.6e5b
Ethernet1/21               0005.9b78.6e7c  0005.9b78.6e5c
Ethernet1/22               0005.9b78.6e7c  0005.9b78.6e5d
--More--
switch# 

This example shows how to display the MAC address information for a specific port channel:

switch# show interface port-channel 5 mac-address 

------------------------------------------------------------------------
Interface                  Mac-Address     Burn-in Mac-Address
------------------------------------------------------------------------
port-channel5              0005.9b78.6e7c  0005.9b78.6e7c
switch#

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

Displays information on the MAC address table.


show interface private-vlan mapping

To display information about private VLAN mapping for 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

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

Before you can configure private VLANs, you must enable them by using the feature private-vlan command. The commands for configuring private VLANs are not visible until you enable private VLANs.

This command displays the mapping information between the primary and secondary VLANs that allows both VLANs to share the VLAN interface of the primary VLAN.

Examples

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

switch# show interface private-vlan mapping 

Related Commands

Command
Description

feature private-vlan

Enables private VLANs.

show interface switchport

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

show vlan

Displays summary information for all VLANs.

show vlan private-vlan

Displays information for all private VLANs on the device.


show interface status err-disabled

To display the error disabled state of interfaces, use the show interface status err-disabled command.

show interface status err-disabled

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.2(1)N1(1)

This command was introduced.


Examples

This example shows how to display the error disabled state of interfaces:

switch# show interface status err-disabled 

-----------------------------------------------------------------------
Port         Name               Status   Reason
-----------------------------------------------------------------------
Eth114/1/27  --                 down     BPDUGuard errDisable
Eth114/1/28  --                 down     BPDUGuard errDisable
Eth114/1/29  --                 down     BPDUGuard errDisable
Eth114/1/30  --                 down     BPDUGuard errDisable
Eth114/1/31  --                 down     BPDUGuard errDisable
Eth114/1/32  --                 down     BPDUGuard errDisable
Eth114/1/33  --                 down     BPDUGuard errDisable
Eth114/1/34  --                 down     BPDUGuard errDisable
Eth114/1/35  --                 down     BPDUGuard errDisable
Eth114/1/36  --                 down     BPDUGuard errDisable
Eth114/1/39  --                 down     BPDUGuard errDisable
Eth114/1/40  --                 down     BPDUGuard errDisable
Eth114/1/41  --                 down     BPDUGuard errDisable
Eth114/1/42  --                 down     BPDUGuard errDisable
Eth114/1/43  --                 down     BPDUGuard errDisable
Eth114/1/44  --                 down     BPDUGuard errDisable
Eth114/1/45  --                 down     BPDUGuard errDisable
Eth114/1/46  --                 down     BPDUGuard errDisable
Eth114/1/47  --                 down     BPDUGuard errDisable
--More--
switch#

Related Commands

Command
Description

errdisable detect cause

Enables the errror disabled (err-disabled) detection.

errdisable recovery cause

Enables errror disabled recovery on an interface.


show interface switchport

To display information about all the switch port interfaces, use the show interface switchport command.

show interface switchport

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display information for all Ethernet interfaces:

switch# show interface switchport 
Name: Ethernet1/1
  Switchport: Enabled
  Switchport Monitor: Not enabled
  Operational Mode: fex-fabric
  Access Mode VLAN: 1 (default)
  Trunking Native Mode VLAN: 1 (default)
  Trunking VLANs Enabled: 1-3967,4048-4093
  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:
  Operational private-vlan: none
  Unknown unicast blocked: disabled
  Unknown multicast blocked: disabled

Name: Ethernet1/2
  Switchport: Enabled
  Switchport Monitor: Not enabled
  Operational Mode: fex-fabric
  Access Mode VLAN: 1 (default)
  Trunking Native Mode VLAN: 1 (default)
  Trunking VLANs Enabled: 1-3967,4048-4093
  Administrative private-vlan primary host-association: none
--More--
switch#

Related Commands

Command
Description

switchport access vlan

Sets the access VLAN when the interface is in access mode.


show interface transceiver

To display the information about the transceivers connected to a specific interface, use the show interface transceiver command.

show interface ethernet slot/port transceiver [details]

Syntax Description

ethernet slot/port

Displays information about an Ethernet interface slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

details

(Optional) Displays detailed information about the transceivers on an interface.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

You can use the show interface transceiver command only for physical interfaces.

Examples

This example shows how to display the transceivers connected to a specified Ethernet interface:

switch# show interface ethernet 1/1 transceiver 
Ethernet1/1
    transceiver is present
    type is SFP-H10GB-CU1M
    name is CISCO-MOLEX
    part number is 74752-9044
    revision is 07
    serial number is MOC14081360
    nominal bitrate is 10300 MBit/sec
    Link length supported for copper is 1 m
    cisco id is --
    cisco extended id number is 4

switch#

Related Commands

Command
Description

interface ethernet

Configures an Ethernet IEEE 802.3 interface.

show interface capabilities

Displays detailed information about the capabilities of an interface.


show interface vlan

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

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

Syntax Description

vlan-id

Number of the VLAN. The range is from 1 to 4094.

brief

(Optional) Displays a summary information for the specified VLAN.

private-vlan mapping

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


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

You must enable interface VLANs by using the feature interface-vlan or the svi enable command. The commands for configuring interface VLANs are not visible until you enable this feature.

This command displays descriptive information for the specified VLAN, including private VLANs.

The switch displays output for the show interface vlan vlan-id private-vlan mapping command only when you specify a primary private VLAN. If you specify a secondary private VLAN, the output is blank.

Examples

This example shows how to display information about the specified VLAN:

switch# show interface vlan 10 
Vlan10 is up, line protocol is up
  Hardware is EtherSVI, address is  0005.9b78.6e7c
  MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec,

switch#

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

switch# show interface vlan 10 brief 

-------------------------------------------------------------------------
Interface Secondary VLAN(Type)                    Status Reason
-------------------------------------------------------------------------
Vlan10    --                                      up     --
switch#

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

switch# show interface vlan 10 private-vlan mapping 

When you specify a primary VLAN, the switch displays all secondary VLANs mapped to that primary VLAN.

Related Commands

Command
Description

show interface switchport

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

show vlan

Displays summary information for all VLANs.

show vlan private-vlan

Displays summary information for all private VLANs.


show ip igmp snooping

To display the Internet Group Management Protocol (IGMP) snooping configuration of the switch, use the show ip igmp snooping command.

show ip igmp snooping [explicit-tracking vlan vlan-id | groups [detail | vlan vlan-id] | mrouter [vlan vlan-id] | querier [vlan vlan-id] | vlan vlan-id]

Syntax Description

explicit-tracking

(Optional) Displays information about the explicit host-tracking status for IGMPv3 hosts. If you provide this keyword, you must specify a VLAN.

vlan vlan-id

(Optional) Specifies a VLAN. The VLAN ID range is from1 to 4094.

groups

(Optional) Displays information for the IGMP group address.

detail

(Optional) Displays detailed information for the group.

mrouter

(Optional) Displays information about dynamically detected multicast routers.

querier

(Optional) Displays information about the snooping querier if defined.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the IGMP snooping configuration of the switch:

switch# show ip igmp snooping 
Global IGMP Snooping Information:
  IGMP Snooping enabled
  IGMPv1/v2 Report Suppression enabled
  IGMPv3 Report Suppression disabled
  Link Local Groups Suppression enabled

IGMP Snooping information for vlan 1
  IGMP snooping enabled
  IGMP querier none
  Switch-querier disabled
  IGMPv3 Explicit tracking enabled
  IGMPv2 Fast leave disabled
  IGMPv1/v2 Report suppression enabled
  IGMPv3 Report suppression disabled
  Link Local Groups suppression enabled
  Router port detection using PIM Hellos, IGMP Queries
  Number of router-ports: 1
  Number of groups: 0
  VLAN vPC function enabled
  Active ports:
    Po19        Po400   Eth170/1/17     Eth171/1/7
    Eth171/1/8  Eth198/1/11     Eth199/1/13
IGMP Snooping information for vlan 300
  IGMP snooping enabled
  IGMP querier none
  Switch-querier disabled
  IGMPv3 Explicit tracking enabled
--More--
switch#

Related Commands

Command
Description

ip igmp snooping (EXEC)

Globally enables IGMP snooping. IGMP snooping must be globally enabled in order to be enabled on a VLAN.

ip igmp snooping (VLAN)

Enables IGMP snooping on the VLAN interface.


show lacp

To display Link Aggregation Control Protocol (LACP) information, use the show lacp command.

show lacp {counters | interface ethernet slot/port | neighbor [interface port-channel number] | port-channel [interface port-channel number] | system-identifier}

Syntax Description

counters

Displays information about the LACP traffic statistics.

interface ethernet slot/port

Displays LACP information for a specific Ethernet interface. The slot number is from 1 to 255, and the port number is from 1 to 128.

neighbor

Displays information about the LACP neighbor.

port-channel

Displays information about all EtherChannels.

interface port-channel number

(Optional) Displays information about a specific EtherChannel. The EtherChannel number is from 1 to 4096.

system-identifier

Displays the LACP system identification. It is a combination of the port priority and the MAC address of the device.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

Use the show lacp command to troubleshoot problems related to LACP in a network.

Examples

This example shows how to display the LACP system identification:

switch# show lacp system-identifier 
32768,0-5-9b-78-6e-7c
switch# 

This example shows how to display the LACP information for a specific interface:

switch# show lacp interface ethernet 1/1 
Interface Ethernet1/1 is up
  Channel group is 1 port channel is Po1
  PDUs sent: 1684
  PDUs rcvd: 1651
  Markers sent: 0
  Markers rcvd: 0
  Marker response sent: 0
  Marker response rcvd: 0
  Unknown packets rcvd: 0
  Illegal packets rcvd: 0
Lag Id: [ [(8000, 0-5-9b-78-6e-7c, 0, 8000, 101), (8000, 0-d-ec-c9-c8-3c, 0, 800
0, 101)] ]
Operational as aggregated link since Wed Apr 21 00:37:27 2010

Local Port: Eth1/1   MAC Address= 0-5-9b-78-6e-7c
  System Identifier=0x8000,0-5-9b-78-6e-7c
  Port Identifier=0x8000,0x101
  Operational key=0
  LACP_Activity=active
  LACP_Timeout=Long Timeout (30s)
  Synchronization=IN_SYNC
  Collecting=true
  Distributing=true
  Partner information refresh timeout=Long Timeout (90s)
Actor Admin State=(Ac-1:To-1:Ag-1:Sy-0:Co-0:Di-0:De-0:Ex-0)
Actor Oper State=(Ac-1:To-0:Ag-1:Sy-1:Co-1:Di-1:De-0:Ex-0)
Neighbor: 1/1
  MAC Address= 0-d-ec-c9-c8-3c
  System Identifier=0x8000,0-d-ec-c9-c8-3c
  Port Identifier=0x8000,0x101
  Operational key=0
  LACP_Activity=active
  LACP_Timeout=Long Timeout (30s)
  Synchronization=IN_SYNC
  Collecting=true
  Distributing=true
Partner Admin State=(Ac-0:To-1:Ag-0:Sy-0:Co-0:Di-0:De-0:Ex-0)
Partner Oper State=(Ac-1:To-0:Ag-1:Sy-1:Co-1:Di-1:De-0:Ex-0)
switch#

Related Commands

Command
Description

lacp port-priority

Sets the priority for the physical interfaces for the LACP.

lacp system-priority

Sets the system priority of the switch for the LACP.


show mac address-table aging-time

To display information about the time-out 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. The VLAN ID range is from 1 to 4094.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.2(1)N1(1)

The command syntax is changed to show mac address-table aging-time.


Examples

This example shows how to display MAC address aging times:

switch# show mac address-table aging-time 
Vlan  Aging Time
----- ----------
2023  300
2022  300
2021  300
2020  300
2019  300
2018  300
2017  300
2016  300
2015  300
2014  300
2013  300
2012  300
2011  300
2010  300
2009  300
2008  300
2007  300
2006  300
2005  300
2004  300
2003  300
--More--
switch#

Related Commands

Command
Description

mac address-table aging-time

Configures the aging time for entries in the MAC address table.

show mac address-table

Displays information about the MAC address table.


show mac address-table count

To display the number of entries currently in the MAC address table, use the show mac address-table count command.

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

Syntax Description

address EEEE.EEEE.EEEE

(Optional) Displays a count of the MAC address table entries for a specific address.

dynamic

(Optional) Displays a count of the dynamic MAC addresses.

static

(Optional) Displays a count of the static MAC addresses.

interface

(Optional) Specifies the interface. The interface can be Ethernet or EtherChannel.

ethernet slot/port

(Optional) Specifies the Ethernet interface slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

port-channel number

(Optional) Specifies the EtherChannel interface. The EtherChannel number is from 1 to 4096.

vlan vlan-id

(Optional) Displays information for a specific VLAN. The range is from 1 to 4094.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.2(1)N1(1)

The command syntax is changed to show mac address-table count.


Examples

This example shows how to display the number of dynamic entries currently in the MAC address table:

switch# show mac address-table count dynamic 
MAC Entries for all vlans:
Total MAC Addresses in Use: 7
switch#

Related Commands

Command
Description

show mac address-table

Displays information about the MAC address table.


show mac address-table notification

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

show mac address-table notification {mac-move | threshold}

Syntax Description

mac-move

Displays notification messages about MAC addresses that were moved.

threshold

Displays notification messages sent when the MAC address table threshold was exceeded.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.2(1)N1(1)

The command syntax is changed to show mac address-table notification.


Examples

This example shows how to display MAC address move notifications:

switch# show mac address-table notification mac-move 
MAC Move Notify : disabled
switch#

Related Commands

Command
Description

show mac address-table

Displays information about the MAC address table.


show mac address-table

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

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

Syntax Description

address mac-address

(Optional) Displays information about a specific MAC address.

dynamic

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

interface

(Optional) Specifies the interface. The interface can be either Ethernet or EtherChannel.

ethernet slot/port

(Optional) Specifies the Ethernet interface slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

port-channel number

(Optional) Specifies the EtherChannel interface. The EtherChannel number is from 1 to 4096.

multicast

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

static

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

vlan vlan-id

(Optional) Displays information for a specific VLAN. The VLAN ID range is from 1 to 4094.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.2(1)N1(1)

The command syntax is changed to show mac address-table.


Usage Guidelines

The switch maintains static MAC address entries that are saved in its startup configuration across reboots and flushes the dynamic entries.

Examples

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

switch# show mac address-table 
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC, O - Overlay MAC
        age - seconds since last seen,+ - primary entry using vPC Peer-Link
   VLAN     MAC Address      Type      age     Secure NTFY    Ports
---------+-----------------+--------+---------+------+----+------------------
+ 100      0000.0001.0003    dynamic   0          F    F  Po1
+ 100      0000.0001.0004    dynamic   0          F    F  Po1
+ 100      0000.0001.0009    dynamic   0          F    F  Po1
+ 100      0000.0001.0010    dynamic   0          F    F  Po1
* 1        001d.7172.6c40    dynamic   300        F    F  Eth100/1/20
switch#

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

switch# show mac address-table address 0018.bad8.3fbd 

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

switch# show mac address-table dynamic 
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC, O - Overlay MAC
        age - seconds since last seen,+ - primary entry using vPC Peer-Link
   VLAN     MAC Address      Type      age     Secure NTFY    Ports
---------+-----------------+--------+---------+------+----+------------------
+ 100      0000.0001.0003    dynamic   0          F    F  Po1
+ 100      0000.0001.0004    dynamic   0          F    F  Po1
+ 100      0000.0001.0009    dynamic   0          F    F  Po1
+ 100      0000.0001.0010    dynamic   0          F    F  Po1
* 1        001d.7172.6c40    dynamic   300        F    F  Eth100/1/20
switch#

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

switch# show mac address-table interface ethernet 1/3 

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

switch# show mac address-table static  

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

switch# show mac address-table vlan 1 
Legend:
        * - primary entry, G - Gateway MAC, (R) - Routed MAC, O - Overlay MAC
        age - seconds since last seen,+ - primary entry using vPC Peer-Link
   VLAN     MAC Address      Type      age     Secure NTFY    Ports
---------+-----------------+--------+---------+------+----+------------------
* 1        001d.7172.6c40    dynamic   60         F    F  Eth100/1/20
switch#

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

Displays information about the time-out values for the MAC address table.

show mac address-table count

Displays the number of entries currently in the MAC address table.

show mac address-table notifications

Displays information about notifications for the MAC address table.


show monitor session

To display information about the Switched Port Analyzer (SPAN) sessions, use the show monitor session command.

show monitor session [session | all [brief] | range range [brief] | status]

Syntax Description

session

(Optional) Number of the session. The range is from 1 to 18.

all

(Optional) Displays all sessions.

brief

(Optional) Displays a brief summary of the information.

range range

(Optional) Displays a range of sessions. The range is from 1 to 18.

status

(Optional) Displays the operational state of all sessions.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display information about SPAN session 1:

switch# show monitor session 1 

This example shows how to display a range of SPAN sessions:

switch# show monitor session range 1-4 

Related Commands

Command
Description

monitor session

Displays the contents of the startup configuration file.


show port-channel capacity

To display the total number of EtherChannel interfaces and the number of free or used EtherChannel interfaces, use the show port-channel capacity command.

show port-channel capacity

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the EtherChannel capacity:

switch# show port-channel capacity 
Port-channel resources
    768 total    29 used    739 free    3% used
switch# 

Related Commands

Command
Description

port-channel load-balance ethernet

Configures the load-balancing algorithm for EtherChannels.

show tech-support port-channel

Displays Cisco Technical Support information about EtherChannels.


show port-channel compatibility-parameters

To display the parameters that must be the same among the member ports in order to join an EtherChannel interface, use the show port-channel compatibility-parameters command.

show port-channel compatibility-parameters

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the EtherChannel interface parameters:

switch# show port-channel compatibility-parameters 
* port mode

Members must have the same port mode configured.

* port mode

Members must have the same port mode configured, either E,F or AUTO. If
they are configured in AUTO port mode, they have to negotiate E or F mode
when they come up. If a member negotiates a different mode, it will be
suspended.

* speed

Members must have the same speed configured. If they are configured in AUTO
speed, they have to negotiate the same speed when they come up. If a member
negotiates a different speed, it will be suspended.

* MTU

Members have to have the same MTU configured. This only applies to ethernet
port-channel.

* shut lan

Members have to have the same shut lan configured. This only applies to
ethernet port-channel.

* MEDIUM

Members have to have the same medium type configured. This only applies to
ethernet port-channel.

* Span mode

Members must have the same span mode.

* load interval

Member must have same load interval configured.
--More--
<---output truncated--->
switch# 

Related Commands

Command
Description

port-channel load-balance ethernet

Configures the load-balancing algorithm for EtherChannels.

show tech-support port-channel

Displays Cisco Technical Support information about EtherChannels.


show port-channel database

To display the aggregation state for one or more EtherChannel interfaces, use the show port-channel database command.

show port-channel database [interface port-channel number[.subinterface-number]]

Syntax Description

interface

(Optional) Displays information for an EtherChannel interface.

port-channel number

(Optional) Displays aggregation information for a specific EtherChannel interface. The number range is from 1 to 4096.

.subinterface-number

(Optional) Subinterface number. Use the EtherChannel number followed by a dot (.) indicator and the subinterface number. The format is portchannel-number.subinterface-number.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the aggregation state of all EtherChannel interfaces:

switch# show port-channel database 
port-channel19
    Last membership update is successful
    4 ports in total, 4 ports up
    First operational port is Ethernet199/1/24
    Age of the port-channel is 0d:09h:11m:30s
    Time since last bundle is 0d:09h:12m:20s
    Last bundled member is
    Ports:   Ethernet199/1/24  [active ] [up] *
             Ethernet199/1/28  [active ] [up]
             Ethernet199/1/30  [active ] [up]
             Ethernet199/1/31  [active ] [up]

port-channel21
    Last membership update is successful
    1 ports in total, 1 ports up
    First operational port is Ethernet2/3
    Age of the port-channel is 0d:09h:11m:30s
    Time since last bundle is 0d:09h:12m:20s
    Last bundled member is
    Ports:   Ethernet2/3     [on] [up] *

port-channel50
    Last membership update is successful
--More--
<---output truncated--->
switch# 

This example shows how to display the aggregation state for a specific EtherChannel interface:

switch# show port-channel database interface port-channel 21 
port-channel21
    Last membership update is successful
    1 ports in total, 1 ports up
    First operational port is Ethernet2/3
    Age of the port-channel is 0d:09h:13m:14s
    Time since last bundle is 0d:09h:14m:04s
    Last bundled member is
    Ports:   Ethernet2/3     [on] [up] *

switch#

Related Commands

Command
Description

port-channel load-balance ethernet

Configures the load-balancing algorithm for EtherChannels.

show tech-support port-channel

Displays Cisco Technical Support information about EtherChannels.


show port-channel load-balance

To display information about EtherChannel load balancing, use the show port-channel load-balance command.

show port-channel load-balance [forwarding-path interface port-channel number {. | vlan vlan_ID} [dst-ip ipv4-addr] [dst-ipv6 ipv6-addr] [dst-mac dst-mac-addr] [l4-dst-port dst-port] [l4-src-port src-port] [src-ip ipv4-addr] [src-ipv6 ipv6-addr] [src-mac src-mac-addr]]

Syntax Description

forwarding-path interface port-channel

(Optional) Identifies the port in the EtherChannel interface that forwards the packet.

number

EtherChannel number for the load-balancing forwarding path that you want to display. The range is from 1 to 4096.

.

(Optional) Subinterface number separator. Use the EtherChannel number followed by a dot (.) indicator and the subinterface number. The format is portchannel-number.subinterface-number.

vlan

(Optional) Identifies the VLAN for hardware hashing.

vlan_ID

VLAN ID. The range is from 1 to 3967 and 4048 to 4093.

dst-ip

(Optional) Displays the load distribution on the destination IP address.

ipv4-addr

IPv4 address to specify a source or destination IP address. The format is A.B.C.D.

dst-ipv6

(Optional) Displays the load distribution on the destination IPv6 address.

ipv6-addr

IPv6 address to specify a source or destination IP address. The format is A:B::C:D.

dst-mac

(Optional) Displays the load distribution on the destination MAC address.

dst-mac-addr

Destination MAC address. The format is AAAA:BBBB:CCCC.

l4-dst-port

(Optional) Displays the load distribution on the destination port.

dst-port

Destination port number. The range is from 0 to 65535.

l4-src-port

(Optional) Displays the load distribution on the source port.

src-port

Source port number. The range is from 0 to 65535.

src-ip

(Optional) Displays the load distribution on the source IP address.

src-ipv6

(Optional) Displays the load distribution on the source IPv6 address.

src-mac

(Optional) Displays the load distribution on the source MAC address.

src-mac-addr

source MAC address. The format is AA:BB:CC:DD:EE:FF.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.2(1)N1(1)

The vlan keyword was added.


Usage Guidelines

You must use the vlan keyword to determine the use of hardware hashing.

When you do not use hardware hashing, the output displays all parameters used to determine the outgoing port ID. Missing parameters are shown as zero values in the output.

If you do not use hardware hashing, the outgoing port ID is determined by using control-plane selection. Hardware hashing is not used in the following scenarios:

The specified VLAN contains an unknown unicast destination MAC address.

The specified VLAN contains a known or an unknown multicast destination MAC or destination IP address.

The specified VLAN contains a broadcast MAC address.

The EtherChannel has only one active member.

The destination MAC address is unknown when the load distribution is configured on the source IP address (src-ip), source port (l4-src-port), or source MAC address (src-mac).

If multichassis EtherChannel trunk (MCT) is enabled and the traffic flows from a virtual port channel (vPC) peer link, the output displays "Outgoing port id (vPC peer-link traffic)".

To get accurate results, you must do do the following:

(For unicast frames) Provide the destination MAC address (dst-mac) and the VLAN for hardware hashing (vlan). When the destination MAC address is not provided, hardware hashing is assumed.

(For multicast frames) For IP multicast, provide either the destination IP address (dst-ip) or destination MAC address (dst-mac) with the VLAN for hardware hashing (vlan). For non-ip multicast, provide the destination MAC address with the VLAN for hardware hashing.

(For broadcast frames) Provide the destination MAC address (dst-mac) and the VLAN for hardware hashing (vlan).

Examples

This example shows how to display the port channel load balance information:

switch# show port-channel load-balance 
Port Channel Load-Balancing Configuration:
System: source-dest-ip

Port Channel Load-Balancing Addresses Used Per-Protocol:
Non-IP: source-dest-mac
IP: source-dest-ip source-dest-mac

switch#

Table 3-1 describes the fields shown in the display:

Table 3-1 show port-channel load-balance Field Descriptions 

Field
Description

System

The load-balancing method configured on the switch.

Non-IP

The field that will be used to calculate the hash value for non-IP traffic.

IP

The fileds used for IPv4 and IPv6 traffic.


This example shows how to display the port channel load balance information when hardware hashing is not used:

switch# show port-channel load-balance forwarding-path interface port-channel 5 vlan 3 
dst-ip 192.168.2.37 
Missing params will be substituted by 0's.
Load-balance Algorithm on FEX: source-dest-ip
crc8_hash: Not Used     Outgoing port id: Ethernet133/1/3
Param(s) used to calculate load-balance (Unknown unicast, multicast and broadcas
t packets):
        dst-mac:  0000.0000.0000
        vlan id:  3
switch# 

This example shows how to display the port channel load balance information when hardware hashing is not used to determine the outgoing port ID:

switch# show port-channel load-balance forwarding-path interface port-channel 10 vlan 1 
dst-ip 192.168.2.25 src-ip 192.168.2.10 dst-mac ffff.ffff.ffff src-mac aa:bb:cc:dd:ee:ff 
l4-src-port 0 l4-dst-port 1 
Missing params will be substituted by 0's.
Load-balance Algorithm on switch: source-dest-port
crc8_hash: Not Used     Outgoing port id: Ethernet1/1
Param(s) used to calculate load-balance (Unknown unicast, multicast and broadcast 
packets):
        dst-mac:  ffff.ffff.ffff
        vlan id:  1

switch#

This example shows how to display the port channel load balance information when MCT is enabled and traffic flows from a vPC peer link:

switch# show port-channel load-balance forwarding-path interface port-channel 10 vlan 1 
dst-ip 192.168.2.25 src-ip 192.168.2.10 dst-mac ffff.ffff.ffff src-mac aa:bb:cc:dd:ee:ff 
l4-src-port 0 l4-dst-port 1 
Missing params will be substituted by 0's.
Load-balance Algorithm on switch: source-dest-port
crc8_hash: Not Used     Outgoing port id (non vPC peer-link traffic): ethernet1/2
crc8_hash: Not Used     Outgoing port id (vPC peer-link traffic): Ethernet1/1
Param(s) used to calculate load-balance (Unknown unicast, multicast and broadcast 
packets):
        dst-mac:  ffff.ffff.ffff
        vlan id:  1

switch#

This example shows how to display the port channel load balance information when hardware hashing is used to determine the outgoing port ID:

switch# show port-channel load-balance forwarding-path interface port-channel 10 vlan 1 
dst-ip 192.168.2.25 src-ip 192.168.2.10 src-mac aa:bb:cc:dd:ee:ff l4-src-port 0 
l4-dst-port 1 
Missing params will be substituted by 0's.
Load-balance Algorithm on switch: source-dest-port
crc8_hash: 204  Outgoing port id: Ethernet1/1
Param(s) used to calculate load-balance:
        dst-port: 1
        src-port: 0
        dst-ip:   192.168.2.25
        src-ip:   192.168.2.10
        dst-mac:  0000.0000.0000
       src-mac:  aabb.ccdd.eeff

switch#

Related Commands

Command
Description

port-channel load-balance ethernet

Configures the load-balancing method among the interfaces in the channel-group bundle.


show port-channel summary

To display summary information about EtherChannels, use the show port-channel summary command.

show port-channel summary

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

Before you use this command, you must configure an EtherChannel group using the interface port-channel command.

Examples

This example shows how to display summary information about EtherChannels:

switch# show port-channel summary 
Flags:  D - Down        P - Up in port-channel (members)
        I - Individual  H - Hot-standby (LACP only)
        s - Suspended   r - Module-removed
        S - Switched    R - Routed
        U - Up (port-channel)
--------------------------------------------------------------------------------
Group Port-       Type     Protocol  Member Ports
      Channel
--------------------------------------------------------------------------------
1     Po1(SU)     Eth      LACP      Eth1/1(P)    Eth1/2(P)    Eth1/3(P)
                                     Eth1/4(P)    Eth1/21(P)   Eth1/22(P)
                                     Eth1/23(P)   Eth1/24(P)   Eth1/25(P)
                                     Eth1/26(P)   Eth1/27(P)   Eth1/28(P)
                                     Eth1/29(P)   Eth1/30(P)   Eth1/31(P)
                                     Eth1/32(P)
3     Po3(SU)     Eth      NONE      Eth1/9(P)    Eth1/10(P)   Eth1/13(P)
                                     Eth1/14(P)   Eth1/40(P)
5     Po5(SU)     Eth      NONE      Eth3/5(P)    Eth3/6(P)
6     Po6(SU)     Eth      NONE      Eth1/5(P)    Eth1/6(P)    Eth1/7(P)
                                     Eth1/8(P)
12    Po12(SU)    Eth      NONE      Eth3/3(P)    Eth3/4(P)
15    Po15(SD)    Eth      NONE      --
20    Po20(SU)    Eth      NONE      Eth1/17(P)   Eth1/18(P)   Eth1/19(D)
                                     Eth1/20(P)
24    Po24(SU)    Eth      LACP      Eth105/1/27(P)  Eth105/1/28(P)  Eth105/1/29
(P)
                                     Eth105/1/30(P)  Eth105/1/31(P)  Eth105/1/32
(P)
25    Po25(SU)    Eth      LACP      Eth105/1/23(P)  Eth105/1/24(P)  Eth105/1/25
(P)
                                     Eth105/1/26(P)
33    Po33(SD)    Eth      NONE      --
41    Po41(SD)    Eth      NONE      --
44    Po44(SD)    Eth      NONE      --
48    Po48(SD)    Eth      NONE      --
100   Po100(SD)   Eth      NONE      --
101   Po101(SD)   Eth      NONE      --
102   Po102(SU)   Eth      LACP      Eth102/1/2(P)
103   Po103(SU)   Eth      LACP      Eth102/1/3(P)
104   Po104(SU)   Eth      LACP      Eth102/1/4(P)
105   Po105(SU)   Eth      LACP      Eth102/1/5(P)
106   Po106(SU)   Eth      LACP      Eth102/1/6(P)
107   Po107(SU)   Eth      LACP      Eth102/1/7(P)
108   Po108(SU)   Eth      LACP      Eth102/1/8(P)
109   Po109(SU)   Eth      LACP      Eth102/1/9(P)
110   Po110(SU)   Eth      LACP      Eth102/1/10(P)
111   Po111(SU)   Eth      LACP      Eth102/1/11(P)
<---output truncated--->
switch# 

Related Commands

Command
Description

channel-group (Ethernet)

Assigns and configures a physical interface to an EtherChannel.

interface port-channel

Creates an EtherChannel interface and enters interface configuration mode.


show port-channel traffic

To display the traffic statistics for EtherChannels, use the show port-channel traffic command.

show port-channel traffic [interface port-channel number[.subinterface-number]]

Syntax Description

interface

(Optional) Displays traffic stattistics for a specified interface.

port-channel number

(Optional) Displays information for a specified EtherChannel. The range is from 1 to 4096.

.subinterface-number

(Optional) Subinterface number. Use the EtherChannel number followed by a dot (.) indicator and the subinterface number. The format is portchannel-number.subinterface-number.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the traffic statistics for all EtherChannels:

switch# show port-channel traffic 
ChanId      Port Rx-Ucst Tx-Ucst Rx-Mcst Tx-Mcst Rx-Bcst Tx-Bcst
------ --------- ------- ------- ------- ------- ------- -------
    10    Eth1/7    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
    10    Eth1/8    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
    10    Eth1/9    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
    10   Eth1/10    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
------ --------- ------- ------- ------- ------- ------- -------
  4000    Eth1/1    0.0%    0.0%  99.64%  99.81%    0.0%    0.0%
  4000    Eth1/2    0.0%    0.0%   0.06%   0.06%    0.0%    0.0%
  4000    Eth1/3    0.0%    0.0%   0.23%   0.06%    0.0%    0.0%
  4000    Eth1/4    0.0%    0.0%   0.06%   0.06%    0.0%    0.0%
switch# 

This example shows how to display the traffic statistics for a specific EtherChannel:

switch# show port-channel traffic interface port-channel 10 
ChanId      Port Rx-Ucst Tx-Ucst Rx-Mcst Tx-Mcst Rx-Bcst Tx-Bcst
------ --------- ------- ------- ------- ------- ------- -------
    10    Eth1/7    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
    10    Eth1/8    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
    10    Eth1/9    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
    10   Eth1/10    0.0%    0.0%    0.0%    0.0%    0.0%    0.0%
switch#

Related Commands

Command
Description

port-channel load-balance ethernet

Configures the load-balancing algorithm for EtherChannels.

show tech-support port-channel

Displays Cisco Technical Support information about EtherChannels.


show port-channel usage

To display the range of used and unused EtherChannel numbers, use the show port-channel usage command.

show port-channel usage

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the EtherChannel usage information:

switch# show port-channel usage 
Total 29 port-channel numbers used
============================================
Used  :   19 , 21 , 50 , 100 , 150 , 170 - 171 , 198 - 199 , 256
          301 , 400 - 401 , 1032 - 1033 , 1111 , 1504 , 1511 , 1514 , 1516 - 1520
          1532 , 1548 , 1723 , 1905 , 1912
Unused:   1 - 18 , 20 , 22 - 49 , 51 - 99 , 101 - 149 , 151 - 169
          172 - 197 , 200 - 255 , 257 - 300 , 302 - 399 , 402 - 1031
          1034 - 1110 , 1112 - 1503 , 1505 - 1510 , 1512 - 1513 , 1515 , 1521 - 1531
          1533 - 1547 , 1549 - 1722 , 1724 - 1904 , 1906 - 1911 , 1913 - 4096
          (some numbers may be in use by SAN port channels)

switch# 

Related Commands

Command
Description

port-channel load-balance ethernet

Configures the load-balancing algorithm for EtherChannels.

show tech-support port-channel

Displays Cisco Technical Support information about EtherChannels.


show resource

To display the number of resources currently available in the system, use the show resource command.

show resource [resource]

Syntax Description

resource

Resource name, which can be one of the following:

port-channel—Displays the number of EtherChannels available in the system.

vlan—Displays the number of VLANs available in the system.

vrf—Displays the number of virtual routing and forwardings (VRFs) available in the system.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the resources available in the system:

switch# show resource 

     Resource               Min       Max      Used    Unused     Avail
    -----------            -----     -----    ------  --------   -------
     vlan                16      4094       509         0         3
     monitor-session      0         2         0         0         2
     vrf                  2      1000         2         0       998
     port-channel         0       768         2         0       766
     u4route-mem         32        32         1        31        31
     u6route-mem         16        16         1        15        15
     m4route-mem         58        58         0        58        58
     m6route-mem          8         8         0         8         8
     bundle-map           0        16         2         0        14

switch#

Related Commands

Command
Description

show interface port-channel

Displays information about EtherChannels.


show running-config

To display the contents of the currently running configuration file, use the show running-config command.

show running-config [all]

Syntax Description

all

(Optional) Displays the full operating information including default settings.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display information on the running configuration:

switch# show running-config 

This example shows how to display detailed information on the running configuration:

switch# show running-config all 

Related Commands

Command
Description

show startup-config

Displays the contents of the startup configuration file.


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 default settings.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display information on the running STP configuration:

switch# show running-config spanning-tree 

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

switch# show running-config spanning-tree all 


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


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 VLAN or range of VLANs. Valid numbers are from 1 to 4096.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

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

The display varies with your configuration. If you have configured the VLAN name, shutdown status, or suspended status, these are also displayed.

Examples

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

switch# show running-config vlan 5 

Related Commands

Command
Description

show vlan

Displays information about all the VLANs on the switch.


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 short or long path cost method is used. The method differs for Rapid Per VLAN Spanning Tree Plus (Rapid PVST+) (configurable, default is short) and Multiple Spanning Tree (MST) (nonconfigurable, operational value is always long).


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


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.

Table 3-2 describes the fields that are displayed in the output of show spanning-tree commands.

Table 3-2 show spanning-tree Command Output Fields 

Field
Definition

Role

Current port STP role. Valid values are as follows:

Desg (designated)

Root

Altn (alternate)

Back (backup)

Sts

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 (shared) interface by the spanning tree.

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 broken states are Root inconsistent, Loopguard inconsistent, PVID inconsistent, Bridge Assurance inconsistent, or Type inconsistent.



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


Examples

This example shows how to display spanning tree information:

switch# show spanning-tree 

VLAN0001
  Spanning tree enabled protocol rstp
  Root ID    Priority    1
             Address     000d.ecb0.fdbc
             Cost        2
             Port        4096 (port-channel1)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec

  Bridge ID  Priority    61441  (priority 61440 sys-id-ext 1)
             Address     0005.9b78.6e7c
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec

Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po1              Root FWD 1         128.4096 (vPC peer-link) Network P2p
Po3              Root FWD 1         128.4098 (vPC) P2p
Po123            Desg FWD 4         128.4218 Edge P2p
Eth1/11          Desg BKN*2         128.139  P2p *TYPE_Inc
Eth1/12          Desg BKN*2         128.140  P2p *TYPE_Inc
Eth1/15          Desg BKN*2         128.143  P2p *TYPE_Inc
Eth1/16          Desg BKN*2         128.144  P2p *TYPE_Inc
Eth1/33          Desg FWD 2         128.161  Edge P2p
Eth1/35          Desg FWD 2         128.163  Edge P2p
Eth1/36          Desg FWD 2         128.164  Edge P2p
Eth1/38          Desg FWD 2         128.166  Edge P2p
Eth100/1/1       Desg FWD 1         128.1025 (vPC) Edge P2p
Eth100/1/2       Desg FWD 1         128.1026 (vPC) Edge P2p
Eth100/1/3       Desg FWD 1         128.1027 (vPC) Edge P2p
Eth100/1/4       Desg FWD 1         128.1028 (vPC) Edge P2p
--More--
switch# 

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

switch(config)# show spanning-tree blockedports 

Name                 Blocked Interfaces List
-------------------- ------------------------------------
VLAN0001             Eth1/11, Eth1/12, Eth1/15, Eth1/16


Number of blocked ports (segments) in the system : 4

switch#

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

switch# show spanning-tree inconsistentports 

Name                 Interface              Inconsistency
-------------------- ---------------------- ------------------
VLAN0001             Eth1/11                Port Type Inconsistent
VLAN0001             Eth1/12                Port Type Inconsistent
VLAN0001             Eth1/15                Port Type Inconsistent
VLAN0001             Eth1/16                Port Type Inconsistent


Number of inconsistent ports (segments) in the system : 4

switch#

This example shows how to display the path cost method:

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

Related Commands

Command
Description

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

show spanning-tree brief

Displays a brief summary 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 mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for 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

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

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

switch# show spanning-tree active  

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree bridge

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

show spanning-tree brief

Displays a brief summary 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 mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for specified VLANs.


show spanning-tree bridge

To display the status and configuration of the local Spanning Tree Protocol (STP) 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 whether the Rapid Per VLAN Spanning Tree Plus (Rapid PVST+) or Multiple Spanning Tree (MST) protocol is active.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

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

switch# show spanning-tree bridge  

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree brief

Displays a brief summary 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 mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for specified VLANs.


show spanning-tree brief

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

show spanning-tree brief [active]

Syntax Description

active

(Optional) Displays information about STP active interfaces only.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


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.ecb0.fc7c
             Cost        1
             Port        4495 (port-channel400)
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec

  Bridge ID  Priority    32769  (priority 32768 sys-id-ext 1)
             Address     000d.ece7.df7c
             Hello Time  2  sec  Max Age 20 sec  Forward Delay 15 sec

Interface        Role Sts Cost      Prio.Nbr Type
---------------- ---- --- --------- -------- --------------------------------
Po19             Desg FWD 1         128.4114 Edge P2p
Po400            Root FWD 1         128.4495 (vPC peer-link) Network P2p
Eth170/1/17      Desg FWD 2         128.3857 Edge P2p
Eth171/1/7       Desg FWD 1         128.3975 (vPC) Edge P2p
Eth171/1/8       Desg FWD 1         128.3976 (vPC) Edge P2p
Eth198/1/11      Desg FWD 1         128.1291 (vPC) Edge P2p
Eth199/1/13      Desg FWD 2         128.1677 Edge P2p


VLAN0300
  Spanning tree enabled protocol rstp
  Root ID    Priority    4396
--More--
switch#

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

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 mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for specified VLANs.


show spanning-tree detail

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

show spanning-tree detail [active]

Syntax Description

active

(Optional) Displays information about STP active interfaces only.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

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

switch(config)# show spanning-tree detail  

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

show spanning-tree brief

Displays a brief summary about STP.

show spanning-tree interface

Displays the STP interface status and configuration of specified interfaces.

show spanning-tree mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for specified VLANs.


show spanning-tree interface

To display information on 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 number} [active [brief | detail] | brief [active] | cost | detail [active] | edge | inconsistency | priority | rootcost | state]

Syntax Description

interface

Specifies the interface. The interface can be Ethernet or EtherChannel.

ethernet slot/port

Specifies the Ethernet interface slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

port-channel number

Specifies the EtherChannel interface and number. The EtherChannel number is from 1 to 4096.

active

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

brief

(Optional) Displays brief summary of STP information on the specified interfaces.

detail

(Optional) Displays detailed STP information about the specified 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

(Optional) Displays the current port STP state.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


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 switch returns an error message.

When you are running Multiple Spanning Tree (MST), this command displays the Per VLAN Spanning Tree (PVST) simulation setting.


Note If you are running Multiple Spanning Tree (MST), use the show spanning-tree mst command to show more detail on the specified interfaces.


Examples

This example shows how to display STP information on a specified interface:

switch(config)# show spanning-tree interface ethernet 1/3  

This example shows how to display detailed STP information on a specified interface:

switch(config)# show spanning-tree interface ethernet 1/3 detail  

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

show spanning-tree brief

Displays a brief summary about STP.

show spanning-tree detail

Displays detailed information about STP.

show spanning-tree mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for specified VLANs.


show spanning-tree mst

To display information on 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 number} [detail]]

show spanning-tree mst [configuration [digest]]

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

Syntax Description

instance-id

(Optional) Multiple Spanning Tree (MST) instance range that you want to display. For example, 0 to 3, 5, 7 to 9.

detail

(Optional) Displays detailed Multiple Spanning Tree (MST) information.

interface

(Optional) Specifies the interface. The interface can be Ethernet or EtherChannel.

ethernet slot/port

(Optional) Specifies the Ethernet interface and its slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

port-channel number

(Optional) Specifies the EtherChannel interface and number. The EtherChannel number is from 1 to 4096.

configuration

(Optional) Displays current Multiple Spanning Tree (MST) regional information including the VLAN-to-instance mapping of all VLANs.

digest

(Optional) Displays information about the MD5 digest.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

If the switch is not running in STP Multiple Spanning Tree (MST) mode when you enter this command, it returns the following message:

ERROR: Switch is not in mst mode

Examples

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

switch# show spanning-tree mst  

This example shows how to display STP information about a specific Multiple Spanning Tree (MST) instance:

switch)# show spanning-tree mst 0  

This example shows how to display detailed STP information about the Multiple Spanning Tree (MST) protocol:

switch)# show spanning-tree mst detail  

This example shows how to display STP information about specified Multiple Spanning Tree (MST) interfaces:

switch)# show spanning-tree mst interface ethernet 8/2  

This example shows how to display information about the Multiple Spanning Tree (MST) configuration:

switch)# show spanning-tree mst configuration  

This example shows how to display the MD5 digest included in the current Multiple Spanning Tree (MST) configuration:

switch)# show spanning-tree mst configuration digest  

See Table 3-2 for descriptions of the fields that are displayed in the output of the show spanning-tree commands.

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

show spanning-tree brief

Displays a brief summary 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 switch belongs.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for 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 on 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

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

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

switch(config)# show spanning-tree root  

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

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 mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree summary

Displays summary information about STP.

show spanning-tree vlan

Displays STP information for specified VLANs.


show spanning-tree summary

To display summary Spanning Tree Protocol (STP) information on the switch, 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

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

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

Examples

This example shows how to display a summary of STP information on the switch:

switch(config)# show spanning-tree summary  

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

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 mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree vlan

Displays STP information for 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]]

show spanning-tree vlan {vlan-id} [blockedports]

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

show spanning-tree vlan {vlan-id} [brief [active]]

show spanning-tree vlan {vlan-id} [detail [active]]

show spanning-tree vlan {vlan-id} [inconsistentports]

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

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

show spanning-tree vlan {vlan-id} [summary]

Syntax Description

vlan-id

VLAN or range of VLANs that you want to display.

active

(Optional) Displays information about 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 switch.

inconsistentports

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

interface

(Optional) Specifies the interface. The interface can be Ethernet or EtherChannel.

ethernet slot/port

(Optional) Specifies the Ethernet interface and its slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

port-channel number

(Optional) Specifies the EtherChannel interface and number. The EtherChannel number 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

(Optional) Displays the current port STP state. Valid values are blocking, disabled, learning, and forwarding.

port

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

summary

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


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display STP information on VLAN 1:

switch# show spanning-tree vlan 1  

Related Commands

Command
Description

show spanning-tree

Displays information about STP.

show spanning-tree active

Displays information about STP active interfaces only.

show spanning-tree bridge

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

show spanning-tree brief

Displays a brief summary 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 mst

Displays information about Multiple Spanning Tree (MST) STP.

show spanning-tree root

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

show spanning-tree summary

Displays summary information about STP.


show startup-config

To display the contents of the currently running configuration file, use the show startup-config command.

show startup-config

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display information from the startup configuration file:

switch# show startup-config  

Related Commands

Command
Description

show running-config

Displays the contents of the currently running configuration file.


show tech-support port-channel

To display troubleshooting information about EtherChannel interfaces, use the show tech-support port-channel command.

show tech-support port-channel

Syntax Description

This command has no arguments and keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

The output from the show tech-support port-channel command is very long. To better manage this output, you can redirect the output to a file.

Examples

This example shows how to display Cisco technical support information for EtherChannel interfaces:

switch# show tech-support port-channel 
`show port-channel internal event-history all`
Low Priority Pending queue: len(0), max len(2) [Thu Jul  8 04:05:04 2010]
High Priority Pending queue: len(0), max len(32) [Thu Jul  8 04:05:04 2010]
PCM Control Block info:
pcm_max_channels        : 4096
pcm_max_channel_in_use  : 1912
pc count                : 29
hif-pc count            : 20
Max PC Cnt              : 768
====================================================
PORT CHANNELS:

port-channel19
channel       : 19
bundle        : 65535
ifindex       : 0x16000012
admin mode    : active
oper mode     : active
fop ifindex   : 0x1fc605c0
nports        : 4
active        : 4
pre cfg       : 0
ltl:          : 0
lif:          : 0
iod:          : 43
global id     : 1
flag          : 0
--More--
<---output truncated--->
switch# 

Related Commands

Command
Description

port-channel load-balance ethernet

Configures the load-balancing method among the interfaces in the channel-group bundle.

show port-channel load-balance

Displays information on EtherChannel load balancing.


show udld

To display the Unidirectional Link Detection (UDLD) information for a switch, use the show udld command.

show udld [ethernet slot/port | global | neighbors]

Syntax Description

ethernet slot/port

Displays UDLD information for an Ethernet IEEE 802.3z interface. The slot number is from 1 to 255, and the port number is from 1 to 128.

global

Displays the UDLD global status and configuration information on all interfaces.

neighbors

Displays information about UDLD neighbor interfaces.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(1a)N1(1)

This command was introduced.


Examples

This example shows how to display UDLD information for all interfaces:

switch# show udld 

Interface Ethernet1/1
--------------------------------
Port enable administrative configuration setting: device-default
Port enable operational state: enabled
Current bidirectional state: bidirectional
Current operational state:  advertisement - Single neighbor detected
Message interval: 15
Timeout interval: 5

        Entry 1
        ----------------
        Expiration time: 41
        Cache Device index: 1
        Current neighbor state: bidirectional
        Device ID: FLC12280095
        Port ID: Ethernet1/1
        Neighbor echo 1 devices: SSI130205RT
        Neighbor echo 1 port: Ethernet1/1

        Message interval: 15
        Timeout interval: 5
        CDP Device name: N5Kswitch-2(FLC12280095)


Interface Ethernet1/2
--------------------------------
Port enable administrative configuration setting: device-default
Port enable operational state: enabled
Current bidirectional state: bidirectional
Current operational state:  advertisement - Single neighbor detected
Message interval: 15
Timeout interval: 5

        Entry 1
        ----------------
--More--
switch# 

This example shows how to display the UDLD information for a specified interface:

switch# show udld ethernet 1/1 

Interface Ethernet1/1
--------------------------------
Port enable administrative configuration setting: device-default
Port enable operational state: enabled
Current bidirectional state: bidirectional
Current operational state:  advertisement - Single neighbor detected
Message interval: 15
Timeout interval: 5

        Entry 1
        ----------------
        Expiration time: 41
        Cache Device index: 1
        Current neighbor state: bidirectional
        Device ID: FLC12280095
        Port ID: Ethernet1/1
        Neighbor echo 1 devices: SSI130205RT
        Neighbor echo 1 port: Ethernet1/1

        Message interval: 15
        Timeout interval: 5
        CDP Device name: N5Kswitch-2(FLC12280095)

switch#

This example shows how to display the UDLD global status and configuration on all interfaces:

switch# show udld global 

UDLD global configuration mode: enabled
UDLD global message interval: 15
switch#

This example shows how to display the UDLD neighbor interfaces:

switch# show udld neighbors 
Port             Device Name    Device ID   Port ID         Neighbor State
--------------------------------------------------------------------------
Ethernet1/1      FLC12280095    1           Ethernet1/1     bidirectional
Ethernet1/2      FLC12280095    1           Ethernet1/2     bidirectional
Ethernet1/3      FLC12280095    1           Ethernet1/3     bidirectional
Ethernet1/4      FLC12280095    1           Ethernet1/4     bidirectional
Ethernet1/7      JAF1346000H    1           Ethernet1/7     bidirectional
Ethernet1/8      JAF1346000H    1           Ethernet1/8     bidirectional
Ethernet1/9      JAF1346000C    1           Ethernet1/9     bidirectional
Ethernet1/10     JAF1346000C    1           Ethernet1/10    bidirectional

switch#

Related Commands

Command
Description

udld (configuration mode)

Configures the UDLD protocol on the switch.

udld (Ethernet)

Configures the UDLD protocol on an Ethernet interface.


show vlan

To display VLAN information, use the show vlan command.

show vlan [brief | name {name} | summary]

Syntax Description

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.

summary

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


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

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

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, only access VLANs are shown under Ports in the display.


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

suspended—VLAN is suspended.

active—VLAN is active.

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

act/lshut—VLAN status is active but shut down locally.

sus/lshut—VLAN status is suspended but shut down locally.

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

act/ishut—VLAN status is active but shut down internally.

sus/ishut—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 switch:

switch# show vlan  

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

switch# show vlan brief  

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

switch# show vlan name test  

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

switch# show vlan summary  

Related Commands

Command
Description

show interface switchport

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

show vlan private-vlan

Displays private VLAN information.


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

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

This example shows how to display the status of 802.1Q tagging on the native VLANs:

switch# show vlan dot1Q tag native 
vlan dot1q native tag is enabled
switch#

Related Commands

Command
Description

vlan dot1q tag nativet

Enables dot1q (IEEE 802.1Q) tagging for all native VLANs on all trunked ports on the switch.


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 {vlan-id}

Syntax Description

vlan-id

VLAN or range of VLANs that you want to display.


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Usage Guidelines

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


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


Examples

This example shows how to display information for the individual VLAN 5:

switch# show vlan id 5  

Related Commands

Command
Description

show vlan

Displays information about VLANs on the switch.


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 vlan-id

(Optional) Displays private VLAN information for the specified VLAN.

type

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


Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.


Examples

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

switch(config)# show vlan private-vlan  

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

switch(config)# show vlan id 42 private-vlan  

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

switch(config)# show vlan private-vlan type  

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

switch(config)# show vlan id 42 private-vlan type  

Related Commands

Command
Description

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 interface switchport

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

show vlan

Displays information about all the VLANs on the switch.


show vtp status

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

show vtp status

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification

4.2(1)N1(1)

This command was introduced.


Usage Guidelines

Before you use this command, you must enable VTP on the switch by using the feature vtp command.

Examples

This example shows how to display the VTP domain status:

switch# show vtp status 
VTP Version                     : 1
Configuration Revision          : 0
Maximum VLANs supported locally : 1005
VTP Operating Mode              : Transparent
VTP Domain Name                 :
VTP Pruning Mode                : Disabled
VTP V2 Mode                     : Disabled
VTP Traps Generation            : Disabled
switch#

Related Commands

Command
Description

feature vtp

Enables VTP on the switch.

vtp domain

Configures the VTP domain.

vtp mode

Configures the VTP device mode.

vtp version

Configures the VTP version.