Catalyst 3750 Metro Switch Command Reference, Release 12.2(58)SE
Catalyst 3750 Metro Switch Cisco IOS Commands - rmon collection stats through show
Downloads: This chapterpdf (PDF - 1.64MB) The complete bookPDF (PDF - 19.75MB) | Feedback

rmon collection stats

Table Of Contents

rmon collection stats

sdm prefer

service instance

service password-recovery

service-policy (interface configuration)

service-policy (policy-map class)

set

setup

setup express

shape

show access-lists

show archive status

show arp access-list

show auto qos

show boot

show class-map

show controllers cpu-interface

show controllers ethernet-controller

show controllers tcam

show cpu traffic qos

show dot1q-tunnel

show dot1x

show dtp

show env

show errdisable detect

show errdisable flap-values

show errdisable recovery

show etherchannel

show ethernet service evc

show ethernet service instance

show ethernet service interface

show interfaces

show interfaces counters

show interfaces rep

show interfaces transceiver

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 sla standards

show ip sla twamp connection

show ip sla twamp session

show ip source binding

show ip verify source

show ipv6 dhcp conflict

show ipv6 mld snooping

show ipv6 mld snooping address

show ipv6 mld snooping mrouter

show ipv6 mld snooping querier

show ipv6 route updated

show l2protocol-tunnel

show lacp

show link state group

show location

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 multicast

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 mpls l2transport vc

show mvr

show mvr interface

show mvr members

show pagp

show parser macro

show policy-map

show port-security

show rep topology

show sdm prefer

show setup express

show spanning-tree

show storm-control

show system mtu

show udld

show version

show vlan

show vlan access-map

show vlan filter

show vmps

show vtp


rmon collection stats

Use the rmon collection stats interface configuration command to collect Ethernet group statistics, which include utilization 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.



Note Though visible in the command-line help, the rmon native and rmon promiscuous commands are not supported.


Defaults

The RMON statistics collection is disabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.1(14)AX

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 on a port:

Switch(config)# interface gigabitethernet1/0/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.

For syntax information, select Cisco IOS Configuration Fundamentals Command Reference, Release 12.2 > System Management Commands > RMON Commands.


sdm prefer

Use the sdm prefer global configuration command to configure the template used in the 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. Use a template to provide maximum system utilization for routing or for VLAN configuration or to select the dual IPv4 and IPv6 template to support IPv6 forwarding. Use the no form of this command to return to the default template.

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

no sdm prefer

Syntax Description

default

Set the switch to use the default template to balance resources among features.

dual-ipv4-and-ipv6 {default | routing | vlan}

Select a template that supports both IPv4 and IPv6 routing.

default—Provide balance to IPv4 and IPv6 Layer 2 and Layer 3 functionality.

routing—Provide maximum system usage for IPv4 and IPv6 routing, including IPv4 policy-based routing.

vlan—Provide maximum system usage for IPv4 and IPv6 VLANs.

routing

Provide maximum system utilization for unicast routing. You would typically use this template for a router or aggregator in the middle of a network.

Note This template does not support policy-based routing.

vlan

Provide maximum system utilization for VLANs. This template maximizes system resources for use as a Layer 2 switch with no routing.


Defaults

The default template provides a balance to all features.

Command Modes

Global configuration

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(25)EY

The routing-pbr keywords for configuring the policy-based routing template were removed. This template is no longer required for policy-based routing.

12.2(52)SE

The dual-ipv4-and-ipv6 templates were added.


Usage Guidelines

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

Use the sdm prefer vlan global configuration command only on switches intended for Layer 2 switching with no routing. When you use the VLAN template, no system resources are reserved for routing entries, and any routing is done through software. This overloads the CPU and severely degrades routing performance.

Do not use the routing template if you do not have routing enabled on your switch. Entering the sdm prefer routing 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 templates if you do not plan to enable IPv6 routing on the switch. Entering the sdm prefer ipv4-and-ipv6 {default | routing | vlan} global configuration command divides resources between IPv4 and IPv6, limiting those allocated to IPv4 forwarding.

Table 2-17 lists the approximate number of each resource supported in each of the three templates for a switch. The first eight rows in the tables (unicast MAC addresses through security access control entries [ACEs]) represent approximate hardware boundaries set when you select a template. If a section of a hardware resource is full, all processing overflow is sent to the CPU, seriously impacting switch performance. The last row is a guideline used to calculate hardware resource consumption related to the other resource parameters.

.

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

Resource
Templates
Default
Routing
VLAN

Unicast MAC addresses

6 K

3 K

12 K

Internet Group Management Protocol (IGMP) groups and multicast routes

1 K

1 K

1 K

Unicast routes

8 K

11 K

0

Directly connected hosts

6 K

3 K

0

Indirect routes

2 K

8 K

0

Policy-based routing ACEs

0

512

0

Quality of service (QoS) classification ACEs

512

512

512

Security ACEs

1 K

1 K

1 K

Layer 2 VLANs

1 K

1 K

1 K


Table 2-18 lists the approximate number of each resource supported in each of the dual IPv4-and IPv6 templates for a switch.

Table 2-18 Approximate Feature Resources Allowed by Dual IPv4-IPv6 Templates 

Resource
Default
Routing
VLAN

Unicast MAC addresses

2 K

1536

8 K

IPv4 IGMP groups and multicast routes

1 K

1K

1 K

Total IPv4 unicast routes:

3 K

2816

0

Directly connected IPv4 hosts

2 K

1536

0

Indirect IPv4 routes

1 K

1280

0

IPv6 multicast groups

1 K

1152

1 K

Total IPv6 unicast routes:

3 K

2816

0

Directly connected IPv6 addresses

2 K

1536

0

Indirect IPv6 unicast routes

1 K

1280

0

IPv4 policy-based routing ACEs

0

256

0

IPv4 or MAC QoS ACEs (total)

512

512

512

IPv4 or MAC security ACEs (total)

1 K

512

1 K

IPv6 policy-based routing ACEs1

0

255

0

IPv6 QoS ACEs

510

510

510

IPv6 security ACEs

510

510

510

1 IPv6 policy-based routing is not supported in this release.


Examples

This example shows how to configure the routing template on a switch:

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

This example shows how to change a switch template to the default template.

Switch(config)# sdm prefer default
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 instance

Use the service instance interface configuration command to configure an Ethernet service instance on the interface and to enter Ethernet service configuration mode. Use the no form of this command to delete the service instance.

service instance id ethernet [evc-id]

no service instance id

Syntax Description

id

Define a service instance identifier, a per-interface service identifier that does not map to a VLAN. The range is 1 to 4294967295.

ethernet

Identify the service instance as an Ethernet instance.

evc-id

(Optional) Attach an Ethernet virtual connection (EVC) to the service instance.


Defaults

No Ethernet service instances are defined.

Command Modes

Interface configuration

Command History

Release
Modification

12.2(25)SEG

This command was introduced.


Usage Guidelines

After you enter the service instance id ethernet command, the switch enters Ethernet service configuration mode, and these configuration commands are available:

default: sets the service instance to its default state.

ethernet lmi ce-vlan map: configures Ethernet Local Management Interface (LMI) parameters. See the ethernet lmi ce-vlan map command.

exit: exits EVC configuration mode and returns to global configuration mode.

no: negates a command or returns a command to its default setting.

Examples

This example shows how to define an Ethernet service instance and to enter Ethernet service configuration mode for EVC test:

Switch(config-if)# service instance 333 ethernet test
Switch(config-if-srv)#

Related Commands

Command
Description

show ethernet service instance

Displays information about configured Ethernet service instances.


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 boot 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 boot 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.1(14)AX

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 goes 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)?
 
   

If the user chooses not to reset the system back to the default configuration, the normal boot process continues, as if the Mode button had not been pressed. If you choose to reset the system back to the default configuration, the configuration file in flash memory is deleted, and the VLAN database file, flash:vlan.dat (if present), is deleted.


Note 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 to default values. Do not keep a backup copy of the config file on the switch.

If the switch is operating in VLAN Trunking Protocol (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 (interface configuration)

Use the service-policy interface configuration command to apply a policy map defined by the policy-map command to a port or a switch virtual interface (SVI). Use the no form of this command to remove the policy map and port association.

service-policy {input | output} policy-map-name

no service-policy {input | output} policy-map-name

Syntax Description

input policy-map-name

Apply the specified single-level ingress policy map to a standard or to an enhanced-services (ES) port.

Apply the specified hierarchical policy map to the input of an enhanced-services (ES) port or Etherchannel made of ES ports.

output policy-map-name

Apply the specified single-level or hierarchical policy map to the output of an ES port or EtherChannel.



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


Defaults

No policy maps are attached to the port.

Command Modes

Interface configuration

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(25)EY

Hierarchical service policies can be attached to inbound or outbound traffic on an ES port. Nonhierarchical dual-level service policies can attached to inbound traffic received on a switch virtual interface (SVI).

12.2(25)SE

Hierarchical service policies can be attached to an EtherChannel with no ports or with one or both ES ports


Usage Guidelines

Only one policy map per port is supported. With standard QoS, you can attach one nonhierarchical service policy to the input of a standard physical port, to an SVI, or to an ES port. You can also attach one ingress hierarchical dual-level service policy per SVI. With hierarchical QoS, you can attach one ingress hierarchical service policy and one egress hierarchical service policy per ES port. You can also attach a hierarchical service policy to an EtherChannel with no ports or with one or both ES ports

Use the service-policy output policy-map-name command only in an egress policy map attached to an ES port. You cannot apply an egress policy to a standard port.

In software releases earlier than Cisco IOS Release 12.2(25)EY, policy maps can be configured only on physical ports. In Cisco IOS Release 12.2(25)EY or later, policy maps can be configured on physical ports or on SVIs. When VLAN-based quality of service (QoS) is disabled by using the no mls qos vlan-based interface configuration command on a physical port, you can configure a port-based policy map on the port. If VLAN-based QoS is enabled by using the mls qos vlan-based interface configuration command on a physical port, the switch removes the previously configured port-based policy map. After a dual-level policy map is configured and applied on an SVI, the interface-level policy map takes effect on the interface.

In software releases earlier than Cisco IOS Release 12.2(25)EY, you can apply a policy map only to the input of a physical port. In Cisco IOS Release 12.2(25)EY or later, you can apply a policy map to the input of a physical port or an SVI.

In Cisco IOS Release 12.2(35)SE or later, you can attach a hierarchical policy map to an EtherChannel made of ES ports.

When applying an ingress nonhierarchical policy map to a physical interface or an SVI or when applying an egress hierarchical policy map to a ES 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. However, if you are applying an ingress hierarchical policy to an ES port that includes the set policy-map class configuration command or policing actions in a two-rate policer, the switch automatically applies a port trust state to the ES port. For example, if you configure the set cos new-cos command, the switch automatically configures the interface to trust CoS.

You can attach single-level policy maps as input policies on a standard ports or as input or output policies on ES ports. You cannot apply a single-level policy map to an egress standard port.

You can attach hierarchical policy maps as input or output policies on ES ports or ES EtherChannels. You cannot attach hierarchical policy maps to standard ports.

In releases earlier than Cisco IOS Release 12.2(35)SE, the switch does not support attaching a service policy to a logical interface (such as an EtherChannel). In these releases, you must configure quality of service (QoS) classification, policing, mapping, and queueing on the individual physical ports that comprise the EtherChannel. In Cisco IOS Release 12.2(35) or later, you can configure hierarchical policy maps on EtherChannels made of ES ports

Examples

This example shows how to apply a policy map to the input of a standard port:

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

This example shows how to apply a policy map to the output of an ES port:

Switch(config)# interface gigabitethernet1/1/1
Switch(config-if)# service-policy output plcmap3
 
   

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 operating configuration. For syntax information, use this link to the Cisco IOS Release 12.2 Command Reference listing page: http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/prod_command_reference_list.html
Select the Cisco IOS Commands Master List, Release 12.2 to navigate to the command.


service-policy (policy-map class)

Use the service-policy policy-map class configuration command to create a service policy that is a quality of service (QoS) policy within a policy map (called a hierarchical service policy). Use the no form of this command to disable the service policy within a policy map.

service-policy policy-map-name

no service-policy policy-map-name

Syntax Description

policy-map-name

Name of the policy map.


Defaults

No service policies maps are defined.

Command Modes

Policy-map class configuration

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(25)EY

Hierarchical service policies can be attached to inbound traffic received on an ES port or a switch virtual interface (SVI).


Usage Guidelines

Use the service-policy command only in a hierarchical policy map attached to an enhanced-services (ES) port. This command is valid in policy maps at any level of the hierarchy.

You can create a hierarchy by associating a class-level policy map with a VLAN-level policy map, by associating that VLAN-level policy map with a physical-level policy map, and by attaching the physical-level policy map to an ES port. You can omit hierarchical levels, but the order of the levels (class level, VLAN level, and then the physical level) must be preserved.

If you use the bandwidth policy-map class configuration command in a child policy, you also must use it in the parent policy.

If you enter this command in policy-map class configuration mode, you return to policy-map configuration mode by using the exit command. To return to privileged EXEC mode, use the end command.

Examples

This example shows how to create a hierarchical service policy in the service policy called parent:

Switch(config)# policy-map child 
Switch(config-pmap)# class voice 
Switch(config-pmap-c)# priority 
Switch(config-pmap-c)# exit 
Switch(config-pmap)# exit 
Switch(config)# policy-map parent 
Switch(config-pmap)# class class1
Switch(config-pmap-c)# shape average 10000000 
Switch(config-pmap-c)# service-policy child 

This example shows how to create a hierarchical service policy in which all levels are present. This configuration associates a class-level policy map with a VLAN-level policy map, associates the VLAN-level policy map with a physical-level policy map, and attaches the physical-level policy map to a port.

Switch(config)# class-map my-class
Switch(config-cmap)# match ip precedence 1
Switch(config-cmap)# exit
Switch(config)# class-map my-logical-class
Switch(config-cmap)# match vlan 5
Switch(config-cmap)# exit
Switch(config)# policy-map my-class-policy
Switch(config-pmap)# class my-class
Switch(config-pmap-c)# set precedence 2
Switch(config-pmap-c)# exit
Switch(config-pmap)# exit
Switch(config)# policy-map my-logical-policy
Switch(config-pmap)# class my-logical-class
Switch(config-pmap-c)# shape average 400000000
Switch(config-pmap-c)# service-policy my-class-policy
Switch(config-pmap-c)# exit
Switch(config-pmap)# exit
Switch(config)# policy-map my-physical-policy
Switch(config-pmap)# class class-default
Switch(config-pmap-c)# shape average 500000000
Switch(config-pmap-c)# service-policy my-logical-policy
Switch(config-pmap-c)# exit
Switch(config-pmap)# exit
Switch(config)# interface gigabitethernet1/1/1
Switch(config)# service-policy input my-physical-policy
 
   

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

Related Commands

Command
Description

bandwidth

Specifies or modifies the minimum bandwidth provided to a class belonging to a policy map attached to an ES port.

class

Specifies the name of the class whose traffic policy you want to create or change.

policy-map

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

priority

Enables the strict-priority queue and gives priority to a class of traffic belonging to a policy map attached to an ES port.

queue-limit

Configures the maximum threshold for tail drop in a policy map attached to an ES port.

random-detect

Configures Weighted Random Early Detection (WRED) in a policy map attached to an ES port.

shape

Enables traffic shaping in a policy map attached to an ES port.

show policy-map

Displays QoS policy maps.


set

Use the set policy-map class configuration command to classify IP traffic by setting a class of service (CoS), a Differentiated Services Code Point (DSCP), an IP-precedence, or the multiprotocol label switching (MPLS) experimental (EXP) bits in the packet. Use the no form of this command to remove the traffic classification.

set {cos new-cos | [ip] {dscp new-dscp | precedence new-precedence} | mpls experimental exp-number}

no set cos new-cos | ip {dscp new-dscp | precedence new-precedence} | mpls experimental exp-number}

Syntax Description

cos new-cos

New CoS value assigned to the classified traffic. The range is 0 to 7.

ip 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. The specified value sets the type of service (ToS) byte in the packet header.

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. The specified value sets the precedence bit in the IP header.

mpls experimental exp-number

New MPLS experimental value assigned to the classified traffic. The range is 0 to 7. The specified value sets the MPLS experimental 3-bit field in the packet header.


Defaults

No traffic classification is defined.

Command Modes

Policy-map class configuration

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(25)EY

Hierarchical service policies can be attached to inbound traffic received on an ES port.


Usage Guidelines

You can use the set command only in class-level classes.

The set dscp new-dscp and the set precedence new-precedence commands are the same as the set ip dscp new-dscp and the set ip precedence new-precedence commands.

For the set dscp new-dscp or the set 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 as same entering the set dscp 10 command. You can enter the set precedence critical command, which is the same as entering the set precedence 5 command. For a list of supported mnemonics, enter the set dscp ? or the set precedence ? command to see the command-line help strings.

You can configure the set cos new-cos, set dscp new-dscp, set precedence new-precedence, or the set mpls experimental exp-number command in an ingress and an egress policy map attached to an enhanced-services (ES) port. You can configure only the set dscp new-dscp or the set precedence new-precedence command in an ingress nonhierarchical policy map attached to an standard SVI or an ES port.

If an ingress hierarchical policy map includes set cos new-cos, the set dscp new-dscp, or the set precedence new-precedence command, the switch automatically applies the port trust state to the ES port. The switch applies the port trust state to all inbound traffic on the ES port, including traffic that does not match the traffic class. For example, if you enter the set cos new-cos command, the switch automatically configures the interface to trust CoS.

In an ingress policy map, you cannot combine Layer 2 and Layer 3 set actions because the port can trust only one value in the inbound packet. For example, the switch does not support this policy map:

policy-map p1
   class cos1
      police cir per 10 conform-action set-cos-transmit 3
      set dscp af22
 
   

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 create a policy map called p1 with CoS values assigned to different traffic types. Class maps for voice and video-data have already been created.

Switch(config)# policy-map p1
Switch(config-pmap)# class voice
Switch(config-pmap-c)# set cos 1
Switch(config-pmap)# exit
Switch(config-pmap)# class video-data
Switch(config-pmap-c)# set cos 2
Switch(config-pmap)# exit
 
   

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

Related Commands

Command
Description

class

Specifies the name of the class whose traffic policy you want to create or change.

policy-map

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

show policy-map

Displays quality of service (QoS) policy maps.

trust

Defines a trust state for traffic class.


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.1(14)AX

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

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, return to the setup program without saving, or return to the command-line prompt without saving the configuration.

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 [<Use current 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? [yes]: yes
    Community string [public]: 
 
   
Current interface summary
 
   
Interface                  IP-Address      OK? Method Status                Prol
Vlan1                      10.1.2.3        YES NVRAM  up                    up 
Vlan100                    unassigned      YES NVRAM  down                  down 
Vlan150                    unassigned      YES NVRAM  down                  down 
Vlan901                    unassigned      YES NVRAM  down                  down
FastEthernet1/0/1          unassigned      YES unset  up                    up 
FastEthernet1/0/2          111.1.1.1       YES NVRAM  up                    up 
 
   
<output truncated>
 
   
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
    Class A network is 10.0.0.0, 8 subnet bits; mask is /8
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$ZzDa$X8ic4TpKggQ5wOgQ/xqdz1
enable password enable-password
line vty 0 15
password terminal-password
snmp-server community public
!
no ip routing
 
   
!
interface Vlan1
no shutdown
ip address 10.1.2.3 255.0.0.0
!
interface Vlan100
shutdown
no ip address
!
interface Vlan150
shutdown
no ip address
!
interface Vlan901
shutdown
no ip address
!
interface FastEthernet1/0/1
!
interface FastEthernet1/0/2
shutdown
no ip address
!
 
   
<output truncated>
 
   
cluster enable cluster-name
!
end
 
   
 
   
[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 operating configuration. For syntax information, use this link to the Cisco IOS Release 12.2 Command Reference listing page: http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/prod_command_reference_list.html
Select the Cisco IOS Commands Master List, Release 12.2 to navigate to the command.

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.1(14)AX

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 with the CLI-based setup program.

When you press the Mode button for 2 seconds on a configured switch, the LEDs next to 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 mode LEDs 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 if Express Setup mode is not enabled on the switch.

Related Commands

Command
Description

show setup express

Displays if Express Setup mode is active.


shape

Use the shape policy-map class configuration command to enable traffic shaping in a hierarchical policy map attached to an enhanced-services (ES) port. Traffic shaping limits the data transmission rate. Use the no form of this command to return to the default setting.

shape average cir-bps

no shape average

Syntax Description

average

Enable average-rate traffic shaping.

cir-bps

Committed information rate, the bit rate that traffic is shaped to, in bps. This is the access bit rate that you contract with your service provider or the service levels that you intend to maintain. The range is 64000 to 2000000000 bps.

Allocate the shaped rate in 100-kbps increments; otherwise, the software rounds down the rate to the nearest 100-kbps increment.


Defaults

Average-rate traffic shaping is disabled.

Command Modes

Policy-map class configuration

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(25)EY

Hierarchical service policies can be attached to inbound traffic received on an ES port.


Usage Guidelines

Use the shape command only in a hierarchical policy map attached to an ES port. This command is valid in policy maps at any level of the hierarchy.

Shaping is the process of delaying out-of-profile packets in queues so that they conform to a specified profile. Shaping is distinct from policing. Policing drops packets that exceed a configured threshold, but shaping buffers packets so that traffic remains within the threshold. Shaping offers greater smoothness in handling traffic than policing.

You must configure the bandwidth or the shape policy-map class configuration command before you configure either the queue-limit or the random-detect policy-map class configuration command in a class policy.

You cannot use the bandwidth, queue-limit, random-detect, and the shape policy-map class configuration commands with the priority policy-map class configuration command in the same class within the same policy map. However, you can use these commands in the same policy map.

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

The switch follows these rules when allocating bandwidth for VLAN-level and class-level classes:

Shaping restricts the bandwidth available to VLAN-level classes. The shaping rate configured in the physical-level policy map becomes the total bandwidth available to all VLAN-level classes.

For VLAN-level and class-level classes, the shaping rate becomes the available bandwidth if the bandwidth is not specified for that class.

For VLAN-level and class-level classes, the shaping rate must be greater or equal to the bandwidth allocated at that level.

The total bandwidth for VLAN-level classes, including the class-default, cannot exceed the available bandwidth of the port.

The total bandwidth for class-level classes, including the class-default, cannot exceed the available bandwidth at the parent VLAN level.

At the VLAN level and at the class level, the configured bandwidth is summed for all the children. If the summed bandwidth is less than the available bandwidth for the parent, the remaining bandwidth is distributed equally among the children.

Examples

This example shows how to limit the specified traffic class to a data transmission rate of 256 kbps:

Switch(config)# policy-map policy1
Switch(config-pmap)# class class1
Switch(config-pmap-c)# shape average 256000
Switch(config-pmap-c)# exit
Switch(config-pmap)# exit
Switch(config)# interface gigabitethernet1/1/1
Switch(config-if)# service-policy output policy1
 
   

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

Related Commands

Command
Description

bandwidth

Specifies or modifies the minimum bandwidth provided to a class belonging to a policy map attached to an ES port.

class

Specifies the name of the class whose traffic policy you want to create or change.

policy-map

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

priority

Enables the strict-priority queue and gives priority to a class of traffic belonging to a policy map attached to an ES port.

queue-limit

Configures the maximum threshold for tail drop in a policy map attached to an ES port.

random-detect

Configures Weighted Random Early Detection (WRED) in a policy map attached to an ES port.

service-policy (policy-map class)

Creates a service policy as a quality of service (QoS) policy within a policy map.

show policy-map

Displays QoS policy maps.


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]

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.



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.1(14)AX

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.

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: 0
     Drop:                All bytes count: 0
     Bridge Only:         All frame count: 0
     Bridge Only:         All bytes count: 0
     Forwarding To CPU:   All frame count: 0
     Forwarding To CPU:   All bytes count: 0
 
   
 L3 ACL INPUT Statistics 
     Drop:                All frame count: 0
     Drop:                All bytes count: 0
     Bridge Only:         All frame count: 0
     Bridge Only:         All bytes count: 0
     Forwarding To CPU:   All frame count: 0
     Forwarding To CPU:   All bytes count: 0
     Forwarded:           All frame count: 0
     Forwarded:           All bytes count: 0
     Drop And Log:        All frame count: 0
     Drop And Log:        All bytes count: 0
     Bridge Only And Log: All frame count: 0
     Bridge Only And Log: All bytes count: 0
     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
     Bridge Only:         All frame count: 61
     Bridge Only:         All bytes count: 3904
     Forwarding To CPU:   All frame count: 0
     Forwarding To CPU:   All bytes count: 0
 
   
<output truncated>

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

Switch# show access-lists ipc
 LC Access List Config Updates Rcvd
 Standard Access Lists rcvd       : 0
 Simple Named Access Lists rcvd   : 0
 Extended Access Lists rcvd       : 0
 Extended Named Access Lists rcvd : 0
 Rate-Limit Access Lists rcvd     : 0
 Delete one Access List rcvd      : 0

Related Commands

Command
Description

access-list

Configures a standard or extended numbered access list on the switch. For syntax information, select Cisco IOS IP Command Reference, Volume 1 of 3:Addressing and Services, Release 12.2 > IP Services Commands.

ip access list

Configures a named IP access list on the switch. For syntax information, select Cisco IOS IP Command Reference, Volume 1 of 3:Addressing and Services, Release 12.2 > IP Services Commands.

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 TFTP protocol.

show archive status

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)EY

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.

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 (ACLs).

show arp access-list [acl-name]

This command is available only if your switch is running the enhanced multilayer image (EMI).

Syntax Description

acl-name

(Optional) Name of the ACL.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced.


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 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 auto qos

Use the show auto qos user EXEC command to display the initial configuration that is generated by the automatic quality of service (auto-QoS) feature.

show auto qos [interface [interface-id]]

Syntax Description

interface [interface-id]

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


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

In releases earlier than Cisco IOS Release 12.2(25)EY, the show auto qos [interface [interface-id]] command output shows the initial generated auto-QoS configuration.

In Cisco IOS Release 12.2(25)EY or later, 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.

On an enhanced-services (ES) port, the srr-queue bandwidth shape interface configuration command is not part of the generated auto qos voip command list.

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 
GigabitEthernet1/0/1
auto qos voip cisco-softphone
 
   
GigabitEthernet1/0/2
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 1/0/1
GigabitEthernet1/0/1
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
!
...
!
interface GigabitEthernet1/0/1
 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
 srr-queue bandwidth shape  10  0  0  0
 auto qos voip cisco-softphone
!
interface GigabitEthernet1/0/2
 switchport mode access
 switchport port-security maximum 1999
 speed 100
 duplex full
 srr-queue bandwidth share 10 10 60 20
 srr-queue bandwidth shape  10  0  0  0
 mls qos trust device cisco-phone
 mls qos trust cos
 auto qos voip cisco-phone
!
<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 fastethernet1/0/2
FastEthernet1/0/2
auto qos voip cisco-phone
 
   

These are examples 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
 
   

These are examples of output from the show auto qos interface interface-id command when auto-QoS is disabled on an interface:

Switch> show auto qos interface gigabitethernet1/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

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

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

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

Table 2-19 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.

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 the first bootable file that it can find in the flash file system.

Config file

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

Private Config file

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

Enable Break

Displays whether a break during booting is enabled or disabled. If it is set to yes, on, or 1, you can interrupt the automatic boot 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. If it is set to no or 0, the boot loader attempts to automatically boot the system. If it is set to anything else, you must manually boot the switch from the boot loader mode.

Helper path-list

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



Note Though visible in the display, the Auto upgrade field is not supported.


Related Commands

Command
Description

boot config-file

Specifies the filename that the software 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 the switch during the next boot cycle.

boot private-config-file

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

boot system

Specifies the image to load during the next boot cycle.


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]

Syntax Description

class-map-name

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


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


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 for a class map.


show controllers cpu-interface

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

show controllers cpu-interface

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

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

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-port send and receive statistics read from the hardware. Use with the phy keyword to display the port internal registers or the port-asic keyword to display information about the port application-specific integrated circuit (ASIC).

show controllers ethernet-controller [[interface-id] [phy [detail] | port-asic {configuration | statistics}]

Syntax Description

interface-id

The physical port (including type, 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 port. This display includes the operational state of the automatic medium-dependent-interface crossover (Auto-MDIX) feature on a port.

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.


Command Modes

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

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

This display without keywords provides traffic statistics, basically the Remote Network Monitoring (RMON) statistics for all ports or for the specified port.

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

Examples

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

Switch# show controllers ethernet-controller gigabitethernet1/0/1
 
   
  Transmit GigabitEthernet1/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
 
   

This is an example of output from the show controllers ethernet-controller phy command for a specific port. Note that the last line of the display shows the Auto-MDIX setting for the port.

Switch# show controllers ethernet-controller fastethernet1/0/3 phy
 
   
 Control Register                      :  0011 0001 0000 0000
 Control STATUS                        :  0111 1000 0000 1001
 Phy ID 1                              :  0000 0000 0001 0011
 Phy ID 2                              :  0111 1000 1111 1011
 Auto-Negotiation Advertisement        :  0000 0011 1110 0001
 Auto-Negotiation Link Partner         :  0000 0000 0000 0000
 Auto-Negotiation Expansion Reg        :  0000 0000 0000 0100
 Next Page Transmit Register           :  0010 0000 0000 0001
 Link Partner Next page Rx Regi        :  0000 0000 0000 0000
 Port Configuration Register           :  0000 0001 1010 0100
 Port Status Register                  :  0000 0001 0000 0000
 Interrupt Enable Register             :  1010 0000 0000 0000
 Interrupt Status Register             :  0000 0000 0101 0100
 LED Configuration Register            :  1001 1001 1001 0000
 Trim Enable Register                  :  0000 1101 0000 0000
 Auto-MDIX                             :  Off   [AdminState=0   Flags=0x00002248
 
   

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
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 boot

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) and TCAM ASICs.


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 port application-specific integrated circuits (ASICs) that are CAM controllers.

show controllers tcam [asic [number]] [detail]

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.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

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

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-port send and receive statistics read from the hardware or the port internal registers.


show cpu traffic qos

Use the show cpu traffic qos command in user EXEC mode to display the QoS marking values for CPU-generated traffic.

show cpu traffic qos

Syntax Description

This command has no arguments or keywords.

Defaults

Displays the QoS marking values for all CPU-generated traffic.

Command Modes

User EXEC

Command History

Release
Modification

12.2(52)SE

This command was introduced.


Examples

The following is sample output from the show cpu traffic qos command:

CPU QoS configuration:

Switch(config)# cpu traffic qos cos 2
Switch(config)# cpu traffic qos dscp 40

Show command:

Switch> show cpu traffic qos
QOS - CPU Generated Traffic
---------------------------
Set parameter-type
----------------------------------------------
Cos                 trust
DSCP                dscp-mutation map1
Precedence          Default
 
   

Related Commands

Command
Description

cpu traffic qos cos

Configures the CoS value for CPU-generated traffic.

cpu traffic qos dscp

Configures the DSCP value for CPU-generated traffic.

cpu traffic qos precedence

Configures the precedence for CPU-generated traffic.

mls qos map

Configures a global map to set CoS, DSCP, and precedence values for CPU-generated traffic.

show mls qos maps

Displays information for all global maps.

show running-config

Displays the configured global maps and CPU traffic QoS settings.


show dot1q-tunnel

Use the show dot1q-tunnel user EXEC command to display information about 802.1Q tunnel ports.

show dot1q-tunnel [interface interface-id]

Syntax Description

interface interface-id

(Optional) Specify the interface for which to display 802.1Q tunneling information. Valid interfaces include physical ports and port channels.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show dot1q-tunnel command:

Switch> show dot1q-tunnel
Port
-----
Gi1/1/1
Gi1/1/2
Po2

Related Commands

Command
Description

show vlan dot1q tag native

Displays 802.1Q native VLAN tagging status.

switchport mode dot1q-tunnel

Configures an interface as an 802.1Q tunnel port.


show dot1x

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

show dot1x [all | interface interface-id | statistics interface interface-id]

Syntax Description

all

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

interface interface-id

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

statistics interface interface-id

(Optional) Display 802.1x statistics for the switch or the specified port (including type, module, and port number).


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

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

Examples

This is an example of output from the show dot1x and the show dot1x all commands:

Switch# show dot1x 
Sysauthcontrol                    = Enabled 
Dot1x Protocol Version            = 1 
Dot1x Oper Controlled Directions  = Both 
Dot1x Admin Controlled Directions = Both 
 
   
Switch# show dot1x all
Dot1x Info for interface FastEthernet1/0/3 
----------------------------------------------------
Supplicant MAC 00d0.b71b.35de
   AuthSM State      = CONNECTING
   BendSM State      = IDLE
PortStatus        = UNAUTHORIZED
MaxReq            = 2 
HostMode          = Single 
Port Control      = Auto
QuietPeriod       = 60 Seconds 
Re-authentication = Disabled 
ReAuthPeriod      = 3600 Seconds
ServerTimeout     = 30 Seconds 
SuppTimeout       = 30 Seconds 
TxPeriod          = 30 Seconds 
Guest-Vlan        = 0 
 
   
Dot1x Info for interface FastEthernet1/0/7 
----------------------------------------------------
PortStatus        = UNAUTHORIZED
MaxReq            = 2 
HostMode          = Multi 
Port Control      = Auto
QuietPeriod       = 60 Seconds 
Re-authentication = Disabled 
ReAuthPeriod      = 3600 Seconds
ServerTimeout     = 30 Seconds 
SuppTimeout       = 30 Seconds 
TxPeriod          = 30 Seconds 
Guest-Vlan        = 0 
 
   

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

Switch# show dot1x interface fastethernet1/0/3
Supplicant MAC 00d0.b71b.35de
   AuthSM State      = AUTHENTICATED
   BendSM State      = IDLE
PortStatus        = AUTHORIZED
MaxReq            = 2 
HostMode          = Single 
Port Control      = Auto
QuietPeriod       = 60 Seconds 
Re-authentication = Disabled 
ReAuthPeriod      = 3600 Seconds
ServerTimeout     = 30 Seconds 
SuppTimeout       = 30 Seconds 
TxPeriod          = 30 Seconds 
Guest-Vlan        = 0 
 
   

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

Switch# show dot1x statistics interface fastethernet1/0/3
PortStatistics Parameters for Dot1x 
--------------------------------------------
TxReqId = 15    TxReq = 0       TxTotal = 15 
RxStart = 4     RxLogoff = 0    RxRespId = 1    RxResp = 1
RxInvalid = 0   RxLenErr = 0    RxTotal= 6
RxVersion = 1   LastRxSrcMac 00d0.b71b.35de 
 
   

Table 2-20 show dot1x statistics Field Descriptions 

Field
Description

TxReqId

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

TxReq

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

TxTotal

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

RxStart

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

RxLogoff

Number of EAPOL-logoff frames that have been received.

RxRespId

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

RxResp

Number of valid EAP-response frames (other than 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.

RxVersion

Number of received packets in the 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 configurable 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]

Syntax Description

interface interface-id

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


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


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 interface-id command:

Switch# show dtp interface fastethernet1/0/1
DTP information for FastEthernet1/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, 3160 software encap isl, 0 isl hardware 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 env

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

show env {all | fan | power | rps | temperature}

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 is connected to the switch.

temperature

Display the switch temperature status.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

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

Switch> show env all
FAN is OK
TEMPERATURE is OK
POWER is OK
RPS is NOT PRESENT
 
   

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

Switch> show env fan
FAN is OK
 
   

show errdisable detect

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

show errdisable detect

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(37)SE

The Mode column was added to the output display.


Usage Guidelines

The Mode column shows the shutdown mode that was configured for the error-disabled reason:

port—The physical port is error disabled if a violation occurs.

vlan—The virtual port is disabled if a violation occurs.

port/vlan—Some ports are configured for physical port disable, and others are configured for virtual port disable. Enter the show running config privileged EXEC command to see the configuration for each port.

A displayed gbic-invalid error in the Reason column refers to an invalid small form-factor pluggable (SFP) interface.

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   port
channel-misconfig   Enabled   port
community-limit     Enabled   port
dhcp-rate-limit     Enabled   port
dtp-flap            Enabled   port
gbic-invalid        Enabled   port
invalid-policy      Enabled   port
l2ptguard           Enabled   port
link-flap           Enabled   port
link-monitor-fail   Enabled   port
loopback            Enabled   port
lsgroup             Enabled   port
oam-remote-failur   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

Note Though visible in the output, the dhcp-rate-limit and storm-control fields are not valid.


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 an 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

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

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
 
   

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-disable detection for a specific cause or all causes.

show errdisable detect

Displays error-disable detection status.

show errdisable recovery

Displays error-disable 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-disable recovery timer information.

show errdisable recovery

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

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

Examples

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


Note Though visible, the dhcp-rate-limit and unicast-flood reasons are not supported.


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            Disabled
gbic-invalid         Disabled
psecure-violation    Disabled
gbic-invalid         Disabled
dhcp-rate-limit      Disabled
unicast-flood        Disabled
loopback             Disabled
 
   
Timer interval:300 seconds
 
   
Interfaces that will be enabled at the next timeout:
 
   
Interface    Errdisable reason    Time left(sec)
---------    -----------------    --------------
Fa1/0/4           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 disable 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}

Syntax Description

channel-group-number

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

detail

Display detailed EtherChannel information.

load-balance

Display the load-balance or frame-distribution scheme among interfaces 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.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

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

In the output, the Passive port list field appears only for Layer 3 port channels. The appearance of this field means that the physical port, which is still not up, is configured to be in the channel group (and indirectly is in the only port channel in the channel group).

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
Fa1/0/1   SA      bndl      32768         0x1       0x1     0x101    0x3D
Fa1/0/2   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
 
   
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)
 
   

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
 
   
Time since last port bundled:    01d:20h:24m:44s    Gi1/0/2
 
   

This is an example of output from 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 an interface to manage channeling.

interface port-channel

Accesses or creates the port channel.


show ethernet service evc

Use the show ethernet service evc privileged EXEC command to display information about Ethernet virtual connection (EVC) customer-service instances.

show ethernet service evc [id evc-id | interface interface-id] [detail]

Syntax Description

id evc-id

(Optional) Display EVC information for the specified service. The EVC identifier can be a string of from 1 to 100 characters.

interface interface-id

(Optional) Display EVC information for the specified interface.

detail

(Optional) Display detailed information about EVC service or the specified EVC ID or interface.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)SEG

This command was introduced.


Examples

This is an example of output from the show ethernet service evc command:

Switch# show ethernet service evc
Identifier                     Type  Act-UNI-cnt Status
BLUE                           P-P       2       Active         
PINK                           MP-MP     2       PartiallyActive
PURPLE                         P-P       2       Active         
BROWN                          MP-MP     2       Active         
GREEN                          P-P       3       Active         
YELLOW                         MP-MP     2       PartiallyActive
BANANAS                        P-P       0       InActive       
TEST2                          P-P       0       NotDefined     
ORANGE                         P-P       2       Active         
TEAL                           P-P       0       InActive 

Related Commands

Command
Description

ethernet evc evc-id

Defines an EVC and enters EVC configuration mode.


show ethernet service instance

Use the show ethernet service instance privileged EXEC command to display information about Ethernet customer-service instances.

show ethernet service instance [id id] [interface interface-id] [detail]

Syntax Description

id id

(Optional) Display information for the specified service-instance identifier, a per-interface service identifier that does not map to a VLAN. The range is 1 to 4294967295.

interface interface-id

(Optional) Display service-instance information for the specified interface.

detail

(Optional) Display detailed information about service instances or the specified service-instance ID or interface.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)SEG

This command was introduced.


Examples

This is an example of output from the show ethernet service instance command:

Switch# show ethernet service instance
Identifier Interface               CE-Vlans
222        FastEthernet0/1       untagged,1-4094
10         FastEthernet0/2
222        FastEthernet0/2       200
333        FastEthernet0/2       default
10         FastEthernet0/3       300
11         FastEthernet0/3
10         FastEthernet0/4       300
10         FastEthernet0/6       untagged,1-4094
10         FastEthernet0/7       untagged,1-4094
10         FastEthernet0/8       untagged,1-4094
10         FastEthernet0/9       untagged
20         FastEthernet0/9
222        FastEthernet0/11      300-350,900-999
333        FastEthernet0/11      100-200,1000,1999-4094
222        FastEthernet0/12      20
333        FastEthernet0/12      10
10         FastEthernet0/13      10
20         FastEthernet0/13      20
30         FastEthernet0/13      30
200        FastEthernet0/13      222
200        FastEthernet0/14      200,222
300        FastEthernet0/14      333
555        FastEthernet0/14      555

Related Commands

Command
Description

service instance id ethernet

Defines an Ethernet service instance and enters Ethernet service configuration mode.


show ethernet service interface

Use the show ethernet service interface privileged EXEC command to display interface-based information about Ethernet customer-service instances for all interfaces or a specified interface.

show ethernet service interface [interface-id] [detail]

Syntax Description

interface-id

(Optional) Display service-instance information for the specified interface.

detail

(Optional) Display detailed information about service instances on all interfaces or the specified interface.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)SEG

This command was introduced.


Examples

These are examples of outputs from the show ethernet service interface commands:

Switch# show ethernet service interface gigabitethernet0/1
Interface          Identifier
GigabitEthernet0/1 PE2-G101
 
   
Switch# show ethernet service interface detail
Interface: FastEthernet0/1
ID:
CE-VLANS:
EVC Map Type: Bundling-Multiplexing
Interface: FastEthernet0/2
ID:
CE-VLANS:
EVC Map Type: Bundling-Multiplexing
Interface: FastEthernet0/3
ID:
CE-VLANS:
EVC Map Type: Bundling-Multiplexing
 
   
<output truncated>
 
   
Interface: GigabitEthernet0/1
ID: PE2-G101
CE-VLANS: 10,20,30
EVC Map Type: Bundling-Multiplexing
Associated EVCs:
EVC-ID CE-VLAN
WHITE 30
RED 20
BLUE 10
Associated Service Instances:
Service-Instance-ID CE-VLAN
10 10
20 20
30 30

Related Commands

Command
Description

service instance id ethernet

Defines an Ethernet service instance and enters Ethernet service configuration mode from interface configuration mode.


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 [mtu] | vlan vlan-id] [accounting | capabilities [module number] | counters | description | etherchannel | flowcontrol | pruning | rep | stats | status [err-disabled] | switchport [backup | module number] | [module number] | transceivers | trunk]

Syntax Description

interface-id

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

mtu

(Optional) Display the system maximum transmission unit (MTU) size set on the interface.

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 or switchport configuration characteristics (depending on preceding keyword) of all interfaces on the switch. The range is 1 to 9. This option is not available if you entered a specific interface ID.

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.

rep

(Optional) See the show interfaces rep command.

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 (nonrouting) port, including port blocking and port protection settings.

backup

(Optional) Display Flex Link backup interface configuration and status for the specified interface.

transceivers

(Optional) See the show interfaces transceiver command.

trunk

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



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.1(14)AX

This command was introduced.

12.2(25)EY

The backup, properties, and private-vlan mapping keywords were added.

12.2(25)SEE

Added the backup, counters, detail, and trunk keywords.


Usage Guidelines

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

Entering show interface capabilities module 1displays the capabilities of all interfaces on the switch. If you enter a number other than 1, the output is blank. This keyword is not available if you enter a specific interface ID before the capabilities keyword.

Entering show interfaces interface-id capabilities displays the capabilities of the specified interface.

Entering show interfaces capabilities (with no module number or interface ID) displays the capabilities of all interfaces on the switch.

The vlan mapping option is available only when you have entered any interface-ID or vlan vlan-id; however, the display shows VLAN mapping information only for ES ports.

Examples

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

Switch# show interfaces gigabitethernet0/2 
GigabitEthernet0/2 is up, line protocol is up (connected) (vlan-err-dis)
  Hardware is Gigabit Ethernet, address is 0018.1902.cd02 (bia 0018.1902.cd02)
  MTU 1548 bytes, BW 1000000 Kbit, DLY 10 usec,
     reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
  Keepalive not set
  Full-duplex, 1000Mb/s, link type is auto, media type is 10/100/1000BaseTX
  input flow-control is off, output flow-control is unsupported
  ARP type: ARPA, ARP Timeout 04:00:00
  Last input 00:00:00, output 00:00:00, output hang never
  Last clearing of "show interface" 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
     12112813 packets input, 801716512 bytes, 0 no buffer
     Received 2001806 broadcasts (0 multicasts)
     0 runts, 0 giants, 0 throttles
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
     0 watchdog, 2001806 multicast, 0 pause input
     0 input packets with dribble condition detected
     11935759 packets output, 783067011 bytes, 0 underruns
     0 output errors, 0 collisions, 2 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
GigabitEthernet1/0/2
  Model:                 WS-C3750G-24TS
  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
 
   

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
 
   

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
 
   
Port    Vlans traffic requested of neighbor
Gi1/0/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
Fa1/0/1                      connected    routed     a-half  a-100 10/100BaseTX
Fa1/0/2                      notconnect   121,40       auto   auto 10/100BaseTX
Fa1/0/3                      notconnect   1            auto   auto 10/100BaseTX
Fa1/0/4                      notconnect   18           auto   auto Not Present
Fa1/0/5                      connected    121        a-full a-1000 10/100BaseTX
Fa1/0/6                      connected    122,11     a-full a-1000 10/100BaseTX 
 
   
<output truncated>
Gi1/0/1                      notconnect   1            auto   auto 10/100/1000BaseTX
Gi1/0/2                        connected    vl-err-dis a-full a-1000 10/100/1000BaseTX
 
   

This is an example of output from the show interfaces status err-disabled command for an interface:

Switch# show interfaces gigabitethernet1/0/2 status err-disabled 
 
   
Port      Name               Status       Reason               Err-disabled Vlans
Gi1/0/2                        connected    elmi evc down        1,200
 
   

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


Note Private VLAN trunks 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
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-21 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.


This 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
     --------------------------------------------------------------
     Fa1/0/1             Fa1/0/2             Active Up/Backup Standby
     Fa3/0/3             Fa4/0/5             Active Down/Backup Up
     Po1                 Po2                 Active Standby/Backup Up
 
   

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

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

This is an example of out put from the show interfaces switchport backup command when a Flex Link interface goes down (LINK_DOWN), and VLANs preferred on this interface are moved to the peer interface of the Flex Link pair. In this example, if interface Gi1/0/6 goes down, Gi1/0/8 carries all VLANs of the Flex Link pair.

Switch# show interfaces switchport backup
Switch Backup Interface Pairs:
 
   
Active Interface        Backup Interface        State
------------------------------------------------------------------------
GigabitEthernet1/0/6    GigabitEthernet1/0/8    Active Down/Backup Up
 
   
Vlans Preferred on Active Interface: 1-50
Vlans Preferred on Backup Interface: 60, 100-120
 
   

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 1/0/6
Switch(config-if)# switchport backup interface gigabitEthernet 1/0/8 prefer vlan 
60,100-120
 
   

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

Switch# show interfaces switchport backup
Switch Backup Interface Pairs:
 
   
Active Interface        Backup Interface        State
------------------------------------------------------------------------
GigabitEthernet1/0/6    GigabitEthernet1/0/8    Active Up/Backup Up
 
   
Vlans on Interface Gi 1/0/6: 1-50
Vlans on Interface Gi 1/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 Gi1/0/6 goes down, Gi1/0/8 carries all VLANs of the Flex Link pair.

Switch# show interfaces switchport backup
Switch Backup Interface Pairs:
 
   
Active Interface        Backup Interface        State
------------------------------------------------------------------------
GigabitEthernet1/0/6    GigabitEthernet1/0/8    Active Down/Backup Up
 
   
Vlans on Interface Gi 1/0/6: 
Vlans on Interface Gi 1/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 Gi1/0/6 comes up, then VLANs preferred on this interface are blocked on the peer interface Gi1/0/8 and forwarded on Gi1/0/6.

Switch# show interfaces switchport backup
Switch Backup Interface Pairs:
 
   
Active Interface        Backup Interface        State
------------------------------------------------------------------------
GigabitEthernet1/0/6    GigabitEthernet1/0/8    Active Up/Backup Up
 
   
Vlans on Interface Gi 1/0/6: 1-50
Vlans on Interface Gi 1/0/8: 60, 100-120
 
   

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/1 trunk
Port          Mode         Encapsulation  Status        Native vlan
Gi1/0/1      auto         negotiate      trunking      1
 
   
Port          Vlans allowed on trunk
Gi1/0/1      1-4094
 
   
Port          Vlans allowed and active in management domain
Gi1/0/1      1-4
 
   
Port          Vlans in spanning tree forwarding state and not pruned
Gi1/0/1       1-4
 
   

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]

Syntax Description

interface-id

(Optional) ID of the physical interface, including type, module, and port number.

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 module. The only valid value is 1.

protocol status

(Optional) Display status of protocols enabled on interfaces.

trunk

(Optional) Display trunk counters.



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.1(14)AX

This command was introduced.

12.2(25)EY

The etherchannel and protocol status keywords were added. The broadcast, multicast, and unicast keywords were removed.


Usage Guidelines

If you do not enter any keywords, all counters for all interfaces are included.

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
Gi1/0/1                0             0             0             0
Gi1/0/2                0             0             0             0
 
   
<output truncated>
 
   

This is an example of partial output from the show interfaces counters module command.

Switch# show interfaces counters module 1
Port            InOctets   InUcastPkts   InMcastPkts   InBcastPkts
Fa1/0/1           475256           105          4335           593
Fa1/0/2                0             0             0             0
Fa1/0/3                0             0             0             0
Fa1/0/4                0             0             0             0
Fa1/0/5                0             0             0             0
Fa1/0/6                0             0             0             0
Fa1/0/7                0             0             0             0
Fa1/0/8                0             0             0             0
Fa1/0/9                0             0             0             0
Fa1/0/10               0             0             0             0
Fa1/0/11               0             0             0             0
Fa1/0/12               0             0             0             0
Fa1/0/13         5689160         11548         63746             0
Fa1/0/14         1998856         11547          6092             0
Fa1/0/15         1999304         11548          6095             0
Fa1/0/16         1999752         11547          6099             0
Fa1/0/17         1999496         11547          6097             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
 FastEthernet1/0/1: Other, IP, ARP, CDP
 FastEthernet1/0/2: Other, IP
 FastEthernet1/0/3: Other, IP
 FastEthernet1/0/4: Other, IP
 FastEthernet1/0/5: Other, IP
 FastEthernet1/0/6: Other, IP
 FastEthernet1/0/7: Other, IP
 FastEthernet1/0/8: Other, IP
 FastEthernet1/0/9: Other, IP
 FastEthernet1/0/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
Fa1/0/1                   0              0           0
Fa1/0/2                   0              0           0
Fa1/0/3               80678           4155           0
Fa1/0/4               82320            126           0
Fa1/0/5                  0               0           0
 
   
<output truncated>

Related Commands

Command
Description

show interfaces

Displays additional interface characteristics.


show interfaces rep

Use the show interfaces rep User EXEC command to display Resilient Ethernet Protocol (REP) configuration and status for a specified interface or for all interfaces.

show interfaces [interface-id] rep [detail]

Syntax Description

interface-id

(Optional) Display REP configuration and status for a specified physical interface or port channel ID.

detail

(Optional) Display detailed REP configuration and status information.


Command Modes

User EXEC

Command History

Release
Modification

12.2(40)SE

This command was introduced.


Usage Guidelines

In the output for the show interface rep [detail] command, in addition to an Open, Fail, or AP (alternate port) state, the Port Role might show as Fail Logical Open (FailLogOpen) or Fail No Ext Neighbor (FailNoNbr). These states indicate that the port is physically up, but REP is not configured on the neighboring port. In this case, one port goes into a forwarding state for the data path to help maintain connectivity during configuration. The Port Role for this port shows as Fail Logical Open; the port forwards all data traffic on all VLANs. The other failed Port Role shows as Fail No Ext Neighbor; this port blocks traffic for all VLANs.

When the external neighbors for the failed ports are configured, the failed ports go through the alternate port state transitions and eventually go to an Open state or remain as the alternate port, based on the alternate port election mechanism.

Examples

This is sample output from the show interface rep command:

Switch # show interface rep 
Interface                Seg-id   Type        LinkOp     Role
---------------------- ------ ------------ ----------- ----
GigabitEthernet1/0/1        1    Primary Edge  TWO_WAY    Open
GigabitEthernet1/0/2        1    Edge          TWO_WAY    Open
FastEthernet1/0/4           2                  INIT_DOWN  Fail
 
   

This is sample output from the show interface rep command when external neighbors are not configured:

Switch # show interface rep 
Interface                Seg-id   Type        LinkOp     Role
---------------------- ------ ------------ ----------- ----
GigabitEthernet1/0/1        1                 NO_NEIGHBOR FailNoNbr 
GigabitEthernet1/0/2        2                 NO_NEIGHBOR FailLogOpen
 
   

This is sample output from the show interface rep detail command for a specified interface:

Switch # show interface gigabitethernet1/0/2 rep detail
GigabitEthernet1/0/2   REP enabled
Segment-id: 1 (Segment)
PortID: 00030019E85BDD00
Preferred flag: No
Operational Link Status: INIT_DOWN
Current Key: 00000000000000000000
Port Role: Fail
Blocked VLAN: 1-4094
Admin-vlan: 1
Preempt Delay Timer: disabled
LSL Ageout Timer: 5000 ms
Configured Load-balancing Block Port: 1234567890123456
Configured Load-balancing Block VLAN: 1-4094
STCN Propagate to: none
LSL PDU rx: 0, tx: 0
HFL PDU rx: 0, tx: 0
BPA TLV rx: 0, tx: 0
BPA (STCN, LSL) TLV rx: 0, tx: 0
BPA (STCN, HFL) TLV rx: 0, tx: 0
EPA-ELECTION TLV rx: 0, tx: 0
EPA-COMMAND TLV rx: 0, tx: 0
EPA-INFO TLV rx: 0, tx: 0

Related Commands

Command
Description

rep segment

Enables REP on an interface and assigns a segment ID. This command is also used to configure a port as an edge port, a primary edge port, or a preferred port.

show rep topology [detail]

Displays information about all ports in the segment, including which one was configured and selected as the primary edge port.


 
   

show interfaces transceiver

Use the show interfaces transceiver privileged EXEC command to display the physical properties of a small form-factor pluggable (SFP) module interface.

show interfaces [interface-id] transceiver [detail | module number | properties | supported-list | threshold-table]

Syntax Description

interface-id

(Optional) Display configuration and status for a specified physical interface.

detail

(Optional) Display calibration properties, including high and low numbers and any alarm information for any Digital Optical Monitoring (DoM)-capable transceiver if one is installed in the switch.

module number

(Optional) Limit display to interfaces on module on the switch. The range is 1 to 9. This option is not available if you entered a specific interface ID.

properties

(Optional) Display speed, duplex, and inline power settings on an interface.

supported-list

(Optional) List all supported DoM transceivers.

threshold-table

(Optional) Display alarm and warning threshold table.

Note This keyword displays the thresholds that are programmed in IOS software and are not those used to determine when to send alarms or traps. To view those thresholds, enter the show interfaces transceiver detail command.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced.

12.2(44)SE

The supported-list and threshold-table keywords were added.


Usage Guidelines

The threshold values shown in the outputs from the show interfaces transceiver threshold-table and the show interfaces transceiver detail are not the same. The thresholds shown in the output from the show interfaces transceiver threshold-table command are hard coded in Cisco IOS, but are not supported. The thresholds shown in the output from the show interfaces transceiver detail command are read from the SFP EEPROM and are supported. You should always use the show interfaces transceiver detail command to view transceiver thresholds.

The DOM threshold provides a mechanism to send traps when parameters from the EEPROM exceed the thresholds. The firmware reads real-time values, including temperature, voltage, transmitted power and received power, from the SFP EEPROM and compares them against product alarm and warning thresholds. When transceiver traps are enabled, a trap is sent every 10 minutes when thresholds are exceeded.

The reading of entSensorThresholdTable and SNMP notification upon threshold violations in CISCO-ENTITY-SENSOR-MIB is supported only in Cisco IOS Release 12.2(52)SE and later.

Examples

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

Switch# show interfaces gigabitethernet1/0/1 transceiver properties
Name : Gi1/0/1
Administrative Speed: auto 
Operational Speed: auto 
Administrative Duplex: auto
Administrative Power Inline: enable
Operational Duplex: auto
Administrative Auto-MDIX: off
Operational Auto-MDIX: off
 
   

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

Switch# show interfaces gigabitethernet1/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)
------- ------------------  ----------  ---------  ---------  ---------
Gi1/0/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)
-------  ---------------    ----------  ---------  ---------  ---------
Gi1/0/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)
-------  -----------------  ----------  ---------  ---------  ---------
Gi1/0/3  31.0               84.0        70.0       4.0        2.0
 
   
<output truncated>
 
   

This is an example of output from the show interfaces transceiver supported-list command:

Switch# show interfaces transceiver supported-list  
Transceiver Type           Cisco p/n min version  
                               supporting DOM     
------------------       -------------------------
 
   
   DWDM GBIC                ALL                      
   DWDM SFP                 ALL                      
   RX only WDM GBIC         ALL                      
   DWDM XENPAK              ALL                      
   DWDM X2                  ALL                      
   DWDM XFP                 ALL                      
   CWDM GBIC                NONE                     
   CWDM X2                  ALL                      
   CWDM XFP                 ALL                      
   XENPAK ZR                ALL                      
   X2 ZR                    ALL                      
   XFP ZR                   ALL                      
   Rx_only_WDM_XENPAK       ALL                      
   XENPAK_ER                10-1888-03               
   X2_ER                    ALL                      
   XFP_ER                   ALL                      
   XENPAK_LR                10-1838-04               
   X2_LR                    ALL                      
   <output truncated>
 
   

This is an example of output from the show interfaces transceiver threshold-table command. Note that these are thresholds programmed into IOS software, and are NOT used to determine alarms.

Optical Tx     Optical Rx    Temp     Laser Bias    Voltage 
                                                    current               
             -------------  -------------  ------   ------------  ---------
 
   
 DWDM GBIC
Min1             -0.50        -28.50        0             N/A          4.50      
Min2             -0.30        -28.29        5             N/A          4.75     
Max2              3.29         -6.69        60            N/A          5.25     
Max1              3.50          6.00        70            N/A          5.50     
 DWDM SFP
Min1             -0.50        -28.50        0             N/A          3.00      
Min2             -0.30        -28.29        5             N/A          3.09     
Max2              4.30         -9.50        60            N/A          3.59     
Max1              4.50          9.30        70            N/A          3.70     
 RX only WDM GBIC
Min1              N/A         -28.50        0             N/A          4.50      
Min2              N/A         -28.29        5             N/A          4.75     
Max2              N/A          -6.69        60            N/A          5.25     
Max1              N/A           6.00        70            N/A          5.50     
 DWDM XENPAK
Min1             -1.50        -24.50        0             N/A          N/A       
Min2             -1.29        -24.29        5             N/A          N/A      
Max2              3.29         -6.69        60            N/A          N/A      
Max1              3.50          4.00        70            N/A          N/A      
 DWDM X2
Min1             -1.50        -24.50        0             N/A          N/A       
Min2             -1.29        -24.29        5             N/A          N/A      
Max2              3.29         -6.69        60            N/A          N/A      
Max1              3.50          4.00        70            N/A          N/A      
 DWDM XFP
Min1             -1.50        -24.50        0             N/A          N/A       
Min2             -1.29        -24.29        5             N/A          N/A      
Max2              3.29         -6.69        60            N/A          N/A      
Max1              3.50          4.00        70            N/A          N/A      
 CWDM X2
Min1              N/A           N/A         0             N/A          N/A       
Min2              N/A           N/A         0             N/A          N/A      
Max2              N/A           N/A         0             N/A          N/A      
Max1              N/A           N/A         0             N/A          N/A 

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]

Syntax Description

entity-name

(Optional) Display the specified entity. For example, enter the interface (such as gigabitethernet1/0/1) into which a small form-factor pluggable (SFP) module is installed.

raw

(Optional) Display every entity in the device.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)SEG

This command was introduced.


Usage Guidelines

The command is case sensitive. With no arguments, the show inventory command produces a compact display of all identifiable entities that have a product identifier. The compact display shows the entity location (slot identity), entity description, and the unique device identifier (UDI), including PID, Version Identifier (VID), and Serial Number (SN) of that entity.

If there is no PID, no output appears when you enter the show inventory command.

For the product identifier (PID) and version identifier (VID) of SFP modules, the output of the show inventory user EXEC command displays either the correct information or displays Unspecified for the PID and nothing for the VID if the SFP module does not have PID and VID information.

Examples

This is example output from the show inventory command:

Switch> show inventory
NAME: "1", DESCR: "ME-C3750-24TE"
PID:                   , VID:    , SN:
 
   
NAME: "GigabitEthernet1/1/2", DESCR: "1000BaseSX SFP"
PID:                     , VID:    , SN: A50015093

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]

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.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced.

12.2(37)SE

The output changed to include Probe Logging information.


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
 ---------------  -----------     ----------    --------------
 Gi1/0/1            Untrusted               15                 1
 Gi1/0/2            Untrusted               15                 1
 Gi1/0/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 gigabitethernet1/0/1
 Interface        Trust State     Rate (pps)    Burst Interval
 ---------------  -----------     ----------    --------------
 Gi1/0/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
----------  ----  --------------  ---------------  ---------  -----------  ----
Gi1/0/1       5     0003.0000.d673  192.2.10.4               5  DHCP Deny    19:39:01 UTC 
Mon Mar 1 1993
Gi1/0/1       5     0001.0000.d774  128.1.9.25               6  DHCP Deny    19:39:02 UTC 
Mon Mar 1 1993
Gi1/0/1       5     0001.c940.1111  10.10.10.1               7  DHCP Deny    19:39:03 UTC 
Mon Mar 1 1993
Gi1/0/1       5     0001.c940.1112  10.10.10.2               8  DHCP Deny    19:39:04 UTC 
Mon Mar 1 1993
Gi1/0/1       5     0001.c940.1114  173.1.1.1               10  DHCP Deny    19:39:06 UTC 
Mon Mar 1 1993
Gi1/0/1       5     0001.c940.1115  173.1.1.2               11  DHCP Deny    19:39:07 UTC 
Mon Mar 1 1993
Gi1/0/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

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced.

12.2(25)SEE

The command output was updated to show the global suboption configuration.


Usage Guidelines

This command displays only the results of global configuration. Therefore, in this example, the circuit ID suboption appears in its default format of vlan-mod-port, even if a string is configured for the circuit ID.

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
	circuit-id format: vlan-mod-port
	remote-id format: string
Verification of hwaddr field is enabled
Interface                    Trusted     Rate limit (pps)
------------------------     -------     ----------------
FastEthernet1/0/1             yes         unlimited
FastEthernet1/0/2             yes         unlimited
FastEthernet1/0/3             no          2000 
FastEthernet1/0/4             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]

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.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

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.

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    GigabitEthernet1/0/1
00:D0:B7:1B:35:DE   10.1.2.151       237         dhcp-snooping  20    GigabitEthernet1/0/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    GigabitEthernet1/0/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    GigabitEthernet1/0/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 gigabitethernet1/0/2
MacAddress          IpAddress        Lease(sec)  Type           VLAN  Interface
------------------  ---------------  ----------  -------------  ----  --------------------
00:30:94:C2:EF:35   10.1.2.151       290         dhcp-snooping  20    GigabitEthernet1/0/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    GigabitEthernet1/0/1
00:00:00:00:00:02   10.1.2.151       65          dhcp-snooping  20    GigabitEthernet1/0/2
Total number of bindings: 2
 
   

Table 2-22 describes the fields in the show ip dhcp snooping binding command output:

Table 2-22 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]

Syntax Description

detail

(Optional) Display detailed status and statistics information.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

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 Succeed 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 Succeed 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]

Syntax Description

detail

(Optional) Display detailed statistics information.


Command Modes

User EXEC

Command History

Release
Modification

12.2(37)SE

This command was introduced.


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-23 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.


Table 2-23 shows the DHCP snooping statistics and their descriptions:

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 view all configured Internet Group Management Protocol (IGMP) profiles or a specified IGMP profile.

show ip igmp profile [profile number]

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.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

These are examples of output from the show ip igmp profile 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 privileged 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]

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.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(25)EY

The groups keyword was added. The show ip igmp snooping groups command replaced the show ip igmp snooping multicast command.


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 for IGMP snooping.

Examples

This is an example of output from the show ip igmp snooping command. It shows how to display snooping characteristics for all VLANs on the switch.

Switch# show ip igmp snooping 
vlan 1
----------
 IGMP snooping is globally enabled
 IGMP snooping TCN solicit query is globally disabled
 IGMP snooping global TCN flood query count is 2
 IGMP snooping is enabled on this Vlan 
 IGMP snooping immediate-leave is disabled on this Vlan 
 IGMP snooping mrouter learn mode is pim-dvmrp on this Vlan 
 IGMP snooping source only learning age timer is 10
 IGMP snooping is running in IGMP_ONLY mode on this Vlan
 IGMP snooping report suppression is enabled on this Vlan 
vlan 2
----------
 IGMP snooping is globally enabled
 IGMP snooping TCN solicit query is globally disabled
 IGMP snooping global TCN flood query count is 2
 
   
<output truncated>
 

This is an example of output from the show ip igmp snooping vlan 1 command. It shows how to display snooping characteristics for a specific VLAN.

Switch# show ip igmp snooping vlan 1
vlan 1
----------
 IGMP snooping is globally enabled
 IGMP snooping TCN solicit query is globally disabled
 IGMP snooping global TCN flood query count is 2
 IGMP snooping is enabled on this Vlan 
 IGMP snooping immediate-leave is disabled on this Vlan 
 IGMP snooping mrouter learn mode is pim-dvmrp on this Vlan 
 IGMP snooping source only learning age timer is 10
 IGMP snooping is running in IGMP_ONLY mode on this Vlan
 IGMP snooping report suppression is enabled on this Vlan 

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.

ip igmp snooping report-suppression

Enables IGMP report suppression.

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]]

show ip igmp snooping groups vlan vlan-id [ip_address | count | dynamic [count] | user [count]]

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.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced. It replaced the show ip igmp snooping multicast command.


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.

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
-------------------------------------------------------------
1         224.1.4.4      igmp                    Fa1/0/11
1         224.1.4.5      igmp                    Fa1/0/11
2         224.0.1.40     igmp        v2          Fa1/0/15
 
   

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          Gi2/0/1, Fa1/0/15
104       224.1.4.3      igmp        v2          Gi2/0/1, Fa1/0/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          Gi2/0/1, Fa1/0/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]

Syntax Description

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

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.

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
----    -----
 200    Fa1/0/13(static), Fa1/0/14(static)

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]]

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.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

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 with 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

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                  Gi1/0/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             Fa1/0/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 Fa1/0/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 sla standards

Use the show ip sla standards command in user EXEC or privileged EXEC mode to display the Cisco IOS IP Service Level Agreements (SLAs) and Two-Way Active Measurement Protocol (TWAMP) standards implemented on the switch.

show ip sla standards

Syntax Description

This command has no arguments or keywords.

Defaults

Displays the IP SLAs and TWAMP standards implemented on the switch.

Command Modes

User EXEC

Command History

Release
Modification

12.2(52)SE

This command was introduced.


Usage Guidelines

Use the show ip sla standards command to display the IP SLAs TWAMP standards implemented on the switch.

Examples

The following is sample output from the show ip sla standards command:

Switch> show ip sla standards
Feature                   Organization    Standard
TWAMP Server              IETF            draft-ietf-ippm-twamp-06
TWAMP Reflector           IETF            draft-ietf-ippm-twamp-06
 
   

Related Commands

Command
Description

show ip sla twamp connection {detail | requests}

Displays IP SLAs TWAMP connections.

show ip sla twamp session

Displays IP SLAs TWAMP sessions.


show ip sla twamp connection

Use the show ip sla twamp connection command in user EXEC mode to display the current Cisco IOS IP Service Level Agreements (SLAs) Two-Way Active Measurement Protocol (TWAMP) connections.

show ip sla twamp connection {detail [source-ip ip-address] | requests} ]

Syntax Description

detail

Display current connection details.

source-ip ip-address

(Optional) Display connection details from a specific TWAMP connection.

requests

Display current connection requests.


Defaults

Displays output for all running IP SLAs TWAMP sessions.

Command Modes

User EXEC

Command History

Release
Modification

12.2(52)SE

This command was introduced.


Usage Guidelines

Use the detail keyword to display detailed information for a single IP SLAs TWAMP connection.

Use the requests keyword to display the current IP SLAs TWAMP connection requests.

Examples

The following is sample output from the show ip sla twamp connection detail command:

Switch> show ip sla twamp connection detail
Connection Id:          91
Client IP Address:    172.27.111.225
Client Port:          43026
Mode:                 Unauthenticated
Connection State:     Connected
Control State:        None
Number of Test Requests - 0:1
 
   

The following is sample output from the show ip sla twamp connection requests command:

Switch> show ip sla twamp connection requests
Connection-Id        Client Address   Client Port
91        172.27.111.225         43026
Total number of current connections: 1
 
   

Related Commands

Command
Description

show ip sla standards

Displays the TWAMP server and reflector standards implemented on the switch.

show ip sla twamp session

Displays IP SLAs TWAMP sessions.


show ip sla twamp session

Use the show ip sla twamp session command in user EXEC mode to display Cisco IOS IP Service Level Agreements (SLAs) Two-Way Active Measurement Protocol (TWAMP) test sessions.

show ip sla twamp session [source-ip ip address | source-port port-number]

Syntax Description

source-ip ip-address

(Optional) Display results from the TWAMP test session on the specified IP address.

source-port port-number

(Optional) Display results from the TWAMP test session on the specified port.


Defaults

Displays the IP SLAs TWAMP test sessions and results.

Command Modes

User EXEC

Command History

Release
Modification

12.2(52)SE

This command was introduced.


Usage Guidelines

Use the show ip sla twamp session command to display information about IP SLAs TWAMP test sessions.

Examples

The following is sample output from the show ip sla twamp session command:

Switch> show ip sla twamp session
IP SLAs Responder TWAMP is: Enabled
Recvr Addr: 172.27.117.116
Recvr Port: 3619
Sender Addr: 172.27.111.225
Sender Port: 32910
Session Id: 172.27.117.116:533112:9C41EC42
Connection Id: 95
 
   

Related Commands

Command
Description

show ip sla standards

Displays the TWAMP server and reflector standards implemented on the switch.

show ip sla twamp connection {detail | requests}

Displays IP SLAs TWAMP connections.


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]

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.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

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.

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    GigabitEthernet1/0/1
00:00:00:0A:00:0A   11.0.0.2         10000       dhcp-snooping  10    GigabitEthernet1/0/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]

Syntax Description

interface interface-id

(Optional) Display IP source guard configuration on a specific interface.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced.


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
---------  -----------  -----------  ---------------  --------------  ---------
Fa1/0/1      ip           active       10.0.0.1                         10
Fa1/0/1      ip           active       deny-all                         11-20
Fa1/0/2      ip           inactive-trust-port
Fa1/0/3      ip           inactive-no-snooping-vlan
Fa1/0/4      ip-mac       active       10.0.0.2         aaaa.bbbb.cccc  10
Fa1/0/4      ip-mac       active       11.0.0.1         aaaa.bbbb.cccd  11
Fa1/0/4      ip-mac       active       deny-all         deny-all        12-20
Fa1/0/5      ip-mac       active       10.0.0.3         permit-all      10
Fa1/0/5      ip-mac       active       deny-all         permit-all      11-20
 
   

In the previous example, this is the IP source guard configuration:

On the Fast Ethernet 1/0/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 list (ACL) is applied on the interface for the VLANs on which IP source guard is not configured.

The Fast Ethernet 1/0/2 interface is configured as trusted for DHCP snooping.

On the Fast Ethernet 1/0/3 interface, DHCP snooping is not enabled on the VLANs to which the interface belongs.

On the Fast Ethernet 1/0/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 Fast Ethernet 1/0/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 fastethernet1/0/6
IP source guard is not configured on the interface fa1/0/6.

Related Commands

Command
Description

ip verify source

Enables IP source guard on an interface.


show ipv6 dhcp conflict

Use the show ipv6 dhcp conflict privileged EXEC command to display address conflicts found by a Dynamic Host Configuration Protocol for IPv6 (DHCPv6) server when addresses are offered to the client.

show ipv6 dhcp conflict


Note This command is available only if and you have configured a dual IPv4 and IPv6 Switch Database Management (SDM) template on the switch.


Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(52)SE

This command was introduced.


Usage Guidelines

To configure the dual IPv4 and IPv6 template, enter the sdm prefer dual-ipv4-and-ipv6 global configuration command, and reload the switch.

When you configure the DHCPv6 server to detect conflicts, it uses ping. The client uses neighbor discovery to detect clients and reports to the server through a DECLINE message. If an address conflict is detected, the address is removed from the pool, and the address is not assigned until the administrator removes the address from the conflict list.

Examples

This is an example of the output from the show ipv6 dhcp conflict command:

Switch# show ipv6 dhcp conflict
Pool 350, prefix 2001:1005::/48
	    2001:1005::10
 
   

Related Commands

Command
Description

ipv6 dhcp pool

Configures a DHCPv6 pool and enters DHCPv6 pool configuration mode.

clear ipv6 dhcp conflict

Clears an address conflict from the DHCPv6 server database.


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]


Note This command is available only if you have configured a dual IPv4 and IPv6 Switch Database Management (SDM) template on the switch.


Syntax Description

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.2(52)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.

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]


Note This command is available only if you have configured a dual IPv4 and IPv6 Switch Database Management (SDM) template on the switch.


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.


Command Modes

User EXEC

Command History

Release
Modification

12.2(52)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.

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          Gi1/0/2, Gi1/0/, Gi1/1/1 
 
   

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    Gi1/0/2, Gi1/0/, Gi1/1/1 
 
   

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]


Note This command is available only if you have configured a dual IPv4 and IPv6 Switch Database Management (SDM) template on the switch.


Syntax Description

vlan vlan-id

(Optional) Specify a VLAN; the range is 1 to 1001 and 1006 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.2(52)SE

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.

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    Gi1/0/11(dynamic)
  72    Gi1/0/11(dynamic)
 200    Gi1/0/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    Gi1/0/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]


Note This command is available only if you have configured a dual IPv4 and IPv6 Switch Database Management (SDM) template on the switch.


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.


Command Modes

User EXEC

Command History

Release
Modification

12.2(52)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.

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          Gi1/0/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          Gi1/0/12
 
   

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 : Gi1/0/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-count

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]}]

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.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(52)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.

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, GigabitEthernet1/0/1
Last updated 10:31:10 27 February 2007
R 2004::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet1/0/2
Last updated 17:23:05 22 February 2007
R 4000::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet1/0/3
Last updated 17:23:05 22 February 2007
R 5000::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet1/0/4
Last updated 17:23:05 22 February 2007
R 5001::/64 [120/2]
via FE80::A8BB:CCFF:FE00:9001, GigabitEthernet1/0/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. For syntax information, select Cisco IOS Software > Command References for the Cisco IOS Software Releases 12.3 Mainline > Cisco IOS IPv6 Command Reference > IPv6 Commands: show ipv6 nat translations through show ipv6 protocols


show l2protocol-tunnel

Use the show l2protocol-tunnel user EXEC command to display information about Layer 2 protocol tunnel ports. The output displays information for the specified interface or all interfaces with protocol tunneling enabled.

show l2protocol-tunnel [interface interface-id] [summary]

Syntax Description

interface interface-id

(Optional) Specify the interface for which protocol tunneling information appears. Valid interfaces are physical ports and port channels; the port channel range is 1 to 12.

summary

(Optional) Display only Layer 2 protocol summary information.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show l2protocol-tunnel command:

Switch> show l2protocol-tunnel
COS for Encapsulated Packets: 5
Drop Threshold for Encapsulated Packets: 0
 
   
Port       Protocol Shutdown  Drop      Encapsulation Decapsulation Drop
                    Threshold Threshold Counter       Counter       Counter
---------- -------- --------- --------- ------------- ------------- -------------
Fa1/0/1    ---           ----      ----          ----          ----          ----
           ---           ----      ----          ----          ----          ----
           ---           ----      ----          ----          ----          ----
           pagp          ----      ----             0         242500
           lacp          ----      ----         24268         242640
           udld          ----      ----             0         897960
Fa1/0/2    ---           ----      ----          ----          ----          ----
           ---           ----      ----          ----          ----          ----
           ---           ----      ----          ----          ----          ----
           pagp          1000      ----         24249         242700
           lacp          ----      ----         24256         242660
           udld          ----      ----             0         897960
Fa1/0/3    cdp           ----      ----        134482        1344820
           ---           ----      ----          ----          ----          ----
           ---           ----      ----          ----          ----          ----
           pagp          1000      ----             0         242500
           lacp           500      ----             0         485320
           udld           300      ----         44899         448980
Fa1/0/4    cdp           ----      ----        134482        1344820
           ---           ----      ----          ----          ----          ----
           ---           ----      ----          ----          ----          ----
           pagp          ----      1000             0         242700
           lacp          ----      ----             0         485220
           udld           300      ----         44899         448980
 
   
<output truncated>
 
   

This is an example of output from the show l2protocol-tunnel summary command:

Switch> show l2protocol-tunnel summary
COS for Encapsulated Packets: 5
Drop Threshold for Encapsulated Packets: 0
 
   
Port    Protocol    Shutdown         Drop             Status
                    Threshold        Threshold
                    (cdp/stp/vtp)    (cdp/stp/vtp)
                    (pagp/lacp/udld) (pagp/lacp/udld)
------- ----------- ---------------- ---------------- ----------
Fa1/0/2   --- --- --- ----/----/----   ----/----/----   up
        pagp lacp udld ----/----/----   ----/----/----
Fa1/0/3  --- --- --- ----/----/----   ----/----/----   up
        pagp lacp udld 1000/----/----   ----/----/----
Fa1/0/4  --- --- --- ----/----/----   ----/----/----   up
        pagp lacp udld 1000/ 500/----   ----/----/----
Fa1/0/5  cdp stp vtp ----/----/----   ----/----/----   down
        ---- ---- ---- ----/----/----   ----/----/----
Fa1/0/6 --- --- --- ----/----/----   ----/----/----   down
        pagp ---- ---- ----/----/----   1000/----/----
Fa1/0/7 --- --- --- ----/----/----   ----/----/----   down
        pagp ---- ---- ----/----/----   1000/----/----
 
   

Related Commands

Command
Description

clear l2protocol-tunnel counters

Clears counters for protocol tunneling ports.

l2protocol-tunnel

Enables Layer 2 protocol tunneling for Cisco Discovery Protocol (CDP), Spanning Tree Protocol (STP), or VLAN Trunking Protocol (VTP) packets on an interface.

l2protocol-tunnel cos

Configures a class of service (CoS) value for tunneled Layer 2 protocol packets.


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}

Syntax Description

channel-group-number

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

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.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

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.

Examples

This is an example of output from the show lacp counters command user EXEC command. Table 2-24 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
Fa1/0/5      19     10       0      0        0      0         0     
Fa1/0/6      14     6        0      0        0      0         0     
Fa1/0/7      8      7        0      0        0      0         0 
 
   

Table 2-24 show lacp counters Field Descriptions 

Field
Description

LACPDUs Sent and Recv

The number of LACP packets sent and received by an interface.

Marker Sent and Recv

The number of LACP marker packets sent and received by an interface.

Marker Response Sent and Recv

The number of LACP marker response packets sent and received by an interface.

LACPDUs Pkts and Err

The number of unknown and illegal packets received by LACP for an interface.


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
Fa1/0/5     SA      bndl      32768         0x3       0x3     0x4      0x3D  
Fa1/0/6     SA      bndl      32768         0x3       0x3     0x5      0x3D  
Fa1/0/7     SA      bndl      32768         0x3       0x3     0x6      0x3D 
 
   

Table 2-25 describes the fields in the display:

Table 2-25 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. The ability of a port to aggregate with other ports is controlled 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
Fa1/0/3   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
Fa1/0/4   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 LACP channel-group information.

lacp port-priority

Configures the LACP port priority.

lacp system-priority

Configures the LACP system priority.


show link state group

Use the show link state group global configuration command to display the link-state group information.

show link state group [number] [detail]

Syntax Description

number

(Optional) Number of the link-state group.

detail

(Optional) Specify that detailed information appears.


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.

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
Link State Group: 1 Status: Enabled, Down 
Upstream Interfaces : Fa1/0/15(Dwn) Fa1/0/16(Dwn) 
Downstream Interfaces : Fa1/0/11(Dis) Fa1/0/12(Dis) Fa1/0/13(Dis) Fa1/0/14(Dis)
 
   
Link State Group: 2 Status: Enabled, Down 
Upstream Interfaces : Fa1/0/15(Dwn) Fa1/0/16(Dwn) Fa1/0/17(Dwn) 
Downstream Interfaces : Fa1/0/11(Dis) Fa1/0/12(Dis) Fa1/0/13(Dis) Fa1/0/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 operating configuration. For syntax information, use this link to the Cisco IOS Release 12.2 Command Reference listing page: http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/prod_command_reference_list.html
Select the Cisco IOS Commands Master List, Release 12.2 to navigate to the command.


show location

Use the show location user EXEC command to display location information for an endpoint.

show location admin-tag

show location civic-location {identifier id number | interface interface-id | static}

show location elin-location {identifier id number | interface interface-id | static}

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.


Command Modes

User EXEC

Command History

Release
Modification

12.2(40)SE

This command was introduced.


Usage Guidelines

Use the show location command to display location information for an endpoint.

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 g2/0/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                   : Gi2/0/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      : Gi2/0/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      : Gi2/0/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 mac access-group

Use the show mac access-group user EXEC command to display the MAC access control lists (ACLs) configured for an interface or a switch.

show mac access-group [interface interface-id]

Syntax Description

interface interface-id

(Optional) Display the MAC ACLs configured on a specific interface. Valid interfaces are physical ports and port channels; the port channel range is 1 to 64.


Command Modes

User EXEC; the interface keyword is available only in privileged EXEC mode.

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac-access group command. In this display, Fast Ethernet interface 1/0/12 has the MAC access list macl_e1 applied; no MAC ACLs are applied to other interfaces.

Switch> show mac access-group 
Interface FastEthernet1/0/1:
   Inbound access-list is not set
Interface FastEthernet1/0/2:
   Inbound access-list is macl_e1
Interface FastEthernet1/0/3:
   Inbound access-list is not set
Interface FastEthernet1/0/4:
   Inbound access-list is not set
 
   
<output truncated>
 
   
Interface FastEthernet1/0/10:
   Inbound access-list is not set
Interface FastEthernet1/0/11:
   Inbound access-list is not set
Interface FastEthernet1/0/12:
   Inbound access-list is macl_e1
 
   
<output truncated>

This is an example of output from the show mac access-group interface interface-id command:

Switch# show mac access-group interface gigabitethernet1/0/2
Interface GigabitEthernet1/0/2:
   Inbound access-list is macl_e1

Related Commands

Command
Description

mac access-group

Applies a MAC access group to an interface.


show mac address-table

Use the show mac address-table user EXEC command to display a specific MAC address table static and dynamic entry or the MAC address table static and dynamic entries on a specific interface or VLAN.

show mac address-table

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac address-table command:

Switch> show mac address-table
          Mac Address Table
------------------------------------------
 
   
Vlan    Mac Address       Type       Ports
----    -----------       ----       -----
 All    0000.0000.0001    STATIC     CPU
 All    0000.0000.0002    STATIC     CPU
 All    0000.0000.0003    STATIC     CPU
 All    0000.0000.0009    STATIC     CPU
 All    0000.0000.0012    STATIC     CPU
 All    0180.c200.000b    STATIC     CPU
 All    0180.c200.000c    STATIC     CPU
 All    0180.c200.000d    STATIC     CPU
 All    0180.c200.000e    STATIC     CPU
 All    0180.c200.000f    STATIC     CPU
 All    0180.c200.0010    STATIC     CPU
   1    0030.9441.6327    DYNAMIC    Fa1/0/23
Total Mac Addresses for this criterion: 12
 
   

Related Commands

Command
Description

clear mac address-table dynamic

Deletes from the MAC address table a specific dynamic address, all dynamic addresses on a particular interface, or all dynamic addresses on a particular VLAN.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table address

Use the show mac address-table address user EXEC command to display MAC address table information for the specified MAC address.

show mac address-table address mac-address [interface interface-id] [vlan vlan-id]

Syntax Description

mac-address

Specify the 48-bit MAC address; the valid format is H.H.H.

interface interface-id

(Optional) Display information for a specific interface. Valid interfaces include physical ports and port channels.

vlan vlan-id

(Optional) Display entries for the specific VLAN only. The range is 1 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac address-table address command:

Switch# show mac address-table address 0002.4b28.c482
          Mac Address Table
------------------------------------------
 
   
Vlan    Mac Address     Type    Ports
----    -----------     ----    -----
 All    0002.4b28.c482  STATIC  CPU
Total Mac Addresses for this criterion: 1 

Related Commands

Command
Description

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table aging-time

Use the show mac address-table aging-time user EXEC command to display the aging time of a specific address table instance, all address table instances on a specified VLAN or, if a specific VLAN is not specified, on all VLANs.

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

Syntax Description

vlan vlan-id

(Optional) Display aging time information for a specific VLAN. The range is 1 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

If no VLAN number is specified, the aging time for all VLANs appears.

Examples

This is an example of output from the show mac address-table aging-time command:

Switch> show mac address-table aging-time
Vlan    Aging Time
----    ----------
   1     300 
 
   

This is an example of output from the show mac address-table aging-time vlan 10 command:

Switch> show mac address-table aging-time vlan 10
Vlan    Aging Time
----    ----------
  10     300 
 
   

Related Commands

Command
Description

mac address-table aging-time

Sets the length of time that a dynamic entry remains in the MAC address table after the entry is used or updated.

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table count

Use the show mac address-table count user EXEC command to display the number of addresses present in all VLANs or the specified VLAN.

show mac address-table count [vlan vlan-id]

Syntax Description

vlan vlan-id

(Optional) Display the number of addresses for a specific VLAN. The range is 1 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

If no VLAN number is specified, the address count for all VLANs appears.

Examples

This is an example of output from the show mac address-table count command:

Switch# show mac address-table count
 
   
Mac Entries for Vlan 10:
---------------------------
Dynamic Address Count  : 0
Static  Address Count  : 0
Total Mac Addresses    : 0
 
   
Mac Entries for Vlan 1:
---------------------------
Dynamic Address Count  : 10
Static  Address Count  : 0
Total Mac Addresses    : 10
 
   
Total Mac Address Space Available: 6120 

Related Commands

Command
Description

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table dynamic

Use the show mac address-table dynamic user EXEC command to display only dynamic MAC address table entries.

show mac address-table dynamic [address mac-address] [interface interface-id] [vlan vlan-id]

Syntax Description

address mac-address

(Optional) Specify a 48-bit MAC address; the valid format is H.H.H (available in privileged EXEC mode only).

interface interface-id

(Optional) Specify an interface to match; valid interfaces include physical ports and port channels.

vlan vlan-id

(Optional) Display entries for a specific VLAN; the range is 1 to 4094.


Command Modes

User EXEC; address keyword available only in privileged EXEC mode.

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac address-table dynamic command:

Switch> show mac address-table dynamic
          Mac Address Table
------------------------------------------
 
   
Vlan    Mac Address       Type        Ports
----    -----------       --------    -----
   1    0000.0c07.ac00    DYNAMIC     Fa1/0/1
   1    0000.0c07.ac81    DYNAMIC     Fa1/0/1
   1    0004.5a5e.f635    DYNAMIC     Fa1/0/1
   1    0006.d713.8dd0    DYNAMIC     Fa1/0/1
   1    0006.d78b.5d80    DYNAMIC     Fa1/0/1
   1    0008.217a.ea00    DYNAMIC     Fa1/0/1
   1    000a.b7d1.6f5b    DYNAMIC     Fa1/0/1
   1    0010.7b3a.e967    DYNAMIC     Fa1/0/1
   1    0010.a4e6.6e58    DYNAMIC     Fa1/0/1
   1    0090.92cf.1400    DYNAMIC     Fa1/0/1
Total Mac Addresses for this criterion: 10

Related Commands

Command
Description

clear mac address-table dynamic

Deletes from the MAC address table a specific dynamic address, all dynamic addresses on a particular interface, or all dynamic addresses on a particular VLAN.

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table interface

Use the show mac address-table interface user command to display the MAC address table information for the specified interface in the specified VLAN.

show mac address-table interface interface-id [vlan vlan-id]

Syntax Description

interface-id

Specify an interface type; valid interfaces include physical ports and port channels.

vlan vlan-id

(Optional) Display entries for a specific VLAN; the range is 1 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac address-table interface interface-id command:

Switch> show mac address-table interface fastethernet1/0/2
          Mac Address Table
------------------------------------------
 
   
Vlan    Mac Address     Type    Ports
----    -----------     ----    -----
   1    0030.b635.7862  DYNAMIC Fa1/0/2
   1    00b0.6496.2741  DYNAMIC Fa1/0/2
Total Mac Addresses for this criterion: 2 

Related Commands

Command
Description

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table learning

Use the show mac address-table learning user EXEC command to display the status of MAC address learning for all VLANs or the specified VLAN.

show mac address-table learning [vlan vlan-id]

Syntax Description

vlan vlan-id

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


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)SEG

This command was introduced.


Usage Guidelines

Use the show mac address-table learning command without any keywords to display configured VLANs and whether MAC address learning is enabled or disabled on them. The default is that MAC address learning is enabled on all VLANs. Use the command with a specific VLAN ID to display the learning status on an individual VLAN.

Examples

This is an example of output from the show mac address-table learning user EXEC command showing that MAC address learning is disabled on VLAN 200:

Switch> show mac address-table learning
VLAN    Learning Status
----    ---------------
1             yes
100           yes
200           no

Related Commands

Command
Description

mac address-table learning vlan

Enables or disables MAC address learning on a VLAN.


show mac address-table move update

Use the show mac address-table move update user EXEC command to display the MAC address-table move update information on the switch.

show mac address-table move update

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.2(25)SED

This command was introduced.


Examples

This is an example of output from the show mac address-table move update command:

Switch> show mac address-table move update
Switch-ID : 010b.4630.1780
Dst mac-address : 0180.c200.0010
Vlans/Macs supported : 1023/8320
Default/Current settings: Rcv Off/On, Xmt Off/On
Max packets per min : Rcv 40, Xmt 60
Rcv packet count : 10
Rcv conforming packet count : 5
Rcv invalid packet count : 0
Rcv packet count this min : 0
Rcv threshold exceed count : 0
Rcv last sequence# this min : 0
Rcv last interface : Po2
Rcv last src-mac-address : 0003.fd6a.8701
Rcv last switch-ID : 0303.fd63.7600
Xmt packet count : 0
Xmt packet count this min : 0
Xmt threshold exceed count : 0
Xmt pak buf unavail cnt : 0
Xmt last interface : None
switch#

Related Commands

Command
Description

clear mac address-table move update

Clears the MAC address-table move update counters.

mac address-table move update

Configures MAC address-table move update on the switch.


show mac address-table multicast

Use the show mac address-table multicast user EXEC command to display the Layer 2 multicast entries for all VLANs. Use the command in privileged EXEC mode to display specific multicast entries.

show mac address-table multicast [vlan-id] [count | user [count]]

Syntax Description

vlan vlan-id

(Optional) Display addresses for a specific VLAN. The range is 1 to 4094.

count

(Optional) Display the total number of entries for the specified command options instead of the actual entries.

user

(Optional) Display only the user-configured multicast entries.



Note Though visible in the command-line help string, the igmp-snooping keyword is not supported. Use the show ip source binding privileged EXEC command to display the Internet Group Management Protocol (IGMP) snooping multicast table.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac address-table multicast command. It shows how to display all multicast entries for the switch.

Switch> show mac address-table multicast
Vlan    Mac Address     Type    Ports
----    -----------     ----    -----
   1    0100.5e00.0128  IGMP    Gi1/0/1 
 
   

This is an example of output from the show mac address-table multicast count command. It shows how to display a total count of MAC address entries for the switch.

Switch> show mac address-table multicast count
Multicast MAC Entries for all vlans:    10
 
   

This is an example of output from the show mac address-table multicast vlan 1 count command. It shows how to display a total count of MAC address entries for a VLAN.

Switch> show mac address-table multicast vlan 1 count
Multicast MAC Entries for vlan 1:    4

Related Commands

Command
Description

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


 
   

show mac address-table notification

Use the show mac address-table notification user EXEC command to display the MAC address notification settings for all interfaces or the specified interface.

show mac address-table notification {change [interface [interface-id] | mac-move | threshold} ]

Syntax Description

change

Display the MAC change notification feature parameters and the history table.

interface

(Optional) Display information for all interfaces. Valid interfaces include physical ports and port channels.

interface-id

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

mac-move

Display status for MAC address move notifications.

threshold

Display status for MAC-address table threshold monitoring.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(40)SE

The change, mac-move, and threshold keywords were added.


Usage Guidelines

Use the show mac address-table notification change command without keywords to see if the MAC address change notification feature is enabled or disabled, the MAC notification interval, the maximum number of entries allowed in the history table, and the history table contents.

Use the interface keyword to display the notifications for all interfaces. If the interface-id is included, only the flags for that interface appear.

Examples

This is an example of output from the show mac address-table notification change command:

Switch> show mac address-table notification change
MAC Notification Feature is Enabled on the switch
Interval between Notification Traps : 60 secs
Number of MAC Addresses Added : 4
Number of MAC Addresses Removed : 4
Number of Notifications sent to NMS : 3
Maximum Number of entries configured in History Table : 100
Current History Table Length : 3
MAC Notification Traps are Enabled
History Table contents
----------------------
History Index 0, Entry Timestamp 1032254, Despatch Timestamp 1032254
MAC Changed Message :
Operation: Added   Vlan: 2     MAC Addr: 0000.0000.0001 Module: 0   Port: 1
 
   
History Index 1, Entry Timestamp 1038254, Despatch Timestamp 1038254
MAC Changed Message :
Operation: Added   Vlan: 2     MAC Addr: 0000.0000.0000 Module: 0   Port: 1
Operation: Added   Vlan: 2     MAC Addr: 0000.0000.0002 Module: 0   Port: 1
Operation: Added   Vlan: 2     MAC Addr: 0000.0000.0003 Module: 0   Port: 1
 
   
History Index 2, Entry Timestamp 1074254, Despatch Timestamp 1074254
MAC Changed Message :
Operation: Deleted Vlan: 2     MAC Addr: 0000.0000.0000 Module: 0   Port: 1
Operation: Deleted Vlan: 2     MAC Addr: 0000.0000.0001 Module: 0   Port: 1
Operation: Deleted Vlan: 2     MAC Addr: 0000.0000.0002 Module: 0   Port: 1
Operation: Deleted Vlan: 2     MAC Addr: 0000.0000.0003 Module: 0   Port: 1

Related Commands

Command
Description

clear mac address-table notification

Clears the MAC address notification global counters.

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table static

Displays static MAC address table entries only.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table static

Use the show mac address-table static user EXEC command to display only static MAC address table entries.

show mac address-table static [address mac-address] [interface interface-id] [vlan vlan-id]

Syntax Description

address mac-address

(Optional) Specify a 48-bit MAC address; the valid format is H.H.H (available in privileged EXEC mode only).

interface interface-id

(Optional) Specify an interface to match; valid interfaces include physical ports and port channels.

vlan vlan-id

(Optional) Display addresses for a specific VLAN. The range is 1 to 4094.


Command Modes

User EXEC; address keyword available only in privileged EXEC mode.

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac address-table static command:

Switch> show mac address-table static

          Mac Address Table
------------------------------------------
 
   
Vlan    Mac Address     Type    Ports
----    -----------     ----    -----
 All    0100.0ccc.cccc  STATIC  CPU
 All    0180.c200.0000  STATIC  CPU
 All    0100.0ccc.cccd  STATIC  CPU
 All    0180.c200.0001  STATIC  CPU
 All    0180.c200.0004  STATIC  CPU
 All    0180.c200.0005  STATIC  CPU
   4    0001.0002.0004  STATIC  Drop
   6    0001.0002.0007  STATIC  Drop
Total Mac Addresses for this criterion: 8

Related Commands

Command
Description

mac address-table static

Adds static addresses to the MAC address table.

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table vlan

Displays the MAC address table information for the specified VLAN.


show mac address-table vlan

Use the show mac address-table vlan user EXEC command to display the MAC address table information for the specified VLAN.

show mac address-table vlan vlan-id

Syntax Description

vlan-id

(Optional) Display addresses for a specific VLAN. The range is 1 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mac address-table vlan 1 command:

Switch> show mac address-table vlan 1
          Mac Address Table
------------------------------------------
 
   
Vlan    Mac Address     Type    Ports
----    -----------     ----    -----
   1    0100.0ccc.cccc  STATIC  CPU
   1    0180.c200.0000  STATIC  CPU
   1    0100.0ccc.cccd  STATIC  CPU
   1    0180.c200.0001  STATIC  CPU
   1    0180.c200.0002  STATIC  CPU
   1    0180.c200.0003  STATIC  CPU
   1    0180.c200.0004  STATIC  CPU
   1    0180.c200.0005  STATIC  CPU
   1    0180.c200.0006  STATIC  CPU
   1    0180.c200.0007  STATIC  CPU
Total Mac Addresses for this criterion: 10 

Related Commands

Command
Description

show mac address-table address

Displays MAC address table information for the specified MAC address.

show mac address-table aging-time

Displays the aging time in all VLANs or the specified VLAN.

show mac address-table count

Displays the number of addresses present in all VLANs or the specified VLAN.

show mac address-table dynamic

Displays dynamic MAC address table entries only.

show mac address-table interface

Displays the MAC address table information for the specified interface.

show mac address-table multicast

Displays the Layer 2 multicast entries for all VLANs or the specified VLAN.

show mac address-table notification

Displays the MAC address notification settings for all interfaces or the specified interface.

show mac address-table static

Displays static MAC address table entries only.


show mls qos

Use the show mls qos user EXEC command to display global quality of service (QoS) configuration information.

show mls qos

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mls qos command when QoS is enabled and Differentiated Services Code Point (DSCP) transparency is disabled:

Switch> show mls qos
QoS is enabled
QoS ip packet dscp rewrite disabled
 
   

This is an example of output from the show mls qos command when QoS is enabled and DSCP transparency is enabled:

Switch> show mls qos
QoS is enabled
QoS ip packet dscp rewrite enabled

Related Commands

Command
Description

mls qos

Enables QoS for the entire switch.


show mls qos aggregate-policer

Use the show mls qos aggregate-policer user EXEC command to display the quality of service (QoS) aggregate policer configuration. A policer defines a maximum permissible rate of transmission, a maximum burst size for transmissions, and an action to take if either maximum is exceeded.

show mls qos aggregate-policer [aggregate-policer-name]

Syntax Description

aggregate-policer-name

(Optional) Display the policer configuration for the specified name.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mls qos aggregate-policer command:

Switch> show mls qos aggregate-policer policer1
aggregate-policer policer1 88000 2000000 exceed-action drop
Not used by any policy map 

Related Commands

Command
Description

mls qos aggregate-policer

Defines policer parameters that can be shared by multiple classes within the same policy map.


show mls qos input-queue

Use the show mls qos input-queue user EXEC command to display quality of service (QoS) settings for the ingress queues.

show mls qos input-queue

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mls qos input-queue command:

Switch> show mls qos input-queue
Queue     :      1      2
----------------------------------------------
buffers   :      90     10
bandwidth :      4      4
priority  :      0      10
threshold1:      100    100
threshold2:      100    100

Related Commands

Command
Description

mls qos srr-queue input bandwidth

Assigns shaped round robin (SRR) weights to an ingress queue.

mls qos srr-queue input buffers

Allocates the buffers between the ingress queues.

mls qos srr-queue input cos-map

Maps class of service (CoS) values to an ingress queue or assigns CoS values to a queue and to a threshold ID.

mls qos srr-queue input dscp-map

Maps Differentiated Services Code Point (DSCP) values to an ingress queue or assigns DSCP values to a queue and to a threshold ID.

mls qos srr-queue input priority-queue

Configures the ingress priority queue and guarantees bandwidth.

mls qos srr-queue input threshold

Assigns weighted tail-drop (WTD) threshold percentages to an ingress queue.


show mls qos interface

Use the show mls qos interface user EXEC command to display quality of service (QoS) information at the port level.

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

Syntax Description

interface-id

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

buffers

(Optional) Display the buffer allocation among the queues.

queueing

(Optional) Display the queueing strategy (shared or shaped) and the weights corresponding to the queues.

statistics

(Optional) Display statistics for sent and received Differentiated Services Code Point (DSCP) and class of service (CoS) values, the number of packets queued or dropped, and the number of in-profile and out-of-profile packets for each policer.



Note Though visible in the command-line help string, the policers keyword is not supported.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

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

Switch# show mls qos interface fastethernet1/0/7
FastEthernet1/0/7
Attached policy-map for Ingress: videowizard_policy
trust state: not trusted
COS override: dis
default COS: 0
DSCP Mutation Map: Default DSCP Mutation Map
 
   

This is an example of output from the show mls qos interface interface-id buffers command:

Switch> show mls qos interface fastethernet1/0/7 buffers
FastEthernet1/0/7
The port is mapped to qset : 1
The allocations between the queues are : 25 25 25 25
 
   

This is an example of output from the show mls qos interface interface-id queueing command:

Switch> show mls qos interface fastethernet1/0/7 queueing
GigabitEthernet1/0/7
Egress Priority Queue :enabled
Shaped queue weights (absolute) :  25 0 0 0
Shared queue weights  :  25 25 25 25
The port bandwidth limit : 100  (Operational Bandwidth:100.0)
The port is mapped to qset : 1
 
   

This is an example of output from the show mls qos interface interface-id statistics command. Table 2-26 describes the fields in this display.

Switch> show mls qos interface fastethernet1/0/7 statistics
FastEthernet1/0/7
 
   
  dscp: incoming
-------------------------------
 
   
  0 -  4 :      4213          0          0          0          0
  5 -  9 :         0          0          0          0          0
 10 - 14 :         0          0          0          0          0
 15 - 19 :         0          0          0          0          0
 20 - 24 :         0          0          0          0          0
 25 - 29 :         0          0          0          0          0
 30 - 34 :         0          0          0          0          0
 35 - 39 :         0          0          0          0          0
 40 - 44 :         0          0          0          0          0
 45 - 49 :         0          0          0          6          0
 50 - 54 :         0          0          0          0          0
 55 - 59 :         0          0          0          0          0
 60 - 64 :         0          0          0          0
  dscp: outgoing
-------------------------------
 
   
  0 -  4 :    363949          0          0          0          0
  5 -  9 :         0          0          0          0          0
 10 - 14 :         0          0          0          0          0
 15 - 19 :         0          0          0          0          0
 20 - 24 :         0          0          0          0          0
 25 - 29 :         0          0          0          0          0
 30 - 34 :         0          0          0          0          0
 35 - 39 :         0          0          0          0          0
 40 - 44 :         0          0          0          0          0
 45 - 49 :         0          0          0          0          0
 50 - 54 :         0          0          0          0          0
 55 - 59 :         0          0          0          0          0
 60 - 64 :         0          0          0          0
  cos: incoming
-------------------------------
 
   
  0 -  4 :    132067          0          0          0          0
  5 -  9 :         0          0          0
  cos: outgoing
-------------------------------
 
   
  0 -  4 :    739155          0          0          0          0
  5 -  9 :        90          0          0
 
   
Policer: Inprofile:        0 OutofProfile:        0

Note The show mls qos interface interface-id statistics command output might show more throughput than the actual amount on the interface.


Table 2-26 show mls qos interface statistics Field Descriptions 

Field
 
Description

DSCP

incoming

Number of received packets for each DSCP value.

 

outgoing

Number of sent packets for each DSCP value.

CoS

incoming

Number of received packets for each CoS value.

 

outgoing

Number of sent packets for each CoS value.

Policer

Inprofile

Number of in profile packets for each policer.

 

Outofprofile

Number of out of profile packets for each policer.


Related Commands

Command
Description

mls qos queue-set output buffers

Allocates buffers to a queue-set.

mls qos queue-set output threshold

Configures the weighted tail-drop (WTD) thresholds, guarantees the availability of buffers, and configures the maximum memory allocation to a queue-set.

mls qos srr-queue input bandwidth

Assigns shaped round robin (SRR) weights to an ingress queue.

mls qos srr-queue input buffers

Allocates the buffers between the ingress queues.

mls qos srr-queue input cos-map

Maps CoS values to an ingress queue or maps CoS values to a queue and to a threshold ID.

mls qos srr-queue input dscp-map

Maps DSCP values to an ingress queue or maps DSCP values to a queue and to a threshold ID.

mls qos srr-queue input priority-queue

Configures the ingress priority queue and guarantees bandwidth.

mls qos srr-queue input threshold

Assigns WTD threshold percentages to an ingress queue.

mls qos srr-queue output cos-map

Maps CoS values to an egress queue or maps CoS values to a queue and to a threshold ID.

mls qos srr-queue output dscp-map

Maps DSCP values to an egress queue or maps DSCP values to a queue and to a threshold ID.

policy-map

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

priority-queue

Enables the egress priority queue on a port.

queue-set

Maps a port to a queue-set.

srr-queue bandwidth limit

Limits the maximum output on a standard port.

srr-queue bandwidth shape

Assigns the shaped weights and enables bandwidth shaping on the four egress queues mapped to a standard port.

srr-queue bandwidth share

Assigns the shared weights and enables bandwidth sharing on the four egress queues mapped to a port.


show mls qos maps

Use the show mls qos maps user EXEC command to display quality of service (QoS) mapping information. During classification, QoS uses the mapping tables to represent the priority of the traffic and to derive a corresponding class of service (CoS) or Differentiated Services Code Point (DSCP) value from the received CoS, DSCP, or IP precedence value.

show mls qos maps [cos-dscp | cos-input-q | cos-output-q | dscp-cos | dscp-input-q | dscp-mutation dscp-mutation-name | dscp-output-q | ip-prec-dscp | policed-dscp]

Syntax Description

cos-dscp

(Optional) Display class of service (CoS)-to-DSCP map.

cos-input-q

(Optional) Display the CoS input queue threshold map.

cos-output-q

(Optional) Display the CoS output queue threshold map.

dscp-cos

(Optional) Display DSCP-to-CoS map.

dscp-input-q

(Optional) Display the DSCP input queue threshold map.

dscp-mutation dscp-mutation-name

(Optional) Display the specified DSCP-to-DSCP-mutation map.

dscp-output-q

(Optional) Display the DSCP output queue threshold map.

ip-prec-dscp

(Optional) Display the IP-precedence-to-DSCP map.

policed-dscp

(Optional) Display the policed-DSCP map.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

The policed-DSCP, DSCP-to-CoS, and the DSCP-to-DSCP-mutation maps are displayed as a matrix. The d1 column specifies the most-significant digit in the DSCP. The d2 row specifies the least-significant digit in the DSCP. The intersection of the d1 and d2 values provides the policed-DSCP, the CoS, or the mutated-DSCP value. For example, in the DSCP-to-CoS map, a DSCP value of 43 corresponds to a CoS value of 5.

The DSCP input queue threshold and the DSCP output queue threshold maps are displayed as a matrix. The d1 column specifies the most-significant digit of the DSCP number. The d2 row specifies the least-significant digit in the DSCP number. The intersection of the d1 and the d2 values provides the queue ID and threshold ID. For example, in the DSCP input queue threshold map, a DSCP value of 43 corresponds to queue 2 and threshold 1 (02-01).

The CoS input queue threshold and the CoS output queue threshold maps show the CoS value in the top row and the corresponding queue ID and threshold ID in the second row. For example, in the CoS input queue threshold map, a CoS value of 5 corresponds to queue 2 and threshold 1 (2-1).

Examples

This is an example of output from the show mls qos maps command:

Switch> show mls qos maps
Policed-dscp map:
     d1 :  d2 0  1  2  3  4  5  6  7  8  9
     ---------------------------------------
      0 :    00 01 02 03 04 05 06 07 08 09
      1 :    10 11 12 13 14 15 16 17 18 19
      2 :    20 21 22 23 24 25 26 27 28 29
      3 :    30 31 32 33 34 35 36 37 38 39
      4 :    40 41 42 43 44 45 46 47 48 49
      5 :    50 51 52 53 54 55 56 57 58 59
      6 :    60 61 62 63
 
   
Dscp-cos map:
     d1 :  d2 0  1  2  3  4  5  6  7  8  9
     ---------------------------------------
      0 :    00 00 00 00 00 00 00 00 01 01
      1 :    01 01 01 01 01 01 02 02 02 02
      2 :    02 02 02 02 03 03 03 03 03 03
      3 :    03 03 04 04 04 04 04 04 04 04
      4 :    05 05 05 05 05 05 05 05 06 06
      5 :    06 06 06 06 06 06 07 07 07 07
      6 :    07 07 07 07
 
   
Cos-dscp map:
     cos:   0  1  2  3  4  5  6  7
  --------------------------------
    dscp:   0  8 16 24 32 40 48 56
 
   
IpPrecedence-dscp map:
     ipprec:   0  1  2  3  4  5  6  7
     --------------------------------
       dscp:   0  8 16 24 32 40 48 56
 
   
Dscp-outputq-threshold map:
  d1 :d2    0     1     2     3     4     5     6     7     8     9
  --------------------------------------------------------------------
   0 :    02-01 02-01 02-01 02-01 02-01 02-01 02-01 02-01 02-01 02-01
   1 :    02-01 02-01 02-01 02-01 02-01 02-01 03-01 03-01 03-01 03-01
   2 :    03-01 03-01 03-01 03-01 03-01 03-01 03-01 03-01 03-01 03-01
   3 :    03-01 03-01 04-01 04-01 04-01 04-01 04-01 04-01 04-01 04-01
   4 :    01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 04-01 04-01
   5 :    04-01 04-01 04-01 04-01 04-01 04-01 04-01 04-01 04-01 04-01
   6 :    04-01 04-01 04-01 04-01
Dscp-inputq-threshold map:
    d1 :d2    0     1     2     3     4     5     6     7     8     9
    --------------------------------------------------------------------
     0 :    01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01
     1 :    01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01
     2 :    01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01
     3 :    01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01
     4 :    02-01 02-01 02-01 02-01 02-01 02-01 02-01 02-01 01-01 01-01
     5 :    01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01 01-01
     6 :    01-01 01-01 01-01 01-01
 
   
Cos-outputq-threshold map:
              cos:  0   1   2   3   4   5   6   7
              ------------------------------------
  queue-threshold: 2-1 2-1 3-1 3-1 4-1 1-1 4-1 4-1
 
   
   Cos-inputq-threshold map:
              cos:  0   1   2   3   4   5   6   7
              ------------------------------------
  queue-threshold: 1-1 1-1 1-1 1-1 1-1 2-1 1-1 1-1
 
   
Dscp-dscp mutation map:
   Default DSCP Mutation Map:
     d1 :  d2 0  1  2  3  4  5  6  7  8  9
     ---------------------------------------
      0 :    00 01 02 03 04 05 06 07 08 09
      1 :    10 11 12 13 14 15 16 17 18 19
      2 :    20 21 22 23 24 25 26 27 28 29
      3 :    30 31 32 33 34 35 36 37 38 39
      4 :    40 41 42 43 44 45 46 47 48 49
      5 :    50 51 52 53 54 55 56 57 58 59
      6 :    60 61 62 63

Related Commands

Command
Description

mls qos map

Defines the CoS-to-DSCP map, the DSCP-to-CoS map, the DSCP-to-DSCP-mutation map, the IP-precedence-to-DSCP map, and the policed-DSCP map.

mls qos srr-queue input cos-map

Maps CoS values to an ingress queue or maps CoS values to a queue and to a threshold ID.

mls qos srr-queue input dscp-map

Maps DSCP values to an ingress queue or maps DSCP values to a queue and to a threshold ID.

mls qos srr-queue output cos-map

Maps CoS values to an egress queue or maps CoS values to a queue and to a threshold ID.

mls qos srr-queue output dscp-map

Maps DSCP values to an egress queue or maps DSCP values to a queue and to a threshold ID.


show mls qos queue-set

Use the show mls qos queue-set user EXEC command to display quality of service (QoS) settings for an egress queue-set.

show mls qos queue-set [qset-id]

Syntax Description

qset-id

(Optional) ID of the queue-set. Each port belongs to a queue-set, which defines all the characteristics of the four egress queues per port. The range is 1 to 2.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mls qos queue-set command:

Switch> show mls qos queue-set
Queueset: 1
Queue   :        1       2       3       4
----------------------------------------------
buffers   :      25      25      25      25
threshold1:      100     200     100     100
threshold2:      100     200     100     100
reserved  :      50      50      50      50
maximum   :      400     400     400     400
Queueset: 2
Queue   :        1       2       3       4
----------------------------------------------
buffers   :      25      25      25      25
threshold1:      100     200     100     100
threshold2:      100     200     100     100
reserved  :      50      50      50      50
maximum   :      400     400     400     400

Related Commands

Command
Description

mls qos queue-set output buffers

Allocates buffers to the queue-set.

mls qos queue-set output threshold

Configures the weighted tail-drop (WTD) thresholds, guarantees the availability of buffers, and configures the maximum memory allocation of the queue-set.


show mls qos vlan

Use the show mls qos vlan user EXEC command to display the policy maps attached to a switch virtual interface (SVI).

show mls qos vlan vlan-id

Syntax Description

vlan-id

Display the policy maps for the specified VLAN. The range is 1 to 4094.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced.


Examples

This is an example of output from the show mls qos queue-set command:

Switch> show mls qos vlan 10
Vlan10
Attached policy-map for Ingress:pm-test-pm-2

Related Commands

Command
Description

policy-map

Creates or modifies a policy map that can be attached to multiple ports and enters policy-map configuration mode.


show monitor

Use the show monitor user EXEC command to display information about all Switched Port Analyzer (SPAN) and Remote SPAN (RSPAN) sessions on the switch. Use the command with keywords to show a specific session, all sessions, all local sessions, or all remote sessions.

show monitor [session {session_number | all | local | range list | remote} [detail]]

Syntax Description

session

(Optional) Display information about specified SPAN sessions.

session_number

Specify the number of the SPAN or RSPAN session. The range is 1 to 66.

all

Display all SPAN sessions.

local

Display only local SPAN sessions.

range list

Display a range of SPAN sessions, where list is the range of valid sessions, either a single session or a range of sessions described by two numbers, the lower one first, separated by a hyphen. Do not enter any spaces between comma-separated parameters or in hyphen-specified ranges.

Note This keyword is available only in privileged EXEC mode.

remote

Display only remote SPAN sessions.

detail

(Optional) Display detailed information about the specified sessions.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

The output is the same for the show monitor command and the show monitor session all command.

Examples

This is an example of output for the show monitor command:

Switch# show monitor
Session 1
---------
Type : Local Session
Source Ports :
RX Only : Fa1/0/1
Both : Fa1/0/2-3,Fa1/0/5-6
Destination Ports : Fa1/0/20
Encapsulation : Replicate
Ingress : Disabled
 
   
Session 2
---------
Type : Remote Source Session
Source VLANs :
TX Only : 10
Both : 1-9
Dest RSPAN VLAN : 105
 
   

This is an example of output for the show monitor command for RSPAN source session 1:

Switch# show monitor session 1
Session 1
---------
Type : Local Session
Source Ports :
RX Only : Fa1/0/1
Both : Fa1/0/2-3,Fa1/0/5-6
Destination Ports : Fa1/0/20
Encapsulation : Replicate
Ingress : Disabled
 
   

This is an example of output for the show monitor session all command when ingress traffic forwarding is enabled:

Switch# show monitor session all
Session 1
---------
Type : Local Session
Source Ports :
Both : Fa1/0/2
Destination Ports : Fa1/0/3
Encapsulation : Native
Ingress : Enabled, default VLAN = 5
Ingress encap : DOT1Q
 
   
Session 2
---------
Type : Local Session
Source Ports :
Both : Fa1/0/8
Destination Ports : Fa1/0/12
Encapsulation : Replicate
Ingress : Enabled, default VLAN = 4
Ingress encap : Untagged

Related Commands

Command
Description

monitor session

Starts or modifies a SPAN or RSPAN session.


show mpls l2transport vc

Use the show mpl2 l2transport vc user EXEC command to provide information about the Ethernet over multiprotocol label switching (EoMPLS) virtual circuits (VCs) that have been enabled to route Layer 2 packets on a provider-edge device.

show mpls l2transport vc [detail] [summary] [vc-id] [vc-id-min - vc-id-max]

Syntax Description

detail

(Optional) Display provides detailed information about the VCs on a provider-edge device.

summary

(Optional) Display provides a summary of the configured VCs on the provider-edge device MPLS interfaces.

vcid

(Optional) Display information about the specified VC. The range is 1 to 4294967295.

vc-id-min - vc-id-max

(Optional) Display information about the specified range of VCs. The range is 1 to 4294967295.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

This is an example of output from the show mpls l2transport vc command:

Switch> show mpls l2transport vc
Transport Client     VC     Trans Local       Remote      Tunnel
VC ID     Intf       State  Type  VC Label    VC Label    Label
49        Vl60       UP     vlan  18          18          implc-null
50        Vl80       DOWN   vlan  unassigned  unassigned  not ready
52        Fa1/0/2    UP     ether 17          17          implc-null
 
   

Table 2-27 describes the fields in the display.

Table 2-27 show mpls l2 transport vc Field Descriptions

Field
Description

Transport VC ID

The virtual circuit identifier assigned to one of the interfaces on the device.

Client Intf

The ingress or egress interface through which the Layer 2 VLAN packet travels. The interface is a VLAN or a physical interface.

VC State

The state of the VC (UP or DOWN):

UP—The VC can carry traffic between the two VC end points. A VC is up when both the local and remote interfaces are programmed.

The local interface is programmed if the VC is configured and the client interface is up.

The remote interface is programmed if the remote interface is configured and there is a VC remote VC label and an IGP label. The IGP label means that there is a label-switched path (LSP) to the peer.

DOWN—The VC is not ready to carry traffic between the two VC end points.

Trans Type

The forwarding mode used.

Local VC Label

The VC label that a device signals to its peer device. The local VC label determines the egress interface of a packet arriving from the MPLS backbone.

Remote VC Label

The VC label of the remote peer device.

Tunnel Label

An IGP label used to route the packet over the MPLS backbone to the destination device that has the egress interface.


This is an example of the output from the show mpls l2transport vc summary command:

Switch> show mpls l2transport vc summary
MPLS interface VC summary (active vc(s) only):
 
   
VC summary (active/non-active) by destination:
  destination: 172.22.255.255, Number of locally configured vc(s): 2
 
   

This is an example of the output from the show mpls l2transport vc detail command:

Switch> show mpls l2transport vc detail
vcid: 49, type: vlan  , local groupid: 32, remote groupid: 36 (vc is up)
client: Vl60 is up, destination: 192.168.255.255, Peer LDP Ident: 192.168.255.25
5:0
local label: 18, remote label: 18, tunnel label: implc-null
outgoing interface: Gi1/1/1, next hop: 10.2.0.2
Local MTU: 1500, Remote MTU: 1500
Remote interface description: Vlan60
Packet totals(in/out): 0/0
byte totals(in/out): 0/0
 
   
vcid: 50, type: vlan  , local groupid: 33, remote groupid: -1 (vc is down)
client: Vl80 is not up, destination: 192.168.255.255, Peer LDP Ident: 192.168.25
5.255:0
local label: unassigned, remote label: unassigned, tunnel label: not ready
Local MTU: 1500, Remote MTU: 0
Remote interface description:
Packet totals(in/out): 0/0
byte totals(in/out): 0/0
 
   
vcid: 52, type: ether , local groupid: 3, remote groupid: 3 (vc is up)
client: Fa1/0/2 is up, destination: 192.168.255.255, Peer LDP Ident: 192.168.255
.255:0
local label: 17, remote label: 17, tunnel label: implc-null
outgoing interface: Gi1/1/1, next hop: 10.2.0.2
Local MTU: 1500, Remote MTU: 1500
Remote interface description: FastEthernet1/0/2
Packet totals(in/out): 606955/0
byte totals(in/out): 47342490/0
 
   
Table 2-28 describes the fields in the display.

Table 2-28 show mpls l2 transport vc detail Field Descriptions 

Field
Description

vcid

The virtual circuit identifier assigned to one of the interfaces on the device.

type

The forwarding mode used.

local groupid

The ID used to group VCs locally. EoMPLS groups VCs by the hardware port, which is unique for each port on a device.

remote groupid

The ID used by the peer to group several VCs.

vc is up

or

vc is down

The state of the VC (up or down):

Up—The VC can carry traffic between the two VC end points. A VC is up when both the local and remote interfaces are programmed.

The local interface is programmed if the VC is configured and the client interface is up.

The remote interface is programmed if the remote interface is configured and there is a VC remote VC label and an IGP label. The IGP label means that there is a label-switched path (LSP) to the peer.

Down—The VC is not ready to carry traffic between the two VC end points.

client

The ingress or egress interface through which the Layer 2 VLAN packet travels. The interface is a VLAN or physical interface.

destination

The destination specified for this VC. You specify the destination IP address as part of the mpls l2transport route interface configuration command.

Peer LDP Ident

The LDP IP address of the targeted peer.

local label

The VC label that a device signals to its peer device. The local VC label determines the egress interface of a packet arriving from the MPLS backbone.

remote label

The VC label of the remote peer device.

tunnel label

An IGP label used to route the packet over the MPLS backbone to the destination device with the egress interface.

Outgoing interface

The egress interface of the VC.

Next hop

The IP address of the next hop.

Local MTU

The maximum transmission unit specified for the client interface.

Remote MTU

The maximum transmission unit specified for the remote device client interface.

Remote interface description

The interface on the remote device that has been enabled to send and receive Layer 2 packets.

Packet totals (in/out)

The total number of packets forwarded in each direction.

byte totals (in/out)

The total number of bytes forwarded in each direction.


Related Commands

Command
Description

mpls l2transport route

Enables routing Layer 2 packets over a specified point-to-point VC by using EoMPLS.


show mvr

Use the show mvr privileged EXEC command without keywords to display the current Multicast VLAN Registration (MVR) global parameter values, including whether or not MVR is enabled, the MVR multicast VLAN, the maximum query response time, the number of multicast groups, and the MVR mode (dynamic or compatible).

show mvr

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

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

Switch# show mvr
MVR Running: TRUE
MVR multicast VLAN: 1
MVR Max Multicast Groups: 256
MVR Current multicast groups: 0
MVR Global query response time: 5 (tenths of sec)
MVR Mode: compatible
 
   

In the preceding display, the maximum number of multicast groups is fixed at 256. The MVR mode is either compatible (for inter-operability with Catalyst 2900 XL and Catalyst 3500 XL switches) or dynamic (where operation is consistent with IGMP snooping operation and dynamic MVR membership on source ports is supported).

Related Commands

Command
Description

mvr (global configuration)

Enables and configures multicast VLAN registration on the switch.

mvr (interface configuration)

Configures MVR ports.

show mvr interface

Displays the configured MVR interfaces, status of the specified interface, or all multicast groups to which the interface belongs when the interface and members keywords are appended to the command.

show mvr members

Displays all ports that are members of an MVR multicast group or, if there are no members, means the group is inactive.


show mvr interface

Use the show mvr interface privileged EXEC command without keywords to display the Multicast VLAN Registration (MVR) receiver and source ports. Use the command with keywords to display MVR parameters for a specific receiver port.

show mvr interface [interface-id [members [vlan vlan-id]]]

Syntax Description

interface-id

(Optional) Display MVR type, status, and Immediate Leave setting for the interface.

Valid interfaces include physical ports (including type, module, and port number.

members

(Optional) Display all MVR groups to which the specified interface belongs.

vlan vlan-id

(Optional) Display all MVR group members on this VLAN. The VLAN ID range is 1 to 1001 and 1006 to 4094.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(35)SE

The Mode and VLAN fields were added to the output display.


Usage Guidelines

If you enter only the show mvr interface command, the output shows all MVR-enabled ports on the switch.

If you enter the show mvr interface interface-id command and the specified port is a non-MVR port, the output displays NON MVR in the Type field. For active MVR ports, it displays the port type (RECEIVER or SOURCE), mode (access or trunk), VLAN, status, and Immediate-Leave setting.

If you enter the members keyword, all MVR group members on the interface are displayed. If you enter a VLAN ID, all MVR group members in the VLAN are displayed.

Examples

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

Switch# show mvr interface
Port    Type            Mode            VLAN    Status          Immediate Leave
----    ----            ----            ----    -------         ---------------
Fa0/1  Receiver        Trunk          1      ACTIVE/UP      DISABLED  
Fa0/1  Receiver        Trunk          2000   ACTIVE/DOWN    DISABLED  
Fa0/2  Receiver        Trunk          2      ACTIVE/UP      DISABLED  
Fa0/2  Receiver        Trunk          3000   ACTIVE/UP      DISABLED  
Fa0/3  Receiver        Trunk          2      ACTIVE/UP      DISABLED  
Fa0/3  Receiver        Trunk          3000   ACTIVE/UP      DISABLED 
Fa0/10 Source          Access         10     ACTIVE/UP      DISABLED 

In the preceding display, Status is defined as follows:

Active means that the port is part of a VLAN

Up/Down means that the port is forwarding/nonforwarding

Inactive means that the port is not yet part of any VLAN.

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

switch# show mvr interface fa0/10         
Port    Type            Mode            VLAN    Status          Immediate Leave
----    ----            ----            ----    -------         ---------------
Fa0/10  RECEIVER        Trunk           201     ACTIVE/DOWN     DISABLED
 
   

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

Switch# show mvr interface fastethernet1/0/6 members
239.255.0.0     DYNAMIC ACTIVE
239.255.0.1     DYNAMIC ACTIVE
239.255.0.2     DYNAMIC ACTIVE
239.255.0.3     DYNAMIC ACTIVE
239.255.0.4     DYNAMIC ACTIVE
239.255.0.5     DYNAMIC ACTIVE
239.255.0.6     DYNAMIC ACTIVE
239.255.0.7     DYNAMIC ACTIVE
239.255.0.8     DYNAMIC ACTIVE
239.255.0.9     DYNAMIC ACTIVE

Related Commands

Command
Description

mvr (global configuration)

Enables and configures multicast VLAN registration on the switch.

mvr (interface configuration)

Configures MVR ports.

show mvr

Displays the global MVR configuration on the switch.

show mvr members

Displays all receiver ports that are members of an MVR multicast group.


show mvr members

Use the show mvr members privileged EXEC command to display all receiver and source ports that are currently members of an IP multicast group.

show mvr members [ip-address]

Syntax Description

ip-address

(Optional) The IP multicast address. If the address is entered, all receiver and source ports that are members of the multicast group are displayed. If no address is entered, all members of all Multicast VLAN Registration (MVR) groups are listed. If a group has no members, the group is listed as Inactive.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.

12.2(25)SEF

The VLAN and Membership fields were added to the output display.


Usage Guidelines

The show mvr members command applies to receiver and source ports. For MVR compatible mode, all source ports are members of all multicast groups.

Examples

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

Switch# show mvr members
MVR Group     Status   Members  VLAN   Membership
------------  ------   -------  ----   ----------
239.1.1.1     ACTIVE   Fa0/1    1      Static
239.1.1.1     ACTIVE   Fa0/1    2000   Static
239.1.1.1     ACTIVE   Fa0/2    2      Static
239.1.1.1     ACTIVE   Fa0/2    3000   Static
239.1.1.2     ACTIVE   Fa0/1    1      Static
239.1.1.2     ACTIVE   Fa0/2    2      Static
 
   
<output truncated>
 
   
239.255.0.255   INACTIVE        None
239.255.1.0     INACTIVE        None 

This is an example of output from the show mvr members ip-address command. It shows how to view the members of the IP multicast group 239.255.0.2.

Switch# show mvr members 239.255.0.2
Switch# show mvr members 239.255.0.2
239.255.0.2     ACTIVE               Fa1/0/1(d), Fa1/0/2(d), Fa1/0/3(d) 
                                     Fa1/0/4(d), Fa1/0/5(s)

Related Commands

Command
Description

mvr (global configuration)

Enables and configures multicast VLAN registration on the switch.

mvr (interface configuration)

Configures MVR ports.

show mvr

Displays the global MVR configuration on the switch.

show mvr interface

Displays the configured MVR interfaces, status of the specified interface, or all multicast groups to which the interface belongs when the members keyword is appended to the command.


show pagp

Use the show pagp user EXEC command to display Port Aggregation Protocol (PAgP) channel-group information.

show pagp [channel-group-number] {counters | internal | neighbor}

Syntax Description

channel-group-number

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

counters

Display traffic information.

internal

Display internal information.

neighbor

Display neighbor information.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Usage Guidelines

You can enter any show pagp command to display the active channel-group information. To display the nonactive information, enter the show pagp command with a channel-group number.

Examples

This is an example of output from the show pagp 1 counters command:

Switch> show pagp 1 counters
          Information         Flush        PAgP
Port      Sent    Recv     Sent    Recv    Err Pkts
---------------------------------------------------
Channel group: 1
Gi1/0/1    0       0        0       0       0    
Gi1/0/1    0       0        0       0       0 
 
   

This is an example of output from the show pagp 1 internal command:

Switch> show pagp 1 internal
Flags:  S - Device is sending Slow hello.  C - Device is in Consistent state.
        A - Device is in Auto mode.
Timers: H - Hello timer is running.        Q - Quit timer is running.
        S - Switching timer is running.    I - Interface timer is running.
 
   
Channel group 1
                                  Hello    Partner  PAgP     Learning  Group
Port        Flags State   Timers  Interval Count   Priority   Method  Ifindex
Gi1/0/1     SC    U6/S7   H       30s      1        128        Any      16
Gi1/0/2     SC    U6/S7   H       30s      1        128        Any      16
 
   

This is an example of output from the show pagp 1 neighbor command:

Switch> show pagp 1 neighbor
Flags:  S - Device is sending Slow hello.  C - Device is in Consistent state.
        A - Device is in Auto mode.        P - Device learns on physical port.
 
   
Channel group 1 neighbors
            Partner              Partner          Partner           Partner Group
Port        Name                 Device ID        Port         Age  Flags   Cap.
Gi1/0/1     switch-p2            0002.4b29.4600   Gi1/0/1       9s  SC      10001 
Gi1/0/2     switch-p2            0002.4b29.4600   Gi1/0/2      24s  SC      10001 

Related Commands

Command
Description

clear pagp

Clears PAgP channel-group information.


show parser macro

Use the show parser macro user EXEC command to display the parameters for all configured macros or for one macro on the switch.

show parser macro [{brief | description [interface interface-id] | name macro-name}]

Syntax Description

brief

(Optional) Display the name of each macro.

description [interface interface-id]

(Optional) Display all macro descriptions or the description of a specific interface.

name macro-name

(Optional) Display information about a single macro identified by the macro name.


Command Modes

User EXEC

Command History

Release
Modification

12.2(25)EY

This command was introduced.


Examples

This is a partial output example from the show parser macro command. The output for the Cisco-default macros varies depending on the switch platform and the software image running on the switch:

Switch# show parser macro
Total number of macros = 6
--------------------------------------------------------------
Macro name : cisco-global
Macro type : default global
# Enable dynamic port error recovery for link state
# failures
errdisable recovery cause link-flap
errdisable recovery interval 60
 
   
<output truncated>
 
   
--------------------------------------------------------------
Macro name : cisco-desktop
Macro type : default interface
# macro keywords $AVID
# Basic interface - Enable data VLAN only
# Recommended value for access vlan (AVID) should not be 1
switchport access vlan $AVID
switchport mode access
 
   
<output truncated>
 
   
--------------------------------------------------------------
Macro name : cisco-phone
Macro type : default interface
# Cisco IP phone + desktop template
# macro keywords $AVID $VVID
# VoIP enabled interface - Enable data VLAN
# and voice VLAN (VVID)
# Recommended value for access vlan (AVID) should not be 1
switchport access vlan $AVID
switchport mode access
 
   
<output truncated>
 
   
--------------------------------------------------------------
Macro name : cisco-switch
Macro type : default interface
# macro keywords $NVID
# Access Uplink to Distribution
# Do not apply to EtherChannel/Port Group
# Define unique Native VLAN on trunk ports
# Recommended value for native vlan (NVID) should not be 1
switchport trunk native vlan $NVID
 
   
<output truncated>
 
   
--------------------------------------------------------------
Macro name : cisco-router
Macro type : default interface
# macro keywords $NVID
# Access Uplink to Distribution
# Define unique Native VLAN on trunk ports
# Recommended value for native vlan (NVID) should not be 1
switchport trunk native vlan $NVID
 
   
<output truncated>
 
   
--------------------------------------------------------------
Macro name : snmp
Macro type : customizable
 
   
#enable port security, linkup, and linkdown traps
snmp-server enable traps port-security
snmp-server enable traps linkup
snmp-server enable traps linkdown
#set snmp-server host
snmp-server host ADDRESS
#set SNMP trap notifications precedence
snmp-server ip precedence VALUE
 
   
--------------------------------------------------------------
 
   

This is an example of output from the show parser macro name command:

Switch# show parser macro name standard-switch10
Macro name : standard-switch10
Macro type : customizable
macro description standard-switch10
# Trust QoS settings on VOIP packets
auto qos voip trust
# Allow port channels to be automatically formed
channel-protocol pagp
 
   

This is an example of output from the show parser macro brief command:

Switch# show parser macro brief
    default global   : cisco-global
    default interface: cisco-desktop
    default interface: cisco-phone
    default interface: cisco-switch
    default interface: cisco-router
    customizable     : snmp
 
   

This is an example of output from the show parser description command:

Switch# show parser macro description 
Global Macro(s): cisco-global
Interface    Macro Description(s)
--------------------------------------------------------------
Fa1/0/1        standard-switch10
Fa1/0/2       this is test macro
--------------------------------------------------------------
 
   

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

Switch# show parser macro description interface fastethernet1/0/2
Interface    Macro Description
--------------------------------------------------------------
Fa1/0/2      this is test macro
--------------------------------------------------------------

Related Commands

Command
Description

macro apply

Applies a macro on an interface or applies and traces a macro on an interface.

macro description

Adds a description about the macros that are applied to an interface.

macro global

Applies a macro on a switch or applies and traces a macro on a switch.

macro global description

Adds a description about the macros that are applied to the switch.

macro name

Creates a macro.

show running-config

Displays the operating configuration. For syntax information, use this link to the Cisco IOS Release 12.2 Command Reference listing page: http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/prod_command_reference_list.html
Select the Cisco IOS Commands Master List, Release 12.2 to navigate to the command.


show policy-map

Use the show policy-map user EXEC command to display quality of service (QoS) policy maps, which define the traffic policy for a traffic class. Policy maps can include policers that specify the bandwidth limitations and the action to take if the limits are exceeded.

show policy-map [policy-map-name [class class-name] | interface interface-id [input | output] [class class-name]]

Syntax Description

policy-map-name [class class-name]

(Optional) Display the specified policy map and policy actions for the specified class.

interface interface-id [input | output] [class class-name]

(Optional) For ingress ports, display the policy-map name that is applied to the specified port. For enhanced-services (ES) ports, display the policy-map configuration, Weighted Random Early Detection (WRED) statistics, and policer counters.

Note The show policy-map interface command displays data for hierarchical policy-maps attached to the ES interfaces. This command does not show counters for non-hierarchical policies on the ES interfaces, or any policies attached to non-ES interfaces.

The keywords have these meanings:

input—Display the ingress policy-map name applied to the specified port.

output—Display the egress policy-map information applied to the specified ES port.

class class-name—Display statistics for an individual class.


Command Modes

User EXEC

Command History

Release
Modification

12.1(14)AX

This command was introduced.


Examples

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

Switch> show policy-map
 
   
Policy Map p1
  class  c1
      Bandwidth 20 (%)
      exponential weight 9
      dscp     min-threshold    max-threshold    mark-probability
      ----------------------------------------------------------
 
   
      af11      -                -                1/10
      af12      -                -                1/10
      af13      -                -                1/10
      af21      -                -                1/10
      af22      -                -                1/10
      af23      -                -                1/10
      af31      -                -                1/10
      af32      -                -                1/10
      af33      -                -                1/10
      af41      -                -                1/10
      af42      -