Catalyst 2960 and 2960 -S Switch Command Reference, Release 12.2(55)SE
Catalyst 2960 Switch Cisco IOS Commands - rmon collection through show vtp
Downloads: This chapterpdf (PDF - 2.05MB) The complete bookPDF (PDF - 20.91MB) | Feedback

rmon collection stats

Table Of Contents

rmon collection stats

sdm prefer

service password-recovery

service-policy

session

set

setup

setup express

show access-lists

show archive status

show arp access-list

show authentication

show auto qos

show boot

show cable-diagnostics tdr

show cisp

show class-map

show cluster

show cluster candidates

show cluster members

show controllers cpu-interface

show controllers ethernet-controller

show controllers ethernet-controller stack port

show controllers power inline

show controllers tcam

show controllers utilization

show diagnostic

show dot1x

show dtp

show eap

show env

show errdisable detect

show errdisable flap-values

show errdisable recovery

show etherchannel

show fallback profile

show flowcontrol

show interfaces

show interfaces counters

show inventory

show ip arp inspection

show ip dhcp snooping

show ip dhcp snooping binding

show ip dhcp snooping database

show ip dhcp snooping statistics

show ip igmp profile

show ip igmp snooping

show ip igmp snooping groups

show ip igmp snooping mrouter

show ip igmp snooping querier

show ip source binding

show ip verify source

show ipv6 mld snooping

show ipv6 mld snooping address

show ipv6 mld snooping mrouter

show ipv6 mld snooping querier

show ipv6 route updated

show lacp

show lldp

show location

show logging onboard

show link state group

show logging onboard

show mac access-group

show mac address-table

show mac address-table address

show mac address-table aging-time

show mac address-table count

show mac address-table dynamic

show mac address-table interface

show mac address-table learning

show mac address-table move update

show mac address-table notification

show mac address-table static

show mac address-table vlan

show mls qos

show mls qos aggregate-policer

show mls qos input-queue

show mls qos interface

show mls qos maps

show mls qos queue-set

show mls qos vlan

show monitor

show mvr

show mvr interface

show mvr members

show network-policy profile

show nmsp

show pagp

show policy-map

show port-security

show power inline

show sdm prefer

show setup express

show spanning-tree

show storm-control

show switch

show system mtu

show udld

show version

show vlan

show vmps

show vtp


rmon collection stats

Use the rmon collection stats interface configuration command to collect Ethernet group statistics, which include usage statistics about broadcast and multicast packets, and error statistics about cyclic redundancy check (CRC) alignment errors and collisions. Use the no form of this command to return to the default setting.

rmon collection stats index [owner name]

no rmon collection stats index [owner name]

Syntax Description

index

Remote Network Monitoring (RMON) collection control index. The range is 1 to 65535.

owner name

(Optional) Owner of the RMON collection.


Defaults

The RMON statistics collection is disabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

The RMON statistics collection command is based on hardware counters.

Examples

This example shows how to collect RMON statistics for the owner root:

Switch(config)# interface gigabitethernet0/1
Switch(config-if)# rmon collection stats 2 owner root

You can verify your setting by entering the show rmon statistics privileged EXEC command.

Related Commands

Command
Description

show rmon statistics

Displays RMON statistics.


sdm prefer

Use the sdm prefer global configuration command to configure the template used in Switch Database Management (SDM) resource allocation. You can use a template to allocate system resources to best support the features being used in your application or select the dual IPv4 and IPv6 template to support IPv6 forwarding (supported only when the switch is running the LAN base image). Use the no form of this command to return to the default template.

sdm prefer {default | dual-ipv4-and-ipv6 default | lanbase-routing | qos}

no sdm prefer


Note A Catalyst 2960-S switch running the LAN base image uses a default template that includes maximum resources for all supported features; it does not require the dual or qos templates. However, to enable static routing on the Catalyst 2960-S, you must configure the lanbase-routing template.


Syntax Description

default

Give balance to all functions.

dual-ipv4-and-ipv6 default

Allows the switch to be used in dual stack environments (supporting both IPv4 and IPv6 forwarding). You must configure this template to enable IPv6 MLD snooping or IPv6 host functions.

lanbase-routing

Supports configuring IPv4 static unicast routes on switch virtual interfaces (SVIs). The switch must be running the LAN base image.

qos

Provide maximum system usage for quality of service (QoS) access control entries (ACEs).


Defaults

The default template provides a balance to all features.

Command Modes

Global configuration

Command History

Release
Modification

12.2(25)FX

This command was introduced.

12.2(40)SE

The dual-ipv4-and-ipv6 default keywords were added.

12.2(55)SE

The lanbase-routing keyword was added to switches running the LAN base image.


Usage Guidelines

You must reload the switch for the configuration to take effect.

If you enter the show sdm prefer command before you enter the reload privileged EXEC command, the show sdm prefer command shows the template currently in use and the template that will become active after a reload.

Use the no sdm prefer command to set the switch to the default template.

Do not use the routing template if you are not using static routing on your switch. Entering the sdm prefer lanbase- outing global configuration command prevents other features from using the memory allocated to unicast routing in the routing template.

Do not use the ipv4-and-ipv6 template if you do not plan to enable IPv6 functionality on the switch. Entering the sdm prefer ipv4-and-ipv6 global configuration command divides resources between IPv4 and IPv6, limiting those allocated to IPv4 forwarding.

Table 2-20 Approximate Number of Feature Resources Allowed by Each Template

Resource
Default
Catalyst 2960
Default
Catalyst 2960-S
QoS
Catalyst 2960 Only
Dual
Catalyst 2960 Only
LAN base routing

Unicast MAC addresses

8 K

8K

8 K

8 K

4K

IPv4 IGMP groups

256

256

256

256

256

IPv4 unicast routes

0

256

0

0

4.25K

Directly connected hosts

0

 

0

0

4K

Indirect routes

0

 

0

0

256

IPv6 multicast groups

0

 

0

0

0

Directly connected IPv6 addresses

0

 

0

0

0

Indirect IPv6 unicast routes

0

 

0

0

0

IPv4 policy-based routing aces

0

 

0

0

0

IPv4 MAC QoS ACEs

128

384

384

0

128

IPv4 MAC security ACEs

384

384

128

256

384

IPv6 policy-based routing aces

0

 

0

0

0

IPv6 QoS ACEs

0

 

0

0

0

IPv6 security ACEs

0

128

0

0

0


Examples

This example shows how to use the QoS template:

Switch(config)# sdm prefer qos
Switch(config)# exit
Switch# reload

This example shows how to configure the dual IPv4-and-IPv6 default template on a switch:

Switch(config)# sdm prefer dual-ipv4-and-ipv6 default
Switch(config)# exit
Switch# reload

You can verify your settings by entering the show sdm prefer privileged EXEC command.

Related Commands

Command
Description

show sdm prefer

Displays the current SDM template in use or displays the templates that can be used, with approximate resource allocation per feature.


service password-recovery

Use the service password-recovery global configuration command to enable the password-recovery mechanism (the default). This mechanism allows an end user with physical access to the switch to hold down the Mode button and interrupt the bootup process while the switch is powering up and to assign a new password. Use the no form of this command to disable part of the password-recovery functionality. When the password-recovery mechanism is disabled, interrupting the bootup process is allowed only if the user agrees to set the system back to the default configuration.

service password-recovery

no service password-recovery

Syntax Description

This command has no arguments or keywords.

Defaults

The password-recovery mechanism is enabled.

Command Modes

Global configuration

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

As a system administrator, you can use the no service password-recovery command to disable some of the functionality of the password recovery feature by allowing an end user to reset a password only by agreeing to return to the default configuration.

To use the password-recovery procedure, a user with physical access to the switch holds down the Mode button while the unit powers up and for a second or two after the LED above port 1X turns off. When the button is released, the system continues with initialization.

If the password-recovery mechanism is disabled, this message appears:

The password-recovery mechanism has been triggered, but
is currently disabled.  Access to the boot loader prompt
through the password-recovery mechanism is disallowed at
this point.  However, if you agree to let the system be
reset back to the default system configuration, access
to the boot loader prompt can still be allowed.

Would you like to reset the system back to the default configuration (y/n)?


Note If the user chooses not to reset the system to the default configuration, the normal bootup process continues, as if the Mode button had not been pressed. If you choose to reset the system to the default configuration, the configuration file in flash memory is deleted, and the VLAN database file, flash:vlan.dat (if present), is deleted.If you use the no service password-recovery command to control end user access to passwords, we recommend that you save a copy of the config file in a location away from the switch in case the end user uses the password recovery procedure and sets the system back to default values. Do not keep a backup copy of the config file on the switch.

If the switch is operating in VTP transparent mode, we recommend that you also save a copy of the vlan.dat file in a location away from the switch.


You can verify if password recovery is enabled or disabled by entering the show version privileged EXEC command.

Examples

This example shows how to disable password recovery on a switch so that a user can only reset a password by agreeing to return to the default configuration.

Switch(config)# no service-password recovery
Switch(config)# exit

Related Commands

Command
Description

show version

Displays version information for the hardware and firmware.


service-policy

Use the service-policy interface configuration command to apply a policy map defined by the policy-map command to the input of a physical port. Use the no form of this command to remove the policy map and port association.

service-policy input policy-map-name

no service-policy input policy-map-name


Note To use this command, the switch must be running the LAN Base image.


Syntax Description

input policy-map-name

Apply the specified policy map to the input of a physical port.



Note Though visible in the command-line help strings, the history keyword is not supported, and you should ignore the statistics that it gathers. The output keyword is also not supported.


Defaults

No policy maps are attached to the port.

Command Modes

Interface configuration

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Policy maps can be configured on physical ports.

You can apply a policy map to incoming traffic on a physical port.

Classification using a port trust state (for example, mls qos trust [cos | dscp | ip-precedence] and a policy map (for example, service-policy input policy-map-name) are mutually exclusive. The last one configured overwrites the previous configuration.

Examples

This example shows how to apply plcmap1 to an physical ingress port:

Switch(config)# interface gigabitethernet0/1
Switch(config-if)# service-policy input plcmap1

This example shows how to remove plcmap2 from a physical port:

Switch(config)# interface gigabitethernet0/1
Switch(config-if)# no service-policy input plcmap2

You can verify your settings by entering the show running-config privileged EXEC command.

Related Commands

Command
Description

policy-map

Creates or modifies a policy map that can be attached to multiple ports to specify a service policy.

show policy-map

Displays QoS policy maps.

show running-config

Displays the running configuration on the switch.


session

Use the session privileged EXEC command on the stack master to access a specific stack member.

session stack-member-number


Note This command is supported only on Catalyst 2960-S switches running the LAN base image.


Syntax Description

stack-member-number

Specify the member number. The range is 1 to 4.



Note Although visible in the command-line help string, the processor keyword is not supported.


Defaults

No default is defined.

Command Modes

Global configuration

Command History

Release
Modification

12.2(53)SE1

This command was introduced.


Usage Guidelines

When you access the member, its member number is appended to the system prompt.

Use the session command from the master to access a member switch.

Use the session command with processor 1 from the master or a standalone switch to access the internal controller. A standalone switch is always member 1.

Examples

This example shows how to access member 6:

Switch(config)# session 6
Switch-6#

Related Commands

Command
Description

reload

Reloads the member and puts a configuration change into effect.

switch

Changes the member priority value.

switch renumber

Changes the member number.

show switch

Displays information about the stack and its members.


set

Use the set policy-map class configuration command to classify IP traffic by setting a Differentiated Services Code Point (DSCP) or an IP-precedence value in the packet. Use the no form of this command to remove traffic classification.

set {dscp new-dscp | [ip] precedence new-precedence}

no set {dscp new-dscp | [ip] precedence new-precedence}

Syntax Description

dscp new-dscp

New DSCP value assigned to the classified traffic. The range is 0 to 63. You also can enter a mnemonic name for a commonly used value.

[ip] precedence new-precedence

New IP-precedence value assigned to the classified traffic. The range is 0 to 7. You also can enter a mnemonic name for a commonly used value.


Defaults

No traffic classification is defined.

Command Modes

Policy-map class configuration

Command History

Release
Modification

12.2(25)FX

This command was introduced.

12.2(25)SED

The ip keyword is optional.


Usage Guidelines

If you have used the set ip dscp policy-map class configuration command, the switch changes this command to set dscp in the switch configuration. If you enter the set ip dscp policy-map class configuration command, this setting appears as set dscp in the switch configuration.

You can use the set ip precedence policy-map class configuration command or the set precedence policy-map class configuration command. This setting appears as set ip precedence in the switch configuration.

The set command is mutually exclusive with the trust policy-map class configuration command within the same policy map.

For the set dscp new-dscp or the set ip precedence new-precedence command, you can enter a mnemonic name for a commonly used value. For example, you can enter the set dscp af11 command, which is the same as entering the set dscp 10 command. You can enter the set ip precedence critical command, which is the same as entering the set ip precedence 5 command. For a list of supported mnemonics, enter the set dscp ? or the set ip precedence ? command to see the command-line help strings.

To return to policy-map configuration mode, use the exit command. To return to privileged EXEC mode, use the end command.

Examples

This example shows how to assign DSCP 10 to all FTP traffic without any policers:

Switch(config)# policy-map policy_ftp
Switch(config-pmap)# class ftp_class
Switch(config-pmap-c)# set dscp 10
Switch(config-pmap)# exit

You can verify your settings by entering the show policy-map privileged EXEC command.

Related Commands

Command
Description

class

Defines a traffic classification match criteria (through the police, set, and trust policy-map class configuration commands) for the specified class-map name.

police

Defines a policer for classified traffic.

policy-map

Creates or modifies a policy map that can be attached to multiple ports to specify a service policy.

show policy-map

Displays QoS policy maps.

trust

Defines a trust state for traffic classified through the class policy-map configuration command or the class-map global configuration command.


setup

Use the setup privileged EXEC command to configure the switch with its initial configuration.

setup

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

When you use the setup command, make sure that you have this information:

IP address and network mask

Password strategy for your environment

Whether the switch will be used as the cluster command switch and the cluster name

When you enter the setup command, an interactive dialog, called the System Configuration Dialog, appears. It guides you through the configuration process and prompts you for information. The values shown in brackets next to each prompt are the default values last set by using either the setup command facility or the configure privileged EXEC command.

Help text is provided for each prompt. To access help text, press the question mark (?) key at a prompt.

To return to the privileged EXEC prompt without making changes and without running through the entire System Configuration Dialog, press Ctrl-C.

When you complete your changes, the setup program shows you the configuration command script that was created during the setup session. You can save the configuration in NVRAM or return to the setup program or the command-line prompt without saving it.

Examples

This is an example of output from the setup command:

Switch# setup
--- System Configuration Dialog ---

Continue with configuration dialog? [yes/no]: yes

At any point you may enter a question mark '?' for help.
Use ctrl-c to abort configuration dialog at any prompt.
Default settings are in square brackets '[]'.

Basic management setup configures only enough connectivity
for management of the system, extended setup will ask you
to configure each interface on the system.

Would you like to enter basic management setup? [yes/no]: yes
Configuring global parameters:
Enter host name [Switch]:host-name

  The enable secret is a password used to protect access to
  privileged EXEC and configuration modes. This password, after
  entered, becomes encrypted in the configuration.
  Enter enable secret: enable-secret-password

  The enable password is used when you do not specify an
  enable secret password, with some older software versions, and
  some boot images.
  Enter enable password: enable-password

  The virtual terminal password is used to protect
  access to the router over a network interface.
  Enter virtual terminal password: terminal-password

  Configure SNMP Network Management? [no]: yes
  Community string [public]: 

Current interface summary
Any interface listed with OK? value "NO" does not have a valid configuration

Interface                  IP-Address      OK? Method Status                Protocol
Vlan1                      172.20.135.202  YES NVRAM  up                    up

GigabitEthernet6/0/1 unassigned      YES unset  up                    up

GigabitEthernet6/0/2 unassigned      YES unset  up                    down

<output truncated>

Port-channel1              unassigned      YES unset  up                    down

Enter interface name used to connect to the
management network from the above interface summary: vlan1

Configuring interface vlan1:
Configure IP on this interface? [yes]: yes 
IP address for this interface: ip_address
Subnet mask for this interface [255.0.0.0]: subnet_mask

Would you like to enable as a cluster command switch? [yes/no]: yes

Enter cluster name: cluster-name

The following configuration command script was created:

hostname host-name
enable secret 5 $1$LiBw$0Xc1wyT.PXPkuhFwqyhVi0
enable password enable-password
line vty 0 15
password terminal-password
snmp-server community public
!
no ip routing
!
interface GigabitEthernet6/0/1
no ip address
!
interface GigabitEthernet6/0/2
no ip address
! 


cluster enable cluster-name
!
end
Use this configuration? [yes/no]: yes
!
[0] Go to the IOS command prompt without saving this config.

[1] Return back to the setup without saving this config.

[2] Save this configuration to nvram and exit.

Enter your selection [2]:

Related Commands

Command
Description

show running-config

Displays the running configuration on the switch.

show version

Displays version information for the hardware and firmware.


setup express

Use the setup express global configuration command to enable Express Setup mode. Use the no form of this command to disable Express Setup mode.

setup express

no setup express

Syntax Description

This command has no arguments or keywords.

Defaults

Express Setup is enabled.

Command Modes

Global configuration

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

When Express Setup is enabled on a new (unconfigured) switch, pressing the Mode button for 2 seconds activates Express Setup. You can access the switch through an Ethernet port by using the IP address 10.0.0.1 and then can configure the switch with the web-based Express Setup program or the command-line interface (CLI)-based setup program.

When you press the Mode button for 2 seconds on a configured switch, the LEDs above the Mode button start blinking. If you press the Mode button for a total of 10 seconds, the switch configuration is deleted, and the switch reboots. The switch can then be configured like a new switch, either through the web-based Express Setup program or the CLI-based setup program.


Note As soon as you make any change to the switch configuration (including entering no at the beginning of the CLI-based setup program), configuration by Express Setup is no longer available. You can only run Express Setup again by pressing the Mode button for 10 seconds. This deletes the switch configuration and reboots the switch.


If Express Setup is active on the switch, entering the write memory or copy running-configuration startup-configuration privileged EXEC commands deactivates Express Setup. The IP address 10.0.0.1 is no longer valid on the switch, and your connection using this IP address ends.

The primary purpose of the no setup express command is to prevent someone from deleting the switch configuration by pressing the Mode button for 10 seconds.

Examples

This example shows how to enable Express Setup mode:

Switch(config)# setup express

You can verify that Express Setup mode is enabled by pressing the Mode button:

On an unconfigured switch, the LEDs above the Mode button turn solid green after 3 seconds.

On a configured switch, the mode LEDs begin blinking after 2 seconds and turn solid green after 10 seconds.


Caution If you hold the Mode button down for a total of 10 seconds, the configuration is deleted, and the switch reboots.

This example shows how to disable Express Setup mode:

Switch(config)# no setup express

You can verify that Express Setup mode is disabled by pressing the Mode button. The mode LEDs do not turn solid green or begin blinking green if Express Setup mode is not enabled on the switch.

Related Commands

Command
Description

show setup express

Displays if Express Setup mode is active.


show access-lists

Use the show access-lists privileged EXEC command to display access control lists (ACLs) configured on the switch.

show access-lists [name | number | hardware counters | ipc] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image.


Syntax Description

name

(Optional) Name of the ACL.

number

(Optional) ACL number. The range is 1 to 2699.

hardware counters

(Optional) Display global hardware ACL statistics for switched and routed packets.

ipc

(Optional) Display Interprocess Communication (IPC) protocol access-list configuration download information.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.



Note Though visible in the command-line help strings, the rate-limit keywords are not supported.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

The switch supports only IP standard and extended access lists. Therefore, the allowed numbers are only 1 to 199 and 1300 to 2699.

This command also displays the MAC ACLs that are configured.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show access-lists command:

Switch# show access-lists
Standard IP access list 1
    10 permit 1.1.1.1
    20 permit 2.2.2.2
    30 permit any
    40 permit 0.255.255.255, wildcard bits 12.0.0.0
Standard IP access list videowizard_1-1-1-1
    10 permit 1.1.1.1
Standard IP access list videowizard_10-10-10-10
    10 permit 10.10.10.10
Extended IP access list 121
    10 permit ahp host 10.10.10.10 host 20.20.10.10 precedence routine
Extended IP access list CMP-NAT-ACL
    Dynamic Cluster-HSRP deny   ip any any
    10 deny ip any host 19.19.11.11
    20 deny ip any host 10.11.12.13
    Dynamic Cluster-NAT permit ip any any
    10 permit ip host 10.99.100.128 any
    20 permit ip host 10.46.22.128 any
    30 permit ip host 10.45.101.64 any
    40 permit ip host 10.45.20.64 any
    50 permit ip host 10.213.43.128 any
    60 permit ip host 10.91.28.64 any
    70 permit ip host 10.99.75.128 any
    80 permit ip host 10.38.49.0 any 

This is an example of output from the show access-lists hardware counters command:

Switch# show access-lists hardware counters
L2 ACL INPUT Statistics
     Drop:                All frame count: 855
     Drop:                All bytes count: 94143
     Drop And Log:        All frame count: 0
     Drop And Log:        All bytes count: 0
     Bridge Only:         All frame count: 0
     Bridge Only:         All bytes count: 0
     Bridge Only And Log: All frame count: 0
     Bridge Only And Log: All bytes count: 0
     Forwarding To CPU:   All frame count: 0
     Forwarding To CPU:   All bytes count: 0
     Forwarded:           All frame count: 2121
     Forwarded:           All bytes count: 180762
     Forwarded And Log:   All frame count: 0
     Forwarded And Log:   All bytes count: 0

 L3 ACL INPUT Statistics
     Drop:                All frame count: 0
     Drop:                All bytes count: 0
     Drop And Log:        All frame count: 0
     Drop And Log:        All bytes count: 0
     Bridge Only:         All frame count: 0
     Bridge Only:         All bytes count: 0
     Bridge Only And Log: All frame count: 0
     Bridge Only And Log: All bytes count: 0
     Forwarding To CPU:   All frame count: 0
     Forwarding To CPU:   All bytes count: 0
     Forwarded:           All frame count: 13586
     Forwarded:           All bytes count: 1236182
     Forwarded And Log:   All frame count: 0
     Forwarded And Log:   All bytes count: 0

 L2 ACL OUTPUT Statistics
     Drop:                All frame count: 0
     Drop:                All bytes count: 0
     Drop And Log:        All frame count: 0
     Drop And Log:        All bytes count: 0
     Bridge Only:         All frame count: 0
     Bridge Only:         All bytes count: 0
     Bridge Only And Log: All frame count: 0
     Bridge Only And Log: All bytes count: 0
     Forwarding To CPU:   All frame count: 0
     Forwarding To CPU:   All bytes count: 0
     Forwarded:           All frame count: 232983
     Forwarded:           All bytes count: 16825661
     Forwarded And Log:   All frame count: 0
     Forwarded And Log:   All bytes count: 0

 L3 ACL OUTPUT Statistics
     Drop:                All frame count: 0
     Drop:                All bytes count: 0
     Drop And Log:        All frame count: 0
     Drop And Log:        All bytes count: 0
     Bridge Only:         All frame count: 0
     Bridge Only:         All bytes count: 0
     Bridge Only And Log: All frame count: 0
     Bridge Only And Log: All bytes count: 0
     Forwarding To CPU:   All frame count: 0
     Forwarding To CPU:   All bytes count: 0
     Forwarded:           All frame count: 514434
     Forwarded:           All bytes count: 39048748
     Forwarded And Log:   All frame count: 0
     Forwarded And Log:   All bytes count: 0

Related Commands

Command
Description

access-list

Configures a standard or extended numbered access list on the switch.

ip access list

Configures a named IP access list on the switch.

mac access-list extended

Configures a named or numbered MAC access list on the switch.


show archive status

Use the show archive status privileged EXEC command to display the status of a new image being downloaded to a switch with the HTTP or the TFTP protocol.

show archive status [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

If you use the archive download-sw privileged EXEC command to download an image to a TFTP server, the output of the archive download-sw command shows the status of the download.

If you do not have a TFTP server, you can use Network Assistant or the embedded device manager to download the image by using HTTP. The show archive status command shows the progress of the download.

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

These are examples of output from the show archive status command:

Switch# show archive status
IDLE: No upgrade in progress

Switch# show archive status
LOADING: Upgrade in progress

Switch# show archive status
EXTRACT: Extracting the image

Switch# show archive status
VERIFY: Verifying software

Switch# show archive status
RELOAD: Upgrade completed. Reload pending

Related Commands

Command
Description

archive download-sw

Downloads a new image from a TFTP server to the switch.


show arp access-list

Use the show arp access-list user EXEC command to display detailed information about Address Resolution Protocol (ARP) access control (lists).

show arp access-list [acl-name] [ | {begin | exclude | include} expression]

Syntax Description

acl-name

(Optional) Name of the ACL.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(50)SE

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show arp access-list command:

Switch> show arp access-list
ARP access list rose
    permit ip 10.101.1.1 0.0.0.255 mac any
    permit ip 20.3.1.0 0.0.0.255 mac any

Related Commands

Command
Description

arp access-list

Defines an ARP ACL.

deny (ARP access-list configuration)

Denies an ARP packet based on matches against the Dynamic Host Configuration Protocol (DHCP) bindings.

ip arp inspection filter vlan

Permits ARP requests and responses from a host configured with a static IP address.

permit (ARP access-list configuration)

Permits an ARP packet based on matches against the DHCP bindings.


show authentication

Use the show authentication command (in either user EXEC or privileged EXEC mode) to display information about authentication manager events on the switch.

show authentication {interface interface-id | registrations | sessions [session-id session-id] [handle handle] [interface interface-id] [mac mac] [method method]}

Syntax Description

interface interface-id

(Optional) Display all of the authentication manager details for the specified interface.

method method

(Optional) Displays all clients authorized by a specified authentication method (dot1x, mab, or webauth)

registrations

(Optional) Display authentication manager registrations

sessions

(Optional) Display detail of the current authentication manager sessions (for example, client devices). If you do not enter any optional specifiers, all current active sessions are displayed. You can enter the specifiers singly or in combination to display a specific session (or group of sessions).

session-id session-id

(Optional) Specify an authentication manager session.

handle handle

(Optional) Specify a range from 1 to 4294967295.

mac mac

(Optional) Display authentication manager information for a specified MAC address.


Command Default

This command has no default settings.

Command Modes

Privileged EXEC and User EXEC

Command History

Release
Modification

12.2(50)SE

This command was introduced.


Usage Guidelines

Table 2-21 describes the significant fields shown in the output of the show authentication command.


Note The possible values for the status of sessions are shown below. For a session in terminal state, Authz Success or Authz Failed is displayed along with No methods if no method has provided a result.


Table 2-21 show authentication Command Output  

Field
Description

Idle

The session has been initialized and no methods have run yet.

Running

A method is running for this session.

No methods

No method has provided a result for this session.

Authc Success

A method has resulted in authentication success for this session.

Authc Failed

A method has resulted in authentication fail for this session.

Authz Success

All features have been successfully applied for this session.

Authz Failed

A feature has failed to be applied for this session.


Table 2-22 lists the possible values for the state of methods. For a session in a terminal state, Authc Success, Authc Failed, or Failed over are displayed. Failed over means that an authentication method ran and then failed over to the next method, which did not provide a result. Not run appears for sessions that synchronized on standby.

Table 2-22 State Method Values

Method State
State Level
Description

Not run

Terminal

The method has not run for this session.

Running

Intermediate

The method is running for this session.

Failed over

Terminal

The method has failed and the next method is expected to provide a result.

Authc Success

Terminal

The method has provided a successful authentication result for the session.

Authc Failed

Terminal

The method has provided a failed authentication result for the session.


Examples

This is an example the show authentication registrations command:

Switch# show authentication registrations 
Auth Methods registered with the Auth Manager:
Handle Priority Name
3 0 dot1x
2 1 mab
1 2 webauth

The is an example of the show authentication interface interface-id command:

Switch# show authentication interface gigabitethernet0/23
Client list:
MAC Address Domain Status Handle Interface
000e.84af.59bd DATA Authz Success 0xE0000000 GigabitEthernet0/23 
Available methods list:
Handle Priority Name
3 0 dot1x
Runnable methods list:
Handle Priority Name
3 0 dot1x

This is an example of the show authentication sessions command:

Switch# show authentication sessions
Interface  MAC Address     Method   Domain   Status         Session ID
Gi3/45     (unknown)       N/A      DATA     Authz Failed   0908140400000007003651EC
Gi3/46     (unknown)       N/A      DATA     Authz Success  09081404000000080057C274

This is an example of the show authentication sessions command for a specified interface:

Switch# show authentication sessions int gigabitethernet 0/46
            Interface:  GigabitEthernet0/46 
          MAC Address:  Unknown
           IP Address:  Unknown
               Status:  Authz Success
               Domain:  DATA
       Oper host mode:  multi-host
     Oper control dir:  both
        Authorized By:  Guest Vlan
          Vlan Policy:  4094
      Session timeout:  N/A
         Idle timeout:  N/A
    Common Session ID:  09081404000000080057C274
      Acct Session ID:  0x0000000A
               Handle:  0xCC000008
Runnable methods list:
       Method   State
       dot1x    Failed over 

This is an example of the show authentication sessions command for a specified MAC address:

Switch# show authentication sessions mac 000e.84af.59bd
Interface: GigabitEthernet0/46 
MAC Address: 000e.84af.59bd
Status: Authz Success
Domain: DATA
Oper host mode: single-host
Authorized By: Authentication Server
Vlan Policy: 10
Handle: 0xE0000000
Runnable methods list:
Method State
dot1x Authc Success

This is an example of the show authentication session method command for a specified method:

Switch# show authentication sessions method mab
No Auth Manager contexts match supplied criteria
Switch# show authentication sessions method dot1x
MAC Address Domain Status Handle Interface
000e.84af.59bd DATA Authz Success 0xE0000000 GigabitEthernet1/23

Related Commands

Command
Description

authentication control-direction

Configures the port mode as unidirectional or bidirectional.

authentication event

Sets the action for specific authentication events.

authentication fallback

Configures a port to use web authentication as a fallback method for clients that do not support IEEE 802.1x authentication.

authentication host-mode

Sets the authorization manager mode on a port.

authentication open

Enables or disables open access on a port.

authentication order

Sets the order of authentication methods used on a port.

authentication periodic

Enables or disables reauthentication on a port.

authentication port-control

Enables manual control of the port authorization state.

authentication priority

Adds an authentication method to the port-priority list.

authentication timer

Configures the timeout and reauthentication parameters for an 802.1x-enabled port.


show auto qos

Use the show auto qos user EXEC command to display the quality of service (QoS) commands entered on the interfaces on which automatic QoS (auto-QoS) is enabled.

show auto qos [interface [interface-id]]


Note To use this command, the switch must be running the LAN Base image.


Syntax Description

interface [interface-id]

(Optional) Display auto-QoS information for the specified port or for all ports. Valid interfaces include physical ports.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.

12.2(40)SE

The information in the command output changed.


Usage Guidelines

The show auto qos command output shows only the auto-QoS command entered on each interface. The show auto qos interface interface-id command output shows the auto-QoS command entered on a specific interface.

Use the show running-config privileged EXEC command to display the auto-QoS configuration and the user modifications.

The show auto qos command output also shows the service policy information for the Cisco IP phone.

To display information about the QoS configuration that might be affected by auto-QoS, use one of these commands:

show mls qos

show mls qos maps cos-dscp

show mls qos interface [interface-id] [buffers | queueing]

show mls qos maps [cos-dscp | cos-input-q | cos-output-q | dscp-cos | dscp-input-q | dscp-output-q]

show mls qos input-queue

show running-config

Examples

This is an example of output from the show auto qos command after the auto qos voip cisco-phone and the auto qos voip cisco-softphone interface configuration commands are entered:

Switch> show auto qos 
GigabitEthernet2/0/4
auto qos voip cisco-softphone

GigabitEthernet2/0/5
auto qos voip cisco-phone

GigabitEthernet2/0/6
auto qos voip cisco-phone

This is an example of output from the show auto qos interface interface-id command when the auto qos voip cisco-phone interface configuration command is entered:


Switch> show auto qos interface gigabitethernet 2/0/5
GigabitEthernet2/0/5
auto qos voip cisco-phone

This is an example of output from the show running-config privileged EXEC command when the auto qos voip cisco-phone and the auto qos voip cisco-softphone interface configuration commands are entered:

Switch# show running-config
Building configuration...
...
mls qos map policed-dscp  24 26 46 to 0
mls qos map cos-dscp 0 8 16 26 32 46 48 56
mls qos srr-queue input bandwidth 90 10
mls qos srr-queue input threshold 1 8 16
mls qos srr-queue input threshold 2 34 66
mls qos srr-queue input buffers 67 33
mls qos srr-queue input cos-map queue 1 threshold 2  1
mls qos srr-queue input cos-map queue 1 threshold 3  0
mls qos srr-queue input cos-map queue 2 threshold 1  2
mls qos srr-queue input cos-map queue 2 threshold 2  4 6 7
mls qos srr-queue input cos-map queue 2 threshold 3  3 5
mls qos srr-queue input dscp-map queue 1 threshold 2  9 10 11 12 13 14 15
mls qos srr-queue input dscp-map queue 1 threshold 3  0 1 2 3 4 5 6 7
mls qos srr-queue input dscp-map queue 1 threshold 3  32
mls qos srr-queue input dscp-map queue 2 threshold 1  16 17 18 19 20 21 22 23
mls qos srr-queue input dscp-map queue 2 threshold 2  33 34 35 36 37 38 39 48
mls qos srr-queue input dscp-map queue 2 threshold 2  49 50 51 52 53 54 55 56
mls qos srr-queue input dscp-map queue 2 threshold 2  57 58 59 60 61 62 63
mls qos srr-queue input dscp-map queue 2 threshold 3  24 25 26 27 28 29 30 31
mls qos srr-queue input dscp-map queue 2 threshold 3  40 41 42 43 44 45 46 47
mls qos srr-queue output cos-map queue 1 threshold 3  5
mls qos srr-queue output cos-map queue 2 threshold 3  3 6 7
mls qos srr-queue output cos-map queue 3 threshold 3  2 4
mls qos srr-queue output cos-map queue 4 threshold 2  1
mls qos srr-queue output cos-map queue 4 threshold 3  0
mls qos srr-queue output dscp-map queue 1 threshold 3  40 41 42 43 44 45 46 47
mls qos srr-queue output dscp-map queue 2 threshold 3  24 25 26 27 28 29 30 31
mls qos srr-queue output dscp-map queue 2 threshold 3  48 49 50 51 52 53 54 55
mls qos srr-queue output dscp-map queue 2 threshold 3  56 57 58 59 60 61 62 63
mls qos srr-queue output dscp-map queue 3 threshold 3  16 17 18 19 20 21 22 23
mls qos srr-queue output dscp-map queue 3 threshold 3  32 33 34 35 36 37 38 39
mls qos srr-queue output dscp-map queue 4 threshold 1  8
mls qos srr-queue output dscp-map queue 4 threshold 2  9 10 11 12 13 14 15
mls qos srr-queue output dscp-map queue 4 threshold 3  0 1 2 3 4 5 6 7
mls qos queue-set output 1 threshold 1 100 100 100 100
mls qos queue-set output 1 threshold 2 75 75 75 250
mls qos queue-set output 1 threshold 3 75 150 100 300
mls qos queue-set output 1 threshold 4 50 100 75 400
mls qos queue-set output 2 threshold 1 100 100 100 100
mls qos queue-set output 2 threshold 2 35 35 35 35
mls qos queue-set output 2 threshold 3 55 82 100 182
mls qos queue-set output 2 threshold 4 90 250 100 400
mls qos queue-set output 1 buffers 15 20 20 45
mls qos queue-set output 2 buffers 24 20 26 30
mls qos
...
!
class-map match-all AutoQoS-VoIP-RTP-Trust
  match ip dscp ef
class-map match-all AutoQoS-VoIP-Control-Trust
  match ip dscp cs3  af31
!
policy-map AutoQoS-Police-SoftPhone
  class AutoQoS-VoIP-RTP-Trust
   set dscp ef
    police 320000 8000 exceed-action policed-dscp-transmit
  class AutoQoS-VoIP-Control-Trust
   set dscp cs3
    police 32000 8000 exceed-action policed-dscp-transmit
!
policy-map AutoQoS-Police-CiscoPhone
  class AutoQoS-VoIP-RTP-Trust
   set dscp ef
    police 320000 8000 exceed-action policed-dscp-transmit
  class AutoQoS-VoIP-Control-Trust
   set dscp cs3
    police 32000 8000 exceed-action policed-dscp-transmit
...
!
interface GigabitEthernet0/4
interface GigabitEthernet0/4
switchport mode access
 switchport port-security maximum 400
 service-policy input AutoQoS-Police-SoftPhone
 speed 100
 duplex half
 srr-queue bandwidth share 10 10 60 20
 priority-queue out
 auto qos voip cisco-softphone
!
interface GigabitEthernet2/0/5
 switchport mode access
 switchport port-security maximum 1999
 speed 100
 duplex full
 srr-queue bandwidth share 10 10 60 20
 priority-queue out
 mls qos trust device cisco-phone
 mls qos trust cos
 auto qos voip cisco-phone
!
interface GigabitEthernet2/0/6
switchport trunk encapsulation dot1q
 switchport trunk native vlan 2
 switchport mode access
 speed 10
 srr-queue bandwidth share 10 10 60 20
 priority-queue out
 mls qos trust device cisco-phone
 mls qos trust cos
 auto qos voip cisco-phone
!
interface GigabitEthernet4/0/1
srr-queue bandwidth share 10 10 60 20
 priority-queue out
 mls qos trust device cisco-phone
 mls qos trust cos
 mls qos trust device cisco-phone 
service-policy input AutoQoS-Police-CiscoPhone

<output truncated>

This is an example of output from the show auto qos interface interface-id command when the auto qos voip cisco-phone interface configuration command is entered:

Switch> show auto qos interface fastethernet0/2
FastEthernet0/2
auto qos voip cisco-softphone

This is an example of output from the show auto qos command when auto-QoS is disabled on the switch:

Switch> show auto qos
AutoQoS not enabled on any interface

This is an example of output from the show auto qos interface interface-id command when auto-QoS is disabled on an interface:

Switch> show auto qos interface gigabitethernet3/0/1
AutoQoS is disabled

Related Commands

Command
Description

auto qos voip

Automatically configures QoS for VoIP within a QoS domain.

debug auto qos

Enables debugging of the auto-QoS feature.


show boot

Use the show boot privileged EXEC command to display the settings of the boot environment variables.

show boot [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show boot command. Table 2-23 describes each field in the display.

Switch# show boot
BOOT path-list      :flash:/image
Config file         :flash:/config.text
Private Config file :flash:/private-config.text
Enable Break        :no
Manual Boot         :yes
HELPER path-list    :
Auto upgrade        :yes
-------------------

For switch stacks, information is shown for each switch in the stack.

Only Catalyst 2960-S switches running the LAN base image support switch stacks.

Table 2-23 show boot Field Descriptions

Field
Description

BOOT path-list

Displays a semicolon separated list of executable files to try to load and execute when automatically booting up.

If the BOOT environment variable is not set, the system attempts to load and execute the first executable image it can find by using a recursive, depth-first search through the flash file system. In a depth-first search of a directory, each encountered subdirectory is completely searched before continuing the search in the original directory.

If the BOOT variable is set but the specified images cannot be loaded, the system attempts to boot up with the first bootable file that it can find in the flash file system.

Config file

Displays the filename that Cisco IOS uses to read and write a nonvolatile copy of the system configuration.

Private Config file

Displays the filename that Cisco IOS uses to read and write a nonvolatile copy of the system configuration.

Enable Break

Displays whether a break during booting up is enabled or disabled. If it is set to yes, on, or 1, you can interrupt the automatic bootup process by pressing the Break key on the console after the flash file system is initialized.

Manual Boot

Displays whether the switch automatically or manually boots up. If it is set to no or 0, the bootloader attempts to automatically boot up the system. If it is set to anything else, you must manually boot up the switch from the bootloader mode.

Helper path-list

Displays a semicolon separated list of loadable files to dynamically load during the bootloader initialization. Helper files extend or patch the functionality of the bootloader.

Auto upgrade

Displays whether the switch stack is set to automatically copy its software version to an incompatible switch so that it can join the stack.

A switch in version-mismatch mode is a switch that has a different stack protocol version than the version on the stack. Switches in version-mismatch mode cannot join the stack. If the stack has an image that can be copied to a switch in version-mismatch mode, and if the boot auto-copy-sw feature is enabled, the stack automatically copies the image from another stack member to the switch in version-mismatch mode. The switch then exits version-mismatch mode, reboots, and joins the stack.

NVRAM/Config file buffer size

Displays the buffer size that Cisco IOS uses to hold a copy of the configuration file in memory. The configuration file cannot be larger than the buffer size allocation.


Related Commands

Command
Description

boot auto-copy-sw

Enables the automatic upgrade (auto-upgrade) process to automatically upgrade a switch in version-mismatch mode.

boot config-file

Specifies the filename that Cisco IOS uses to read and write a nonvolatile copy of the system configuration.

boot enable-break

Enables interrupting the automatic boot process.

boot manual

Enables manually booting up the switch during the next bootup cycle.

boot private-config-file

Specifies the filename that Cisco IOS uses to read and write a nonvolatile copy of the private configuration.

boot system

Specifies the Cisco IOS image to load during the next bootup cycle.


show cable-diagnostics tdr

Use the show cable-diagnostics tdr privileged EXEC command to display the Time Domain Reflector (TDR) results.

show cable-diagnostics tdr interface interface-id [ | {begin | exclude | include} expression]

Syntax Description

interface-id

Specify the interface on which TDR was run.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

TDR is supported only on 10/100 and 10/100/1000 copper Ethernet ports. It is not supported on SFP module ports. For more information about TDR, see the software configuration guide for this release.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show cable-diagnostics tdr interface interface-id command:

Switch# show cable-diagnostics tdr interface gigabitethernet1/0/2
TDR test last run on: March 01 20:15:40
Interface Speed Local pair Pair length        Remote pair Pair status
--------- ----- ---------- ------------------ ----------- --------------------
Gi1/0/2     auto  Pair A     0    +/- 2  meters N/A         Open
                
                  Pair B     0    +/- 2  meters N/A         Open
                  Pair C     0    +/- 2  meters N/A         Open
                  Pair D     0    +/- 2  meters N/A         Open

Table 2-24 lists the descriptions of the fields in the show cable-diagnostics tdr command output.

Table 2-24 Fields Descriptions for the show cable-diagnostics tdr Command Output 

Field
Description

Interface

Interface on which TDR was run.

Speed

Speed of connection.

Local pair

Name of the pair of wires that TDR is testing on the local interface.

Pair length

Location on the cable where the problem is, with respect to your switch. TDR can only find the location in one of these cases:

The cable is properly connected, the link is up, and the interface speed is 1000 Mb/s.

The cable is open.

The cable has a short.

Remote pair

Name of the pair of wires to which the local pair is connected. TDR can learn about the remote pair only when the cable is properly connected and the link is up.

Pair status

The status of the pair of wires on which TDR is running:

Normal—The pair of wires is properly connected.

Not completed—The test is running and is not completed.

Not supported—The interface does not support TDR.

Open—The pair of wires is open.

Shorted—The pair of wires is shorted.

ImpedanceMis—The impedance is mismatched.

Short/Impedance Mismatched—The impedance mismatched or the cable is short.

InProgress—The diagnostic test is in progress


This is an example of output from the show interfaces interface-id command when TDR is running:

Switch# show interfaces gigabitethernet0/2
gigabitethernet0/2 is up, line protocol is up (connected: TDR in Progress)

This is an example of output from the show cable-diagnostics tdr interface interface-id command when TDR is not running:

Switch# show cable-diagnostics tdr interface  gigabitethernet0/2
% TDR test was never issued on Gi1/0/2

If an interface does not support TDR, this message appears:

% TDR test is not supported on switch 1

Related Commands

Command
Description

test cable-diagnostics tdr

Enables and runs TDR on an interface.


show cisp

Use the show cisp privileged EXEC command to display CISP information for a specified interface.

show cisp {[interface interface-id] | clients | summary} | {[begin | exclude | include} expression]}

Syntax Description

clients

(Optional) Display CISP client details

interface interface-id

(Optional) Display CISP information about the specified interface. Valid interfaces include physical ports and port channels.

summary

(Optional) Display

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Global configuration

Command History

Release
Modification

12.2(50)SE

This command was introduced.


Examples

This example shows output from the show cisp interface command:

WS-C3750E-48TD#show cisp interface fast 0 
CISP not enabled on specified interface

This example shows output from the show cisp summary command:

CISP is not running on any interface

Related Commands

Command
Description

dot1x credentials profile

Configure a profile on a supplicant switch

cisp enable

Enable Client Information Signalling Protocol (CISP)


show class-map

Use the show class-map user EXEC command to display quality of service (QoS) class maps, which define the match criteria to classify traffic.

show class-map [class-map-name] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image.


Syntax Description

class-map-name

(Optional) Display the contents of the specified class map.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show class-map command:

Switch> show class-map 
Class Map match-all videowizard_10-10-10-10 (id 2)
   Match access-group name videowizard_10-10-10-10

 Class Map match-any class-default (id 0)
   Match any
 Class Map match-all dscp5 (id 3)
   Match ip dscp 5

Related Commands

Command
Description

class-map

Creates a class map to be used for matching packets to the class whose name you specify.

match (class-map configuration)

Defines the match criteria to classify traffic.


show cluster

Use the show cluster user EXEC command to display the cluster status and a summary of the cluster to which the switch belongs. This command can be entered on the cluster command switch and cluster member switches.

show cluster [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

If you enter this command on a switch that is not a cluster member, the error message Not a management cluster member appears.

On a cluster member switch, this command displays the identity of the cluster command switch, the switch member number, and the state of its connectivity with the cluster command switch.

On a cluster command switch stack or cluster command switch, this command displays the cluster name and the total number of members. It also shows the cluster status and time since the status changed. If redundancy is enabled, it displays the primary and secondary command-switch information.


Note Stacking is supported only on Catalyst 2960-S switches.


Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output when the show cluster command is entered on the active cluster command switch:

Switch> show cluster
Command switch for cluster "Ajang"
        Total number of members:        7
        Status:                         1 members are unreachable
        Time since last status change:  0 days, 0 hours, 2 minutes
        Redundancy:                     Enabled
                Standby command switch: Member 1
                Standby Group:          Ajang_standby
                Standby Group Number:   110
        Heartbeat interval:             8
        Heartbeat hold-time:            80
        Extended discovery hop count:   3 

This is an example of output when the show cluster command is entered on a cluster member switch:

Switch1> show cluster
Member switch for cluster "hapuna"
        Member number:                  3
        Management IP address:          192.192.192.192
        Command switch mac address:     0000.0c07.ac14
        Heartbeat interval:             8
        Heartbeat hold-time:            80 

This is an example of output when the show cluster command is entered on a cluster member switch that is configured as the standby cluster command switch:

Switch> show cluster
Member switch for cluster "hapuna"
        Member number:                  3 (Standby command switch)
        Management IP address:          192.192.192.192
        Command switch mac address:     0000.0c07.ac14
        Heartbeat interval:             8
        Heartbeat hold-time:            80 

This is an example of output when the show cluster command is entered on the cluster command switch that has lost connectivity with member 1:

Switch> show cluster
Command switch for cluster "Ajang"
        Total number of members:        7
        Status:                         1 members are unreachable
        Time since last status change:  0 days, 0 hours, 5 minutes
        Redundancy:                     Disabled
        Heartbeat interval:             8
        Heartbeat hold-time:            80
        Extended discovery hop count:   3 

This is an example of output when the show cluster command is entered on a cluster member switch that has lost connectivity with the cluster command switch:

Switch> show cluster
Member switch for cluster "hapuna"
        Member number:                  <UNKNOWN>
        Management IP address:          192.192.192.192
        Command switch mac address:     0000.0c07.ac14
        Heartbeat interval:             8
        Heartbeat hold-time:            80 

Related Commands

Command
Description

cluster enable

Enables a command-capable switch as the cluster command switch, assigns a cluster name, and optionally assigns a member number to it.

show cluster candidates

Displays a list of candidate switches.

show cluster members

Displays information about the cluster members.


show cluster candidates

Use the show cluster candidates privileged EXEC command to display a list of candidate switches.

show cluster candidates [detail | mac-address H.H.H.] [ | {begin | exclude | include} expression]

Syntax Description

detail

(Optional) Display detailed information for all candidates.

mac-address H.H.H.

(Optional) MAC address of the cluster candidate.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

This command is available only on the cluster command switch stack or cluster command switch.


Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.


If the switch is not a cluster command switch, the command displays an empty line at the prompt.

The SN in the display means switch member number. If E appears in the SN column, it means that the switch is discovered through extended discovery. If E does not appear in the SN column, it means that the switch member number is the upstream neighbor of the candidate switch. The hop count is the number of devices the candidate is from the cluster command switch.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show cluster candidates command:

Switch> show cluster candidates
                                                             |---Upstream---|
MAC Address    Name         Device Type      PortIf  FEC Hops SN PortIf  FEC
00d0.7961.c4c0 StLouis-2    WS-C2960-12T     Gi0/1        2   1  Fa0/11 
00d0.bbf5.e900 ldf-dist-128 WS-C3524-XL      Fa0/7        1   0  Fa0/24      
00e0.1e7e.be80 1900_Switch  1900             3        0   1   0  Fa0/11      
00e0.1e9f.7a00 Surfers-24   WS-C2924-XL      Fa0/5        1   0  Fa0/3       
00e0.1e9f.8c00 Surfers-12-2 WS-C2912-XL      Fa0/4        1   0  Fa0/7       
00e0.1e9f.8c40 Surfers-12-1 WS-C2912-XL      Fa0/1        1   0  Fa0/9       
 
   

This is an example of output from the show cluster candidates command that uses the MAC address of a cluster member switch directly connected to the cluster command switch:

Switch> show cluster candidates mac-address 00d0.7961.c4c0
Device 'Tahiti-12' with mac address number 00d0.7961.c4c0
        Device type:            cisco WS-C2960-12T
        Upstream MAC address:   00d0.796d.2f00 (Cluster Member 0)
        Local port:             Gi0/1   FEC number:
        Upstream port:          GI0/11  FEC Number:
Hops from cluster edge: 1
        Hops from command device: 1
 
   

This is an example of output from the show cluster candidates command that uses the MAC address of a cluster member switch three hops from the cluster edge:

Switch> show cluster candidates mac-address 0010.7bb6.1cc0
Device 'Ventura' with mac address number 0010.7bb6.1cc0
        Device type:            cisco WS-C2912MF-XL
        Upstream MAC address:   0010.7bb6.1cd4
        Local port:             Fa2/1   FEC number: 
        Upstream port:          Fa0/24  FEC Number: 
        Hops from cluster edge: 3
        Hops from command device: -

This is an example of output from the show cluster candidates detail command:

Switch> show cluster candidates detail
Device 'Tahiti-12' with mac address number 00d0.7961.c4c0
        Device type:            cisco WS-C3512-XL
        Upstream MAC address:   00d0.796d.2f00 (Cluster Member 1)
        Local port:             Fa0/3   FEC number: 
        Upstream port:          Fa0/13  FEC Number: 
        Hops from cluster edge: 1
        Hops from command device: 2
Device '1900_Switch' with mac address number 00e0.1e7e.be80
        Device type:            cisco 1900
        Upstream MAC address:   00d0.796d.2f00 (Cluster Member 2)
        Local port:             3       FEC number: 0
        Upstream port:          Fa0/11  FEC Number: 
        Hops from cluster edge: 1
        Hops from command device: 2
Device 'Surfers-24' with mac address number 00e0.1e9f.7a00
        Device type:            cisco WS-C2924-XL
        Upstream MAC address:   00d0.796d.2f00 (Cluster Member 3)
        Local port:             Fa0/5   FEC number: 
        Upstream port:          Fa0/3   FEC Number: 
        Hops from cluster edge: 1
        Hops from command device: 2

Related Commands

Command
Description

show cluster

Displays the cluster status and a summary of the cluster to which the switch belongs.

show cluster members

Displays information about the cluster members.


show cluster members

Use the show cluster members privileged EXEC command to display information about the cluster members.

show cluster members [n | detail] [ | {begin | exclude | include} expression]

Syntax Description

n

(Optional) Number that identifies a cluster member. The range is 0 to 15.

detail

(Optional) Display detailed information for all cluster members.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

This command is available only on the cluster command switch stack or cluster command switch.


Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.


If the cluster has no members, this command displays an empty line at the prompt.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show cluster members command. The SN in the display means switch number.

Switch# show cluster members
                                                |---Upstream---|
SN MAC Address    Name         PortIf FEC Hops   SN PortIf  FEC  State
0  0002.4b29.2e00 StLouis1                 0                    Up   (Cmdr)
1  0030.946c.d740 tal-switch-1 Fa0/13      1     0  Gi0/1       Up
2  0002.b922.7180 nms-2820     10      0   2     1  Fa0/18      Up
3  0002.4b29.4400 SanJuan2     Gi0/1       2     1  Fa0/11      Up
4  0002.4b28.c480 GenieTest    Gi0/2       2     1  Fa0/9       Up

This is an example of output from the show cluster members for cluster member 3:

Switch# show cluster members 3
Device 'SanJuan2' with member number 3
        Device type:            cisco WS-C2960
        MAC address:            0002.4b29.4400
        Upstream MAC address:   0030.946c.d740 (Cluster member 1)
        Local port:             Gi0/1   FEC number:
        Upstream port:          GI0/11  FEC Number:
        Hops from command device: 2    
 
   

This is an example of output from the show cluster members detail command:

Switch# show cluster members detail
Device 'StLouis1' with member number 0 (Command Switch)
        Device type:            cisco WS-C2960
        MAC address:            0002.4b29.2e00
        Upstream MAC address:
        Local port:                     FEC number:
        Upstream port:                  FEC Number:
        Hops from command device: 0                 
Device 'tal-switch-14' with member number 1
        Device type:            cisco WS-C3548-XL
        MAC address:            0030.946c.d740
        Upstream MAC address:   0002.4b29.2e00 (Cluster member 0)
        Local port:             Fa0/13  FEC number:
        Upstream port:          Gi0/1   FEC Number:
        Hops from command device: 1                   
Device 'nms-2820' with member number 2
        Device type:            cisco 2820
        MAC address:            0002.b922.7180
        Upstream MAC address:   0030.946c.d740 (Cluster member 1)
        Local port:             10      FEC number: 0
        Upstream port:          Fa0/18  FEC Number:
        Hops from command device: 2                        
Device 'SanJuan2' with member number 3
        Device type:            cisco WS-C2960
        MAC address:            0002.4b29.4400
        Upstream MAC address:   0030.946c.d740 (Cluster member 1)
        Local port:             Gi0/1   FEC number:
        Upstream port:          Fa0/11  FEC Number:
        Hops from command device: 2
Device 'GenieTest' with member number 4
        Device type:            cisco SeaHorse
        MAC address:            0002.4b28.c480
        Upstream MAC address:   0030.946c.d740 (Cluster member 1)
        Local port:             Gi0/2   FEC number:
        Upstream port:          Fa0/9   FEC Number:
        Hops from command device: 2
Device 'Palpatine' with member number 5
        Device type:            cisco WS-C2924M-XL
        MAC address:            00b0.6404.f8c0
        Upstream MAC address:   0002.4b29.2e00 (Cluster member 0)
        Local port:             Gi2/1   FEC number:
        Upstream port:          Gi0/7   FEC Number:
        Hops from command device: 1                            

Related Commands

Command
Description

show cluster

Displays the cluster status and a summary of the cluster to which the switch belongs.

show cluster candidates

Displays a list of candidate switches.


show controllers cpu-interface

Use the show controllers cpu-interface privileged EXEC command to display the state of the CPU network interface ASIC and the send and receive statistics for packets reaching the CPU.

show controllers cpu-interface [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

This display provides information that might be useful for Cisco technical support representatives troubleshooting the switch.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is a partial output example from the show controllers cpu-interface command:

Switch# show controllers cpu-interface
cpu-queue-frames  retrieved  dropped    invalid    hol-block
----------------- ---------- ---------- ---------- ----------
rpc               4523063    0          0          0
stp               1545035    0          0          0
ipc               1903047    0          0          0
routing protocol  96145      0          0          0
L2 protocol       79596      0          0          0
remote console    0          0          0          0
sw forwarding     5756       0          0          0
host              225646     0          0          0
broadcast         46472      0          0          0
cbt-to-spt        0          0          0          0
igmp snooping     68411      0          0          0
icmp              0          0          0          0
logging           0          0          0          0
rpf-fail          0          0          0          0
queue14           0          0          0          0
cpu heartbeat     1710501    0          0          0

Supervisor ASIC receive-queue parameters
----------------------------------------
 queue 0 maxrecevsize 5EE pakhead 1419A20 paktail 13EAED4
 queue 1 maxrecevsize 5EE pakhead 15828E0 paktail 157FBFC
 queue 2 maxrecevsize 5EE pakhead 1470D40 paktail 1470FE4
 queue 3 maxrecevsize 5EE pakhead 19CDDD0 paktail 19D02C8

<output truncated>

Supervisor ASIC Mic Registers
------------------------------
MicDirectPollInfo               80000800
MicIndicationsReceived          00000000
MicInterruptsReceived           00000000
MicPcsInfo                      0001001F
MicPlbMasterConfiguration       00000000
MicRxFifosAvailable             00000000
MicRxFifosReady                 0000BFFF
MicTimeOutPeriod:       FrameTOPeriod: 00000EA6 DirectTOPeriod: 00004000

<output truncated>

MicTransmitFifoInfo:
Fifo0:   StartPtrs:     038C2800        ReadPtr:        038C2C38
        WritePtrs:      038C2C38        Fifo_Flag:      8A800800
        Weights:        001E001E
Fifo1:  StartPtr:       03A9BC00        ReadPtr:        03A9BC60
        WritePtrs:      03A9BC60        Fifo_Flag:      89800400
        writeHeaderPtr: 03A9BC60
Fifo2:  StartPtr:       038C8800        ReadPtr:        038C88E0
        WritePtrs:      038C88E0        Fifo_Flag:      88800200
        writeHeaderPtr: 038C88E0
Fifo3:  StartPtr:       03C30400        ReadPtr:        03C30638
        WritePtrs:      03C30638        Fifo_Flag:      89800400
        writeHeaderPtr: 03C30638
Fifo4:  StartPtr:       03AD5000        ReadPtr:        03AD50A0
        WritePtrs:      03AD50A0        Fifo_Flag:      89800400
        writeHeaderPtr: 03AD50A0
Fifo5:  StartPtr:       03A7A600        ReadPtr:        03A7A600
        WritePtrs:      03A7A600        Fifo_Flag:      88800200
        writeHeaderPtr: 03A7A600
Fifo6:  StartPtr:       03BF8400        ReadPtr:        03BF87F0
        WritePtrs:      03BF87F0        Fifo_Flag:      89800400 

<output truncated>

Related Commands

Command
Description

show controllers ethernet-controller

Displays per-interface send and receive statistics read from the hardware or the interface internal registers.

show interfaces

Displays the administrative and operational status of all interfaces or a specified interface.


show controllers ethernet-controller

Use the show controllers ethernet-controller privileged EXEC command without keywords to display per-interface send and receive statistics read from the hardware. Use with the phy keyword to display the interface internal registers or the port-asic keyword to display information about the port ASIC.

show controllers ethernet-controller [interface-id] [phy [detail]] [port-asic {configuration | statistics}] [fastethernet 0] [ | {begin | exclude | include} expression]

Syntax Description

interface-id

The physical interface (including type, stack member, module, and port number).

phy

(Optional) Display the status of the internal registers on the switch physical layer device (PHY) for the device or the interface. This display includes the operational state of the automatic medium-dependent interface crossover (auto-MDIX) feature on an interface.

detail

(Optional) Display details about the PHY internal registers.

port-asic

(Optional) Display information about the port ASIC internal registers.

configuration

Display port ASIC internal register configuration.

statistics

Display port ASIC statistics, including the Rx/Sup Queue and miscellaneous statistics.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC (only supported with the interface-id keywords in user EXEC mode)

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

This display without keywords provides traffic statistics, basically the RMON statistics for all interfaces or for the specified interface.

When you enter the phy or port-asic keywords, the displayed information is useful primarily for Cisco technical support representatives troubleshooting the switch.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show controllers ethernet-controller command for an interface. Table 2-25 lists the Transmit fields, and Table 2-26 lists the Receive fields.

Switch# show controllers ethernet-controller gigabitethernet6/0/1
Transmit GigabitEthernet6/0/1 						 	 	 	 	 	 Receive
         0 Bytes                             0 Bytes
         0 Unicast frames                    0 Unicast frames
         0 Multicast frames                  0 Multicast frames
         0 Broadcast frames                  0 Broadcast frames
         0 Too old frames                    0 Unicast bytes
         0 Deferred frames                   0 Multicast bytes
         0 MTU exceeded frames               0 Broadcast bytes
         0 1 collision frames                0 Alignment errors
         0 2 collision frames                0 FCS errors
         0 3 collision frames                0 Oversize frames
         0 4 collision frames                0 Undersize frames
         0 5 collision frames                0 Collision fragments
         0 6 collision frames
         0 7 collision frames                0 Minimum size frames
         0 8 collision frames                0 65 to 127 byte frames
         0 9 collision frames                0 128 to 255 byte frames
         0 10 collision frames               0 256 to 511 byte frames
         0 11 collision frames               0 512 to 1023 byte frames
         0 12 collision frames               0 1024 to 1518 byte frames
         0 13 collision frames               0 Overrun frames
         0 14 collision frames               0 Pause frames
         0 15 collision frames               0 Symbol error frames
         0 Excessive collisions
         0 Late collisions                   0 Invalid frames, too large
         0 VLAN discard frames               0 Valid frames, too large
         0 Excess defer frames               0 Invalid frames, too small
         0 64 byte frames                    0 Valid frames, too small
         0 127 byte frames
         0 255 byte frames                   0 Too old frames
         0 511 byte frames                   0 Valid oversize frames
         0 1023 byte frames                  0 System FCS error frames
         0 1518 byte frames                  0 RxPortFifoFull drop frame
         0 Too large frames
         0 Good (1 coll) frames

Table 2-25 Transmit Field Descriptions 

Field
Description

Bytes

The total number of bytes sent on an interface.

Unicast Frames

The total number of frames sent to unicast addresses.

Multicast frames

The total number of frames sent to multicast addresses.

Broadcast frames

The total number of frames sent to broadcast addresses.

Too old frames

The number of frames dropped on the egress port because the packet aged out.

Deferred frames

The number of frames that are not sent after the time exceeds 2*maximum-packet time.

MTU exceeded frames

The number of frames that are larger than the maximum allowed frame size.

1 collision frames

The number of frames that are successfully sent on an interface after one collision occurs.

2 collision frames

The number of frames that are successfully sent on an interface after two collisions occur.

3 collision frames

The number of frames that are successfully sent on an interface after three collisions occur.

4 collision frames

The number of frames that are successfully sent on an interface after four collisions occur.

5 collision frames

The number of frames that are successfully sent on an interface after five collisions occur.

6 collision frames

The number of frames that are successfully sent on an interface after six collisions occur.

7 collision frames

The number of frames that are successfully sent on an interface after seven collisions occur.

8 collision frames

The number of frames that are successfully sent on an interface after eight collisions occur.

9 collision frames

The number of frames that are successfully sent on an interface after nine collisions occur.

10 collision frames

The number of frames that are successfully sent on an interface after ten collisions occur.

11 collision frames

The number of frames that are successfully sent on an interface after 11 collisions occur.

12 collision frames

The number of frames that are successfully sent on an interface after 12 collisions occur.

13 collision frames

The number of frames that are successfully sent on an interface after 13 collisions occur.

14 collision frames

The number of frames that are successfully sent on an interface after 14 collisions occur.

15 collision frames

The number of frames that are successfully sent on an interface after 15 collisions occur.

Excessive collisions

The number of frames that could not be sent on an interface after 16 collisions occur.

Late collisions

After a frame is sent, the number of frames dropped because late collisions were detected while the frame was sent.

VLAN discard frames

The number of frames dropped on an interface because the CFI1 bit is set.

Excess defer frames

The number of frames that are not sent after the time exceeds the maximum-packet time.

64 byte frames

The total number of frames sent on an interface that are 64 bytes.

127 byte frames

The total number of frames sent on an interface that are from 65 to 127 bytes.

255 byte frames

The total number of frames sent on an interface that are from 128 to 255 bytes.

511 byte frames

The total number of frames sent on an interface that are from 256 to 511 bytes.

1023 byte frames

The total number of frames sent on an interface that are from 512 to 1023 bytes.

1518 byte frames

The total number of frames sent on an interface that are from 1024 to 1518 bytes.

Too large frames

The number of frames sent on an interface that are larger than the maximum allowed frame size.

Good (1 coll) frames

The number of frames that are successfully sent on an interface after one collision occurs. This value does not include the number of frames that are not successfully sent after one collision occurs.

1 CFI = Canonical Format Indicator


Table 2-26 Receive Field Descriptions 

Field
Description

Bytes

The total amount of memory (in bytes) used by frames received on an interface, including the FCS1 value and the incorrectly formed frames. This value excludes the frame header bits.

Unicast frames

The total number of frames successfully received on the interface that are directed to unicast addresses.

Multicast frames

The total number of frames successfully received on the interface that are directed to multicast addresses.

Broadcast frames

The total number of frames successfully received on an interface that are directed to broadcast addresses.

Unicast bytes

The total amount of memory (in bytes) used by unicast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.

Multicast bytes

The total amount of memory (in bytes) used by multicast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.

Broadcast bytes

The total amount of memory (in bytes) used by broadcast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.

Alignment errors

The total number of frames received on an interface that have alignment errors.

FCS errors

The total number of frames received on an interface that have a valid length (in bytes) but do not have the correct FCS values.

Oversize frames

The number of frames received on an interface that are larger than the maximum allowed frame size.

Undersize frames

The number of frames received on an interface that are smaller than 64 bytes.

Collision fragments

The number of collision fragments received on an interface.

Minimum size frames

The total number of frames that are the minimum frame size.

65 to 127 byte frames

The total number of frames that are from 65 to 127 bytes.

128 to 255 byte frames

The total number of frames that are from 128 to 255 bytes.

256 to 511 byte frames

The total number of frames that are from 256 to 511 bytes.

512 to 1023 byte frames

The total number of frames that are from 512 to 1023 bytes.

1024 to 1518 byte frames

The total number of frames that are from 1024 to 1518 bytes.

Overrun frames

The total number of overrun frames received on an interface.

Pause frames

The number of pause frames received on an interface.

Symbol error frames

The number of frames received on an interface that have symbol errors.

Invalid frames, too large

The number of frames received that were larger than maximum allowed MTU2 size (including the FCS bits and excluding the frame header) and that have either an FCS error or an alignment error.

Valid frames, too large

The number of frames received on an interface that are larger than the maximum allowed frame size.

Invalid frames, too small

The number of frames received that are smaller than 64 bytes (including the FCS bits and excluding the frame header) and that have either an FCS error or an alignment error.

Valid frames, too small

The number of frames received on an interface that are smaller than 64 bytes (or 68 bytes for VLAN-tagged frames) and that have valid FCS values. The frame size includes the FCS bits but excludes the frame header bits.

Too old frames

The number of frames dropped on the ingress port because the packet aged out.

Valid oversize frames

The number of frames received on an interface that are larger than the maximum allowed frame size and have valid FCS values. The frame size includes the FCS value but does not include the VLAN tag.

System FCS error frames

The total number of frames received on an interface that have a valid length (in bytes) but that do not have the correct FCS values.

RxPortFifoFull drop frames

The total number of frames received on an interface that are dropped because the ingress queue is full.

1 FCS = frame check sequence

2 MTU = maximum transmission unit


This is an example of output from the show controllers ethernet-controller phy command for a specific interface:

Switch# show controllers ethernet-controller gigabitethernet0/2 phy
GigabitEthernet1/0/2 (gpn: 2, port-number: 2)
-----------------------------------------------------------
============================================================
Port    Conf-Media   Active-Media Attached                  
------- ------------ ------------ --------------------------
Gi1/0/1   auto-select  none         0 -Not Present
Gi1/0/2   auto-select  none         0 -Not Present
============================================================
Other Information
-------------------------------------------------------
Port asic num         : 0
Port asic port num    : 1
XCVR init completed   : 0
Embedded PHY          : not present
SFP presence index    : 0
SFP iter cnt          : 2564163d
SFP failed oper flag  : 0x00000000
IIC error cnt         : 0
IIC error dsb cnt     : 0
IIC max sts cnt       : 0
Chk for link status   : 1
Link Status           : 0
<output truncated>

This is an example of output from the show controllers ethernet-controller port-asic configuration command:

Switch# show controllers ethernet-controller port-asic configuration
========================================================================
Switch 1, PortASIC 0 Registers
------------------------------------------------------------------------
DeviceType                         : 000101BC
Reset                              : 00000000
PmadMicConfig                      : 00000001
PmadMicDiag                        : 00000003
SupervisorReceiveFifoSramInfo      : 000007D0 000007D0 40000000
SupervisorTransmitFifoSramInfo     : 000001D0 000001D0 40000000
GlobalStatus                       : 00000800
IndicationStatus                   : 00000000
IndicationStatusMask               : FFFFFFFF
InterruptStatus                    : 00000000
InterruptStatusMask                : 01FFE800
SupervisorDiag                     : 00000000
SupervisorFrameSizeLimit           : 000007C8
SupervisorBroadcast                : 000A0F01
GeneralIO                          : 000003F9 00000000 00000004
StackPcsInfo                       : FFFF1000 860329BD 5555FFFF FFFFFFFF
                                     FF0FFF00 86020000 5555FFFF 00000000
StackRacInfo                       : 73001630 00000003 7F001644 00000003
                                     24140003 FD632B00 18E418E0 FFFFFFFF
StackControlStatus                 : 18E418E0
stackControlStatusMask             : FFFFFFFF
TransmitBufferFreeListInfo         : 00000854 00000800 00000FF8 00000000
                                     0000088A 0000085D 00000FF8 00000000
TransmitRingFifoInfo               : 00000016 00000016 40000000 00000000
                                     0000000C 0000000C 40000000 00000000
TransmitBufferInfo                 : 00012000 00000FFF 00000000 00000030
TransmitBufferCommonCount          : 00000F7A
TransmitBufferCommonCountPeak      : 0000001E
TransmitBufferCommonCommonEmpty    : 000000FF
NetworkActivity                    : 00000000 00000000 00000000 02400000
DroppedStatistics                  : 00000000
FrameLengthDeltaSelect             : 00000001
SneakPortFifoInfo                  : 00000000
MacInfo                            : 0EC0801C 00000001 0EC0801B 00000001
                                     00C0001D 00000001 00C0001E 00000001

<output truncated>

This is an example of output from the show controllers ethernet-controller port-asic statistics command:

Switch# show controllers ethernet-controller port-asic statistics
===========================================================================
 Switch 1, PortASIC 0 Statistics
---------------------------------------------------------------------------
         0 RxQ-0, wt-0 enqueue frames            0 RxQ-0, wt-0 drop frames
   4118966 RxQ-0, wt-1 enqueue frames            0 RxQ-0, wt-1 drop frames
         0 RxQ-0, wt-2 enqueue frames            0 RxQ-0, wt-2 drop frames

         0 RxQ-1, wt-0 enqueue frames            0 RxQ-1, wt-0 drop frames
       296 RxQ-1, wt-1 enqueue frames            0 RxQ-1, wt-1 drop frames
   2836036 RxQ-1, wt-2 enqueue frames            0 RxQ-1, wt-2 drop frames

         0 RxQ-2, wt-0 enqueue frames            0 RxQ-2, wt-0 drop frames
         0 RxQ-2, wt-1 enqueue frames            0 RxQ-2, wt-1 drop frames
    158377 RxQ-2, wt-2 enqueue frames            0 RxQ-2, wt-2 drop frames

         0 RxQ-3, wt-0 enqueue frames            0 RxQ-3, wt-0 drop frames
         0 RxQ-3, wt-1 enqueue frames            0 RxQ-3, wt-1 drop frames
         0 RxQ-3, wt-2 enqueue frames            0 RxQ-3, wt-2 drop frames


        15 TxBufferFull Drop Count               0 Rx Fcs Error Frames
         0 TxBufferFrameDesc BadCrc16            0 Rx Invalid Oversize Frames
         0 TxBuffer Bandwidth Drop Cou           0 Rx Invalid Too Large Frames
         0 TxQueue Bandwidth Drop Coun           0 Rx Invalid Too Large Frames
         0 TxQueue Missed Drop Statist           0 Rx Invalid Too Small Frames
        74 RxBuffer Drop DestIndex Cou           0 Rx Too Old Frames
         0 SneakQueue Drop Count                 0 Tx Too Old Frames
         0 Learning Queue Overflow Fra           0 System Fcs Error Frames
         0 Learning Cam Skip Count

        15 Sup Queue 0 Drop Frames               0 Sup Queue 8 Drop Frames
         0 Sup Queue 1 Drop Frames               0 Sup Queue 9 Drop Frames
         0 Sup Queue 2 Drop Frames               0 Sup Queue 10 Drop Frames
         0 Sup Queue 3 Drop Frames               0 Sup Queue 11 Drop Frames
         0 Sup Queue 4 Drop Frames               0 Sup Queue 12 Drop Frames
         0 Sup Queue 5 Drop Frames               0 Sup Queue 13 Drop Frames
         0 Sup Queue 6 Drop Frames               0 Sup Queue 14 Drop Frames
         0 Sup Queue 7 Drop Frames               0 Sup Queue 15 Drop Frames
===========================================================================
 Switch 1, PortASIC 1 Statistics
---------------------------------------------------------------------------
         0 RxQ-0, wt-0 enqueue frames            0 RxQ-0, wt-0 drop frames
        52 RxQ-0, wt-1 enqueue frames            0 RxQ-0, wt-1 drop frames
         0 RxQ-0, wt-2 enqueue frames            0 RxQ-0, wt-2 drop frames

<output truncated>

Related Commands

Command
Description

show controllers cpu-interface

Displays the state of the CPU network ASIC and send and receive statistics for packets reaching the CPU.

show controllers tcam

Displays the state of registers for all ternary content addressable memory (TCAM) in the system and for TCAM interface ASICs that are CAM controllers.


show controllers ethernet-controller stack port

To display stack port counters (or per-interface and per-stack port send and receive statistics from the hardware, use the show controllers ethernet-controller stack port privileged EXEC command.

show controllers ethernet-controller stackport [stack-port-number] [ | {begin | exclude | include} expression]


Note This command is supported only on the Catalyst 2960-S switches running the LAN base image.


Syntax Description

stack-port-number

The stack port number of the interface. The range is from 1 to 2. If no stack port number is provided, information for both stack ports appears.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(53)SE1

This command was introduced.


Usage Guidelines

To display stack port information for both stack ports on the specified interface, enter the show controllers ethernet-controller stackport privileged EXEC command without specifying a stack port number. Use this command to display the counters on various packet types sent on the stack port. To clear stack port and Ethernet counters, enter the clear controllers ethernet-controllers privileged EXEC command.

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show controllers ethernet-controller stackport command for stack port 1. Table 2-25 lists the Transmit FastEthernet0 fields, and Table 2-26 lists the Receive fields.

switch# show controllers ethernet-controller stack port 1

Transmit StackPort1                      Receive
  13226803644 Bytes                      10704476071 Bytes                    
     27647287 Unicast frames                20878836 Unicast frames           
     12728665 Multicast frames              10258136 Multicast frames         
            0 Broadcast frames                     0 Broadcast frames         
            0 Too old frames              6287969588 Unicast bytes            
            0 Deferred frames             3233301547 Multicast bytes          
            0 MTU exceeded frames                  0 Broadcast bytes          
            0 1 collision frames                   0 Alignment errors         
            0 2 collision frames                   0 FCS errors               
            0 3 collision frames                   0 Oversize frames          
            0 4 collision frames                   0 Undersize frames         
            0 5 collision frames                   0 Collision fragments      
            0 6 collision frames       
            0 7 collision frames                   0 Minimum size frames      
            0 8 collision frames            22103015 65 to 127 byte frames    
            0 9 collision frames                 685 128 to 255 byte frames   
            0 10 collision frames               5778 256 to 511 byte frames   
            0 11 collision frames            5703871 512 to 1023 byte frames  
            0 12 collision frames            3323623 1024 to 1518 byte frames 
            0 13 collision frames                  0 Overrun frames           
            0 14 collision frames                  0 Pause frames             
            0 15 collision frames      
            0 Excessive collisions                 0 Symbol error frames      
            0 Late collisions                      0 Invalid frames, too large
            0 VLAN discard frames                  0 Valid frames, too large  
            0 Excess defer frames                  0 Invalid frames, too small
            0 64 byte frames                       0 Valid frames, too small  
     30164543 127 byte frames          
         4302 255 byte frames                      0 Too old frames           
         5814 511 byte frames                      0 Valid oversize frames    
      5790695 1023 byte frames                     0 System FCS error frames  
      4410598 1518 byte frames                     0 RxPortFifoFull drop frame
            0 Too large frames         
            0 Good (1 coll) frames     
            0 Good (>1 coll) frames 

Table 2-27 Transmit FastEthernet and Stack Port Field Descriptions 

Field
Description

Bytes

The total number of bytes sent on an interface.

Unicast Frames

The total number of frames sent to unicast addresses.

Multicast frames

The total number of frames sent to multicast addresses.

Broadcast frames

The total number of frames sent to broadcast addresses.

Too old frames

The number of frames dropped on the egress port because the packet aged out.

Deferred frames

The number of frames that are not sent after the time exceeds 2*maximum-packet time.

MTU exceeded frames

The number of frames that are larger than the maximum allowed frame size.

1 collision frames

The number of frames that are successfully sent on an interface after one collision occurs.

2 collision frames

The number of frames that are successfully sent on an interface after two collisions occur.

3 collision frames

The number of frames that are successfully sent on an interface after three collisions occur.

4 collision frames

The number of frames that are successfully sent on an interface after four collisions occur.

5 collision frames

The number of frames that are successfully sent on an interface after five collisions occur.

6 collision frames

The number of frames that are successfully sent on an interface after six collisions occur.

7 collision frames

The number of frames that are successfully sent on an interface after seven collisions occur.

8 collision frames

The number of frames that are successfully sent on an interface after eight collisions occur.

9 collision frames

The number of frames that are successfully sent on an interface after nine collisions occur.

10 collision frames

The number of frames that are successfully sent on an interface after ten collisions occur.

11 collision frames

The number of frames that are successfully sent on an interface after 11 collisions occur.

12 collision frames

The number of frames that are successfully sent on an interface after 12 collisions occur.

13 collision frames

The number of frames that are successfully sent on an interface after 13 collisions occur.

14 collision frames

The number of frames that are successfully sent on an interface after 14 collisions occur.

15 collision frames

The number of frames that are successfully sent on an interface after 15 collisions occur.

Excessive collisions

The number of frames that could not be sent on an interface after 16 collisions occur.

Late collisions

After a frame is sent, the number of frames dropped because late collisions were detected while the frame was sent.

VLAN discard frames

The number of frames dropped on an interface because the CFI1 bit is set.

Excess defer frames

The number of frames that are not sent after the time exceeds the maximum-packet time.

64 byte frames

The total number of frames sent on an interface that are 64 bytes.

127 byte frames

The total number of frames sent on an interface that are from 65 to 127 bytes.

255 byte frames

The total number of frames sent on an interface that are from 128 to 255 bytes.

511 byte frames

The total number of frames sent on an interface that are from 256 to 511 bytes.

1023 byte frames

The total number of frames sent on an interface that are from 512 to 1023 bytes.

1518 byte frames

The total number of frames sent on an interface that are from 1024 to 1518 bytes.

Too large frames

The number of frames sent on an interface that are larger than the maximum allowed frame size.

Good (1 coll) frames

The number of frames that are successfully sent on an interface after one collision occurs. This value does not include the number of frames that are not successfully sent after one collision occurs.

Good (>1 coll) frames

The number of frames that are successfully sent on an interface after more than one collision occurs. This value does not include the number of frames that are not successfully sent after one collision occurs.

1 CFI = Canonical Format Indicator


Table 2-28 Receive Field Descriptions 

Field
Description

Bytes

The total amount of memory (in bytes) used by frames received on an interface, including the FCS1 value and the incorrectly formed frames. This value excludes the frame header bits.

Unicast frames

The total number of frames successfully received on the interface that are directed to unicast addresses.

Multicast frames

The total number of frames successfully received on the interface that are directed to multicast addresses.

Broadcast frames

The total number of frames successfully received on an interface that are directed to broadcast addresses.

Unicast bytes

The total amount of memory (in bytes) used by unicast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.

Multicast bytes

The total amount of memory (in bytes) used by multicast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.

Broadcast bytes

The total amount of memory (in bytes) used by broadcast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.

Alignment errors

The total number of frames received on an interface that have alignment errors.

FCS errors

The total number of frames received on an interface that have a valid length (in bytes) but do not have the correct FCS values.

Oversize frames

The number of frames received on an interface that are larger than the maximum allowed frame size.

Undersize frames

The number of frames received on an interface that are smaller than 64 bytes.

Collision fragments

The number of collision fragments received on an interface.

Minimum size frames

The total number of frames that are the minimum frame size.

65 to 127 byte frames

The total number of frames that are from 65 to 127 bytes.

128 to 255 byte frames

The total number of frames that are from 128 to 255 bytes.

256 to 511 byte frames

The total number of frames that are from 256 to 511 bytes.

512 to 1023 byte frames

The total number of frames that are from 512 to 1023 bytes.

1024 to 1518 byte frames

The total number of frames that are from 1024 to 1518 bytes.

Overrun frames

The total number of overrun frames received on an interface.

Pause frames

The number of pause frames received on an interface.

Symbol error frames

The number of frames received on an interface that have symbol errors.

Invalid frames, too large

The number of frames received that were larger than maximum allowed MTU2 size (including the FCS bits and excluding the frame header) and that have either an FCS error or an alignment error.

Valid frames, too large

The number of frames received on an interface that are larger than the maximum allowed frame size.

Invalid frames, too small

The number of frames received that are smaller than 64 bytes (including the FCS bits and excluding the frame header) and that have either an FCS error or an alignment error.

Valid frames, too small

The number of frames received on an interface that are smaller than 64 bytes (or 68 bytes for VLAN-tagged frames) and that have valid FCS values. The frame size includes the FCS bits but excludes the frame header bits.

Too old frames

The number of frames dropped on the ingress port because the packet aged out.

Valid oversize frames

The number of frames received on an interface that are larger than the maximum allowed frame size and have valid FCS values. The frame size includes the FCS value but does not include the VLAN tag.

System FCS error frames

The total number of frames received on an interface that have a valid length (in bytes) but that do not have the correct FCS values.

RxPortFifoFull drop frames

The total number of frames received on an interface that are dropped because the ingress queue is full.

1 FCS = frame check sequence

2 MTU = maximum transmission unit


Related Commands

Command
Description

clear controllers ethernet-controllers

Clears the Ethernet controller and stack port counters.

show controllers ethernet-controller

Displays per-interface send and receive statistics read from the hardware.


show controllers power inline

Use the show controllers power inline user EXEC command to display the values in the registers of the specified Power over Ethernet (PoE) controller.

show controllers power inline [instance] [module switch-number] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image.


Syntax Description

instance

(Optional) Power controller instance, where each instance corresponds to four ports. See the "Usage Guidelines" section for more information. If no instance is specified, information for all instances appear.

module switch number

(Optional) Limit the display to ports on the specified stack member. The switch number is 1 to 4.

Note Stacking is supported only on Catalyst 2960-S switches.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(44)SE

This command was introduced.


Usage Guidelines

The instance range is 0 to 1. For instances other than 0 to 1, the switches provides no output.

Though visible on all switches, this command is valid only for PoE switches. It provides no information for switches that do not support PoE.

The output provides information that might be useful for Cisco technical support representatives troubleshooting the switch.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show controllers power inline command on a Catalyst 2960 or 2960-S switch:

Switch> show controllers power inline
Alchemy instance 0, address 0
 Pending event flag    :N N N N N N N N N N N N
 Current State         :00 05 10 51 61 11
 Current Event         :00 01 00 10 40 00
 Timers                :00 C5 57 03 12 20 04 B2 05 06 07 07
 Error State           :00 00 00 00 10 00
 Error Code            :00 00 00 00 00 00 00 00 00 00 00 00
 Power Status          :N Y N N Y N N N N N N N
 Auto Config           :N Y Y N Y Y Y Y Y Y Y Y
 Disconnect            :N N N N N N N N N N N N
 Detection Status      :00 00 00 30 00 00
 Current Class         :00 00 00 30 00 00
 Tweetie debug         :00 00 00 00
 POE Commands pending at sub:
     Command 0 on each port :00 00 00 00 00 00
     Command 1 on each port :00 00 00 00 00 00
     Command 2 on each port :00 00 00 00 00 00
     Command 3 on each port :00 00 00 00 00 00

Related Commands

Command
Description

logging event power-inline-status

Enables the logging of PoE events.

power inline

Configures the power management mode for the specified PoE port or for all PoE ports.

show power inline

Displays the PoE status for the specified PoE port or for all PoE ports.


show controllers tcam

Use the show controllers tcam privileged EXEC command to display the state of the registers for all ternary content addressable memory (TCAM) in the system and for all TCAM interface ASICs that are CAM controllers.

show controllers tcam [asic [number]] [detail] [ | {begin | exclude | include} expression]

Syntax Description

asic

(Optional) Display port ASIC TCAM information.

number

(Optional) Display information for the specified port ASIC number. The range is from 0 to 15.

detail

(Optional) Display detailed TCAM register information.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

This display provides information that might be useful for Cisco technical support representatives troubleshooting the switch.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show controllers tcam command:

Switch# show controllers tcam
------------------------------------------------------------------------
TCAM-0 Registers
------------------------------------------------------------------------
  REV:    00B30103
  SIZE:   00080040
  ID:     00000000
  CCR:    00000000_F0000020

  RPID0:  00000000_00000000
  RPID1:  00000000_00000000
  RPID2:  00000000_00000000
  RPID3:  00000000_00000000

  HRR0:   00000000_E000CAFC
  HRR1:   00000000_00000000
  HRR2:   00000000_00000000
  HRR3:   00000000_00000000
  HRR4:   00000000_00000000
  HRR5:   00000000_00000000
  HRR6:   00000000_00000000
  HRR7:   00000000_00000000
<output truncated>

  GMR31:  FF_FFFFFFFF_FFFFFFFF
  GMR32:  FF_FFFFFFFF_FFFFFFFF
  GMR33:  FF_FFFFFFFF_FFFFFFFF

=============================================================================
 TCAM related PortASIC 1 registers
=============================================================================
LookupType:                   89A1C67D_24E35F00
LastCamIndex:                 0000FFE0
LocalNoMatch:                 000069E0
ForwardingRamBaseAddress:
                              00022A00 0002FE00 00040600 0002FE00 0000D400
                              00000000 003FBA00 00009000 00009000 00040600
                              00000000 00012800 00012900

Related Commands

Command
Description

show controllers cpu-interface

Displays the state of the CPU network ASIC and send and receive statistics for packets reaching the CPU.

show controllers ethernet-controller

Displays per-interface send and receive statistics read from the hardware or the interface internal registers.


show controllers utilization

Use the show controllers utilization user EXEC command to display bandwidth utilization on the switch or specific ports.

show controllers [interface-id] utilization [ | {begin | exclude | include} expression]

Syntax Description

interface-id

(Optional) ID of the switch interface.

| begin

(Optional) Display begins with the line that matches the specified expression.

| exclude

(Optional) Display excludes lines that match the specified expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show controllers utilization command.

Switch> show controllers utilization
Port       Receive Utilization  Transmit Utilization
Fa0/1            0                    0
Fa0/2 		 	 	 	0                    0
Fa0/3 	 	 	 	 	0
Fa0/4 	 	 	 	 	0                    0
Fa0/5            0                    0
Fa0/6            0                    0
Fa0/7            0                    0
<output truncated>

<output truncated>

Switch Receive Bandwidth Percentage Utilization  : 0
Switch Transmit Bandwidth Percentage Utilization : 0

Switch Fabric Percentage Utilization : 0

This is an example of output from the show controllers utilization command on a specific port:

Switch> show controllers gigabitethernet1/0/1 utilization
Receive Bandwidth Percentage Utilization   : 0
Transmit Bandwidth Percentage Utilization  : 0

Table 2-29 show controllers utilization Field Descriptions

Field
Description

Receive Bandwidth Percentage Utilization

Displays the received bandwidth usage of the switch, which is the sum of the received traffic on all the ports divided by the switch receive capacity.

Transmit Bandwidth Percentage Utilization

Displays the transmitted bandwidth usage of the switch, which is the sum of the transmitted traffic on all the ports divided it by the switch transmit capacity.

Fabric Percentage Utilization

Displays the average of the transmitted and received bandwidth usage of the switch.


Related Commands

Command
Description

show controllers ethernet-controller

Displays the interface internal registers.


show diagnostic

Use the show diagnostic user EXEC command to view the test results of the online diagnostics and to list the supported test suites.

show diagnostic content switch [num | all] [ | {begin | exclude | include} expression]

show diagnostic result switch [num | all] [detail | test {test-id | test-id-range | all} [detail]] [ | {begin | exclude | include} expression]

show diagnostic schedule switch [num | all] [ | {begin | exclude | include} expression]

show diagnostic status [ | {begin | exclude | include} expression]

show diagnostic switch [num | all] [detail] [ | {begin | exclude | include} expression]


Note This command is supported only on Catalyst 2960-S switches running the LAN base image.


Syntax Description

content

Display test information including test ID, test attributes, and supported coverage test levels for each test and for all modules.

switch num

Specify the switch number. The range is from 1 to 4.

switch all

Specify all of the switches in the switch stack.

post

Display the power-on self-test (POST) results; the command output is the same as the show post command.

result

Displays the test results.

detail

(Optional) Displays the all test statistics.

test

Specify a test.

test-id

Identification number for the test; see the "Usage Guidelines" section for additional information.

test-id-range

Range of identification numbers for tests; see the "Usage Guidelines" section for additional information.

all

All the tests.

schedule

Displays the current scheduled diagnostic tasks.

status

Displays the test status.

|begin

(Optional) Display begins with the line that matches the expression.

|exclude

(Optional) Display excludes lines that match the expression.

|include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Defaults

This command has no default settings.

Command Modes

User EXEC

Command History

Release
Modification

12.2(53)SE1

This command was introduced.


Usage Guidelines

If you do not enter a switch num, information for all switches is displayed.

In the command output, the possible testing results are as follows:

Passed (.)

Failed (F)

Unknown (U)

Examples

This example shows how to display the online diagnostics that are configured on a switch:

Switch# show diagnostic content switch 3

Switch 3:
Diagnostics test suite attributes:
    B/* - Basic ondemand test / NA
  P/V/* - Per port test / Per device test / NA
  D/N/* - Disruptive test / Non-disruptive test / NA
    S/* - Only applicable to standby unit / NA
    X/* - Not a health monitoring test / NA
    F/* - Fixed monitoring interval test / NA
    E/* - Always enabled monitoring test / NA
    A/I - Monitoring is active / Monitoring is inactive
    R/* - Switch will reload after test list completion / NA
    P/* - will partition stack / NA
                                                     Test Interval   Thre-
ID    Test Name                          attributes  day hh:mm:ss.ms shold
==== ================================== ============ =============== =====
 1)    TestPortAsicStackPortLoopback     B*N****A**   000 00:01:00.00  n/a
 2)    TestPortAsicLoopback              B*D*X**IR*   not configured  n/a
 3)    TestPortAsicCam                   B*D*X**IR*   not configured  n/a
 4)    TestPortAsicRingLoopback          B*D*X**IR*   not configured  n/a
 5)    TestMicRingLoopback               B*D*X**IR*   not configured  n/a
 6)    TestPortAsicMem                   B*D*X**IR*   not configured  n/a

This example shows how to display the online diagnostic results for a switch:

Switch# show diagnostic result switch 1
Switch 1: SerialNo :
Overall diagnostic result: PASS
Test results: (. = Pass, F = Fail, U = Untested)
1) TestPortAsicStackPortLoopback ---> .
2) TestPortAsicLoopback ------------> .
3) TestPortAsicCam -----------------> .
4) TestPortAsicRingLoopback --------> .
5) TestMicRingLoopback -------------> .
6) TestPortAsicMem -----------------> .

This example shows how to display the online diagnostic test status:

Switch# show diagnostic status
<BU> - Bootup Diagnostics, <HM> - Health Monitoring Diagnostics,
<OD> - OnDemand Diagnostics, <SCH> - Scheduled Diagnostics
====== ================================= =============================== ======
Card   Description                       Current Running Test             Run by
------ --------------------------------- ---------------------            ------
1                                         N/A                              N/A
2                                         TestPortAsicStackPortLoopback    <OD>
                                          TestPortAsicLoopback             <OD>
                                          TestPortAsicCam                  <OD>
                                          TestPortAsicRingLoopback         <OD>
                                          TestMicRingLoopback              <OD>
                                          TestPortAsicMem                  <OD>
3                                         N/A                              N/A 
4                                         N/A                              N/A
====== ================================= =============================== ======
Switch# 

This example shows how to display the online diagnostic test schedule for a switch:

Switch# show diagnostic schedule switch 1
Current Time = 14:39:49 PST Tue Jul 5 2005
Diagnostic for Switch 1:
Schedule #1:
To be run daily 12:00
Test ID(s) to be executed: 1.

Related Commands

Command
Description

clear arp inspection log

Configures the health-monitoring diagnostic test.

diagnostic schedule

Sets the scheduling of test-based online diagnostic testing.

diagnostic start

Starts the online diagnostic test.


show dot1x

Use the show dot1x user EXEC command to display IEEE 802.1x statistics, administrative status, and operational status for the switch or for the specified port.

show dot1x [{all [summary] | interface interface-id} [details | statistics]] [ | {begin | exclude | include} expression]

Syntax Description

all [summary]

(Optional) Display the IEEE 802.1x status for all ports.

interface interface-id

(Optional) Display the IEEE 802.1x status for the specified port (including type, stack member, module, and port number).

Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.

details

(Optional) Display the IEEE 802.1x interface details.

statistics

(Optional) Display IEEE 802.1x statistics for the specified port.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.

12.2(25)SED

The display was expanded to include auth-fail-vlan in the authorization state machine state and port status fields.

12.2(25)SEE

The command syntax was changed, and the command output was modified.


Usage Guidelines

If you do not specify a port, global parameters and a summary appear. If you specify a port, details for that port appear.

If the port control is configured as unidirectional or bidirectional control and this setting conflicts with the switch configuration, the show dot1x {all | interface interface-id} privileged EXEC command output has this information:

ControlDirection          = In (Inactive)

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output appear.

Examples

This is an example of output from the show dot1x user EXEC command:

Switch> show dot1x 
Sysauthcontrol              Enabled
Dot1x Protocol Version            2
Critical Recovery Delay         100
Critical EAPOL             Disabled

This is an example of output from the show dot1x all user EXEC command:

Switch> show dot1x all
Sysauthcontrol              Enabled
Dot1x Protocol Version            2
Critical Recovery Delay         100
Critical EAPOL             Disabled

Dot1x Info for GigabitEthernet1/0/1
-----------------------------------
PAE                       = AUTHENTICATOR
PortControl               = AUTO
ControlDirection          = Both
HostMode                  = SINGLE_HOST
Violation Mode            = PROTECT
ReAuthentication          = Disabled
QuietPeriod               = 60
ServerTimeout             = 30
SuppTimeout               = 30
ReAuthPeriod              = 3600 (Locally configured)
ReAuthMax                 = 2
MaxReq                    = 2
TxPeriod                  = 30
RateLimitPeriod           = 0

<output truncated>

This is an example of output from the show dot1x all summary user EXEC command:

Interface       PAE     Client          Status
--------------------------------------------------------
Gi2/0/1         AUTH    none            UNAUTHORIZED
Gi2/0/2         AUTH    00a0.c9b8.0072  AUTHORIZED
Gi0/3 AUTH    none            UNAUTHORIZED

This is an example of output from the show dot1x interface interface-id user EXEC command:

Switch> show dot1x interface gigabitethernet1/0/2
Dot1x Info for GigabitEthernet1/0/2
-----------------------------------
PAE                       = AUTHENTICATOR
PortControl               = AUTO
ControlDirection          = In
HostMode                  = SINGLE_HOST
ReAuthentication          = Disabled
QuietPeriod               = 60
ServerTimeout             = 30
SuppTimeout               = 30
ReAuthPeriod              = 3600 (Locally configured)
ReAuthMax                 = 2
MaxReq                    = 2
TxPeriod                  = 30
RateLimitPeriod           = 0

This is an example of output from the show dot1x interface interface-id details user EXEC command:

Switch# show dot1x interface gigabitethernet1/0/2 details
Dot1x Info for GigabitEthernet1/0/2
-----------------------------------
PAE                       = AUTHENTICATOR
PortControl               = AUTO
ControlDirection          = Both
HostMode                  = SINGLE_HOST
ReAuthentication          = Disabled
QuietPeriod               = 60
ServerTimeout             = 30
SuppTimeout               = 30
ReAuthPeriod              = 3600 (Locally configured)
ReAuthMax                 = 2
MaxReq                    = 2
TxPeriod                  = 30
RateLimitPeriod           = 0

Dot1x Authenticator Client List Empty

This is an example of output from the show dot1x interface interface-id details commmand when a port is assigned to a guest VLAN and the host mode changes to multiple-hosts mode:

Switch# show dot1x interface gigabitethernet1/0/1 details
Dot1x Info for GigabitEthernet1/0/1
-----------------------------------
PAE                       = AUTHENTICATOR
PortControl               = AUTO
ControlDirection          = Both 
HostMode                  = SINGLE_HOST
ReAuthentication          = Enabled
QuietPeriod               = 60
ServerTimeout             = 30
SuppTimeout               = 30
ReAuthPeriod              = 3600 (Locally configured)
ReAuthMax                 = 2
MaxReq                    = 2
TxPeriod                  = 30
RateLimitPeriod           = 0
Guest-Vlan                = 182

Dot1x Authenticator Client List Empty

Port Status               = AUTHORIZED
Authorized By             = Guest-Vlan
Operational HostMode      = MULTI_HOST 
Vlan Policy               = 182

This is an example of output from the show dot1x interface interface-id statistics command. Table 2-30 describes the fields in the display.

Switch> show dot1x interface gigabitethernet0/2 statistics
Dot1x Authenticator Port Statistics for GigabitEthernet0/2
--------------------------------------------
RxStart = 0     RxLogoff = 0    RxResp = 1      RxRespID = 1
RxInvalid = 0   RxLenErr = 0    RxTotal = 2

TxReq = 2       TxReqID = 132   TxTotal = 134

RxVersion = 2   LastRxSrcMAC = 00a0.c9b8.0072

Table 2-30 show dot1x statistics Field Descriptions 

Field
Description

RxStart

Number of valid EAPOL-start frames that have been received.

RxLogoff

Number of EAPOL-logoff frames that have been received.

RxResp

Number of valid EAP-response frames (other than response/identity frames) that have been received.

RxRespID

Number of EAP-response/identity frames that have been received.

RxInvalid

Number of EAPOL frames that have been received and have an unrecognized frame type.

RxLenError

Number of EAPOL frames that have been received in which the packet body length field is invalid.

RxTotal

Number of valid EAPOL frames of any type that have been received.

TxReq

Number of EAP-request frames (other than request/identity frames) that have been sent.

TxReqId

Number of Extensible Authentication Protocol (EAP)-request/identity frames that have been sent.

TxTotal

Number of Extensible Authentication Protocol over LAN (EAPOL) frames of any type that have been sent.

RxVersion

Number of received packets in the IEEE 802.1x Version 1 format.

LastRxSrcMac

Source MAC address carried in the most recently received EAPOL frame.


Related Commands

Command
Description

dot1x default

Resets the IEEE 802.1x parameters to their default values.


show dtp

Use the show dtp privileged EXEC command to display Dynamic Trunking Protocol (DTP) information for the switch or for a specified interface.

show dtp [interface interface-id] [ | {begin | exclude | include} expression]

Syntax Description

interface interface-id

(Optional) Display port security settings for the specified interface. Valid interfaces include physical ports (including type, stack member, module, and port number).

Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show dtp command:

Switch# show dtp
Global DTP information
        Sending DTP Hello packets every 30 seconds
        Dynamic Trunk timeout is 300 seconds
        21 interfaces using DTP

This is an example of output from the show dtp interface command:

Switch# show dtp interface gigabitethernet1/0/1
DTP information for GigabitEthernet1/0/1:
  TOS/TAS/TNS:                              ACCESS/AUTO/ACCESS
  TOT/TAT/TNT:                              NATIVE/NEGOTIATE/NATIVE
  Neighbor address 1:                       000943A7D081
  Neighbor address 2:                       000000000000
  Hello timer expiration (sec/state):       1/RUNNING
  Access timer expiration (sec/state):      never/STOPPED
  Negotiation timer expiration (sec/state): never/STOPPED
  Multidrop timer expiration (sec/state):   never/STOPPED
  FSM state:                                S2:ACCESS
  # times multi & trunk                     0
  Enabled:                                  yes
  In STP:                                   no

  Statistics
  ----------
  3160 packets received (3160 good)
  0 packets dropped
      0 nonegotiate, 0 bad version, 0 domain mismatches, 0 bad TLVs, 0 other
  6320 packets output (6320 good)
      3160 native
  0 output errors
  0 trunk timeouts
  1 link ups, last link up on Mon Mar 01 1993, 01:02:29
  0 link downs

Related Commands

Command
Description

show interfaces trunk

Displays interface trunking information.


show eap

Use the show eap privileged EXEC command to display Extensible Authentication Protocol (EAP) registration and session information for the switch or for the specified port.

show eap {{registrations [method [name] | transport [name]]} | {sessions [credentials name [interface interface-id] | interface interface-id | method name | transport name]}} [credentials name | interface interface-id | transport name] [ | {begin | exclude | include} expression]

Syntax Description

registrations

Display EAP registration information.

method name

(Optional) Display EAP method registration information.

transport name

(Optional) Display EAP transport registration information.

sessions

Display EAP session information.

credentials name

(Optional) Display EAP method registration information.

interface interface-id

(Optional) Display the EAP information for the specified port (including type, stack member, module, and port number).

Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)SEE

This command was introduced.


Usage Guidelines

When you use the show eap registrations privileged EXEC command with these keywords, the command output shows this information:

None—All the lower levels used by EAP and the registered EAP methods.

method name keyword—The specified method registrations.

transport name keyword—The specific lower-level registrations.

When you use the show eap sessions privileged EXEC command with these keywords, the command output shows this information:

None—All active EAP sessions.

credentials name keyword—The specified credentials profile.

interface interface-id keyword—The parameters for the specified interface.

method name keyword—The specified EAP method.

transport name keyword—The specified lower layer.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output appear.

Examples

This is an example of output from the show eap registrations privileged EXEC command:

Switch> show eap registrations
Registered EAP Methods:
  Method  Type            Name
    4     Peer            MD5

Registered EAP Lower Layers:
  Handle  Type            Name
    2     Authenticator   Dot1x-Authenticator
    1     Authenticator   MAB

This is an example of output from the show eap registrations transport privileged user EXEC command:

Switch> show eap registrations transport all
Registered EAP Lower Layers:
  Handle  Type            Name
    2     Authenticator   Dot1x-Authenticator
    1     Authenticator   MAB

This is an example of output from the show eap sessions privileged EXEC command:

Switch> show eap sessions 
Role:                    Authenticator   Decision:                Fail
Lower layer:             Dot1x-AuthenticaInterface:               Gi0/1
Current method:          None            Method state:            Uninitialised
Retransmission count:    0  (max: 2)     Timer:                   Authenticator
ReqId Retransmit (timeout: 30s, remaining: 2s)
EAP handle:              0x5200000A      Credentials profile:     None
Lower layer context ID:  0x93000004      Eap profile name:        None
Method context ID:       0x00000000      Peer Identity:           None
Start timeout (s):       1               Retransmit timeout (s):  30 (30)
Current ID:              2               Available local methods: None

Role:                    Authenticator   Decision:                Fail
Lower layer:             Dot1x-AuthenticaInterface:               Gi0/2
Current method:          None            Method state:            Uninitialised
Retransmission count:    0  (max: 2)     Timer:                   Authenticator
ReqId Retransmit (timeout: 30s, remaining: 2s)
EAP handle:              0xA800000B      Credentials profile:     None
Lower layer context ID:  0x0D000005      Eap profile name:        None
Method context ID:       0x00000000      Peer Identity:           None
Start timeout (s):       1               Retransmit timeout (s):  30 (30)
Current ID:              2               Available local methods: None

<Output truncated>

This is an example of output from the show eap sessions interface interface-id privileged EXEC command:

Switch# show eap sessions gigabitethernet1/0/1
Role:                    Authenticator   Decision:                Fail
Lower layer:             Dot1x-AuthenticaInterface:               Gi0/1
Current method:          None            Method state:            Uninitialised
Retransmission count:    1  (max: 2)     Timer:                   Authenticator
ReqId Retransmit (timeout: 30s, remaining: 13s)
EAP handle:              0x5200000A      Credentials profile:     None
Lower layer context ID:  0x93000004      Eap profile name:        None
Method context ID:       0x00000000      Peer Identity:           None
Start timeout (s):       1               Retransmit timeout (s):  30 (30)
Current ID:              2               Available local methods: None

Related Commands

Command
Description

clear eap sessions

Clears EAP session information for the switch or for the specified port.


show env

Use the show env user EXEC command to show fan, temperature, redundant power system (RPS) availability, and power information for the switch.

Use the show env user EXEC command to show fan, temperature, redundant power system (RPS) availability, and power information for the switch (standalone switch, stack master, or stack member). Use with the stack keyword to show all information for the stack or for a specified switch in the stack.

show env {all | fan | power | rps | stack [switch-number] | temperature} [ | {begin | exclude | include} expression]

Syntax Description

all

Display both fan and temperature environmental status.

fan

Display the switch fan status.

power

Display the switch power status.

rps

Display whether an RPS 300 Redundant Power System (RPS 300) and Cisco RPS675 Redundant Power System (RPS 675) is connected to the switch.

stack [switch-number]

Display all environmental status for each switch in the stack or for the specified switch. The range is 1 to 4, depending on the switch member numbers in the stack.

Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.

temperature

Display the switch temperature status.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use the session privileged EXEC command to access information from a specific switch other than the master.

Use the show env stack [switch-number] command to display information about any switch in the stack from any member switch.


Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.


Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show env all command entered from the master switch or a standalone switch:

Switch> show env all
FAN is OK
TEMPERATURE is OK
POWER is OK
RPS is AVAILABLE

This is an example of output from the show env fan command:

Switch> show env fan
FAN is OK

This is an example of output from the show env stack command on a Catalyst 2960-S switch:

Switch> show env stack
SWITCH: 1
FAN is OK
TEMPERATURE is OK
Temperature Value: 32 Degree Celsius
Temperature State: GREEN
Yellow Threshold : 49 Degree Celsius
Red Threshold    : 59 Degree Celsius
POWER is OK
RPS is NOT PRESENT

This example shows how to display information about stack member 3 from the master switch:

Switch> show env stack 3
SWITCH: 3
FAN is OK
TEMPERATURE is OK
POWER is OK
RPS is NOT PRESENT

show errdisable detect

Use the show errdisable detect user EXEC command to display error-disabled detection status.

show errdisable detect [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

A displayed gbic-invalid error reason refers to an invalid small form-factor pluggable (SFP) module.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show errdisable detect command:

Switch> show errdisable detect
ErrDisable Reason    Detection    Mode
-----------------    ---------    ----
arp-inspection       Enabled      port
bpduguard            Enabled      vlan
channel-misconfig    Enabled      port
community-limit      Enabled      port
dhcp-rate-limit      Enabled      port
dtp-flap             Enabled      port
gbic-invalid         Enabled      port
inline-power         Enabled      port
invalid-policy       Enabled      port
link-flap            Enabled      port
loopback             Enabled      port
lsgroup              Enabled      port
pagp-flap            Enabled      port
psecure-violation    Enabled      port/vlan
security-violatio    Enabled      port
sfp-config-mismat    Enabled      port
storm-control        Enabled      port
udld                 Enabled      port
vmps                 Enabled      port

Related Commands

Command
Description

errdisable detect cause

Enables error-disabled detection for a specific cause or all causes.

show errdisable flap-values

Displays error condition recognition information.

show errdisable recovery

Displays error-disabled recovery timer information.

show interfaces status

Displays interface status or a list of interfaces in error-disabled state.


show errdisable flap-values

Use the show errdisable flap-values user EXEC command to display conditions that cause an error to be recognized for a cause.

show errdisable flap-values [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

The Flaps column in the display shows how many changes to the state within the specified time interval will cause an error to be detected and a port to be disabled. For example, the display shows that an error will be assumed and the port shut down if three Dynamic Trunking Protocol (DTP)-state (port mode access/trunk) or Port Aggregation Protocol (PAgP) flap changes occur during a 30-second interval, or if 5 link-state (link up/down) changes occur during a 10-second interval.

ErrDisable Reason    Flaps    Time (sec)
-----------------    ------   ----------
pagp-flap              3       30
dtp-flap               3       30
link-flap              5       10

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show errdisable flap-values command:

Switch> show errdisable flap-values
ErrDisable Reason    Flaps    Time (sec)
-----------------    ------   ----------
pagp-flap              3       30
dtp-flap               3       30
link-flap              5       10

Related Commands

Command
Description

errdisable detect cause

Enables error-disabled detection for a specific cause or all causes.

show errdisable detect

Displays error-disabled detection status.

show errdisable recovery

Displays error-disabled recovery timer information.

show interfaces status

Displays interface status or a list of interfaces in error-disabled state.


show errdisable recovery

Use the show errdisable recovery user EXEC command to display the error-disabled recovery timer information.

show errdisable recovery [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

A gbic-invalid error-disable reason refers to an invalid small form-factor pluggable (SFP) module interface.

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show errdisable recovery command:

Switch> show errdisable recovery
ErrDisable Reason    Timer Status
-----------------    --------------
udld                 Disabled
bpduguard            Disabled
security-violatio    Disabled
channel-misconfig    Disabled
vmps                 Disabled
pagp-flap            Disabled
dtp-flap             Disabled
link-flap            Enabled
psecure-violation    Disabled
gbic-invalid         Disabled
dhcp-rate-limit      Disabled
unicast-flood        Disabled
storm-control        Disabled
arp-inspection       Disabled
loopback             Disabled

Timer interval:300 seconds

Interfaces that will be enabled at the next timeout:

Interface    Errdisable reason    Time left(sec)
---------    -----------------    --------------
Gi0/2        link-flap             279 


Note Though visible in the output, the unicast-flood field is not valid.


Related Commands

Command
Description

errdisable recovery

Configures the recover mechanism variables.

show errdisable detect

Displays error-disabled detection status.

show errdisable flap-values

Displays error condition recognition information.

show interfaces status

Displays interface status or a list of interfaces in error-disabled state.


show etherchannel

Use the show etherchannel user EXEC command to display EtherChannel information for a channel.

show etherchannel [channel-group-number {detail | port | port-channel | protocol | summary}] {detail | load-balance | port | port-channel | protocol | summary} [ | {begin | exclude | include} expression]

Syntax Description

channel-group-number

(Optional) Number of the channel group. The range is 1 to 6.

detail

Display detailed EtherChannel information.

load-balance

Display the load-balance or frame-distribution scheme among ports in the port channel.

port

Display EtherChannel port information.

port-channel

Display port-channel information.

protocol

Display the protocol that is being used in the EtherChannel.

summary

Display a one-line summary per channel-group.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

If you do not specify a channel-group, all channel groups are displayed.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show etherchannel 1 detail command:

Switch> show etherchannel 1 detail
Group state = L2
Ports: 2   Maxports = 16
Port-channels: 1 Max Port-channels = 16
Protocol:   LACP
                Ports in the group:
                -------------------
Port: Gi1/0/1
------------

Port state    = Up Mstr In-Bndl
Channel group = 1           Mode = Active      Gcchange = -
Port-channel  = Po1         GC   =   -         Pseudo port-channel = Po1
Port index    = 0           Load = 0x00        Protocol =   LACP

Flags:  S - Device is sending Slow LACPDUs   F - Device is sending fast LACPDU
        A - Device is in active mode.        P - Device is in passive mode.

Local information:
                            LACP port     Admin     Oper    Port     Port
Port      Flags   State     Priority      Key       Key     Number   State
Gi1/0/1   SA      bndl      32768         0x1       0x1     0x101    0x3D
Gi1/0/2   SA      bndl      32768         0x0       0x1     0x0      0x3D
Gi0/1     SA      bndl      32768         0x0       0x1     0x0      0x3D
 
   
Age of the port in the current state: 01d:20h:06m:04s
          
                Port-channels in the group:
                ----------------------

Port-channel: Po1    (Primary Aggregator)
------------

Age of the Port-channel   = 01d:20h:20m:26s
Logical slot/port   = 10/1          Number of ports = 2
HotStandBy port = null
Port state          = Port-channel Ag-Inuse
Protocol            =   LACP

Ports in the Port-channel:

Index   Load   Port     EC state        No of bits
------+------+------+------------------+-----------
  0     00     Gi1/0/1  Active          0
  0     00     Gi1/0/2  Active          0
  0     00     Gi0/1    Active          0
  0     00     Gi0/2    Active          0
 
   
Time since last port bundled:    01d:20h:20m:20s    Gi1/0/2

This is an example of output from the show etherchannel 1 summary command:

Switch> show etherchannel 1 summary
Flags:  D - down        P - in port-channel
        I - stand-alone s - suspended
        H - Hot-standby (LACP only)
        R - Layer3      S - Layer2
        u - unsuitable for bundling
        U - in use      f - failed to allocate aggregator
        d - default port

Number of channel-groups in use: 1
Number of aggregators:           1

Group  Port-channel  Protocol    Ports
------+-------------+-----------+----------------------------------------
1      Po1(SU)         LACP      Gi1/0/1(P)  Gi1/0/2(P)
1      Po1(SU)         LACP      Gi0/1(P)    Gi0/2(P) 
 
   

This is an example of output from the show etherchannel 1 port-channel command:

Switch> show etherchannel 1 port-channel 
                Port-channels in the group: 
                ----------------------
Port-channel: Po1    (Primary Aggregator)

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

Age of the Port-channel   = 01d:20h:24m:50s
Logical slot/port   = 10/1          Number of ports = 2
HotStandBy port = null
Port state          = Port-channel Ag-Inuse
Protocol            =   LACP

Ports in the Port-channel:

Index   Load   Port     EC state        No of bits
------+------+------+------------------+-----------
  0     00     Gi1/0/1  Active          0
  0     00     Gi1/0/2  Active          0
  0     00     Gi0/1    Active          0
  0     00     Gi0/2    Active          0
 
   
Time since last port bundled:    01d:20h:24m:44s    Gi1/0/2

This is an example of output from the show etherchannel protocol command:

Switch# show etherchannel protocol
                Channel-group listing:
                -----------------------
Group: 1
----------
Protocol:  LACP

Group: 2
----------
Protocol:  PAgP

Related Commands

Command
Description

channel-group

Assigns an Ethernet port to an EtherChannel group.

channel-protocol

Restricts the protocol used on a port to manage channeling.

interface port-channel

Accesses or creates the port channel.


show fallback profile

Use the show fallback profile privileged EXEC command to display the fallback profiles that are configured on a switch.

show fallback profile [append | begin | exclude | include | { [redirect | tee] url} expression]

Syntax Description

| append

(Optional) Append redirected output to a specified URL

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

| redirect

(Optional) Copy output to a specified URL.

| tee

(Optional) Copy output to a specified URL.

expression

Expression in the output to use as a reference point.

url

Specified URL where output is directed.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use the show fallback profile privileged EXEC command to display profiles that are configured on the switch.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show fallback profile command:

switch# show fallback profile 
Profile Name: dot1x-www
------------------------------------
Description       : NONE
IP Admission Rule : webauth-fallback
IP Access-Group IN: default-policy
Profile Name: dot1x-www-lpip
------------------------------------
Description       : NONE
IP Admission Rule : web-lpip
IP Access-Group IN: default-policy
Profile Name: profile1
------------------------------------
Description       : NONE
IP Admission Rule : NONE
IP Access-Group IN: NONE

Related Commands

Command
Description

dot1x fallback profile

Configure a port to use web authentication as a fallback method for clients that do not support IEEE 802.1x authentication.

fallback profile profile

Create a web authentication fallback profile.

ip admission rule

Enable web authentication on a switch port

ip admission name proxy http

Enable web authentication globally on a switch

show dot1x [interface interface-id]

Displays IEEE 802.1x status for the specified port.


show flowcontrol

Use the show flowcontrol user EXEC command to display the flow control status and statistics.

show flowcontrol [interface interface-id | module number] [ | {begin | exclude | include} expression]

Syntax Description

interface interface-id

(Optional) Display the flow control status and statistics for a specific interface.

module number

(Optional) Display the flow control status and statistics for all interfaces on the specified stack member switch. 8The only valid module number is 1. This option is not available if you have entered a specific interface ID.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use this command to display the flow control status and statistics on the switch or for a specific interface.

Use the show flowcontrol command to display information about all the switch interfaces. For a standalone switch, the output from the show flowcontrol command is the same as the output from the show flowcontrol module number command.

Use the show flowcontrol interface interface-id command to display information about a specific interface.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show flowcontrol command.

Switch> show flowcontrol
Port       Send FlowControl  Receive FlowControl  RxPause TxPause
           admin    oper     admin    oper
---------  -------- -------- -------- --------    ------- -------
Gi2/0/1      Unsupp.  Unsupp.  off      off         0       0
Gi2/0/2      desired  off      off      off         0       0
Gi2/0/3      desired  off      off      off         0       0
<output truncated>

This is an example of output from the show flowcontrol interface interface-id command:

Switch> show flowcontrol gigabitethernet2/0/2
Port       Send FlowControl  Receive FlowControl  RxPause TxPause
           admin    oper     admin    oper
---------  -------- -------- -------- --------    ------- -------
Gi2/0/2    desired  off      off      off         0       0
Gi0/2      desired  off      off      off         0       0

Related Commands

Command
Description

flowcontrol

Sets the receive flow-control state for an interface.


show interfaces

Use the show interfaces privileged EXEC command to display the administrative and operational status of all interfaces or a specified interface.

show interfaces [interface-id | vlan vlan-id] [accounting | capabilities [module number] | counters | description | etherchannel | flowcontrol | pruning | stats | status [err-disabled] | switchport [backup | module number] | transceiver | properties | detail [module number] | trunk] [ | {begin | exclude | include} expression]

Syntax Description

interface-id

(Optional) Valid interfaces include physical ports (including type, stack member, module, and port number) and port channels. The port-channel range is 1 to 6.

vlan vlan-id

(Optional) VLAN identification. The range is 1 to 4094.

accounting

(Optional) Display accounting information on the interface, including active protocols and input and output packets and octets.

Note The display shows only packets processed in software; hardware-switched packets do not appear.

capabilities

(Optional) Display the capabilities of all interfaces or the specified interface, including the features and options that you can configure on the interface. Though visible in the command line help, this option is not available for VLAN IDs.

module number

(Optional) Display capabilities, switchport configuration, or transceiver characteristics (depending on preceding keyword) of all interfaces on the specified stack member or switch.The range is 1 to 4. This option is not available if you enter a specific interface ID.

Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image. On all other Catalyst 2960 switches, the only valid module number is 1.

counters

(Optional) See the show interfaces counters command.

description

(Optional) Display the administrative status and description set for an interface.

etherchannel

(Optional) Display interface EtherChannel information.

flowcontrol

(Optional) Display interface flowcontrol information

pruning

(Optional) Display interface trunk VTP pruning information.

stats

(Optional) Display the input and output packets by switching path for the interface.

status

(Optional) Display the status of the interface. A status of unsupported in the Type field means that a non-Cisco small form-factor pluggable (SFP) module is inserted in the module slot.

err-disabled

(Optional) Display interfaces in error-disabled state.

switchport

(Optional) Display the administrative and operational status of a switching port, including port blocking and port protection settings.

backup

(Optional) Display Flex Link backup interface configuration and status for the specified interface or all interfaces on the switchstack.

transceiver [detail | properties]

(Optional) Display the physical properties of a CWDM1 or DWDM2 small form-factor (SFP) module interface. The keywords have these meanings:

detail(Optional) Display calibration properties, including high and low numbers and any alarm information.

properties—(Optional) Display speed and duplex settings on an interface.

trunk

Display interface trunk information. If you do not specify an interface, only information for active trunking ports appears.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.

1 Coarse wavelength-division multiplexer

2 Dense wavelength-division multiplexer



Note Though visible in the command-line help strings, the crb, fair-queue, irb, mac-accounting, precedence, random-detect, rate-limit, and shape keywords are not supported.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

The show interfaces capabilities command with different keywords has these results:

Use the show interfaces capabilities module number command to display the capabilities of all interfaces on that switch in the stack. If there is no switch with that module number in the stack, there is no output1 to display the capabilities of all interfaces on the switch. Entering any other number is invalid.


Note Stacking is supported only on Catalyst 2960-S switches.


Use the show interfaces interface-id capabilities to display the capabilities of the specified interface.

Use the show interfaces capabilities (with no module number or interface ID) to display the capabilities of all interfaces on the switch or in the stack.

On Catalyst 2960-S switches running the LAN base image, use the show interfaces switchport module number command to display the switch port characteristics of all interfaces on that switch in the stack. If there is no switch with that module number in the stack, there is no output.

On all other Catalyst 2960 switches, use the show interfaces switchport module 1 to display the switch port characteristics of all interfaces on the switch. Entering any other number is invalid.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show interfaces command for an interface on stack member 3:

Switch# show interfaces gigabitethernet3/0/2 0/2 
GigabitEthernet0/2is down, line protocol is down
  Hardware is Gigabit Ethernet, address is 0009.43a7.d085 (bia 0009.43a7.d085)
  MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec,
     reliability 255/255, txload 1/255, rxload 1/255
  Encapsulation ARPA, loopback not set
  Keepalive set (10 sec)
  Auto-duplex, Auto-speed
  input flow-control is off, output flow-control is off
  ARP type: ARPA, ARP Timeout 04:00:00 Last input never, output never, output hang never
  Last clearing of "show interfaces" counters never
  Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
  Queueing strategy: fifo
  Output queue :0/40 (size/max)
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 0 bits/sec, 0 packets/sec
     2 packets input, 1040 bytes, 0 no buffer
     Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
     0 watchdog, 0 multicast, 0 pause input
     0 input packets with dribble condition detected
     4 packets output, 1040 bytes, 0 underruns
     0 output errors, 0 collisions, 3 interface resets
     0 babbles, 0 late collision, 0 deferred
     0 lost carrier, 0 no carrier, 0 PAUSE output
     0 output buffer failures, 0 output buffers swapped out
 
   

This is an example of output from the show interfaces accounting command.

Switch# show interfaces accounting
Vlan1
                Protocol    Pkts In   Chars In   Pkts Out  Chars Out
                      IP    1094395  131900022     559555   84077157
           Spanning Tree     283896   17033760         42       2520
                     ARP      63738    3825680        231      13860
Interface Vlan2 is disabled
Vlan7
                Protocol    Pkts In   Chars In   Pkts Out  Chars Out
No traffic sent or received on this interface.
Vlan31
                Protocol    Pkts In   Chars In   Pkts Out  Chars Out
No traffic sent or received on this interface.

GigabitEthernet1/0/1
                Protocol    Pkts In   Chars In   Pkts Out  Chars Out
No traffic sent or received on this interface.
GigabitEthernet1/0/2
                Protocol    Pkts In   Chars In   Pkts Out  Chars Out
No traffic sent or received on this interface.

<output truncated>

This is an example of output from the show interfaces capabilities command for an interface.

Switch# show interfaces gigabitethernet1/0/2 capabilities
GigabitEthernet0/2
  Model:                 WS-C2960G-24TC-L
Type:                  10/100/1000BaseTX
  Speed:                 10,100,1000,auto
  Duplex:                full,auto
  Trunk encap. type:     802.1Q,ISL
  Trunk mode:            on,off,desirable,nonegotiate
  Channel:               yes
  Broadcast suppression: percentage(0-100)
  Flowcontrol:           rx-(off,on,desired),tx-(none)
  Fast Start:            yes
  QoS scheduling:        rx-(not configurable on per port basis),tx-(4q2t)
  CoS rewrite:           yes
  ToS rewrite:           yes
  UDLD:                  yes
  Inline power:          no
  SPAN:                  source/destination
  PortSecure:            yes
  Dot1x:                 yes
  Multiple Media Types:  rj45, sfp, auto-select 
 
   

This is an example of output from the show interfaces interface description command when the interface has been described as Connects to Marketing by using the description interface configuration command.

Switch# show interfaces gigabitethernet1/0/2 description
Interface Status         Protocol Description
Gi1/0/2     up             down     Connects to Marketing
Gi0/2       up             down     Connects to Marketing
 
   

This is an example of output from the show interfaces etherchannel command when port channels are configured on the switch:

Switch# show interfaces etherchannel
----
Port-channel1:
Age of the Port-channel   = 03d:20h:17m:29s
Logical slot/port   = 10/1           Number of ports = 0
GC                  = 0x00000000      HotStandBy port = null
Port state          = Port-channel Ag-Not-Inuse

Port-channel2:
Age of the Port-channel   = 03d:20h:17m:29s
Logical slot/port   = 10/2           Number of ports = 0
GC                  = 0x00000000      HotStandBy port = null
Port state          = Port-channel Ag-Not-Inuse

Port-channel3:
Age of the Port-channel   = 03d:20h:17m:29s
Logical slot/port   = 10/3           Number of ports = 0
GC                  = 0x00000000      HotStandBy port = null
Port state          = Port-channel Ag-Not-Inuse

This is an example of output from the show interfaces interface-id pruning command when pruning is enabled in the VTP domain:

Switch# show interfaces gigibitethernet1/0/2 pruning
Port    Vlans pruned for lack of request by neighbor
Gi1/0/2   3,4
Gi0/2     3,4
 
   
Port    Vlans traffic requested of neighbor
Gi1/0/2   1-3
Gi0/2     1-3
 
   

This is an example of output from the show interfaces stats command for a specified VLAN interface.

Switch# show interfaces vlan 1 stats
Switching path    Pkts In   Chars In   Pkts Out  Chars Out
        Processor    1165354  136205310     570800   91731594
      Route cache          0          0          0          0
            Total    1165354  136205310     570800   91731594

This is an example of partial output from the show interfaces status command. It displays the status of all interfaces.

Switch# show interfaces status
Port      Name               Status       Vlan       Duplex  Speed Type
Gi0/1                        notconnect   1            auto   auto 10/100/1000BaseTX
Gi0/2                        notconnect   1            auto   auto 10/100/1000BaseTX
Gi0/3                        notconnect   1            auto   auto 10/100/1000BaseTX
Gi0/4                        notconnect   1            auto   auto 10/100/1000BaseTX
Gi0/5                        notconnect   1            auto   auto 10/100/1000BaseTX
Gi0/6                        notconnect   1            auto   auto 10/100/1000BaseTX

<output truncated>
 
   

This is an example of output from the show interfaces status err-disabled command. It displays the status of interfaces in the error-disabled state.

Switch# show interfaces status err-disabled 
Port      Name               Status       Reason
Gi0/2                        err-disabled dtp-flap
 
   

This is an example of output from the show interfaces switchport command for a port. Table 2-31 describes the fields in the display.


Note Private VLANs are not supported in this release, so those fields are not applicable.


Switch# show interfaces gigabitethernet1/0/1 switchport
Name: Gi1/0/1
Switchport: Enabled
Administrative Mode: dynamic auto
Operational Mode: static access
Administrative Trunking Encapsulation: negotiate
Operational Trunking Encapsulation: native
Negotiation of Trunking: On
Access Mode VLAN: 1 (default)
Trunking Native Mode VLAN: 1 (default)
Voice VLAN: none
Administrative private-vlan host-association:10 (VLAN0010) 502 (VLAN0502)
Administrative private-vlan mapping: none 
Administrative private-vlan trunk native VLAN: none
Administrative private-vlan trunk encapsulation: dot1q
Administrative private-vlan trunk normal VLANs: none
Administrative private-vlan trunk private VLANs: none
Operational private-vlan: none
Trunking VLANs Enabled: ALL
Pruning VLANs Enabled: 2-1001
Capture Mode Disabled
Capture VLANs Allowed: ALL

Protected: false
Unknown unicast blocked: disabled
Unknown multicast blocked: disabled

Voice VLAN: none (Inactive)
Appliance trust: none

Table 2-31 show interfaces switchport Field Descriptions 

Field
Description

Name

Displays the port name.

Switchport

Displays the administrative and operational status of the port. In this display, the port is in switchport mode.

Administrative Mode

Operational Mode

Displays the administrative and operational modes.

Administrative Trunking Encapsulation

Operational Trunking Encapsulation

Negotiation of Trunking

Displays the administrative and operational encapsulation method and whether trunking negotiation is enabled.

Access Mode VLAN

Displays the VLAN ID to which the port is configured.

Trunking Native Mode VLAN

Trunking VLANs Enabled

Trunking VLANs Active

Lists the VLAN ID of the trunk that is in native mode. Lists the allowed VLANs on the trunk. Lists the active VLANs on the trunk.

Pruning VLANs Enabled

Lists the VLANs that are pruning-eligible.

Protected

Displays whether or not protected port is enabled (True) or disabled (False) on the interface.

Unknown unicast blocked

Unknown multicast blocked

Displays whether or not unknown multicast and unknown unicast traffic is blocked on the interface.

Voice VLAN

Displays the VLAN ID on which voice VLAN is enabled.

Appliance trust

Displays the class of service (CoS) setting of the data packets of the IP phone.


1This is an example of output from the show interfaces switchport backup command:

Switch# show interfaces switchport backup
Switch Backup Interface Pairs:
     Active Interface    Backup Interface    State
     --------------------------------------------------------------
     Fa0/1               Fa0/2             Active Up/Backup Standby
     Fa0/3               Fa0/5             Active Down/Backup Up
     Po1                       Po2                 Active Standby/Backup Up

This is an example of output from the show interfaces switchport backup command. In this example, VLANs 1 to 50, 60, and 100 to 120 are configured on the switch:

Switch(config)#interface gigabitEthernet 0/6
Switch(config-if)#switchport backup interface gigabitEthernet 0/8 prefer vlan 60,100-120

When both interfaces are up, Gi0/8 forwards traffic for VLANs 60, 100 to 120, and Gi0/6 forwards traffic for VLANs 1 to 50.

Switch#show interfaces switchport backup
Switch Backup Interface Pairs:

Active Interface        Backup Interface        State
------------------------------------------------------------------------
GigabitEthernet2/0/6 GigabitEthernet2/0/8 Active Down/Backup Up

Vlans on Interface Gi 2/0/6: 1-50
Vlans on Interface Gi 2/0/8: 60, 100-120

When a Flex Link interface goes down (LINK_DOWN), VLANs preferred on this interface are moved to the peer interface of the Flex Link pair. In this example, if interface Gi2/0/6 goes down, Gi2/0/8 carries all VLANs of the Flex Link pair.

Switch#show interfaces switchport backup
Switch Backup Interface Pairs:

Active Interface        Backup Interface        State
------------------------------------------------------------------------
GigabitEthernet2/0/6 GigabitEthernet2/0/8 Active Down/Backup Up

Vlans on Interface Gi 2/0/6: 
Vlans on Interface Gi 2/0/8: 1-50, 60, 100-120

When a Flex Link interface comes up, VLANs preferred on this interface are blocked on the peer interface and moved to the forwarding state on the interface that has just come up. In this example, if interface Gi2/0/6 comes up, then VLANs preferred on this interface are blocked on the peer interface Gi2/0/8 and forwarded on Gi2/0/6.

Switch#show interfaces switchport backup
Switch Backup Interface Pairs:

Active Interface        Backup Interface        State
------------------------------------------------------------------------
GigabitEthernet2/0/6 GigabitEthernet2/0/8 Active Down/Backup Up

Vlans on Interface Gi 2/0/6: 1-50
Vlans on Interface Gi 2/0/8: 60, 100-120

This is an example of output from the show interfaces interface-id pruning command:

Switch# show interfaces gigibitethernet1/0/2 0/2 pruning
Port    Vlans pruned for lack of request by neighbor

This is an example of output from the show interfaces interface-id trunk command. It displays trunking information for the port.

Switch# show interfaces gigabitethernet1/0/2 0/2 trunk
Port          Mode         Encapsulation  Status        Native vlan
Gi1/0/1        auto         negotiate      trunking      1

Port          Vlans allowed on trunk
Gi0/1        1-4094

Port          Vlans allowed and active in management domain
Gi0/1        1-4

Port          Vlans in spanning tree forwarding state and not pruned
Gi0/1         1-4

This is an example of output from the show interfaces interface-id transceiver properties command:

Switch# show interfaces gigabitethernet1/0/2 0/2 transceiver properties
Name : Gi0/2
Administrative Speed: auto 
Operational Speed: auto 
Administrative Duplex: auto
Administrative Power Inline: N/A
Operational Duplex: auto
Administrative Auto-MDIX: off
Operational Auto-MDIX: off
Configured Media: sfp
Active Media: sfp
Attached: 10/100/1000BaseTX SFP-10/100/1000BaseTX

This is an example of output from the show interfaces interface-id transceiver detail command:

Switch# show interfaces gigabitethernet2/0/3 0/3 transceiver detail
ITU Channel not available (Wavelength not available),
Transceiver is externally calibrated.
mA:milliamperes, dBm:decibels (milliwatts), N/A:not applicable.
++:high alarm, +:high warning, -:low warning, -- :low alarm.
A2D readouts (if they differ), are reported in parentheses.
The threshold values are uncalibrated.

                            High Alarm  High Warn  Low Warn   Low Alarm
        Temperature         Threshold   Threshold  Threshold  Threshold
Port     (Celsius)          (Celsius)   (Celsius)  (Celsius)  (Celsius)
------- ------------------  ----------  ---------  ---------  ---------
Gi0/3   41.5                110.0       103.0      -8.0       -12.0

                            High Alarm  High Warn  Low Warn   Low Alarm
         Voltage            Threshold   Threshold  Threshold  Threshold
Port     (Volts)            (Volts)     (Volts)    (Volts)    (Volts)
-------  ---------------    ----------  ---------  ---------  ---------
Gi0/3    3.20               4.00        3.70       3.00       2.95

                            High Alarm  High Warn  Low Warn   Low Alarm
         Current            Threshold   Threshold  Threshold  Threshold
Port     (milliamperes)     (mA)        (mA)       (mA)       (mA)
-------  -----------------  ----------  ---------  ---------  ---------
Gi0/3    31.0               84.0        70.0       4.0        2.0

         Optical            High Alarm  High Warn  Low Warn   Low Alarm
         Transmit Power     Threshold   Threshold  Threshold  Threshold
Port     (dBm)              (dBm)       (dBm)      (dBm)      (dBm)
-------  -----------------  ----------  ---------  ---------  ---------
Gi0/3    -0.0 ( -0.0)       -0.0        -0.0       -0.0       -0.0

         Optical            High Alarm  High Warn  Low Warn   Low Alarm
         Receive Power      Threshold   Threshold  Threshold  Threshold
Port     (dBm)              (dBm)       (dBm)      (dBm)      (dBm)
-------  -----------------  ----------  ---------  ---------  ---------
Gi0/3    N/A  ( -0.0) --    -0.0        -0.0       -0.0       -0.0

Related Commands

Command
Description

switchport access

Configures a port as a static-access or a dynamic-access port.

switchport block

Blocks unknown unicast or multicast traffic on an interface.

switchport backup interface

Configures Flex Links, a pair of Layer 2 interfaces that provide mutual backup.

switchport mode

Configures the VLAN membership mode of a port.

switchport protected

Isolates unicast, multicast, and broadcast traffic at Layer 2 from other protected ports on the same switch.

switchport trunk pruning

Configures the VLAN pruning-eligible list for ports in trunking mode.


show interfaces counters

Use the show interfaces counters privileged EXEC command to display various counters for the switch or for a specific interface.

show interfaces [interface-id | vlan vlan-id] counters [errors | etherchannel | module switch- number | protocol status | trunk] [ | {begin | exclude | include} expression]

Syntax Description

interface-id

(Optional) ID of the physical interface.

errors

(Optional) Display error counters.

etherchannel

(Optional) Display EtherChannel counters, including octets, broadcast packets, multicast packets, and unicast packets received and sent.

module switch- number

(Optional) Display counters for the specified stack member. The range is from 1 to 4, depending upon the switch numbers in the stack.

The module keyword in this command refers to the stack member number (1 to 4). The module number that is part of the interface ID is always zero.

Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.

protocol status

(Optional) Display status of protocols enabled on interfaces.

trunk

(Optional) Display trunk counters.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.



Note Though visible in the command-line help string, the vlan vlan-id keyword is not supported.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

If you do not enter any keywords, all counters for all interfaces are included.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of partial output from the show interfaces counters command. It displays all counters for the switch.

Switch# show interfaces counters
Port            InOctets   InUcastPkts   InMcastPkts   InBcastPkts
Gi0/1                  0             0             0             0
Gi0/2                  0             0             0             0

<output truncated>

This is an example of partial output from the show interfaces counters module command for stack member 2. It displays all counters for the specified switch in the stack.


Note This example applies only to Catalyst 2960-S switches running the LAN base image.


Switch# show interfaces counters module 2
Port            InOctets   InUcastPkts   InMcastPkts   InBcastPkts
Gi2/0/1              520             2             0             0
Gi2/0/2              520             2             0             0
Gi2/0/3              520             2             0             0
Gi2/0/4              520             2             0             0
Gi2/0/5              520             2             0             0
Gi2/0/6              520             2             0             0
Gi2/0/7              520             2             0             0
Gi2/0/8              520             2             0             0

<output truncated>

This is an example of partial output from the show interfaces counters protocol status command for all interfaces.

Switch# show interfaces counters protocol status
Protocols allocated:
 Vlan1: Other, IP
 Vlan20: Other, IP, ARP
 Vlan30: Other, IP, ARP
 Vlan40: Other, IP, ARP
 Vlan50: Other, IP, ARP
 Vlan60: Other, IP, ARP
 Vlan70: Other, IP, ARP
 Vlan80: Other, IP, ARP
 Vlan90: Other, IP, ARP
 Vlan900: Other, IP, ARP
 Vlan3000: Other, IP
 Vlan3500: Other, IP
 FastEthernet0/1: Other, IP, ARP, CDP
 FastEthernet0/2: Other, IP
 FastEthernet0/3: Other, IP
 FastEthernet0/4: Other, IP
 FastEthernet0/5: Other, IP
 FastEthernet0/6: Other, IP
 FastEthernet0/7: Other, IP
 FastEthernet0/8: Other, IP
 FastEthernet0/9: Other, IP
 FastEthernet0/10: Other, IP, CDP

<output truncated>

This is an example of output from the show interfaces counters trunk command. It displays trunk counters for all interfaces.

Switch# show interfaces counters trunk
Port        TrunkFramesTx  TrunkFramesRx  WrongEncap
Gi0/1                   0              0           0
Gi0/2                   0              0           0
Gi0/3               80678           4155           0
Gi0/4               82320            126           0
Gi0/5                  0               0           0

<output truncated>

Related Commands

Command
Description

show interfaces

Displays additional interface characteristics.


show inventory

Use the show inventory user EXEC command to display product identification (PID) information for the hardware.

show inventory [entity-name | raw] [ | {begin | exclude | include} expression]

Syntax Description

entity-name

(Optional) Display the specified entity. For example, enter the interface (such as gigabitethernet0/1) into which a small form-factor pluggable (SFP) module is installed.

raw

(Optional) Display every entity in the device.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

The command is case sensitive. With no arguments, the show inventory command produces a compact dump of all identifiable entities that have a product identifier. The compact dump displays the entity location (slot identity), entity description, and the unique device identifier (UDI) (PID, VID, and SN) of that entity.


Note If there is no PID, no output appears when you enter the show inventory command.


Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is example output from the show inventory command:

 
   
Switch> show inventory
NAME: "1", DESCR: "WS-C2960-48TC-L"
PID: WS-C2960-24TC-L   , VID: 02 , SN: FHH0923D075

NAME: "GigabitEthernet0/1", DESCR: "100BaseBX-10D SFP"
PID:                     , VID:    , SN: NEC09050251     

NAME: "GigabitEthernet0/2", DESCR: "100BaseBX-10U SFP"
PID:                     , VID:    , SN: NEC09050020     

show ip arp inspection

Use the show ip arp inspection privileged EXEC command to display the configuration and the operating state of dynamic Address Resolution Protocol (ARP) inspection or the status of this feature for all VLANs or for the specified interface or VLAN.

show ip arp inspection [interfaces [interface-id] | log | statistics [vlan vlan-range] | vlan vlan-range] [ | {begin | exclude | include} expression]

Syntax Description

interfaces [interface-id]

(Optional) Display the trust state and the rate limit of ARP packets for the specified interface or all interfaces. Valid interfaces include physical ports and port channels.

log

(Optional) Display the configuration and contents of the dynamic ARP inspection log buffer.

statistics [vlan vlan-range]

(Optional) Display statistics for forwarded, dropped, MAC validation failure, IP validation failure, access control list (ACL) permitted and denied, and DHCP permitted and denied packets for the specified VLAN. If no VLANs are specified or if a range is specified, display information only for VLANs with dynamic ARP inspection enabled (active).

You can specify a single VLAN identified by VLAN ID number, a range of VLANs separated by a hyphen, or a series of VLANs separated by a comma. The range is 1 to 4094.

vlan vlan-range

(Optional) Display the configuration and the operating state of dynamic ARP inspection for the specified VLAN. If no VLANs are specified or if a range is specified, display information only for VLANs with dynamic ARP inspection enabled (active).

You can specify a single VLAN identified by VLAN ID number, a range of VLANs separated by a hyphen, or a series of VLANs separated by a comma. The range is 1 to 4094.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(50)SE

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show ip arp inspection command

Switch# show ip arp inspection

Source Mac Validation      : Disabled
Destination Mac Validation : Disabled
IP Address Validation      : Enabled

  Vlan     Configuration    Operation   ACL Match          Static ACL
  ----     -------------    ---------   ---------          ----------
     1     Enabled          Active      deny-all           No

  Vlan     ACL Logging      DHCP Logging      Probe Logging
  ----     -----------      ------------      -------------
     1     Acl-Match        All               Permit

  Vlan      Forwarded        Dropped     DHCP Drops      ACL Drops
  ----      ---------        -------     ----------      ---------
     1              0              0              0              0

  Vlan   DHCP Permits    ACL Permits  Probe Permits   Source MAC Failures
  ----   ------------    -----------  -------------   -------------------
     1              0              0              0                     0

  Vlan   Dest MAC Failures   IP Validation Failures   Invalid Protocol Data
  ----   -----------------   ----------------------   ---------------------
     1                   0                        0                       0

This is an example of output from the show ip arp inspection interfaces command:

Switch# show ip arp inspection interfaces
 Interface        Trust State     Rate (pps)    Burst Interval
 ---------------  -----------     ----------    --------------
 Gi0/1            Untrusted               15                 1
 Gi0/2            Untrusted               15                 1
 Gi0/3            Untrusted               15                 1

This is an example of output from the show ip arp inspection interfaces interface-id command:

Switch# show ip arp inspection interfaces gigabitethernet0/1 
 Interface        Trust State     Rate (pps)    Burst Interval
 ---------------  -----------     ----------    --------------
 Gi0/1            Untrusted               15                 1

This is an example of output from the show ip arp inspection log command. It shows the contents of the log buffer before the buffers are cleared:

Switch# show ip arp inspection log
Total Log Buffer Size : 32
Syslog rate : 10 entries per 300 seconds.

Interface   Vlan  Sender MAC      Sender IP        Num Pkts   Reason       Time
----------  ----  --------------  ---------------  ---------  -----------  ----
Gi0/1       5     0003.0000.d673  192.2.10.4               5  DHCP Deny    19:39:01 UTC 
Mon Mar 1 1993
Gi0/1       5     0001.0000.d774  128.1.9.25               6  DHCP Deny    19:39:02 UTC 
Mon Mar 1 1993
Gi0/1       5     0001.c940.1111  10.10.10.1               7  DHCP Deny    19:39:03 UTC 
Mon Mar 1 1993
Gi0/1       5     0001.c940.1112  10.10.10.2               8  DHCP Deny    19:39:04 UTC 
Mon Mar 1 1993
Gi0/1       5     0001.c940.1114  173.1.1.1               10  DHCP Deny    19:39:06 UTC 
Mon Mar 1 1993
Gi0/1       5     0001.c940.1115  173.1.1.2               11  DHCP Deny    19:39:07 UTC 
Mon Mar 1 1993
Gi0/1       5     0001.c940.1116  173.1.1.3               12  DHCP Deny    19:39:08 UTC 
Mon Mar 1 1993

If the log buffer overflows, it means that a log event does not fit into the log buffer, and the display for the show ip arp inspection log privileged EXEC command is affected. A -- in the display appears in place of all data except the packet count and the time. No other statistics are provided for the entry. If you see this entry in the display, increase the number of entries in the log buffer, or increase the logging rate in the ip arp inspection log-buffer global configuration command.

This is an example of output from the show ip arp inspection statistics command. It shows the statistics for packets that have been processed by dynamic ARP inspection for all active VLANs.

Switch# show ip arp inspection statistics
Vlan       Forwarded        Dropped     DHCP Drops      ACL Drops
 ----      ---------        -------     ----------      ---------
    5              3           4618           4605              4
 2000              0              0              0              0

 Vlan   DHCP Permits    ACL Permits   Source MAC Failures
 ----   ------------    -----------   -------------------
    5              0             12                     0
 2000              0              0                     0

 Vlan   Dest MAC Failures   IP Validation Failures
 ----   -----------------   ----------------------
    5                   0                        9
 2000                   0                        0

For the show ip arp inspection statistics command, the switch increments the number of forwarded packets for each ARP request and response packet on a trusted dynamic ARP inspection port. The switch increments the number of ACL or DHCP permitted packets for each packet that is denied by source MAC, destination MAC, or IP validation checks, and the switch increments the appropriate failure count.

This is an example of output from the show ip arp inspection statistics vlan 5 command. It shows statistics for packets that have been processed by dynamic ARP for VLAN 5.

Switch# show ip arp inspection statistics vlan 5
Vlan      Forwarded        Dropped     DHCP Drops      ACL Drops
 ----      ---------        -------     ----------      ---------
    5              3           4618           4605              4

 Vlan   DHCP Permits    ACL Permits   Source MAC Failures
 ----   ------------    -----------   -------------------
    5              0             12                     0

 Vlan   Dest MAC Failures   IP Validation Failures      Invalid Protocol Data
 ----   -----------------   ----------------------      ---------------------
    5                   0                        9                          3

This is an example of output from the show ip arp inspection vlan 5 command. It shows the configuration and the operating state of dynamic ARP inspection for VLAN 5.

Switch# show ip arp inspection vlan 5
Source Mac Validation      :Enabled
Destination Mac Validation :Enabled
IP Address Validation      :Enabled

 Vlan     Configuration    Operation   ACL Match          Static ACL
 ----     -------------    ---------   ---------          ----------
    5     Enabled          Active      second             No

 Vlan     ACL Logging      DHCP Logging
 ----     -----------      ------------
    5     Acl-Match        All

Related Commands

Command
Description

arp access-list

Defines an ARP ACL.

clear ip arp inspection log

Clears the dynamic ARP inspection log buffer.

clear ip arp inspection statistics

Clears the dynamic ARP inspection statistics.

ip arp inspection log-buffer

Configures the dynamic ARP inspection logging buffer.

ip arp inspection vlan logging

Controls the type of packets that are logged per VLAN.

show arp access-list

Displays detailed information about ARP access lists.


show ip dhcp snooping

Use the show ip dhcp snooping user EXEC command to display the DHCP snooping configuration.

show ip dhcp snooping [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ip dhcp snooping command:

Switch> show ip dhcp snooping
Switch DHCP snooping is enabled
DHCP snooping is configured on following VLANs:
40-42
Insertion of option 82 is enabled
Option 82 on untrusted port is allowed 
Verification of hwaddr field is enabled
Interface                    Trusted     Rate limit (pps)
------------------------     -------     ----------------
GigabitEthernet0/1               yes         unlimited
GigabitEthernet0/2               yes         unlimited

Related Commands

Command
Description

show ip dhcp snooping binding

Displays the DHCP snooping binding information.


show ip dhcp snooping binding

Use the show ip dhcp snooping binding user EXEC command to display the DHCP snooping binding database and configuration information for all interfaces on a switch.

show ip dhcp snooping binding [ip-address] [mac-address] [interface interface-id] [vlan vlan-id] | {begin | exclude | include} expression]

Syntax Description

ip-address

(Optional) Specify the binding entry IP address.

mac-address

(Optional) Specify the binding entry MAC address.

interface interface-id

(Optional) Specify the binding input interface.

vlan vlan-id

(Optional) Specify the binding entry VLAN.

| begin

Display begins with the line that matches the expression.

| exclude

Display excludes lines that match the expression.

| include

Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

The show ip dhcp snooping binding command output shows only the dynamically configured bindings. Use the show ip source binding privileged EXEC command to display the dynamically and statically configured bindings in the DHCP snooping binding database.

If DHCP snooping is enabled and an interface changes to the down state, the switch does not delete the statically configured bindings.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This example shows how to display the DHCP snooping binding entries for a switch:

Switch> show ip dhcp snooping binding
MacAddress          IpAddress        Lease(sec)  Type           VLAN  Interface
------------------  ---------------  ----------  -------------  ----  --------------------
01:02:03:04:05:06   10.1.2.150       9837        dhcp-snooping  20    GigabitEthernet0/1
00:D0:B7:1B:35:DE   10.1.2.151       237         dhcp-snooping  20    GigabitEthernet0/2
Total number of bindings: 2

This example shows how to display the DHCP snooping binding entries for a specific IP address:

Switch> show ip dhcp snooping binding 10.1.2.150
MacAddress          IpAddress        Lease(sec)  Type           VLAN  Interface
------------------  ---------------  ----------  -------------  ----  --------------------
01:02:03:04:05:06   10.1.2.150       9810        dhcp-snooping  20    GigabitEthernet0/1
Total number of bindings: 1

This example shows how to display the DHCP snooping binding entries for a specific MAC address:

Switch> show ip dhcp snooping binding 0102.0304.0506
MacAddress          IpAddress        Lease(sec)  Type           VLAN  Interface
------------------  ---------------  ----------  -------------  ----  --------------------
01:02:03:04:05:06   10.1.2.150       9788        dhcp-snooping  20    GigabitEthernet0/2
Total number of bindings: 1

This example shows how to display the DHCP snooping binding entries on a port:

Switch> show ip dhcp snooping binding interface gigabitethernet0/2
MacAddress          IpAddress        Lease(sec)  Type           VLAN  Interface
------------------  ---------------  ----------  -------------  ----  --------------------
00:30:94:C2:EF:35   10.1.2.151       290         dhcp-snooping  20    GigabitEthernet0/2
Total number of bindings: 1

This example shows how to display the DHCP snooping binding entries on VLAN 20:

Switch> show ip dhcp snooping binding vlan 20
MacAddress          IpAddress        Lease(sec)  Type           VLAN  Interface
------------------  ---------------  ----------  -------------  ----  --------------------
01:02:03:04:05:06   10.1.2.150       9747        dhcp-snooping  20    GigabitEthernet0/1
00:00:00:00:00:02   10.1.2.151       65          dhcp-snooping  20    GigabitEthernet0/2
Total number of bindings: 2

Table 2-32 describes the fields in the show ip dhcp snooping binding command output:

Table 2-32 show ip dhcp snooping binding Command Output 

Field
Description

MacAddress

Client hardware MAC address

IpAddress

Client IP address assigned from the DHCP server

Lease(sec)

Remaining lease time for the IP address

Type

Binding type

VLAN

VLAN number of the client interface

Interface

Interface that connects to the DHCP client host

Total number of bindings

Total number of bindings configured on the switch

Note The command output might not show the total number of bindings. For example, if 200 bindings are configured on the switch and you stop the display before all the bindings appear, the total number does not change.


Related Commands

Command
Description

ip dhcp snooping binding

Configures the DHCP snooping binding database

show ip dhcp snooping

Displays the DHCP snooping configuration.


show ip dhcp snooping database

Use the show ip dhcp snooping database user EXEC command to display the status of the DHCP snooping binding database agent.

show ip dhcp snooping database [detail] [ | {begin | exclude | include} expression]

Syntax Description

detail

(Optional) Display detailed status and statistics information.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Examples

This is an example of output from the show ip dhcp snooping database command:

Switch> show ip dhcp snooping database
Agent URL : 
Write delay Timer : 300 seconds
Abort Timer : 300 seconds

Agent Running : No
Delay Timer Expiry : Not Running
Abort Timer Expiry : Not Running

Last Succeded Time : None
Last Failed Time : None
Last Failed Reason : No failure recorded.

Total Attempts       :        0   Startup Failures :        0
Successful Transfers :        0   Failed Transfers :        0
Successful Reads     :        0   Failed Reads     :        0
Successful Writes    :        0   Failed Writes    :        0
Media Failures       :        0

This is an example of output from the show ip dhcp snooping database detail command:

Switch# show ip dhcp snooping database detail 
Agent URL : tftp://10.1.1.1/directory/file
Write delay Timer : 300 seconds
Abort Timer : 300 seconds

Agent Running : No
Delay Timer Expiry : 7 (00:00:07)
Abort Timer Expiry : Not Running

Last Succeded Time : None
Last Failed Time : 17:14:25 UTC Sat Jul 7 2001
Last Failed Reason : Unable to access URL.

Total Attempts       :       21   Startup Failures :        0
Successful Transfers :        0   Failed Transfers :       21
Successful Reads     :        0   Failed Reads     :        0
Successful Writes    :        0   Failed Writes    :       21
Media Failures       :        0

First successful access: Read

Last ignored bindings counters :
Binding Collisions    :        0   Expired leases    :        0
Invalid interfaces    :        0   Unsupported vlans :        0
Parse failures        :        0
Last Ignored Time : None

Total ignored bindings counters:
Binding Collisions    :        0   Expired leases    :        0
Invalid interfaces    :        0   Unsupported vlans :        0
Parse failures        :        0

Related Commands

Command
Description

ip dhcp snooping

Enables DHCP snooping on a VLAN.

ip dhcp snooping database

Configures the DHCP snooping binding database agent or the binding file.

show ip dhcp snooping

Displays DHCP snooping information.


show ip dhcp snooping statistics

Use the show ip dhcp snooping statistics user EXEC command to display DHCP snooping statistics in summary or detail form.

show ip dhcp snooping statistics [detail] [ | {begin | exclude | include} expression]

Syntax Description

detail

(Optional) Display detailed statistics information.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(37)SE

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

In a switch stack, all statistics are generated on the stack master. If a new stack master is elected, the statistics counters reset.


Note Stacking is supported only on Catalyst 2960-S switches running the LAN base image.


Examples

This is an example of output from the show ip dhcp snooping statistics command:

Switch> show ip dhcp snooping statistics
 Packets Forwarded                                     = 0
 Packets Dropped                                       = 0
 Packets Dropped From untrusted ports                  = 0

This is an example of output from the show ip dhcp snooping statistics detail command:

Switch> show ip dhcp snooping statistics detail
 Packets Processed by DHCP Snooping                    = 0
 Packets Dropped Because
   IDB not known                                       = 0
   Queue full                                          = 0
   Interface is in errdisabled                         = 0
   Rate limit exceeded                                 = 0
   Received on untrusted ports                         = 0
   Nonzero giaddr                                      = 0
   Source mac not equal to chaddr                      = 0
   Binding mismatch                                    = 0
   Insertion of opt82 fail                             = 0
   Interface Down                                      = 0
   Unknown output interface                            = 0
   Reply output port equal to input port               = 0
   Packet denied by platform                           = 0

Table 2-33 shows the DHCP snooping statistics and their descriptions:

Table 2-33 DHCP Snooping Statistics 

DHCP Snooping Statistic
Description

Packets Processed by DHCP Snooping

Total number of packets handled by DHCP snooping, including forwarded and dropped packets.

Packets Dropped Because IDB not known

Number of errors when the input interface of the packet cannot be determined.

Queue full

Number of errors when an internal queue used to process the packets is full. This might happen if DHCP packets are received at an excessively high rate and rate limiting is not enabled on the ingress ports.

Interface is in errdisabled

Number of times a packet was received on a port that has been marked as error disabled. This might happen if packets are in the processing queue when a port is put into the error-disabled state and those packets are subsequently processed.

Rate limit exceeded

Number of times the rate limit configured on the port was exceeded and the interface was put into the error-disabled state.

Received on untrusted ports

Number of times a DHCP server packet (OFFER, ACK, NAK, or LEASEQUERY) was received on an untrusted port and was dropped.

Nonzero giaddr

Number of times the relay agent address field (giaddr) in the DHCP packet received on an untrusted port was not zero, or the no ip dhcp snooping information option allow-untrusted global configuration command is not configured and a packet received on an untrusted port contained option-82 data.

Source mac not equal to chaddr

Number of times the client MAC address field of the DHCP packet (chaddr) does not match the packet source MAC address and the ip dhcp snooping verify mac-address global configuration command is configured.

Binding mismatch

Number of times a RELEASE or DECLINE packet was received on a port that is different than the port in the binding for that MAC address-VLAN pair. This indicates someone might be trying to spoof the real client, or it could mean that the client has moved to another port on the switch and issued a RELEASE or DECLINE. The MAC address is taken from the chaddr field of the DHCP packet, not the source MAC address in the Ethernet header.

Insertion of opt82 fail

Number of times the option-82 insertion into a packet failed. The insertion might fail if the packet with the option-82 data exceeds the size of a single physical packet on the internet.

Interface Down

Number of times the packet is a reply to the DHCP relay agent, but the SVI interface for the relay agent is down. This is an unlikely error that occurs if the SVI goes down between sending the client request to the DHCP server and receiving the response.

Unknown output interface

Number of times the output interface for a DHCP reply packet cannot be determined by either option-82 data or a lookup in the MAC address table. The packet is dropped. This can happen if option 82 is not used and the client MAC address has aged out. If IPSG is enabled with the port-security option and option 82 is not enabled, the MAC address of the client is not learned, and the reply packets will be dropped.

Reply output port equal to input port

Number of times the output port for a DHCP reply packet is the same as the input port, causing a possible loop. Indicates a possible network misconfiguration or misuse of trust settings on ports.

Packet denied by platform

Number of times the packet has been denied by a platform-specific registry.


Related Commands

Command
Description

clear ip dhcp snooping

Clears the DHCP snooping binding database, the DHCP snooping binding database agent statistics, or the DHCP snooping statistics counters.


show ip igmp profile

Use the show ip igmp profile privileged EXEC command to display all configured Internet Group Management Protocol (IGMP) profiles or a specified IGMP profile.

show ip igmp profile [profile number] [ | {begin | exclude | include} expression]

Syntax Description

profile number

(Optional) The IGMP profile number to be displayed. The range is 1 to 4294967295. If no profile number is entered, all IGMP profiles are displayed.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

These are examples of output from the show ip igmp profile privileged EXEC command, with and without specifying a profile number. If no profile number is entered, the display includes all profiles configured on the switch.

Switch# show ip igmp profile 40
IGMP Profile 40
    permit
    range 233.1.1.1 233.255.255.255

Switch# show ip igmp profile
IGMP Profile 3
    range 230.9.9.0 230.9.9.0
IGMP Profile 4
    permit
    range 229.9.9.0 229.255.255.255

Related Commands

Command
Description

ip igmp profile

Configures the specified IGMP profile number.


show ip igmp snooping

Use the show ip igmp snooping user EXEC command to display the Internet Group Management Protocol (IGMP) snooping configuration of the switch or the VLAN.

show ip igmp snooping [groups | mrouter | querier] [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

groups

(Optional) See the show ip igmp snooping groups command.

mrouter

(Optional) See the show ip igmp snooping mrouter command.

querier

(Optional) See the show ip igmp snooping querier command.

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094 (available only in privileged EXEC mode).

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use this command to display snooping configuration for the switch or for a specific VLAN.

VLAN IDs 1002 to 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in IGMP snooping.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ip igmp snooping vlan 1 command. It shows snooping characteristics for a specific VLAN.

Switch# show ip igmp snooping vlan 1
Global IGMP Snooping configuration:
-----------------------------------
IGMP snooping             :Enabled
IGMPv3 snooping (minimal) :Enabled
Report suppression        :Enabled
TCN solicit query         :Disabled
TCN flood query count     :2
Last member query interval : 100

Vlan 1:
--------
IGMP snooping                       :Enabled
Immediate leave                     :Disabled
Multicast router learning mode      :pim-dvmrp
Source only learning age timer      :10
CGMP interoperability mode          :IGMP_ONLY
Last member query interval : 100

This is an example of output from the show ip igmp snooping command. It displays snooping characteristics for all VLANs on the switch.

Switch> show ip igmp snooping 
Global IGMP Snooping configuration:
-----------------------------------
IGMP snooping              : Enabled
IGMPv3 snooping (minimal)  : Enabled
Report suppression         : Enabled
TCN solicit query          : Disabled
TCN flood query count      : 2
Last member query interval : 100

Vlan 1:
--------
IGMP snooping                       :Enabled
Immediate leave                     :Disabled
Multicast router learning mode      :pim-dvmrp
Source only learning age timer      :10
CGMP interoperability mode          :IGMP_ONLY
Last member query interval          : 100

Vlan 2:
--------
IGMP snooping                       :Enabled
Immediate leave                     :Disabled
Multicast router learning mode      :pim-dvmrp
Source only learning age timer      :10
CGMP interoperability mode          :IGMP_ONLY
Last member query interval          : 333

<output truncated>

Related Commands

Command
Description

ip igmp snooping

Enables IGMP snooping on the switch or on a VLAN.

ip igmp snooping last-member-query-interval

Enables the IGMP snooping configurable-leave timer.

ip igmp snooping querier

Enables the IGMP querier function in Layer 2 networks.

ip igmp snooping report-suppression

Enables IGMP report suppression.

ip igmp snooping tcn

Configures the IGMP topology change notification behavior.

ip igmp snooping tcn flood

Specifies multicast flooding as the IGMP spanning-tree topology change notification behavior.

ip igmp snooping vlan immediate-leave

Enables IGMP snooping immediate-leave processing on a VLAN.

ip igmp snooping vlan mrouter

Adds a multicast router port or configures the multicast learning method.

ip igmp snooping vlan static

Statically adds a Layer 2 port as a member of a multicast group.

show ip igmp snooping groups

Displays the IGMP snooping multicast table for the switch.

show ip igmp snooping mrouter

Displays IGMP snooping multicast router ports for the switch or for the specified multicast VLAN.

show ip igmp snooping querier

Displays the configuration and operation information for the IGMP querier configured on a switch.


show ip igmp snooping groups

Use the show ip igmp snooping groups privileged EXEC command to display the Internet Group Management Protocol (IGMP) snooping multicast table for the switch or the multicast information. Use with the vlan keyword to display the multicast table for a specified multicast VLAN or specific multicast information.

show ip igmp snooping groups [count | dynamic [count] | user [count]] [ | {begin | exclude | include} expression]

show ip igmp snooping groups vlan vlan-id [ip_address | count | dynamic [count] | user [count]] [ | {begin | exclude | include} expression]

Syntax Description

count

(Optional) Display the total number of entries for the specified command

options instead of the actual entries.

dynamic

(Optional) Display entries learned by IGMP snooping.

user

Optional) Display only the user-configured multicast entries.

ip_address

(Optional) Display characteristics of the multicast group with the specified group IP address.

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use this command to display multicast information or the multicast table.

VLAN IDs 1002 to 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in IGMP snooping.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ip igmp snooping groups command without any keywords. It displays the multicast table for the switch.

Switch# show ip igmp snooping groups
Vlan      Group          Type        Version     Port List
-------------------------------------------------------------
104       224.1.4.2      igmp        v2          Gi0/1, Gi0/2
104       224.1.4.3      igmp        v2          Gi0/1, Gi0/2
 
   

This is an example of output from the show ip igmp snooping groups count command. It displays the total number of multicast groups on the switch.

Switch# show ip igmp snooping groups count
Total number of multicast groups: 2

This is an example of output from the show ip igmp snooping groups dynamic command. It shows only the entries learned by IGMP snooping.

Switch# show ip igmp snooping groups vlan 1 dynamic
Vlan      Group          Type        Version     Port List
-------------------------------------------------------------
104       224.1.4.2      igmp        v2          Gi0/1, Fa0/15
104       224.1.4.3      igmp        v2          Gi0/1, Fa0/15

This is an example of output from the show ip igmp snooping groups vlan vlan-id ip-address command. It shows the entries for the group with the specified IP address.

Switch# show ip igmp snooping groups vlan 104 224.1.4.2
Vlan      Group          Type        Version     Port List
-------------------------------------------------------------
104       224.1.4.2      igmp        v2          Gi0/1, Fa0/15

Related Commands

Command
Description

ip igmp snooping

Enables IGMP snooping on the switch or on a VLAN.

ip igmp snooping vlan mrouter

Configures a multicast router port.

ip igmp snooping vlan static

Statically adds a Layer 2 port as a member of a multicast group.

show ip igmp snooping

Displays the IGMP snooping configuration of the switch or the VLAN.

show ip igmp snooping mrouter

Displays IGMP snooping multicast router ports for the switch or for the specified multicast VLAN.


show ip igmp snooping mrouter

Use the show ip igmp snooping mrouter privileged EXEC command to display the Internet Group Management Protocol (IGMP) snooping dynamically learned and manually configured multicast router ports for the switch or for the specified multicast VLAN.

show ip igmp snooping mrouter [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use this command to display multicast router ports on the switch or for a specific VLAN.

VLAN IDs 1002 to 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in IGMP snooping.

When multicast VLAN registration (MVR) is enabled, the show ip igmp snooping mrouter command displays MVR multicast router information and IGMP snooping information.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ip igmp snooping mrouter command. It shows how to display multicast router ports on the switch.

Switch# show ip igmp snooping mrouter
Vlan    ports
----    -----
   1    Gi0/1(dynamic)

Related Commands

Command
Description

ip igmp snooping

Enables IGMP snooping on the switch or on a VLAN.

ip igmp snooping vlan mrouter

Adds a multicast router port.

ip igmp snooping vlan static

Statically adds a Layer 2 port as a member of a multicast group.

show ip igmp snooping

Displays the IGMP snooping configuration of the switch or the VLAN

show ip igmp snooping groups

Displays IGMP snooping multicast information for the switch or for the specified parameter.


show ip igmp snooping querier

Use the show ip igmp snooping querier detail user EXEC command to display the configuration and operation information for the IGMP querier configured on a switch.

show ip igmp snooping querier [detail | vlan vlan-id [detail]] [ | {begin | exclude | include} expression]

Syntax Description

detail

Optional) Display detailed IGMP querier information.

vlan vlan-id [detail]

Optional) Display IGMP querier information for the specified VLAN. The range is 1 to 1001 and 1006 to 4094. Use the detail keyword to display detailed information.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use the show ip igmp snooping querier command to display the IGMP version and the IP address of a detected device, also called a querier, that sends IGMP query messages. A subnet can have multiple multicast routers but has only one IGMP querier. In a subnet running IGMPv2, one of the multicast routers is elected as the querier. The querier can be a Layer 3 switch.

The show ip igmp snooping querier command output also shows the VLAN and the interface on which the querier was detected. If the querier is the switch, the output shows the Port field as Router. If the querier is a router, the output shows the port number on which the querier is learned in the Port field.

The show ip igmp snooping querier detail user EXEC command is similar to the show ip igmp snooping querier command. However, the show ip igmp snooping querier command displays only the device IP address most recently detected by the switch querier.

The show ip igmp snooping querier detail command displays the device IP address most recently detected by the switch querier and this additional information:

The elected IGMP querier in the VLAN

The configuration and operational information pertaining to the switch querier (if any) that is configured in the VLAN

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ip igmp snooping querier command:

Switch> show ip igmp snooping querier
Vlan      IP Address     IGMP Version        Port
---------------------------------------------------
1         172.20.50.11   v3                  Gi0/1
2         172.20.40.20   v2                  Router

This is an example of output from the show ip igmp snooping querier detail command:

Switch> show ip igmp snooping querier detail

Vlan      IP Address     IGMP Version   Port
-------------------------------------------------------------
1         1.1.1.1        v2             Fa0/1 

Global IGMP switch querier status
--------------------------------------------------------
admin state                    : Enabled
admin version                  : 2
source IP address              : 0.0.0.0        
query-interval (sec)           : 60
max-response-time (sec)        : 10
querier-timeout (sec)          : 120
tcn query count                : 2
tcn query interval (sec)       : 10

Vlan 1:   IGMP switch querier status

--------------------------------------------------------
elected querier is 1.1.1.1         on port Fa0/1
--------------------------------------------------------
admin state                    : Enabled
admin version                  : 2
source IP address              : 10.1.1.65      
query-interval (sec)           : 60
max-response-time (sec)        : 10
querier-timeout (sec)          : 120
tcn query count                : 2
tcn query interval (sec)       : 10
operational state              : Non-Querier
operational version            : 2
tcn query pending count        : 0

Related Commands

Command
Description

ip igmp snooping

Enables IGMP snooping on the switch or on a VLAN.

ip igmp snooping querier

Enables the IGMP querier function in Layer 2 networks.

show ip igmp snooping

Displays IGMP snooping multicast router ports for the switch or for the specified multicast VLAN.


show ip source binding

Use the show ip source binding user EXEC command to display the IP source bindings on the switch.

show ip source binding [ip-address] [mac-address] [dhcp-snooping | static] [interface interface-id] [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

ip-address

(Optional) Display IP source bindings for a specific IP address.

mac-address

(Optional) Display IP source bindings for a specific MAC address.

dhcp-snooping

(Optional) Display IP source bindings that were learned by DHCP snooping.

static

(Optional) Display static IP source bindings.

interface interface-id

(Optional) Display IP source bindings on a specific interface.

vlan vlan-id

(Optional) Display IP source bindings on a specific VLAN.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(50)SE

This command was introduced.


Usage Guidelines

The show ip source binding command output shows the dynamically and statically configured bindings in the DHCP snooping binding database. Use the show ip dhcp snooping binding privileged EXEC command to display only the dynamically configured bindings.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ip source binding command:

Switch> show ip source binding
MacAddress          IpAddress        Lease(sec)  Type           VLAN  Interface
--------------      ---------------  ----------  -------------  ----  --------------------
00:00:00:0A:00:0B   11.0.0.1         infinite    static         10    GigabitEthernet0/1
00:00:00:0A:00:0A   11.0.0.2         10000       dhcp-snooping  10    GigabitEthernet0/1

Related Commands

Command
Description

ip dhcp snooping binding

Configures the DHCP snooping binding database.

ip source binding

Configures static IP source bindings on the switch.


show ip verify source

Use the show ip verify source user EXEC command to display the IP source guard configuration on the switch or on a specific interface.

show ip verify source [interface interface-id] [ | {begin | exclude | include} expression]

Syntax Description

interface interface-id

(Optional) Display IP source guard configuration on a specific interface.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(50)SE

This command was introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ip verify source command:

Switch> show ip verify source
Interface  Filter-type  Filter-mode  IP-address       Mac-address     Vlan
---------  -----------  -----------  ---------------  --------------  ---------
gi0/1      ip           active       10.0.0.1                         10
gi0/1      ip           active       deny-all                         11-20
gi0/2      ip           inactive-trust-port
gi0/3      ip           inactive-no-snooping-vlan
gi0/4      ip-mac       active       10.0.0.2         aaaa.bbbb.cccc  10
gi0/4      ip-mac       active       11.0.0.1         aaaa.bbbb.cccd  11
gi0/4      ip-mac       active       deny-all         deny-all        12-20
gi0/5      ip-mac       active       10.0.0.3         permit-all      10
gi0/5      ip-mac       active       deny-all         permit-all      11-20

In the previous example, this is the IP source guard configuration:

On the Gigabit Ethernet 1 interface, DHCP snooping is enabled on VLANs 10 to 20. For VLAN 10, IP source guard with IP address filtering is configured on the interface, and a binding exists on the interface. For VLANs 11 to 20, the second entry shows that a default port access control lists (ACLs) is applied on the interface for the VLANs on which IP source guard is not configured.

The Gigabit Ethernet 2 interface is configured as trusted for DHCP snooping.

On the Gigabit Ethernet 3 interface, DHCP snooping is not enabled on the VLANs to which the interface belongs.

On the Gigabit Ethernet 4 interface, IP source guard with source IP and MAC address filtering is enabled, and static IP source bindings are configured on VLANs 10 and 11. For VLANs 12 to 20, the default port ACL is applied on the interface for the VLANs on which IP source guard is not configured.

On the Gigabit Ethernet 5 interface, IP source guard with source IP and MAC address filtering is enabled and configured with a static IP binding, but port security is disabled. The switch cannot filter source MAC addresses.

This is an example of output on an interface on which IP source guard is disabled:

Switch> show ip verify source gigabitethernet 0/6 
IP source guard is not configured on the interface gi0/6.

Related Commands

Command
Description

ip verify source

Enables IP source guard on an interface.


show ipv6 mld snooping

Use the show ipv6 mld snooping user EXEC command to display IP version 6 (IPv6) Multicast Listener Discovery (MLD) snooping configuration of the switch or the VLAN.

show ipv6 mld snooping [vlan vlan-id] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image. A Catalyst 2960 switch must also have the dual IPv4 and IPv6 Switch Database Management (SDM) template configured (not required on Catalyst 2960-S switches).


Syntax Description

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(40)SE

This command was introduced.


Usage Guidelines

Use this command to display MLD snooping configuration for the switch or for a specific VLAN.

VLAN numbers 1002 through 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in MLD snooping.

To configure the dual IPv4 and IPv6 template, enter the sdm prefer dual-ipv4-and-ipv6 global configuration command and reload the switch (Catalyst 2960 switches only).

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ipv6 mld snooping vlan command. It shows snooping characteristics for a specific VLAN.

Switch> show ipv6 mld snooping vlan 100
Global MLD Snooping configuration:
-------------------------------------------
MLD snooping                  : Enabled
MLDv2 snooping (minimal)      : Enabled
Listener message suppression  : Enabled
TCN solicit query             : Disabled
TCN flood query count         : 2
Robustness variable           : 3
Last listener query count     : 2
Last listener query interval  : 1000
Vlan 100:
--------
MLD snooping                        : Disabled
MLDv1 immediate leave               : Disabled
Explicit host tracking              : Enabled
Multicast router learning mode      : pim-dvmrp
Robustness variable                 : 3
Last listener query count           : 2
Last listener query interval        : 1000

This is an example of output from the show ipv6 mld snooping command. It displays snooping characteristics for all VLANs on the switch.

Switch> show ipv6 mld snooping
Global MLD Snooping configuration:
-------------------------------------------
MLD snooping                  : Enabled
MLDv2 snooping (minimal)      : Enabled
Listener message suppression  : Enabled
TCN solicit query             : Disabled
TCN flood query count         : 2
Robustness variable           : 3
Last listener query count     : 2
Last listener query interval  : 1000

Vlan 1:
--------
MLD snooping                        : Disabled
MLDv1 immediate leave               : Disabled
Explicit host tracking              : Enabled
Multicast router learning mode      : pim-dvmrp
Robustness variable                 : 1
Last listener query count           : 2
Last listener query interval        : 1000

<output truncated>

Vlan 951:
--------
MLD snooping                        : Disabled
MLDv1 immediate leave               : Disabled
Explicit host tracking              : Enabled
Multicast router learning mode      : pim-dvmrp
Robustness variable                 : 3
Last listener query count           : 2
Last listener query interval        : 1000

Related Commands

Command
Description

ipv6 mld snooping

Enables and configures MLD snooping on the switch or on a VLAN.

sdm prefer

Configures an SDM template to optimize system resources based on how the switch is being used.


show ipv6 mld snooping address

Use the show ipv6 mld snooping address user EXEC command to display all or specified IP version 6 (IPv6) multicast address information maintained by Multicast Listener Discovery (MLD) snooping.

show ipv6 mld snooping address [[vlan vlan-id] [ipv6 address]] [vlan vlan-id] [count | dynamic | user] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image. A Catalyst 2960 switch must also have the dual IPv4 and IPv6 Switch Database Management (SDM) template configured (not required on Catalyst 2960-S switches).


Syntax Description

vlan vlan-id

(Optional) Specify a VLAN about which to show MLD snooping multicast address information. The VLAN ID range is 1 to 1001 and 1006 to 4094.

ipv6-multicast-address

(Optional) Display information about the specified IPv6 multicast address. This keyword is only available when a VLAN ID is entered.

count

(Optional) Display the number of multicast groups on the switch or in the specified VLAN.

dynamic

(Optional) Display MLD snooping learned group information.

user

(Optional) Display MLD snooping user-configured group information.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(40)SE

This command was introduced.


Usage Guidelines

Use this command to display IPv6 multicast address information.

You can enter an IPv6 multicast address only after you enter a VLAN ID.

VLAN numbers 1002 through 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in MLD snooping.

Use the dynamic keyword to display information only about groups that are learned. Use the user keyword to display information only about groups that have been configured.

To configure the dual IPv4 and IPv6 template, enter the sdm prefer dual-ipv4-and-ipv6 global configuration command and reload the switch (Catalyst 2960 switches only).

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show snooping address user EXEC command:

Switch> show ipv6 mld snooping address

Vlan Group   Type Version Port List
-------------------------------------------------------------
2    FF12::3 user         Fa0/2, Gi0/2, Gi0/1,Gi0/3

This is an example of output from the show snooping address count user EXEC command:

Switch> show ipv6 mld snooping address count
Total number of multicast groups: 2

This is an example of output from the show snooping address user user EXEC command:

Switch> show ipv6 mld snooping address user
Vlan Group  Type Version Port List
-------------------------------------------------------------
2    FF12::3 user  v2    Fa0/2, Gi0/2, Gi0/1,Gi0/3

Related Commands

Command
Description

ipv6 mld snooping vlan

Configures IPv6 MLD snooping on a VLAN.

sdm prefer

Configures an SDM template to optimize system resources based on how the switch is being used.


show ipv6 mld snooping mrouter

Use the show ipv6 mld snooping mrouter user EXEC command to display dynamically learned and manually configured IP version 6 (IPv6) Multicast Listener Discovery (MLD) router ports for the switch or a VLAN.

show ipv6 mld snooping mrouter [vlan vlan-id] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image. A Catalyst 2960 switch must also have the dual IPv4 and IPv6 Switch Database Management (SDM) template configured (not required on Catalyst 2960-S switches).


Syntax Description

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)SED

This command was introduced.


Usage Guidelines

Use this command to display MLD snooping router ports for the switch or for a specific VLAN.

VLAN numbers 1002 through 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in MLD snooping.

To configure the dual IPv4 and IPv6 template, enter the sdm prefer dual-ipv4-and-ipv6 global configuration command and reload the switch (Catalyst 2960 switches only).

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ipv6 mld snooping mrouter command. It displays snooping characteristics for all VLANs on the switch that are participating in MLD snooping.

Switch> show ipv6 mld snooping mrouter
Vlan    ports
----    -----
   2    Gi0/11(dynamic)
  72    Gi0/11(dynamic)
 200    Gi0/11(dynamic)
 
   

This is an example of output from the show ipv6 mld snooping mrouter vlan command. It shows multicast router ports for a specific VLAN.

Switch> show ipv6 mld snooping mrouter vlan 100
Vlan    ports
----    -----
   2    Gi0/11(dynamic)

Related Commands

Command
Description

ipv6 mld snooping

Enables and configures MLD snooping on the switch or on a VLAN.

ipv6 mld snooping vlan mrouter interface interface-id | static ipv6-multicast-address interface interface-id]

Configures multicast router ports for a VLAN.

sdm prefer

Configures an SDM template to optimize system resources based on how the switch is being used.


show ipv6 mld snooping querier

Use the show ipv6 mld snooping querier user EXEC command to display IP version 6 (IPv6) Multicast Listener Discovery (MLD) snooping querier-related information most recently received by the switch or the VLAN.

show ipv6 mld snooping querier [vlan vlan-id] [detail] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image. A Catalyst 2960 switch must also have the dual IPv4 and IPv6 Switch Database Management (SDM) template configured (not required on Catalyst 2960-S switches).


Syntax Description

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.

detail

(Optional) Display MLD snooping detailed querier information for the switch or for the VLAN.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(40)SE

This command was introduced.


Usage Guidelines

Use the show ipv6 mld snooping querier command to display the MLD version and IPv6 address of a detected device that sends MLD query messages, which is also called a querier. A subnet can have multiple multicast routers but has only one MLD querier. The querier can be a Layer 3 switch.

The show ipv6 mld snooping querier command output also shows the VLAN and interface on which the querier was detected. If the querier is the switch, the output shows the Port field as Router. If the querier is a router, the output shows the port number on which the querier is learned in the Port field.

The output of the show ipv6 mld snoop querier vlan command displays the information received in response to a query message from an external or internal querier. It does not display user-configured VLAN values, such as the snooping robustness variable on the particular VLAN. This querier information is used only on the MASQ message that is sent by the switch. It does not override the user-configured robustness variable that is used for aging out a member that does not respond to query messages.

VLAN numbers 1002 through 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in MLD snooping.

To configure the dual IPv4 and IPv6 template, enter the sdm prefer dual-ipv4-and-ipv6 global configuration command and reload the switch (Catalyst 2960 switches only).

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ipv6 mld snooping querier command:

Switch> show ipv6 mld snooping querier
Vlan      IP Address               MLD Version Port
-------------------------------------------------------------
2         FE80::201:C9FF:FE40:6000 v1          Gi0/1

This is an example of output from the show ipv6 mld snooping querier detail command:

Switch> show ipv6 mld snooping querier detail
Vlan      IP Address               MLD Version Port
-------------------------------------------------------------
2         FE80::201:C9FF:FE40:6000 v1          Gi0/1

This is an example of output from the show ipv6 mld snooping querier vlan command:

Switch> show ipv6 mld snooping querier vlan 2
IP address : FE80::201:C9FF:FE40:6000 
MLD version : v1
Port : Gi0/1
Max response time : 1000s

Related Commands

Command
Description

ipv6 mld snooping

Enables and configures IPv6 MLD snooping on the switch or on a VLAN.

ipv6 mld snooping last-listener-query-count

Configures the maximum number of queries that the switch sends before aging out an MLD client.

ipv6 mld snooping last-listener-query-interval

Configures the maximum response time after sending out a query that the switch waits before deleting a port from the multicast group.

ipv6 mld snooping robustness-variable

Configures the maximum number of queries that the switch sends before aging out a multicast address when there is no response.

sdm prefer

Configures an SDM template to optimize system resources based on how the switch is being used.

ipv6 mld snooping

Enables and configures IPv6 MLD snooping on the switch or on a VLAN.


show ipv6 route updated

Use the show ipv6 route updated command in user EXEC command to display the current contents of the IPv6 routing table.

show ipv6 route [protocol] updated [boot-up]{hh:mm | day{month [hh:mm]} [{hh:mm | day{month [hh:mm]}] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image.


Syntax Description

protocol

(Optional) Displays routes for the specified routing protocol using any of these keywords:

bgp

isis

ospf

rip

or displays routes for the specified type of route using any of these keywords:

connected

local

static

interface interface id

boot-up

Display the current contents of the IPv6 routing table.

hh:mm

Enter the time as a 2-digit number for a 24-hour clock. Make sure to use the colons (:). For example, enter 13:32

day

Enter the day of the month. The range is from 1 to 31.

month

Enter the month in upper case or lower case letters. You can enter the full name of the month, such as January or august, or the first three letters of the month, such as jan or Aug.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(40)SE

This command was introduced.


Usage Guidelines

Use the show ipv6 route privileged EXEC command to display the current contents of the IPv6 routing table.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show ipv6 route updated rip command.

Switch> show ipv6 route rip updated
IPv6 Routing Table - 12 entries
Codes: C - Connected, L - Local, S - Static, U - Per-user Static route
B - BGP, R - RIP, I1 - ISIS L1, I2 - ISIS L2
IA - ISIS interarea, IS - ISIS summary
O - OSPF Intra, OI - OSPF Inter, OE1 - OSPF ext 1, OE2 - OSPF ext 2
ON1 - OSPF NSSA ext 1, ON2 - OSPF NSSA ext 2
R 2001::/64 [120/2]
via FE80::A8BB:CCFF:FE00:8D01, GigabitEthernet0/1
Last updated 10:31:10 27 February 2007
R 2004::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet0/2
Last updated 17:23:05 22 February 2007
R 4000::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet0/3
Last updated 17:23:05 22 February 2007
R 5000::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet0/4
Last updated 17:23:05 22 February 2007
R 5001::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet0/5
Last updated 17:23:05 22 February 2007

Related Commands

Command
Description

show ipv6 route

Displays the current contents of the IPv6 routing table.


show lacp

Use the show lacp user EXEC command to display Link Aggregation Control Protocol (LACP) channel-group information.

show lacp [channel-group-number] {counters | internal | neighbor | sys-id} [ | {begin | exclude | include} expression]

Syntax Description

channel-group-number

(Optional) Number of the channel group. The range is 1 to 6.

counters

Display traffic information.

internal

Display internal information.

neighbor

Display neighbor information.

sys-id

Display the system identifier that is being used by LACP. The system identifier is made up of the LACP system priority and the switch MAC address.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

You can enter any show lacp command to display the active channel-group information. To display specific channel information, enter the show lacp command with a channel-group number.

If you do not specify a channel group, information for all channel groups appears.

You can enter the channel-group-number option to specify a channel group for all keywords except sys-id.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show lacp counters user EXEC command. Table 2-34 describes the fields in the display.

Switch> show lacp counters
               LACPDUs         Marker      Marker Response    LACPDUs
Port         Sent   Recv     Sent   Recv     Sent   Recv      Pkts Err
---------------------------------------------------------------------
Channel group:1
Gi0/1        19     10       0      0        0      0         0     
Gi0/2        14     6        0      0        0      0         0     
 
   

Table 2-34 show lacp counters Field Descriptions 

Field
Description

LACPDUs Sent and Recv

The number of LACP packets sent and received by a port.

Marker Sent and Recv

The number of LACP marker packets sent and received by a port.

Marker Response Sent and Recv

The number of LACP marker response packets sent and received by a port.

LACPDUs Pkts and Err

The number of unknown and illegal packets received by LACP for a port.


This is an example of output from the show lacp internal command:

Switch> show lacp 1 internal 
Flags:  S - Device is requesting Slow LACPDUs
        F - Device is requesting Fast LACPDUs
        A - Device is in Active mode       P - Device is in Passive mode 

Channel group 1
                              LACP port     Admin     Oper    Port     Port
Port        Flags   State     Priority      Key       Key     Number   State
Gi0/1       SA      bndl      32768         0x3       0x3     0x4      0x3D  
Gi0/2       SA      bndl      32768         0x3       0x3     0x5      0x3D  
 
   

Table 2-35 describes the fields in the display:

Table 2-35 show lacp internal Field Descriptions 

Field
Description

State

State of the specific port. These are the allowed values:

- —Port is in an unknown state.

bndl—Port is attached to an aggregator and bundled with other ports.

susp—Port is in a suspended state; it is not attached to any aggregator.

hot-sby—Port is in a hot-standby state.

indiv—Port is incapable of bundling with any other port.

indep—Port is in an independent state (not bundled but able to switch data traffic. In this case, LACP is not running on the partner port).

down—Port is down.

LACP Port Priority

Port priority setting. LACP uses the port priority to put ports s in standby mode when there is a hardware limitation that prevents all compatible ports from aggregating.

Admin Key

Administrative key assigned to this port. LACP automatically generates an administrative key value as a hexadecimal number. The administrative key defines the ability of a port to aggregate with other ports. A port's ability to aggregate with other ports is determined by the port physical characteristics (for example, data rate and duplex capability) and configuration restrictions that you establish.

Oper Key

Runtime operational key that is being used by this port. LACP automatically generates this value as a hexadecimal number.

Port Number

Port number.

Port State

State variables for the port, encoded as individual bits within a single octet with these meanings:

bit0: LACP_Activity

bit1: LACP_Timeout

bit2: Aggregation

bit3: Synchronization

bit4: Collecting

bit5: Distributing

bit6: Defaulted

bit7: Expired

Note In the list above, bit7 is the MSB and bit0 is the LSB.


This is an example of output from the show lacp neighbor command:

Switch> show lacp neighbor 
Flags:  S - Device is sending Slow LACPDUs F - Device is sending Fast LACPDUs
        A - Device is in Active mode       P - Device is in Passive mode     

Channel group 3 neighbors

Partner's information:

          Partner               Partner                     Partner
Port      System ID             Port Number     Age         Flags
Gi0/1     32768,0007.eb49.5e80  0xC              19s        SP
 
   
          LACP Partner         Partner         Partner
          Port Priority        Oper Key        Port State
          32768                0x3             0x3C

Partner's information:

          Partner               Partner                     Partner
Port      System ID             Port Number     Age         Flags
Gi0/2     32768,0007.eb49.5e80  0xD              15s        SP
 
   
          LACP Partner         Partner         Partner
          Port Priority        Oper Key        Port State
          32768                0x3             0x3C

This is an example of output from the show lacp sys-id command:

Switch> show lacp sys-id 
32765,0002.4b29.3a00

The system identification is made up of the system priority and the system MAC address. The first two bytes are the system priority, and the last six bytes are the globally administered individual MAC address associated to the system.

Related Commands

Command
Description

clear lacp

Clears the LACP channel-group information.

lacp port-priority

Configures the LACP port priority.

lacp system-priority

Configures the LACP system priority.


show lldp

The show lldp command is documented at http://www.cisco.com/en/US/docs/ios/cether/command/reference/ce_04.html#wp1095571.

show location

Use the show location user EXEC command to display location information for an endpoint.

show location admin-tag | [ | {begin | exclude | include} expression]

show location civic-location {identifier id number | interface interface-id | static} | {begin | exclude | include} expression]

show location elin-location {identifier id number | interface interface-id | static} | {begin | exclude | include} expression]

Syntax Description

admin-tag

Display administrative tag or site information.

civic-location

Display civic location information.

elin-location

Display emergency location information (ELIN).

identifier id

Specify the ID for the civic location or the elin location. The id range is 1 to 4095.

interface interface-id

(Optional) Display location information for the specified interface or all interfaces. Valid interfaces include physical ports.

static

Display static configuration information.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)FX

This command was introduced.


Usage Guidelines

Use the show location command to display location information for an endpoint.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

This is an example of output from the show location civic-location command that displays location information for an interface:

Switch> show location civic interface gigibitethernet0/1 
Civic location information
--------------------------
Identifier              : 1
County                  : Santa Clara
Street number           : 3550
Building                : 19
Room                    : C6
Primary road name       : Cisco Way
City                    : San Jose
State                   : CA
Country                 : US

This is an example of output from the show location civic-location command that displays all the civic location information:

Switch> show location civic-location static
Civic location information
--------------------------
Identifier              : 1
County                  : Santa Clara
Street number           : 3550
Building                : 19
Room                    : C6
Primary road name       : Cisco Way
City                    : San Jose
State                   : CA
Country                 : US
Ports                   : Gi0/1 
--------------------------
Identifier              : 2
Street number           : 24568
Street number suffix    : West
Landmark                : Golden Gate Bridge
Primary road name       : 19th Ave
City                    : San Francisco
Country                 : US
--------------------------

This is an example of output from the show location elin-location command that displays the 
emergency location information:

Switch> show location elin-location identifier 1
Elin location information
--------------------------
Identifier : 1
Elin       : 14085553881
Ports      : Gi0/2 

This is an example of output from the show location elin static command that displays all emergency 
location information:

Switch> show location elin static 
Elin location information
--------------------------
Identifier : 1
Elin       : 14085553881
Ports      : Gi0/2 
--------------------------
Identifier : 2
Elin       : 18002228999
--------------------------

Related Commands

Command
Description

location (global configuration)

Configures the global location information for an endpoint.

location (interface configuration)

Configures the location information for an interface.


show logging onboard

To display the on-board failure logging (OBFL) information, use the show logging onboard privileged EXEC command.

show logging onboard [module [switch-number]] {{clilog | environment | message | poe | temperature | uptime | voltage} [continuous | detail | summary] [start hh:mm:ss day month year] [end hh:mm:ss day month year]} [ | {begin | exclude | include} expression]


Note This command is supported only on Catalyst 2960-S switches running the LAN base image.


Syntax Description

module [switch-number]

(Optional) Display OBFL information about the specified switches.

Use the switch-number parameter to specify the switch number, which is the stack member number. If the switch is a standalone switch, the switch number is 1. If the switch is in a stack, the range is 1 to 8, depending on the switch member numbers in the stack.

For more information about this parameter, see the "Usage Guidelines" section for this command.

clilog

Display the OBFL CLI commands that were entered on the standalone switch or specified stack members.

environment

Display the unique device identifier (UDI) information for the standalone switch or specified stack members and for all the connected FRU devices: the product identification (PID), the version identification (VID), and the serial number.

message

Display the hardware-related system messages generated by the standalone switch or specified stack members.

poe

Display the power consumption of PoE ports on the standalone switch or specified stack members.

temperature

Display the temperature of the standalone switch or specified stack members.

uptime

Display the time when the standalone switch or specified stack members start, the reason the standalone switch or specified members restart, and the length of time the standalone switch or specified stack members have been running since they last restarted.

voltage

Display the system voltages of the standalone switch or the specified switch stack members.

continuous

(Optional) Display the data in the continuous file.

summary

(Optional) Display the data in the summary file.

start hh:mm:ss day month year

(Optional) Display the data from the specified time and date. For more information, see the "Usage Guidelines" section.

end hh:mm:ss day month year

(Optional) Display the data up to the specified time and date. For more information, see the "Usage Guidelines" section.

detail

(Optional) Display both the continuous and summary data.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Default

There is no default.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(53)SE1

This command was introduced.


Usage Guidelines

When OBFL is enabled, the switch records OBFL data in a continuous file that contains all of the data. The continuous file is circular. When the continuous file is full, the switch combines the data into a summary file, which is also known as a historical file. Creating the summary file frees up space in the continuous file so that the switch can write newer data to it.

If you enter the module keyword but do not enter the switch number, the switch displays OBFL information about the stack members that support OBFL.

Use the start and end keywords to display data collected only during a particular time period. When specifying the start and end times, follow these guidelines:

hh:mm:ss—Enter the time as a 2-digit number for a 24-hour clock. Make sure to use the colons (:). For example, enter 13:32:45.

day—Enter the day of the month. The range is from 1 to 31.

month—Enter the month in upper case or lower case letters. You can enter the full name of the month, such as January or august, or the first three letters of the month, such as jan or Aug.

year—Enter the year as a 4-digit number, such as 2008. The range is from 1993 to 2035.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show logging onboard clilog continuous command:

Switch# show logging onboard clilog continuous
--------------------------------------------------------------------------------
CLI LOGGING CONTINUOUS INFORMATION
--------------------------------------------------------------------------------
MM/DD/YYYY HH:MM:SS COMMAND
--------------------------------------------------------------------------------
05/12/2006 15:33:17 show logging onboard temperature detail
05/12/2006 15:33:21 show logging onboard voltage detail
05/12/2006 15:33:32 show logging onboard poe detail
05/12/2006 16:14:09 show logging onboard temperature summary
...
<output truncated>
....
05/16/2006 13:07:53 no hw-module module logging onboard message level
05/16/2006 13:16:13 show logging onboard uptime continuous
05/16/2006 13:39:18 show logging onboard uptime summary
05/16/2006 13:45:57 show logging onboard clilog summary
--------------------------------------------------------------------------------

This is an example of output from the show logging onboard message command:

Switch# show logging onboard message
--------------------------------------------------------------------------------
ERROR MESSAGE SUMMARY INFORMATION
--------------------------------------------------------------------------------
Facility-Sev-Name      | Count | Persistence Flag
MM/DD/YYYY HH:MM:SS
--------------------------------------------------------------------------------
No historical data to display
--------------------------------------------------------------------------------

This is an example of output from the show logging onboard poe continuous end 01:01:00 jan 2000 command on a switch:

Switch# show logging onboard poe continuous end 01:01:00 1 jan 2000

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

POE CONTINUOUS INFORMATION

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

Sensor | ID |

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

Gi1/0/1 1

Gi1/0/2 2

Gi1/0/3 3

Gi1/0/4 4

...

<output truncated>

...

Gi1/0/21 21

Gi1/0/22 22

Gi1/0/23 23

Gi1/0/24 24


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

Time Stamp |Sensor Watts

MM/DD/YYYY HH:MM:SS | Gi1/0/1 Gi1/0/2 Gi1/0/3 Gi1/0/4 Gi1/0/5 Gi1/0/6 Gi1/0/7 Gi1/0/8 Gi1/0/9 Gi1/0/10 Gi1/0/11 Gi1/0/12 Gi1/0/13 Gi1/0/14 Gi1/0/15 Gi1/0/16 Gi1/0/17 Gi1/0/18 Gi1/0/19 Gi1/0/20 Gi1/0/21 Gi1/0/22 Gi1/0/23 Gi1/0/24

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

03/01/1993 00:04:03 0.000 0.000 0.000 0.000 0.000 0.000 0.0 00 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0. 000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000

03/01/1993 00:05:03 0.000 1.862 0.000 1.862 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000

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


This is an example of output from the show logging onboard status command:

Switch# show logging onboard status 
Devices registered with infra
                 Slot no.: 0 Subslot no.: 0, Device obfl0: 
Application name clilog : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name environment : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name errmsg : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name poe : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name temperature : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name uptime : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name voltage : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled

This is an example of output from the show logging onboard temperature continuous command:

Switch# show logging onboard temperature continuous
--------------------------------------------------------------------------------
TEMPERATURE CONTINUOUS INFORMATION
--------------------------------------------------------------------------------
Sensor                            |   ID  |
--------------------------------------------------------------------------------
Board temperature                        1

--------------------------------------------------------------------------------
       Time Stamp   |Sensor Temperature 0C
MM/DD/YYYY HH:MM:SS |  1    2    3    4    5    6    7    8    9   10   11   12
--------------------------------------------------------------------------------
05/12/2006 15:33:20   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 16:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 17:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 18:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 19:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 20:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 21:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 22:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 23:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 00:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 01:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 02:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 03:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 04:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 05:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 06:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 07:25:24   36   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 08:25:24   35   --   --   --   --   --   --   --   --   --   --   --
<output truncated>

This is an example of output from the show logging onboard uptime summary command:

Switch# show logging onboard uptime summary
--------------------------------------------------------------------------------
UPTIME SUMMARY INFORMATION
--------------------------------------------------------------------------------
First customer power on : 03/01/1993 00:03:50
Total uptime            :   0 years   0 weeks   3 days  21 hours  55 minutes
Total downtime          :   0 years   0 weeks   0 days   0 hours   0 minutes
Number of resets        : 2
Number of slot changes  : 1
Current reset reason    : 0x0
Current reset timestamp : 03/01/1993 00:03:28
Current slot            : 1
Current uptime          :   0 years   0 weeks   0 days   0 hours  55 minutes
--------------------------------------------------------------------------------
Reset  |        |
Reason | Count  |
--------------------------------------------------------------------------------
No historical data to display
--------------------------------------------------------------------------------

This is an example of output from the show logging onboard voltage summary command:

Switch# show logging onboard voltage summary
--------------------------------------------------------------------------------
VOLTAGE SUMMARY INFORMATION
--------------------------------------------------------------------------------
Number of sensors          : 8
Sampling frequency         : 60 seconds
Maximum time of storage    : 3600 minutes
--------------------------------------------------------------------------------
Sensor                            |   ID  | Maximum Voltage
--------------------------------------------------------------------------------
12.00V                              0      12.567
5.00V                               1       5.198
3.30V                               2       3.439
2.50V                               3       2.594
1.50V                               4       1.556
1.20V                               5       1.239
1.00V                               6       0.980
0.75V                               7       0.768
--------------------------------------------------------------------------------
Nominal Range                         Sensor ID

--------------------------------------------------------------------------------
No historical data to display
--------------------------------------------------------------------------------

Related Commands

Command
Description

clear logging onboard

Removes the OBFL data in the flash memory.

hw-module [switch-number] logging onboard

Enables OBFL.


show link state group

Use the show link state group privileged EXEC command to display the link-state group information.

show link state group [number] [detail] [ | {begin | exclude | include} expression]


Note To use this command, the switch must be running the LAN Base image.


Syntax Description

number

(Optional) Number of the link-state group.

detail

(Optional) Specify that detailed information appears.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Defaults

There is no default.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)SEE

This command was introduced.


Usage Guidelines

Use the show link state group command to display the link-state group information. Enter this command without keywords to display information about all link-state groups. Enter the group number to display information specific to the group.

Enter the detail keyword to display detailed information about the group. The output for the show link state group detail command displays only those link-state groups that have link-state tracking enabled or that have upstream or downstream interfaces (or both) configured. If there is no link-state group configuration for a group, it is not shown as enabled or disabled.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show link state group 1 command:

Switch> show link state group 1
Link State Group: 1      Status: Enabled, Down

This is an example of output from the show link state group detail command:

Switch> show link state group detail
(Up):Interface up   (Dwn):Interface Down   (Dis):Interface disabled

Link State Group: 1 Status: Enabled, Down 
Upstream Interfaces : Gi0/15(Dwn) Gi0/16(Dwn) 
Downstream Interfaces : Gi0/11(Dis) Gi0/12(Dis) Gi0/13(Dis) Gi0/14(Dis)

Link State Group: 2 Status: Enabled, Down 
Upstream Interfaces : Gi0/15(Dwn) Gi0/16(Dwn) Gi0/17(Dwn) 
Downstream Interfaces : Gi0/11(Dis) Gi0/12(Dis) Gi0/13(Dis) Gi0/14(Dis)

(Up):Interface up (Dwn):Interface Down (Dis):Interface disabled

Related Commands

Command
Description

link state group

Configures an interface as a member of a link-state group.

link state track

Enables a link-state group.

show running-config

Displays the current operating configuration.


show logging onboard

Use the show logging onboard privileged EXEC command to display the on-board failure logging (OBFL) information.

show logging onboard [module [switch-number]] {{clilog | environment | message | poe | temperature | uptime | voltage} [continuous | detail | summary] [start hh:mm:ss day month year] [end hh:mm:ss day month year]} [ | {begin | exclude | include} expression]


Note This command is supported only on Catalyst 2960-S switches running the LAN Base image.


Syntax Description

module [switch-number]

(Optional) Display OBFL information about the specified switches.

Use the switch-number parameter to specify the switch number, which is the stack member number. If the switch is a standalone switch, the switch number is 1. If the switch is in a stack, the range is 1 to 8, depending on the switch member numbers in the stack.

For more information about this parameter, see the "Usage Guidelines" section for this command.

clilog

Display the OBFL CLI commands that were entered on the standalone switch or specified stack members.

environment

Display the unique device identifier (UDI) information for the standalone switch or specified stack members and for all the connected FRU devices: the product identification (PID), the version identification (VID), and the serial number.

message

Display the hardware-related system messages generated by the standalone switch or specified stack members.

poe

Display the power consumption of PoE ports on the standalone switch or specified stack members.

temperature

Display the temperature of the standalone switch or specified stack members.

uptime

Display the time when the standalone switch or specified stack members start, the reason the standalone switch or specified members restart, and the length of time the standalone switch or specified stack members have been running since they last restarted.

voltage

Display the system voltages of the standalone switch or the specified switch stack members.

continuous

(Optional) Display the data in the continuous file.

summary

(Optional) Display the data in the summary file.

start hh:mm:ss day month year

(Optional) Display the data from the specified time and date. For more information, see the "Usage Guidelines" section.

end hh:mm:ss day month year

(Optional) Display the data up to the specified time and date. For more information, see the "Usage Guidelines" section.

detail

(Optional) Display both the continuous and summary data.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Default

There is no default.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(53)SE1

This command was introduced.


Usage Guidelines

When OBFL is enabled, the switch records OBFL data in a continuous file that contains all of the data. The continuous file is circular. When the continuous file is full, the switch combines the data into a summary file, which is also known as a historical file. Creating the summary file frees up space in the continuous file so that the switch can write newer data to it.

If you enter the module keyword but do not enter the switch number, the switch displays OBFL information about the stack members that support OBFL.

Use the start and end keywords to display data collected only during a particular time period. When specifying the start and end times, follow these guidelines:

hh:mm:ss—Enter the time as a 2-digit number for a 24-hour clock. Make sure to use the colons (:). For example, enter 13:32:45.

day—Enter the day of the month. The range is from 1 to 31.

month—Enter the month in upper case or lower case letters. You can enter the full name of the month, such as January or august, or the first three letters of the month, such as jan or Aug.

year—Enter the year as a 4-digit number, such as 2008. The range is from 1993 to 2035.

Expressions are case sensitive. For example, if you enterexclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This is an example of output from the show logging onboard clilog continuous command:

Switch# show logging onboard clilog continuous
--------------------------------------------------------------------------------
CLI LOGGING CONTINUOUS INFORMATION
--------------------------------------------------------------------------------
MM/DD/YYYY HH:MM:SS COMMAND
--------------------------------------------------------------------------------
05/12/2006 15:33:17 show logging onboard temperature detail
05/12/2006 15:33:21 show logging onboard voltage detail
05/12/2006 15:33:32 show logging onboard poe detail
05/12/2006 16:14:09 show logging onboard temperature summary
...
<output truncated>
....
05/16/2006 13:07:53 no hw-module module logging onboard message level
05/16/2006 13:16:13 show logging onboard uptime continuous
05/16/2006 13:39:18 show logging onboard uptime summary
05/16/2006 13:45:57 show logging onboard clilog summary
--------------------------------------------------------------------------------

This is an example of output from the show logging onboard message command:

Switch# show logging onboard message
--------------------------------------------------------------------------------
ERROR MESSAGE SUMMARY INFORMATION
--------------------------------------------------------------------------------
Facility-Sev-Name      | Count | Persistence Flag
MM/DD/YYYY HH:MM:SS
--------------------------------------------------------------------------------
No historical data to display
--------------------------------------------------------------------------------

This is an example of output from the show logging onboard poe continuous end 01:01:00 jan 2000 command on a switch:

Switch# show logging onboard poe continuous end 01:01:00 1 jan 2000
--------------------------------------------------------------------------------
POE CONTINUOUS INFORMATION
--------------------------------------------------------------------------------
Sensor                            |   ID  |
--------------------------------------------------------------------------------
Gi1/0/1                                  1
Gi1/0/2                                  2
Gi1/0/3                                  3
Gi1/0/4                                  4
...
<output truncated>
...
Gi1/0/21                                21
Gi1/0/22                                22
Gi1/0/23                                23
Gi1/0/24                                24

--------------------------------------------------------------------------------
       Time Stamp   |Sensor Watts
MM/DD/YYYY HH:MM:SS |  Gi1/0/1  Gi1/0/2  Gi1/0/3  Gi1/0/4  Gi1/0/5  Gi1/0/6  Gi1/0/7  Gi1/0/8  Gi1/0/9  
Gi1/0/10 Gi1/0/11 Gi1/0/12 Gi1/0/13 Gi1/0/14 Gi1/0/15 Gi1/0/16 Gi1/0/17 Gi1/0/18 Gi1/0/19 Gi1/0/20 Gi1/0/21 
Gi1/0/22 Gi1/0/23 Gi1/0/24
--------------------------------------------------------------------------------
03/01/1993 00:04:03    0.000    0.000    0.000    0.000    0.000    0.000    0.0 00    0.000    0.000    
0.000    0.000    0.000    0.000    0.000    0.000    0. 000    0.000    0.000    0.000    0.000    0.000    
0.000    0.000    0.000 
03/01/1993 00:05:03    0.000    1.862    0.000    1.862    0.000    0.000    0.000    0.000    0.000    0.000    
0.000    0.000    0.000    0.000    0.000    0.000    0.000    0.000    0.000    0.000    0.000    0.000    
0.000    0.000
--------------------------------------------------------------------------------

This is an example of output from the show logging onboard status command:

Switch# show logging onboard status 
Devices registered with infra
                 Slot no.: 0 Subslot no.: 0, Device obfl0: 
Application name clilog : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name environment : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name errmsg : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name poe : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name temperature : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name uptime : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled
Application name voltage : 
                 Path : obfl0:
                 CLI enable status  : enabled
                 Platform enable status: enabled

This is an example of output from the show logging onboard temperature continuous command:

Switch# show logging onboard temperature continuous
--------------------------------------------------------------------------------
TEMPERATURE CONTINUOUS INFORMATION
--------------------------------------------------------------------------------
Sensor                            |   ID  |
--------------------------------------------------------------------------------
Board temperature                        1

--------------------------------------------------------------------------------
       Time Stamp   |Sensor Temperature 0C
MM/DD/YYYY HH:MM:SS |  1    2    3    4    5    6    7    8    9   10   11   12
--------------------------------------------------------------------------------
05/12/2006 15:33:20   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 16:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 17:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 18:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 19:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 20:31:21   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 21:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 22:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/12/2006 23:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 00:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 01:29:22   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 02:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 03:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 04:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 05:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 06:27:23   35   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 07:25:24   36   --   --   --   --   --   --   --   --   --   --   --
05/13/2006 08:25:24   35   --   --   --   --   --   --   --   --   --   --   --
<output truncated>

This is an example of output from the show logging onboard uptime summary command:

Switch# show logging onboard uptime summary
--------------------------------------------------------------------------------
UPTIME SUMMARY INFORMATION
--------------------------------------------------------------------------------
First customer power on : 03/01/1993 00:03:50
Total uptime            :   0 years   0 weeks   3 days  21 hours  55 minutes
Total downtime          :   0 years   0 weeks   0 days   0 hours   0 minutes
Number of resets        : 2
Number of slot changes  : 1
Current reset reason    : 0x0
Current reset timestamp : 03/01/1993 00:03:28
Current slot            : 1
Current uptime          :   0 years   0 weeks   0 days   0 hours  55 minutes
--------------------------------------------------------------------------------
Reset  |        |
Reason | Count  |
--------------------------------------------------------------------------------
No historical data to display
--------------------------------------------------------------------------------

This is an example of output from the show logging onboard voltage summary command:

Switch# show logging onboard voltage summary
--------------------------------------------------------------------------------
VOLTAGE SUMMARY INFORMATION
--------------------------------------------------------------------------------