ME 3800X and ME 3600X Switch Command Reference, Release 15.2(2)S

rmon collection stats

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

rmon collection stats index [owner name]

no rmon collection stats index [owner name]

Syntax Description

index	Remote Network Monitoring (RMON) collection control index. The range is 1 to 65535.
owner name	(Optional) Owner of the RMON collection.

Defaults

The RMON statistics collection is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

The RMON statistics collection command is based on hardware counters.

Examples

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

Switch(config)# interface gigabitethernet0/1

Switch(config-if)# rmon collection stats 2 owner root

Related Commands

Command	Description
show rmon statistics	Displays RMON statistics.

service instance

To configure an Ethernet service instance on the interface and to enter Ethernet service-instance configuration mode, use the service instance command in interface configuration mode. To delete the service instance, use the no form of this command.

service instance id ethernet [evc-id]

no service instance id

Syntax Description

id	Defines a service instance identifier, a per-interface service identifier that does not map to a VLAN. The range is 1 to 4000.
ethernet	Identifies the service instance as an Ethernet instance.
evc-id	(Optional) Attaches 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(52)EY	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.

•description—adds a specific description for the service instance.

•encapsulation—configures Ethernet frame match criteria.

•errdisable recovery cause mac-security—configure the error disable recovery timer interval from a MAC security violation.

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

•l2prototol {peer | tunnel}—configures Layer 2 control protocol processing.

•mac security—configures MAC address security.

•no— negates a command or returns a command to its default setting.

•service-policy—attach a policy map to the EFP.

•shutdown—shuts down the EFP (no shutdown brings up the EFP)

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

To enable the password-recovery mechanism (the default), use the service password-recovery command in global configuration mode. This mechanism allows an end user with physical access to the switch to press the break key on the console terminal to interrupt the boot process while the switch is powering up and to assign a new password.

To disable part of the password-recovery functionality, use the no form of this command. 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.2(52)EY	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. This provides configuration file security by ensuring that only authenticated and authorized users have access to the configuration file and prevents users from accessing the configuration file by using the password recovery process.

The password recovery procedure requires using a break key. After the switch performs power-on self test (POST), the switch begins the autoboot process. The boot loader prompts the user for a break key character during the boot-up sequence, as shown in this example:

***** The system will autoboot in 5 seconds ***** 

Send a break key to prevent autobooting. 

You must enter the break key on the console terminal within 5 seconds of receiving the message that the system will autoboot. A user with physical access to the switch presses the break key on the console terminal within 5 seconds of receiving the message that flash memory is initializing. The System LED flashes green until the break key is accepted. After the break key is accepted, the System LED turns off until after the switch boots.

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 to the default configuration, the normal boot process continues as if the break key had not been pressed. If you choose to reset the system to the default configuration, the configuration file in flash memory is deleted, and the VLAN database file, flash:vlan.dat (if present), is deleted.

---

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 configuration file in a location away from the switch in case the end user uses the password recovery procedure and sets the system back to default values. Do not keep a backup copy of the configuration file on the switch.

---

You can enter the show version privileged EXEC command to determine if password recovery is enabled or disabled.

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 and service-instance configuration modes)

To apply a policy map defined by the policy-map command to the incoming or outgoing traffic of a target, use the service-policy command in interface configuration mode or service-instance configuration mode. To remove the policy map and port association, use the no form of this command.

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

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

Syntax Description

input	Applies the policy map to the input of a target (physical port or Ethernet flow point (EFP) service instance.
output	Applies the policy map to the output of a target.
policy-map-name	The specified policy map to be applied.

Defaults

No policy maps are attached to the port or service instance.

Command Modes

Interface configuration or service-instance configuration mode

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

Only one input policy map and one output policy map can be attached to a target, which can be a physical interface or Ethernet flow point service instance.

The switch supports a limit of three unique queue-limit configurations across all output policy maps at any time. Multiple policy maps can share the same queue-limit configuration.If you try to attach an output policy map with a fourth unique queue-limit configuration, you see this error message:

QoS: Configuration failed. Maximum number of allowable unique queue-limit 
configurations exceeded.

You can attach input or output policy maps to a Gigabit Ethernet port 10 Gigabit Ethernet port or to a service instance. You cannot attach policy maps to switch virtual interfaces (SVIs) and EtherChannel interfaces.

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

Examples

This example shows how to apply plcmap1 as an output policy map to a port:

Switch(config)# interface gigabitethernet0/1

Switch(config-if)# service-policy output plcmap1

This example shows how to remove plcmap2 from a port:

Switch(config)# interface gigabitethernet0/2

Switch(config-if)# no service-policy output plcmap2

This example shows how to apply plcmap1 as an output policy map to a service instance:

Switch (config)# interface gigabitethernet0/2

Switch (config-if)# service instance 1 Ethernet 

Switch (config-if-srv)# service-policy output plcmap1

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 quality of service (QoS) policy maps.
show policy-map interface [interface-id]	Displays policy maps configured on the specified interface or on all interfaces.
show running-config	Displays the operating configuration.

set cos

To set a Layer 2 class of service (CoS) value in the packet, use the set cos command in policy-map class configuration mode. To remove traffic marking, use the no form of this command.

set cos cos_value

no set cos cos_value

Syntax Description

cos_value

Enters an IEEE 802.1Q class of service/user priority value with which to classify traffic. The range is from 0 to 7.

Defaults

No traffic marking is defined.

Command Modes

Policy-map class configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You can configure set cos with all other marking actions, specifically set dscp, set discard-class, set mpls, set precedence, and set qos-group, for the same class.

Use the set cos command if you want to mark a packet that is being sent to a switch. Switches can leverage Layer 2 header information including a CoS value marking.

You can use the match cos class-map configuration command and the set cos policy-map class configuration command together to allow switches to interoperate and provide quality of service (QoS) based on the CoS markings. You can also configure Layer 2 to Layer 3 mapping by matching on the CoS value because switches can already match and set CoS values.

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

Examples

This example shows how to set all FTP traffic to cos 3:

Switch(config)# policy-map policy_ftp

Switch(config-pmap)# class ftp_class

Switch(config-pmap-c)# set cos 3

Switch(config-pmap-c)# exit

Related Commands

Command	Description
class	Defines a traffic classification match criteria for the specified class-map name.
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.

set discard-class

To classify packets by entering the exact value to be marked for traffic to be discarded, use the set discard-class command in policy-map class configuration mode. To remove the discard-class value, use the no form of this command.

set discard-class value

no discard-class value

Syntax Description

value

Sets the value to be marked for discarding traffic. The range is from 0 to 7.

Defaults

No traffic marking is defined.

Command Modes

Policy-map class configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You can configure set discard-class with all other marking actions, specifically set cos, set dscp, set mpls, set precedence, and set qos-group, for the same class.

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

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

Examples

This example shows how to set all FTP traffic with a discard value of 5:

Switch(config)# policy-map policy_ftp

Switch(config-pmap)# class ftp_class

Switch(config-pmap-c)# set discard-class 5

Switch(config-pmap-c)# exit

Related Commands

Command	Description
class	Defines a traffic classification match criteria for the specified class-map name.
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.

set dscp

To mark IPv4 traffic by setting a Differentiated Services Code Point (DSCP) value in the type of service (ToS) byte of the packet, use the set [ip] dscp command in policy-map class configuration mode. To remove the traffic marking, use the no form of this command.

set [ip] dscp dscp_value

no set [ip] dscp dscp_value

---

Note Entering ip dscp is the same as entering dscp.

---

Syntax Description

dscp-value

Specifies a DSCP value with which to classify traffic. The range is from 0 to 63. You also can enter a mnemonic name for a commonly used value.

Defaults

No traffic marking is defined.

Command Modes

Policy-map class configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You can configure set dscp with other marking actions, specifically set cos, set discard-class, set mpls, and set qos-group, for the same class.

You cannot use the set dscp command with the set precedence command to mark the same packet. DSCP values and IP precedence values are mutually exclusive. A packet can have one value or the other, but not both.

After DSCP bits are set, other quality of service (QoS) features can then operate on the bit settings.

The network gives priority (or some type of expedited handling) to marked traffic. Typically, you set the DSCP value at the edge of the network (or administrative domain) and data is then queued according to the precedence. Class-based weighted fair queuing (CBWFQ) can speed up handling for high-precedence traffic at congestion points. Weighted Tail Drop (WTD) ensures that high-precedence traffic has lower loss rates than other traffic during times of congestion.

Instead of using numeric values, you can also specify the dscp-value by using the reserved keywords EF, AF11, and AF12.

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

Examples

This example shows how to set all FTP traffic to DSCP 10:

Switch(config)# policy-map policy_ftp

Switch(config-pmap)# class ftp_class

Switch(config-pmap-c)# set dscp 10

Switch(config-pmap-c)# exit

Related Commands

Command	Description
class	Defines a traffic classification match criteria for the specified class-map name.
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.

set mpls

To set an multiprotocol label switching (MPLS) experimental (EXP) value in the inbound packet to classify packets, use the set mpls command in policy-map class configuration mode. To remove the group MPLS value, use the no form of this command.

set mpls experimental {imposition | topmost} experimental _value

no set mpls experimental {imposition | topmost} experimental _value

Syntax Description

imposition	Specifies that the MPLS experimental value is set at tag imposition. This means that the MPLS value in a packet header is set with the new value after the packet is switched. This applies only to MPLS packets that are MPLS routed, but to all MPLS tags that are imposed by the switch.
topmost	Specifies that the MPLS experimental value is set for the outermost or topmost label. This marks all valid MPLS packets.
experimental _value	Sets the MPLS value to use to classify traffic. The range is from 0 to 7.

Defaults

No traffic marking is defined.

Command Modes

Policy-map class configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You can configure set mpls with all other marking actions, specifically set cos, set discard-class, set dscp, set qos-group, and set precedence, for the same class.

In an MPLS network, packet IP precedence bits are copied into the MPLS EXP field at the edge of the network. If a service provider wants to set a QoS value for an MPLS packet to a different value, instead of overwriting the value in the IP precedence field that belongs to a customer, the service provider can set the MPLS experimental field. The IP header remains available for the customer's use, and the QoS of an IP packet is not changed as the packet travels through the MPLS network.

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

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

Examples

This example shows how to classify all MPLS packets with a value of 5:

Switch(config)# policy-map policy_ftp

Switch(config-pmap)# class mpls_class

Switch(config-pmap-c)# set mpls topmost 5

Switch(config-pmap-c)# exit

Related Commands

Command	Description
class	Defines a traffic classification match criteria for the specified class-map name.
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.

set network-clocks

To force selection of a particular Synchronous Ethernet (SyncE) network clock or to configure automatic clock selection, use the set network-clocks command in privileged EXEC mode.

set network-clocks {automatic | force-select | next-select}

---

Note There is not a no version of this command.

---

Syntax Description

automatic	Selects automatic clock selection. The clock with the highest priority is always automatically selected as the input clock.
force-select	Forces the system to reselect a valid network clock with the highest priority.
next-select	Forces the system to select the valid clock with the next highest priority.

Defaults

The default is automatic.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

The input network clock reference selection can be forced or automatically selected using an algorithm based on the highest priority valid input clock.

•In revertive mode, the forced clock automatically becomes the selected reference.

•In non-revertive mode, the forced clock is selected only with the existing reference is invalidated or made unavailable.

You use the network-clock-select mode {nonrevert | revert} global configuration command to set the mode.

You can use set network-clocks next-select command to scroll through the set of available clocks.

After you force the network clock selection by entering the set network-clocks force-select or set network-clocks next-select command, the system remains locked to the selected clock even if it becomes invalid.

You can verify your settings by entering the show network-clock privileged EXEC command.

Examples

This example shows how to set clock selection to automatic:

Switch# set network-clocks automatic

Related Commands

Command	Description
network-clock-select	Configures the network clock for the switch.
show network-clocks	Displays SyncE configuration on the switch.

set precedence

To mark IPv4 traffic by setting an IP-precedence value in the packet, use the set [ip] precedence command in policy-map class configuration mode. To remove traffic marking, use the no form of this command.

set [ip] precedence precedence_value

no set [ip] precedence precedence_value

---

Note Entering ip precedence is the same as entering precedence.

---

Syntax Description

precedence_value

Specifies an IPv4 precedence value with which to classify traffic. The range is 0 to 7. You also can enter a mnemonic name for a commonly used value. •0 to 7—Enter up to 4 precedence values separated by spaces. •critical—Match packets with critical precedence (5). •flash—Match packets with flash precedence (3). •flash-override—Match packets with flash override precedence (4). •immediate—Match packets with immediate precedence (2). •internet—Match packets with internetwork control precedence (6). •network—Match packets with network control precedence (7). •priority—Match packets with priority precedence (1). •routine—Match packets with routine precedence (0).

Defaults

No traffic marking is defined.

Command Modes

Policy-map class configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You can configure set precedence with other marking actions, specifically set cos, set discard-class, set mpls, and set qos-group, for the same class.

You cannot use the set precedence command with the set dscp command to mark the same packet. DSCP values and IP precedence values are mutually exclusive. A packet can have one value of the other, but not both.

After precedence bits are set, other quality of service (QoS) features can then operate on the bit settings.

The network gives priority (or some type of expedited handling) to marked traffic. Typically, you set the precedence value at the edge of the network (or administrative domain) and data is then queued according to the precedence. Class-based weighted fair queuing (CBWFQ) can speed up handling for high-precedence traffic at congestion points. Weighted Tail Drop (WTD) ensures that high-precedence traffic has lower loss rates than other traffic during times of congestion.

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

Examples

This example shows how to give all FTP traffic an IP precedence value of 5:

Switch(config)# policy-map policy_ftp

Switch(config-pmap)# class ftp_class

Switch(config-pmap-c)# set precedence 5

Switch(config-pmap-c)# exit

Related Commands

Command	Description
class	Defines a traffic classification match criteria for the specified class-map name.
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.

set qos-group

To set a quality of service (QoS) group identifier that can be used later to classify packets, use the set qos-group command in policy-map class configuration mode. To remove the group identifier, use the no form of this command.

set qos-group value

no set qos-group value

Syntax Description

value

Sets the QoS group value to use to classify traffic. The range is from 0 to 99.

Defaults

No traffic marking is defined.

Command Modes

Policy-map class configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You can configure set qos-group with all other marking actions, specifically set cos, set discard-class, set dscp, set mpls, and set precedence, for the same class.

Use this command to associate a QoS group value with a traffic flow as it enters the switch, which can then be used in an output policy map to identify the flow.

A maximum of 100 QoS groups (0 through 99) is supported on the switch.

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

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

Examples

This example shows how to set all FTP traffic to QoS group 5:

Switch(config)# policy-map policy_ftp

Switch(config-pmap)# class ftp_class

Switch(config-pmap-c)# set qos-group 5

Switch(config-pmap-c)# exit

Related Commands

Command	Description
class	Defines a traffic classification match criteria for the specified class-map name.
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.

setup

To configure the switch with its initial configuration, use the setup command in privileged EXEC mode.

setup

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	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 or return to the setup program or the command-line prompt without saving it.

Examples

This is an example of output from the setup command:

Switch# setup

--- System Configuration Dialog ---

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

At any point you may enter a question mark '?' for help.

Use ctrl-c to abort configuration dialog at any prompt.

Default settings are in square brackets '[]'.

Basic management setup configures only enough connectivity

for management of the system, extended setup will ask you

to configure each interface on the system.

Would you like to enter basic management setup? [yes/no]: yes

Configuring global parameters:

Enter host name [Switch]:host-name

  The enable secret is a password used to protect access to

  privileged EXEC and configuration modes. This password, after

  entered, becomes encrypted in the configuration.

  Enter enable secret: enable-secret-password

  The enable password is used when you do not specify an

  enable secret password, with some older software versions, and

  some boot images.

  Enter enable password: enable-password

  The virtual terminal password is used to protect

  access to the router over a network interface.

  Enter virtual terminal password: terminal-password

  Configure SNMP Network Management? [no]: yes

  Community string [public]: 

Current interface summary

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

Interface                  IP-Address      OK? Method Status                Protocol

Vlan1                      172.20.135.202  YES NVRAM  up                    up

GigabitEthernet0/1         unassigned      YES unset  up                    up

GigabitEthernet0/2         unassigned      YES unset  up                    down

<output truncated>

Port-channel1              unassigned      YES unset  up                    down

Enter interface name used to connect to the

management network from the above interface summary: vlan1

Configuring interface vlan1:

Configure IP on this interface? [yes]: yes 

IP address for this interface: ip_address

Subnet mask for this interface [255.0.0.0]: subnet_mask

The following configuration command script was created:

hostname host-name

enable secret 5 $1$LiBw$0Xc1wyT.PXPkuhFwqyhVi0

enable password enable-password

line vty 0 15

password terminal-password

snmp-server community public

!

no ip routing

!

interface GigabitEthernet0/1

no ip address

!

interface GigabitEthernet0/2

no ip address

! 

end

Use this configuration? [yes/no]: yes

!

[0] Go to the IOS command prompt without saving this config.

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

[2] Save this configuration to nvram and exit.

Enter your selection [2]:

Related Commands

Command	Description
show running-config	Displays the operating configuration.
show version	Displays version information for the hardware and firmware.

shape average

To configure class-based or port shaping by specifying the average traffic shaping rate or percentage, use the shape average command in policy-map class configuration mode. To set port shaping, use the command with the class class-default. To remove traffic shaping, use the no form of this command.

shape average {target bps | percent value}

no shape average {target bps | percent value}

Syntax Description

target bps	Sets the target average rate in bits per second (bps). The range is from 1000 to 1000000000.
percent value	Sets the percentage of interface bandwidth. The range is 0 to 100 percent. The percentage is calculated based on the peak information rate (PIR) of the parent class. If there is no configured PIR at any level, this is the percentage of the interface speed. Setting the percent to 0 disables shaping.

Defaults

No traffic shaping is defined.

Command Modes

Policy-map class configuration

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You use the shape average policy-map class command to control output traffic. Shaping is not supported in input policy maps.

Traffic shaping limits the rate of transmission of data. Configuring traffic shaping for a user-defined class or class-default for class-based shaping sets the peak information rate (PIR) for that class. Configuring traffic shaping for the class class-default when it is the only class in the policy map that is attached to an interface sets the PIR for the interface (port shaping).

You cannot configure shape average in a class that includes priority queueing (configured with the priority policy-map class configuration command).

The shape average command uses a default queue limit for the class. You can change the queue limit by using the queue-limit policy-map class command, overriding the default that is set by the shape average command.

Port shaping is applied to all traffic leaving an interface. It uses a policy map with only class default when the maximum bandwidth for the port is specified by using the shape average command. A child policy can be attached to the class-default in a hierarchical policy map format to specify class-based and VLAN-based actions.

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

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

Examples

This example shows how to configure traffic shaping for outgoing traffic on a Gigabit Ethernet port so that outclass1, outclass2, and outclass3 get a maximum of 50, 20, and 10 Mb/s of the available port bandwidth.

Switch(config)# policy-map out-policy

Switch(config-pmap)# class classout1

Switch(config-pmap-c)# shape average 50000000

Switch(config-pmap-c)# exit

Switch(config-pmap)# class classout2

Switch(config-pmap-c)# shape average 20000000

Switch(config-pmap-c)# exit

Switch(config-pmap)# class classout3

Switch(config-pmap-c)# shape average 10000000

Switch(config-pmap-c)# exit

Switch(config-pmap)# exit

Switch(config)# interface gigabitethernet0/1

Switch(config-if)# service-policy output out-policy

Switch(config-if)# exit

This example shows how to configure port shaping by configuring a hierarchical policy map that shapes a port to 90 Mb/s, allocated according to the out-policy policy map configured in the previous example.

Switch(config)# policy-map out-policy-parent

Switch(config-pmap)# class class-default

Switch(config-pmap-c)# shape average 90000000

Switch(config-pmap-c)# service-policy out-policy

Switch(config-pmap-c)# exit

Switch(config-pmap)# exit

Switch(config)# interface gigabitethernet0/1

Switch(config-if)# service-policy output out-policy-parent

Switch(config-if)# exit

Related Commands

Command	Description
class	Defines a traffic classification match criteria for the specified class-map name.
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 policy-map interface [interface-id]	Displays policy maps configured on the specified interface or on all interfaces.

show access-lists

To display access control lists (ACLs) configured on the switch, use the show access-lists command in privileged EXEC mode.

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

Syntax Description

name	(Optional) Name of the ACL.
number	(Optional) ACL number. The range is 1 to 2699.
hardware counters	(Optional) Displays global hardware ACL statistics for switched and routed packets.
ipc	(Optional) Displays Interprocess Communication (IPC) protocol access-list configuration download information.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

---

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

---

Command Modes

Privileged EXEC

Command History

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

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

Examples

This is an example of output from the show 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

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

Switch# show access-lists hardware counters

L2 ACL INPUT Statistics

     Drop:                All frame count: 855

     Drop:                All bytes count: 94143

     Drop And Log:        All frame count: 0

     Drop And Log:        All bytes count: 0

     Bridge Only:         All frame count: 0

     Bridge Only:         All bytes count: 0

     Bridge Only And Log: All frame count: 0

     Bridge Only And Log: All bytes count: 0

     Forwarding To CPU:   All frame count: 0

     Forwarding To CPU:   All bytes count: 0

     Forwarded:           All frame count: 2121

     Forwarded:           All bytes count: 180762

     Forwarded And Log:   All frame count: 0

     Forwarded And Log:   All bytes count: 0

 L3 ACL INPUT Statistics

     Drop:                All frame count: 0

     Drop:                All bytes count: 0

     Drop And Log:        All frame count: 0

     Drop And Log:        All bytes count: 0

     Bridge Only:         All frame count: 0

     Bridge Only:         All bytes count: 0

     Bridge Only And Log: All frame count: 0

     Bridge Only And Log: All bytes count: 0

     Forwarding To CPU:   All frame count: 0

     Forwarding To CPU:   All bytes count: 0

     Forwarded:           All frame count: 13586

     Forwarded:           All bytes count: 1236182

     Forwarded And Log:   All frame count: 0

     Forwarded And Log:   All bytes count: 0

 L2 ACL OUTPUT Statistics

     Drop:                All frame count: 0

     Drop:                All bytes count: 0

     Drop And Log:        All frame count: 0

     Drop And Log:        All bytes count: 0

     Bridge Only:         All frame count: 0

     Bridge Only:         All bytes count: 0

     Bridge Only And Log: All frame count: 0

     Bridge Only And Log: All bytes count: 0

     Forwarding To CPU:   All frame count: 0

     Forwarding To CPU:   All bytes count: 0

     Forwarded:           All frame count: 232983

     Forwarded:           All bytes count: 16825661

     Forwarded And Log:   All frame count: 0

     Forwarded And Log:   All bytes count: 0

 L3 ACL OUTPUT Statistics

     Drop:                All frame count: 0

     Drop:                All bytes count: 0

     Drop And Log:        All frame count: 0

     Drop And Log:        All bytes count: 0

     Bridge Only:         All frame count: 0

     Bridge Only:         All bytes count: 0

     Bridge Only And Log: All frame count: 0

     Bridge Only And Log: All bytes count: 0

     Forwarding To CPU:   All frame count: 0

     Forwarding To CPU:   All bytes count: 0

     Forwarded:           All frame count: 514434

     Forwarded:           All bytes count: 39048748

     Forwarded And Log:   All frame count: 0

     Forwarded And Log:   All bytes count: 0

Related Commands

Command	Description
access-list	Configures a standard or extended numbered access list on the switch.
ip access list	Configures a named IP access list on the switch.
mac access-list extended	Configures a named or numbered MAC access list on the switch.

show archive status

To display the status of a new image being downloaded to a switch with the HTTP or the TFTP protocol, use the show archive status command in privileged EXEC mode.

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

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)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 show archive status command shows the status of the download.

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

Examples

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

Switch# show archive status

IDLE: No upgrade in progress

Switch# show archive status

LOADING: Upgrade in progress

Switch# show archive status

EXTRACT: Extracting the image

Switch# show archive status

VERIFY: Verifying software

Switch# show archive status

RELOAD: Upgrade completed. Reload pending

Related Commands

Command	Description
archive download-sw	Downloads a new image from a TFTP server to the switch.

show boot

To display the settings of the boot environment variables, use the show boot command in privileged EXEC mode.

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

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch# show boot

5d05h: %SYS-5-CONFIG_I: Configured from console by console

BOOT path-list      :

Config file         : flash:/config.text

Private Config file : flash:/private-config.text

Enable Break        : no

Manual Boot         : yes

HELPER path-list    :

Auto upgrade        : yes

Table 3-6 show boot Field Descriptions 

Field	Description
BOOT path-list	Displays a semicolon-separated list of executable files 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 Cisco IOS uses to read and write a nonvolatile copy of the system configuration.
Private Config file	Displays the filename that Cisco IOS uses to read and write a nonvolatile copy of the system configuration.
Enable Break	Displays whether a break during booting 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.

Related Commands

Command	Description
boot config-file	Specifies the filename that Cisco IOS uses to read and write a nonvolatile copy of the system configuration.
boot enable-break	Enables interrupting the automatic boot process.
boot manual	Enables manually booting the switch during the next boot cycle.
boot private-config-file	Specifies the filename that Cisco IOS uses to read and write a nonvolatile copy of the private configuration.
boot system	Specifies the Cisco IOS image to load during the next boot cycle.

show cable-diagnostics tdr

To display the Time Domain Reflector (TDR) results, use the show cable-diagnostics tdr command in privileged EXEC mode.

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

Syntax Description

interface-id	Specifies the interface on which TDR was run.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

TDR is supported only on copper Ethernet 10/100 ports on the Cisco ME switch. It is not supported on small form-factor pluggable (SFP)-module ports. For more information about TDR, see the software configuration guide for this release.

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

Examples

This is an example of output from the show cable-diagnostics tdr interface interface-id command on a Cisco ME switch:

Switch# show cable-diagnostics tdr interface gigabitethernet0/1

TDR test last run on: March 01 18:14:44

Interface Speed Local pair Pair length        Remote pair Pair status

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

Gi0/1     100M  Pair A     4    +/- 5  meters Pair A      Normal              

                Pair B     4    +/- 5  meters Pair B      Normal              

                Pair C     N/A                Pair C      N/A                 

                Pair D     N/A                Pair D      N/A                 

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

Table 3-7 Fields Descriptions for the show cable-diagnostics tdr Command Output 

Field	Description
Interface	Interface on which TDR was run.
Speed	Speed of connection.
Local pair	Name of the pair of wires that TDR is testing on the local interface.
Pair length	Location on the cable where the problem is, with respect to your switch. TDR can only find the location in one of these cases: •The cable is properly connected, the link is up, and the interface speed is 100 Mbps. •The cable is open. •The cable has a short.
Remote pair	Name of the pair of wires to which the local pair is connected. TDR can learn about the remote pair only when the cable is properly connected and the link is up.
Pair status	The status of the pair of wires on which TDR is running: •Normal—The pair of wires is properly connected. •Not completed—The test is running and is not completed. •Not supported—The interface does not support TDR. •Open—The pair of wires is open. •Shorted—The pair of wires is shorted. •ImpedanceMis—The impedance is mismatched. •Short/Impedance Mismatched—The impedance mismatched or the cable is short. •InProgress—The diagnostic test is in progress

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

Switch# show interface gigabitethernet0/1

gigabitethernet0/1 is up, line protocol is up (connected: TDR in Progress)

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

Switch# show cable-diagnostics tdr interface gigabitethernet0/1

% TDR test was never issued on gi0/1

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

% TDR test is not supported on switch 1

Related Commands

Command	Description
test cable-diagnostics tdr	Enables and runs TDR on an interface.

show class-map

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

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

Syntax Description

class-map-name	(Optional) Displays the contents of the specified class map.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show 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 access-group	Defines the match criteria to classify traffic.

show controllers bits

To display the state of the Building Integrated Timing Supply (BITS) clock controller, use the show controllers bits in privileged EXEC mode.

show controllers bits [ | {begin | exclude | include} expression]

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is a partial output example from the show controllers bits command:

Switch# show controllers BITS

Applique type is T1

Line Coding is B8ZS(Rx), B8ZS(Tx)

Framing is ESF(Rx), ESF(Tx)

Line Build Out is 0-133ft

No alarms detected.

Related Commands

Command	Description
controllers bits input applique	Sets the BITS clock input link type and characteristics.
controllers bits output applique	Sets the BITS clock output link type and characteristics.

show controllers cpu-interface

To display the state of the CPU network interface ASIC and the send and receive statistics for packets reaching the CPU, use the show controllers cpu-interface command in privileged EXEC mode.

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

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

Examples

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

Switch# show controllers cpu-interface

Queue cnt          normal     jumbo      normal-err jumbo-err  dropped    unfill

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

sw forwarding      0          0          0          0          0          0

routing protocol   0          0          0          0          0          0

icmp               0          0          0          0          0          0

host               0          0          0          0          0          0

acl logging        0          0          0          0          0          0

stp                36         0          0          0          0          0

l2 protocol        14357      0          0          0          0          0

mcast control      18862      0          0          0          0          0

broadcast          0          0          0          0          0          0

rep                0          0          0          0          0          0

cfm                0          0          0          0          0          0

control?           0          0          0          0          0          0

ip mpls ttl        0          0          0          0          0          0

ipmcast default    0          0          0          0          0          0

route data         0          0          0          0          0          0

ipmcast mismatch   0          0          0          0          0          0

ipmcast rpf-fail   0          0          0          0          0          0

routing throttle   0          0          0          0          0          0

ipmcast?           0          0          0          0          0          0

<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

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

show controllers ethernet-controller [interface-id] [down-when-looped] [phy [detail]] [ | {begin | exclude | include} expression]

Syntax Description

interface-id	The physical interface (including type, module, and port number).
down-when-looped	Display the state related to the down-when-looped detection.
phy	(Optional) Displays the status of the internal registers on the switch physical layer device (PHY) for the device or the interface. This display includes the operational state of the automatic medium-dependent interface crossover (Auto-MDIX) feature on an interface.
detail	(Optional) Displays details about the PHY internal registers.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

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

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

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

Examples

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

Switch# show controllers ethernet-controller gigabitethernet0/1

Transmit GigabitEthernet0/1              Receive

      1279800 Bytes                          2788787 Bytes

            0 Unicast frames                   12058 Unicast frames

         4050 Multicast frames                 14779 Multicast frames

            0 Broadcast frames                  1195 Broadcast frames

            0 Dot1Q frames                         0 Dot1Q frames

            0 Too old frames                  771712 Unicast bytes

            0 Deferred frames                1934854 Multicast bytes

            0 MTU exceeded frames              82221 Broadcast bytes

            0 FCS errors                           0 FCS errors

            0 1 collision frames                   0 Alignment errors

            0 2 collision frames

            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               12071 Minimum size frames

            0 8 collision frames               13917 65 to 127 byte frames

            0 9 collision frames                   0 128 to 255 byte frames

            0 10 collision frames               2044 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 15 collision frames

            0 Pause frames                         0 Pause frames

            0 Excessive collisions                 0 Symbol error frames

            0 Late collisions                      0 Invalid frames, too large

            0 VLAN discard frames                  0 Valid frames, too large

            0 Excess defer frames                  0 Invalid frames, too small

            0 64 byte frames                       0 Valid frames, too small

            0 127 byte frames

            0 255 byte frames                      0 Too old frames

         4050 511 byte frames                      0 Valid oversize frames

            0 1023 byte frames                     0 System FCS error frames

            0 1518 byte frames

            0 Too large frames

            0 Good (1 coll) frames

            0 Good (>1 coll) frames

Table 3-8 Transmit Field Descriptions 

Field	Description
Bytes	The total number of bytes sent on an interface.
Unicast Frames	The total number of frames sent to unicast addresses.
Multicast frames	The total number of frames sent to multicast addresses.
Broadcast frames	The total number of frames sent to broadcast addresses.
Too old frames	The number of frames dropped on the egress port because the packet aged out.
Deferred frames	The number of frames that are not sent after the time exceeds 2*maximum-packet time.
MTU exceeded frames	The number of frames that are larger than the maximum allowed frame size.
1 collision frames	The number of frames that are successfully sent on an interface after one collision occurs.
2 collision frames	The number of frames that are successfully sent on an interface after two collisions occur.
3 collision frames	The number of frames that are successfully sent on an interface after three collisions occur.
4 collision frames	The number of frames that are successfully sent on an interface after four collisions occur.
5 collision frames	The number of frames that are successfully sent on an interface after five collisions occur.
6 collision frames	The number of frames that are successfully sent on an interface after six collisions occur.
7 collision frames	The number of frames that are successfully sent on an interface after seven collisions occur.
8 collision frames	The number of frames that are successfully sent on an interface after eight collisions occur.
9 collision frames	The number of frames that are successfully sent on an interface after nine collisions occur.
10 collision frames	The number of frames that are successfully sent on an interface after ten collisions occur.
11 collision frames	The number of frames that are successfully sent on an interface after 11 collisions occur.
12 collision frames	The number of frames that are successfully sent on an interface after 12 collisions occur.
13 collision frames	The number of frames that are successfully sent on an interface after 13 collisions occur.
14 collision frames	The number of frames that are successfully sent on an interface after 14 collisions occur.
15 collision frames	The number of frames that are successfully sent on an interface after 15 collisions occur.
Excessive collisions	The number of frames that could not be sent on an interface after 16 collisions occur.
Late collisions	After a frame is sent, the number of frames dropped because late collisions were detected while the frame was sent.
VLAN discard frames	The number of frames dropped on an interface because the CFI1 bit is set.
Excess defer frames	The number of frames that are not sent after the time exceeds the maximum-packet time.
64 byte frames	The total number of frames sent on an interface that are 64 bytes.
127 byte frames	The total number of frames sent on an interface that are from 65 to 127 bytes.
255 byte frames	The total number of frames sent on an interface that are from 128 to 255 bytes.
511 byte frames	The total number of frames sent on an interface that are from 256 to 511 bytes.
1023 byte frames	The total number of frames sent on an interface that are from 512 to 1023 bytes.
1518 byte frames	The total number of frames sent on an interface that are from 1024 to 1518 bytes.
Too large frames	The number of frames sent on an interface that are larger than the maximum allowed frame size.
Good (1 coll) frames	The number of frames that are successfully sent on an interface after one collision occurs. This value does not include the number of frames that are not successfully sent after one collision occurs.

1 CFI = Canonical Format Indicator

Table 3-9 Receive Field Descriptions 

Field	Description
Bytes	The total amount of memory (in bytes) used by frames received on an interface, including the FCS1 value and the incorrectly formed frames. This value excludes the frame header bits.
Unicast frames	The total number of frames successfully received on the interface that are directed to unicast addresses.
Multicast frames	The total number of frames successfully received on the interface that are directed to multicast addresses.
Broadcast frames	The total number of frames successfully received on an interface that are directed to broadcast addresses.
Unicast bytes	The total amount of memory (in bytes) used by unicast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.
Multicast bytes	The total amount of memory (in bytes) used by multicast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.
Broadcast bytes	The total amount of memory (in bytes) used by broadcast frames received on an interface, including the FCS value and the incorrectly formed frames. This value excludes the frame header bits.
Alignment errors	The total number of frames received on an interface that have alignment errors.
FCS errors	The total number of frames received on an interface that have a valid length (in bytes) but do not have the correct FCS values.
Oversize frames	The number of frames received on an interface that are larger than the maximum allowed frame size.
Undersize frames	The number of frames received on an interface that are smaller than 64 bytes.
Collision fragments	The number of collision fragments received on an interface.
Minimum size frames	The total number of frames that are the minimum frame size.
65 to 127 byte frames	The total number of frames that are from 65 to 127 bytes.
128 to 255 byte frames	The total number of frames that are from 128 to 255 bytes.
256 to 511 byte frames	The total number of frames that are from 256 to 511 bytes.
512 to 1023 byte frames	The total number of frames that are from 512 to 1023 bytes.
1024 to 1518 byte frames	The total number of frames that are from 1024 to 1518 bytes.
Overrun frames	The total number of overrun frames received on an interface.
Pause frames	The number of pause frames received on an interface.
Symbol error frames	The number of frames received on an interface that have symbol errors.
Invalid frames, too large	The number of frames received that were larger than maximum allowed MTU2 size (including the FCS bits and excluding the frame header) and that have either an FCS error or an alignment error.
Valid frames, too large	The number of frames received on an interface that are larger than the maximum allowed frame size.
Invalid frames, too small	The number of frames received that are smaller than 64 bytes (including the FCS bits and excluding the frame header) and that have either an FCS error or an alignment error.
Valid frames, too small	The number of frames received on an interface that are smaller than 64 bytes (or 68 bytes for VLAN-tagged frames) and that have valid FCS values. The frame size includes the FCS bits but excludes the frame header bits.
Too old frames	The number of frames dropped on the ingress port because the packet aged out.
Valid oversize frames	The number of frames received on an interface that are larger than the maximum allowed frame size and have valid FCS values. The frame size includes the FCS value but does not include the VLAN tag.
System FCS error frames	The total number of frames received on an interface that have a valid length (in bytes) but that do not have the correct FCS values.
RxPortFifoFull drop frames	The total number of frames received on an interface that are dropped because the ingress queue is full.

1 FCS = frame check sequence 2 MTU = maximum transmission unit

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

Switch# show controllers ethernet-controller gigabitethernet0/1 phy

GigabitEthernet0/1 (port-number: 1)

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

General SFP Information

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

Identifier            :   0x03

Connector             :   0x00

Transceiver           :   0x00 0x00 0x00 0x08 0x00 0x00 0x00 0x00

Encoding              :   0x01

BR_Nominal            :   0x0D

Vendor Name           :   CISCO-METHODE

Vendor Part Number    :   SP7041

Vendor Revision       :   0x44 0x20 0x20 0x20

Vendor Serial Number  :   00000MTC111701L3

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

EEPROM PAGE A0

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

000:  03 04 00 00 00 00 08 00 00 00

010:  00 01 0D 00 00 00 00 00 64 00

020:  43 49 53 43 4F 2D 4D 45 54 48

030:  4F 44 45 20 20 20 01 00 00 00

040:  53 50 37 30 34 31 20 20 20 20

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 utilization

To display bandwidth utilization on the switch or specific ports, use the show controllers utilization command in user EXEC mode.

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

Syntax Description

interface-id	(Optional) ID of the switch interface.
| begin	(Optional) Display begins with the line that matches the specified expression.
| exclude	(Optional) Display excludes lines that match the specified expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch> show controllers utilization

Port       Receive Utilization  Transmit Utilization

Gi0/1              0                    0

Gi0/2              0                    0

Gi0/3              0                    0

Gi0/4              0                    0

Gi0/5              0                    0

Gi0/6              0                    0

Gi0/7              0                    0

Gi0/8              0                    0

Gi0/9              0                    0

Gi0/10             0                    0

Gi0/11             0                    0

Gi0/12             0                    0

Gi0/13             0                    0

Gi0/14             0                    0

Gi0/15             0                    0

Gi0/16             0                    0

Gi0/17             0                    0

Gi0/18             0                    0

Gi0/19             0                    0

Gi0/20             0                    0

Gi0/21             0                    0

Gi0/22             0                    0

Gi0/23             0                    0

Gi0/24             0                    0

Te0/1              0                    0

Te0/2              0                    0

Total Ports : 26

Switch Receive Bandwidth Percentage Utilization  : 0

Switch Transmit Bandwidth Percentage Utilization : 0

Switch Fabric Percentage Utilization : 0

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

Switch> show controllers gigabitethernet0/1 utilization

Receive Bandwidth Percentage Utilization   : 0

Transmit Bandwidth Percentage Utilization  : 0

Table 3-10 show controllers utilization Field Descriptions

Field	Description
Receive Bandwidth Percentage Utilization	Displays the received bandwidth usage of the switch, which is the sum of the received traffic on all the ports divided by the switch receive capacity.
Transmit Bandwidth Percentage Utilization	Displays the transmitted bandwidth usage of the switch, which is the sum of the transmitted traffic on all the ports divided it by the switch transmit capacity.
Fabric Percentage Utilization	Displays the average of the transmitted and received bandwidth usage of the switch.

Related Commands

Command	Description
show controllers ethernet-controller	Displays the interface internal registers.

show diagnostic

To display the online diagnostic test results and the supported test suites, use the show diagnostic command in user EXEC mode.

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

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

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

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

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

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

Syntax Description

content	Displays test information including the test ID, the test attributes, and the supported coverage test levels for specific tests and for switches.
detail	Displays detailed test results.
post	Displays the power-on self-test (POST) results.
result	Displays the diagnostic test results.
test	(Optional) Specifies the test results to display: •name—Enter the name of the diagnostic test to display results only for this test. •test-id—Enter the test ID number to display results only for this test. The test ID can be from 1 to 6. •test-id-range—Enter the range of test ID numbers to display results only for these tests. •all—Enter this keyword to display results for all the tests.
detail	(Optional) Displays the detailed test results.
schedule	Displays the scheduled diagnostic tests.
status	Display the running diagnostic tests.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Defaults

This command has no default setting.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

The show diagnostic post command output is the same as the show post command output.

The show diagnostic result [detail] command output is the same as the show diagnostic switch [detail] command output.

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

Examples

This example shows how to display the diagnostic test IDs and attributes.

Switch> show diagnostic content 

  Diagnostics test suite attributes:

      B/* - Basic ondemand test / NA

    P/V/* - Per port test / Per device test / NA

    D/N/* - Disruptive test / Non-disruptive test / NA

      S/* - Only applicable to standby unit / NA

      R/* - Switch will reload after test list completion / NA

      P/* - will partition stack / NA

  ID   Test Name                          Attributes

  ==== ================================== ============

    1) TestPortAsicMem -----------------> B*D*R*

    2) TestPortAsicCam -----------------> B*D*R*

    3) TestPortAsicLoopback ------------> B*D*R*

    4) TestPortLoopback ----------------> B*D*R*

    5) TestFpga ------------------------> B*D*R*

This example shows how to display the diagnostic test results for a switch. You can also use the show diagnostic switch command to display these results.

Switch> show diagnostic result 

:   SerialNo : FHH1329P00B

  Overall diagnostic result: UNTESTED

  Test results: (. = Pass, F = Fail, U = Untested)

    1) TestPortAsicMem -----------------> U

    2) TestPortAsicCam -----------------> U

    3) TestPortAsicLoopback ------------> U

    4) TestPortLoopback ----------------> U

    5) TestFpga ------------------------> U

This example shows how to display the running tests in a switch:

Switch> show diagnostic status

<BU> - Bootup Diagnostics, <HM> - Health Monitoring Diagnostics,

<OD> - OnDemand Diagnostics, <SCH> - Scheduled Diagnostics

====== ================================= =============================== ======

Card   Description                       Current Running Test            Run by

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

sw     FHH1329P00B                       N/A                             N/A

====== ================================= =============================== ======

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

Switch> show diagnostic schedule

Current Time = 14:39:49 PST Tue Jul 5 2005

Diagnostic for Switch 1:

Schedule #1:

To be run daily 12:00

Test ID(s) to be executed: 1.

This example shows how to display the detailed results for a switch. You can also use the show diagnostic result test all detail command to display these results.

Switch> show diagnostic result test all detail

Test results: (. = Pass, F = Fail, U = Untested)

  ___________________________________________________________________________

    1) TestPortAsicMem -----------------> U

          Error code ------------------> 0 (DIAG_SUCCESS)

          Total run count -------------> 0

          Last test execution time ----> n/a

          First test failure time -----> n/a

          Last test failure time ------> n/a

          Last test pass time ---------> n/a

          Total failure count ---------> 0

          Consecutive failure count ---> 0

  ___________________________________________________________________________

    2) TestPortAsicCam -----------------> U

          Error code ------------------> 0 (DIAG_SUCCESS)

          Total run count -------------> 0

          Last test execution time ----> n/a

          First test failure time -----> n/a

          Last test failure time ------> n/a

          Last test pass time ---------> n/a

          Total failure count ---------> 0

          Consecutive failure count ---> 0

  ___________________________________________________________________________

    3) TestPortAsicLoopback ------------> U

          Error code ------------------> 0 (DIAG_SUCCESS)

          Total run count -------------> 0

          Last test execution time ----> n/a

          First test failure time -----> n/a

          Last test failure time ------> n/a

          Last test pass time ---------> n/a

          Total failure count ---------> 0

          Consecutive failure count ---> 0

  ___________________________________________________________________________

    4) TestPortLoopback ----------------> U

          Error code ------------------> 0 (DIAG_SUCCESS)

          Total run count -------------> 0

          Last test execution time ----> n/a

          First test failure time -----> n/a

          Last test failure time ------> n/a

          Last test pass time ---------> n/a

          Total failure count ---------> 0

          Consecutive failure count ---> 0

  ___________________________________________________________________________

    5) TestFpga ------------------------> U

          Error code ------------------> 0 (DIAG_SUCCESS)

          Total run count -------------> 0

          Last test execution time ----> n/a

          First test failure time -----> n/a

          Last test failure time ------> n/a

          Last test pass time ---------> n/a

          Total failure count ---------> 0

          Consecutive failure count ---> 0

  ___________________________________________________________________________

Related Commands

Command	Description
diagnostic monitor	Configures the health-monitoring diagnostic test.
diagnostic schedule test	Sets the scheduling of test-based online diagnostic testing.
diagnostic start test	Starts the online diagnostic test.

show env

To display alarm contact, fan, temperature, and power information for the switch, use the show env command in user EXEC mode.

show env {alarm-contact | all | fan | power| temperature [status]} [ | {begin | exclude | include} expression]

Syntax Description

alarm-contact	Displays alarm contact status.
all	Displays fan, temperature, power supply, and alarm status.
fan	Displays the switch fan status, including the power-supply fan.
power	Displays the switch power-supply status.
temperature	Displays the switch temperature status as GREEN or RED.
status	(Optional) Shows more detailed temperature status, including the temperature value, state (green, yellow, or red), and the yellow and red threshold values.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

You can use the show env temperature status command to display the switch temperature status. The command output shows the temperature state as green or red and shows the shutdown and alert thresholds. The output from the show env all command also includes this information.

For more information about the threshold levels, see the software configuration guide for this release.

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

Examples

This is an example of output from the show env alarm-contact command:

Switch# show env alarm-contact

ALARM CONTACT 1

   Status:      not asserted

   Description: external alarm contact 1

   Severity:    minor

   Trigger:     closed

ALARM CONTACT 2

   Status:      not asserted

   Description: external alarm contact 2

   Severity:    minor

   Trigger:     closed

ALARM CONTACT 3

   Status:      not asserted

   Description: external alarm contact 3

   Severity:    minor

   Trigger:     closed

ALARM CONTACT 4

   Status:      not asserted

   Description: external alarm contact 4

   Severity:    minor

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

Switch> show env all

FAN in PS-1 is OK

FAN in FANTRAY-2 is OK

SYSTEM TEMPERATURE is GREEN

SYSTEM Temperature Value: 35.5 Degree Celsius

SYSTEM Temperature State: GREEN

SYSTEM Low Temperature Alert Threshold: 0.0 Degree Celsius

SYSTEM Low Temperature Shutdown Threshold: -20.0 Degree Celsius

SYSTEM High Temperature Alert Threshold: 58.0 Degree Celsius

SYSTEM High Temperature Shutdown Threshold: 80.0 Degree Celsius

POWER SUPPLY 1 Temperature Value: 32.7500 Degree Celsius

POWER SUPPLY 1 Temperature Alert Threshold: 85.0000 Degree Celsius

POWER SUPPLY 1 Temperature Shutdown Threshold: 110.0000 Degree Celsius

FAN TRAY 2: No Temperature Information Provided

POWER SUPPLY 1 is AC OK

POWER SUPPLY 2 is Fan Tray OK

ALARM CONTACT 1 is not asserted

ALARM CONTACT 2 is not asserted

ALARM CONTACT 3 is not asserted

ALARM CONTACT 4 is not asserted

This is an example of output from the show env fan command for the Cisco ME 3400G-12CS switch:

Switch> show env fan

FAN in PS-1 is OK

FAN in FANTRAY-2 is OK

This is an example of output from the show env power command for the Cisco ME 3400G-12CS switch:

Switch> show env power

POWER SUPPLY 1 is AC OK

   AC Input  : OK

   Output    : OK

   Fan       : OK

POWER SUPPLY 2 is Fan Tray OK

   Fan       : OK

These are examples of output from the show env temperature and show env temperature status commands:

Switch> show env temperature

SYSTEM TEMPERATURE is GREEN

Switch> show env temperature status

SYSTEM Temperature Value: 35.5 Degree Celsius

SYSTEM Temperature State: GREEN

SYSTEM Low Temperature Alert Threshold: 0.0 Degree Celsius

SYSTEM Low Temperature Shutdown Threshold: -20.0 Degree Celsius

SYSTEM High Temperature Alert Threshold: 58.0 Degree Celsius

SYSTEM High Temperature Shutdown Threshold: 80.0 Degree Celsius

POWER SUPPLY 1 Temperature Value: 32.7500 Degree Celsius

POWER SUPPLY 1 Temperature Alert Threshold: 85.0000 Degree Celsius

POWER SUPPLY 1 Temperature Shutdown Threshold: 110.0000 Degree Celsius

FAN TRAY 2: No Temperature Information Provided

Related Commands

Command	Description
system env temperature threshold alert	Configures the system temperature thresholds.
alarm-contact	Configures alarm contacts.

show errdisable detect

To display error-disable detection status, use the show errdisable detect command in user EXEC mode.

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

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

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.

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

Examples

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

Switch> show errdisable detect

ErrDisable Reason            Detection    Mode

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

arp-inspection               Enabled      port

bpduguard                    Enabled      port

channel-misconfig (STP)      Enabled      port

community-limit              Enabled      port

dhcp-rate-limit              Enabled      port

dtp-flap                     Enabled      port

gbic-invalid                 Enabled      port

invalid-policy               Enabled      port

link-flap                    Enabled      port

link-monitor-failure         Enabled      port

loopback                     Enabled      port

lsgroup                      Enabled      port

oam-remote-failure           Enabled      port

mac-limit                    Enabled      port

pagp-flap                    Enabled      port

port-mode-failure            Enabled      port

pppoe-ia-rate-limit          Enabled      port

psecure-violation            Enabled      port

security-violation           Enabled      port

sfp-config-mismatch          Enabled      port

storm-control                Enabled      port

udld                         Enabled      port

vmps                         Enabled      port

---

Note Though visible in the output, the dtp-flap and arp-inspection fields are not valid.

---

Related Commands

Command	Description
errdisable detect cause	Enables error-disable detection for a specific cause or all causes.
show errdisable flap-values	Displays error condition recognition information.
show errdisable recovery	Displays error-disable recovery timer information.
show interfaces status	Displays interface status or a list of interfaces in an error-disabled state.

show errdisable flap-values

To display conditions that cause an error to be recognized for a cause, use the show errdisable flap-values command in user EXEC mode.

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

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	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

---

Note Although visible in the output display, the switch does not support DTP.

---

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

Examples

This is an example of output from the show errdisable 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

To display the error-disable recovery timer information, use the show errdisable recovery command in user EXEC mode.

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

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

Examples

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

Switch> show errdisable recovery

ErrDisable Reason            Timer Status

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

arp-inspection               Disabled

bpduguard                    Disabled

channel-misconfig (STP)      Disabled

dhcp-rate-limit              Disabled

dtp-flap                     Disabled

gbic-invalid                 Disabled

link-flap                    Disabled

mac-limit                    Disabled

link-monitor-failure         Disabled

loopback                     Disabled

oam-remote-failure           Disabled

pagp-flap                    Disabled

port-mode-failure            Disabled

pppoe-ia-rate-limit          Disabled

psecure-violation            Disabled

security-violation           Disabled

sfp-config-mismatch          Disabled

storm-control                Disabled

udld                         Disabled

vmps                         Disabled 

Timer interval: 300 seconds

Interfaces that will be enabled at the next timeout:

Interface    Errdisable reason    Time left(sec)

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

Gi0/2        link-flap             279 

---

Note Though visible in the output, the unicast-flood and DTP fields are not valid.

---

Related Commands

Command	Description
errdisable recovery	Configures the recover mechanism variables.
show errdisable detect	Displays error-disabled detection status.
show errdisable flap-values	Displays error condition recognition information.
show interfaces status	Displays interface status or a list of interfaces in error-disabled state.

show etherchannel

To display EtherChannel information for a channel, use the show etherchannel command in user EXEC mode.

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

Syntax Description

channel-group-number	(Optional) Number of the channel group. The range is 1 to 26.
detail	Displays detailed EtherChannel information.
load-balance	Displays the load-balance or frame-distribution scheme among ports in the port channel.
port	Displays EtherChannel port information.
port-channel	Displays port-channel information.
protocol	Displays the protocol that is being used in the EtherChannel.
summary	Displays a one-line summary per channel-group.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	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 is displayed only for Layer 3 port channels. 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).

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

Examples

This is an example of output from the show 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: Gi0/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

Gi0/1     SA      bndl      32768         0x0       0x1     0x0      0x3D

Age of the port in the current state: 01d:20h:06m:04s

                Port-channels in the group:

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

Port-channel: Po1    (Primary Aggregator)

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

Age of the Port-channel   = 01d:20h:20m:26s

Logical slot/port   = 10/1          Number of ports = 2

HotStandBy port = null

Port state          = Port-channel Ag-Inuse

Protocol            =   LACP

Ports in the Port-channel:

Index   Load   Port     EC state        No of bits

------+------+------+------------------+-----------

0     00     Gi0/1    Active          0

  0     00     Gi0/2    Active          0

Time since last port bundled:    01d:20h:20m:20s    Gi0/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      Gi0/1(P)    Gi0/2(P) 

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

Switch> show etherchannel 1 port-channel 

                Port-channels in the group: 

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

Port-channel: Po1    (Primary Aggregator)

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

Age of the Port-channel   = 01d:20h:24m:50s

Logical slot/port   = 10/1          Number of ports = 2

HotStandBy port = null

Port state          = Port-channel Ag-Inuse

Protocol            =   LACP

Ports in the Port-channel:

Index   Load   Port     EC state        No of bits

------+------+------+------------------+-----------

  0     00     Gi0/1    Active          0

  0     00     Gi0/2    Active          0

Time since last port bundled:    01d:20h:24m:44s    Gi0/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 a port to manage channeling.
interface port-channel	Accesses or creates the port channel.

show ethernet service evc

To display information about Ethernet virtual connection (EVC) customer-service instances, use the show ethernet service evc command in privileged EXEC mode.

show ethernet service evc [id evc-id | interface interface-id] [detail] [summary] [ | {begin | exclude | include} expression]

Syntax Description

id evc-id	(Optional) Displays EVC information for the specified service. The EVC identifier can be a string of from 1 to 100 characters.
interface interface-id	(Optional) Displays EVC information for the specified interface.
detail	(Optional) Displays detailed information about EVC service or the specified EVC ID or interface.
summary	(Optional) Displays summary of information for EVC service or the specified EVC interface.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show 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 flowcontrol

To display the flow control status and statistics, use the show flowcontrol command in user EXEC mode.

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

Syntax Description

interface interface-id	(Optional) Displays the flow control status and statistics for a specific interface.
module number	(Optional) Displays the flow control status and statistics for all interfaces on the switch. The only valid module number is 1. This option is not available if you have entered a specific interface ID.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

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

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

Examples

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

Switch> show flowcontrol

Port       Send FlowControl  Receive FlowControl  RxPause TxPause

           admin    oper     admin    oper

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

Gi0/1      Unsupp.  Unsupp.  off      off         0       0

Gi0/2      desired  off      off      off         0       0

Gi0/3      desired  off      off      off         0       0

<output truncated>

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

Switch> show flowcontrol interface gigabitethernet0/2

Port       Send FlowControl  Receive FlowControl  RxPause TxPause

           admin    oper     admin    oper

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

Gi0/2      desired  off      off      off         0       0

Related Commands

Command	Description
flowcontrol	Sets the receive flow-control state for an interface.

show interfaces

To display the administrative and operational status of all interfaces or a specified interface, use the show interfaces command in privileged EXEC mode.

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

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.
vlan vlan-id	(Optional) VLAN identification. The range is 1 to 4094.
accounting	(Optional) Displays accounting information on the interface, including active protocols and input and output packets and octets.
capabilities	(Optional) Displays 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) Displays capabilities, switchport configuration, or transceiver characteristics (depending on preceding keyword) of all interfaces on the switch. The only valid module number is 1. This option is not available if you have entered a specific interface ID.
counters	(Optional) See the show interfaces counters command.
dampening	(Optional) Displays interface dampening information.
debounce [module]	(Optional) Displays interface debounce time information.
description	(Optional) Displays the administrative status and description set for an interface.
etherchannel	(Optional) Displays interface EtherChannel information.
fcpa	(Optional) Displays fiber channel information
flowcontrol	(Optional) Displays interface flowcontrol information
mpls-exp	(Optional) Display interface MPLS experimental accounting information.
rep	(Optional) See the show interfaces rep command.
stats	(Optional) Displays the input and output packets by switching path for the interface.
status	(Optional) Displays 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) Displays interfaces in error-disabled state.
switchport	(Optional) Displays the administrative and operational status of a switching (nonrouting) port, including port blocking and port protection settings.
backup	(Optional) Displays the backup interface configuration.
module	(Optional) Limits the display to interfaces on a module
transceivers	(Optional) See the show interfaces transceiver command.
trunk	Displays interface trunk information. If you do not specify an interface, only information for active trunking ports appears.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

---

Note Though visible in the command-line help strings, the crb, private-vlan mapping, pruning random-detect, and rate-limit keywords are not supported.

---

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

•Use the show interface capabilities module 1 to display the capabilities of all interfaces on the switch. Entering any other number is invalid.

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

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

•Use the show interface switchport module 1 to display the switch port characteristics of all interfaces on the switch. Entering any other number is invalid.

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

Examples

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

Switch# show interfaces gigabitethernet0/1 

GigabitEthernet0/1 is up, line protocol is up (connected)

  Hardware is Gigabit Ethernet, address is 0023.eb17.c781 (bia 0023.eb17.c781)

  MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec,

     reliability 255/255, txload 1/255, rxload 1/255

  Encapsulation ARPA, loopback not set

  Keepalive not set

  Full-duplex, 1000Mb/s, link type is auto, media type is 10/100/1000BaseTX SFP

  input flow-control is off, output flow-control is unsupported

  ARP type: ARPA, ARP Timeout 04:00:00

  Last input never, output 00:00:14, 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/0 (size/max)

  5 minute input rate 0 bits/sec, 0 packets/sec

  5 minute output rate 0 bits/sec, 0 packets/sec

     28980 packets input, 2882755 bytes, 0 no buffer

     Received 16517 broadcasts (15276 multicasts)

     0 runts, 0 giants, 0 throttles

     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored

     0 watchdog, 15276 multicast, 0 pause input

     0 input packets with dribble condition detected

     4186 packets output, 1322776 bytes, 0 underruns

     0 output errors, 0 collisions, 1 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

VGigabitEthernet0

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

                   Other       8468     810077          1         60

                      IP    3156345  260882105    5133740  504298864

           Spanning Tree      62855    3771300          0          0

                     ARP      64072    3906250         38       2280

                     CDP       2110     827120       2106     720252

Interface Vlan1 is disabled

GigabitEthernet0/1

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

                   Other          0          0       4188    1306656

                     CDP          0          0       2129     766440

GigabitEthernet0/2

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

                   Other          0          0       4187    1306344

                     CDP          0          0       2129     766440

GigabitEthernet0/3

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

                   Other          0          0       4211    1313832

                     CDP          0          0       2106     758160

GigabitEthernet0/4

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

                   Other          0          0       4211    1313832

                      IP          0          0          6        360

           Spanning Tree          0          0      61843    3710580

                     CDP       2104     864744       2106     758160

GigabitEthernet0/5

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

                   Other          0          0       4188    1306656

           Spanning Tree         23       1380      61547    3692820

                     CDP       2139     796595       2130     766800

GigabitEthernet0/6

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

                   Other          0          0       3435    1044240

                    CLNS          0          0        144     218016

                     ARP          0          0          3        180

                     CDP       1740     648394       1733     596712

GigabitEthernet0/7

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

No traffic sent or received on this interface.

GigabitEthernet0/8

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

No traffic sent or received on this interface.

GigabitEthernet0/9

                Protocol    Pkts In   Chars In   Pkts Out  Chars Out

<output truncated>

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

Switch# show interfaces gigabitethernet0/2 capabilities

GigabitEthernet0/2

Model:                 ME-3800X-24FS-M

 Type:                  10/100/1000BaseTX SFP

 Speed:                 10,100,1000,auto

 Duplex:                half,full,auto

 Trunk encap. type:     802.1Q

 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-no ingress scheduling

                        tx-three levels of hierarchy and 2 level scheduling

 CoS rewrite:           yes

 ToS rewrite:           yes

 UDLD:                  yes

 Inline power:          no

 SPAN:                  no

 PortSecure:            no

 Dot1x:                 no

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 gigabitethernet0/2 description

Interface Status         Protocol Description

Gi0/2       up             down     Connects to Marketing

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

Switch# show interfaces etherchannel

----

Port-channel1:

Age of the Port-channel   = 03d:20h:17m:29s

Logical slot/port   = 10/1           Number of ports = 0

GC                  = 0x00000000      HotStandBy port = null

Port state          = Port-channel Ag-Not-Inuse

Port-channel2:

Age of the Port-channel   = 03d:20h:17m:29s

Logical slot/port   = 10/2           Number of ports = 0

GC                  = 0x00000000      HotStandBy port = null

Port state          = Port-channel Ag-Not-Inuse

Port-channel3:

Age of the Port-channel   = 03d:20h:17m:29s

Logical slot/port   = 10/3           Number of ports = 0

GC                  = 0x00000000      HotStandBy port = null

Port state          = Port-channel Ag-Not-Inuse

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

Switch# show interfaces vlan 1 stats

Switching path    Pkts In   Chars In   Pkts Out  Chars Out

        Processor    1165354  136205310     570800   91731594

      Route cache          0          0          0          0

            Total    1165354  136205310     570800   91731594

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

Switch# show interfaces status

Port      Name               Status       Vlan       Duplex  Speed Type

Gi0/1                        connected    trunk      a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/2                        connected    trunk      a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/3                        connected    trunk      a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/4                        connected    1          a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/5                        connected    1          a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/6                        connected    routed     a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/7                        notconnect   1            auto   auto Not Present

Gi0/8                        notconnect   1            auto   auto Not Present

Gi0/9                        notconnect   trunk        auto   auto Not Present

Gi0/10                       notconnect   1            auto   auto Not Present

Gi0/11    testwhelshdevice   connected    1          a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/12                       notconnect   1            auto   auto Not Present

Gi0/13                       connected    trunk      a-full    100 10/100/1000Ba

seTX SFP

Gi0/14                       connected    1          a-full a-1000 10/100/1000Ba

seTX SFP

Port      Name               Status       Vlan       Duplex  Speed Type

Gi0/15                       connected    1          a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/16                       connected    1          a-full a-1000 10/100/1000Ba

seTX SFP

Gi0/17                       notconnect   1            auto   auto Not Present

Gi0/18                       notconnect   1            auto   auto Not Present

Gi0/19                       notconnect   1            auto   auto Not Present

Gi0/20                       notconnect   1            auto   auto Not Present

Gi0/21                       notconnect   1            auto   auto Not Present

Gi0/22                       notconnect   1            auto   auto Not Present

Gi0/23                       notconnect   1            auto   auto Not Present

Gi0/24                       notconnect   1            auto   auto Not Present

Te0/1                        disabled     1            full    10G Not Present

Te0/2                        disabled     1            full    10G SFP-10GBase-C

UxM

Port      Name               Status       Vlan       Duplex  Speed Type

Gi0                          connected    routed     a-full  a-100 10/100/1000Ba

seTX

These are examples of output from the show interfaces status command for a specific interface when private VLANs are configured. Port 22 is configured as a private-VLAN host port. It is associated with primary VLAN 20 and secondary VLAN 25.

Switch# show interfaces gigabitethernet0/22 status

Port      Name               Status       Vlan       Duplex  Speed Type

Gi0/2                        connected    trunk      a-full a-1000 10/100/1000Ba

seTX SFP

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

Switch# show interfaces gigabitethernet0/2 status err-disabled 

Port      Name               Status       Reason               Err-disabled Vlans

Gi0/2                        connected    elmi evc down        1,200

This is an example of output from the show interfaces switchport command for a single port. Table 2-12 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 gigabitethernet0/8 switchport

Name: Gi0/8

Switchport: Enabled

Administrative Mode: static access

Operational Mode: down

Administrative Trunking Encapsulation: dot1q

Negotiation of Trunking: Off

Access Mode VLAN: 1 (default)

Trunking Native Mode VLAN: 1 (default)

Administrative Native VLAN tagging: enabled

Administrative private-vlan host-association: none

Administrative private-vlan mapping: none

Administrative private-vlan trunk native VLAN: none

Administrative private-vlan trunk Native VLAN tagging: enabled

Administrative private-vlan trunk encapsulation: dot1q

Administrative private-vlan trunk normal VLANs: none

Administrative private-vlan trunk associations: none

Administrative private-vlan trunk mappings: none

Operational private-vlan: none

Trunking VLANs Enabled: ALL

Capture Mode Disabled

Capture VLANs Allowed: ALL

Unknown unicast blocked: disabled

Unknown multicast blocked: disabled

Appliance trust: none

Table 3-11 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 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	Lists the VLAN ID of the trunk that is in native mode.
Administrative Native VLAN tagging	Displays whether or not VLAN tagging is enabled.
Administrative private-vlan host-association	Displays the administrative VLAN association for private-VLAN host ports.
Administrative private-vlan mapping	Displays the administrative VLAN mapping for private-VLAN promiscuous ports.
Operational private-vlan	Displays the operational private-VLAN status.
Trunking VLANs enabled	Lists the active VLANs on the trunk.
Capture VLANs allowed	Lists the allowed VLANs on the trunk.
Unknown unicast blocked Unknown multicast blocked	Displays whether or not unknown multicast and unknown unicast traffic is blocked on the interface.

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

Switch# show interfaces gigabitethernet0/1 trunk

Port          Mode         Encapsulation  Status        Native vlan

Gi0/1         auto         negotiate      trunking      1

Port          Vlans allowed on trunk

Gi0/1         1-4094

Port          Vlans allowed and active in management domain

Gi0/1         1-4

Port          Vlans in spanning tree forwarding state and not pruned

Gi0/1         1-4

Related Commands

Command	Description
switchport access vlan	Configures a port as a static-access or a dynamic-access port.
switchport block	Blocks unknown unicast or multicast traffic on an interface.
switchport mode	Configures the VLAN membership mode of a port.

show interfaces counters

To display various counters for the switch or for a specific interface, use the show interfaces counters command in privileged EXEC mode.

show interfaces [interface-id | vlan vlan-id] counters [errors | trunk] [module switch- number] | etherchannel | protocol status] [ | {begin | exclude | include} expression]

Syntax Description

interface-id	(Optional) ID of the physical interface, including type, module, and port number.
errors	(Optional) Displays error counters.
trunk	(Optional) Displays trunk counters.
module switch- number	(Optional) Displays counters for the specified switch number. The only available value is 1.
etherchannel	(Optional) Displays EtherChannel counters, including octets, broadcast packets, multicast packets, and unicast packets received and sent.
protocol status	(Optional) Displays status of protocols enabled on interfaces.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

---

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

---

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

Examples

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

Switch# show interfaces counters

Port            InOctets    InUcastPkts    InMcastPkts    InBcastPkts

Gi0/1            2895390          12518          15343           1247

Gi0/2            1609255          12517           2147              0

Gi0/3            3524654          12617          23846              1

Gi0/4            3391800          12617          21768              1

Gi0/5            1610919          12516           2174              0

Gi0/6            1315586          10269           1748              0

Gi0/7                  0              0              0              0

Gi0/8                  0              0              0              0

Gi0/9                  0              0              0              0

Gi0/10                 0              0              0              0

Gi0/11           1610151          12517           2161              0

Gi0/12                 0              0              0              0

Gi0/13                 0              0              0              0

Gi0/14                 0              0              0              0

Gi0/15                 0              0              0              0

Gi0/16                 0              0              0              0

Gi0/17                 0              0              0              0

Gi0/18                 0              0              0              0

Gi0/19                 0              0              0              0

Gi0/20                 0              0              0              0

Gi0/21                 0              0              0              0

<output truncated>

This is an example of partial output from the show interfaces counters protocol status command for all interfaces.

Switch# show interfaces counters protocol status

Protocols allocated:

 GigabitEthernet0: Other, IP, Spanning Tree, ARP, CDP

 Vlan1: Other, IP

 GigabitEthernet0/1: Other, IP, CDP

 GigabitEthernet0/2: Other, IP, CDP

 GigabitEthernet0/3: Other, IP, CDP

 GigabitEthernet0/4: Other, IP, Spanning Tree, CDP

 GigabitEthernet0/5: Other, IP, Spanning Tree, CDP

 GigabitEthernet0/6: Other, IP, CLNS, ARP, CDP

 GigabitEthernet0/7: Other, IP

 GigabitEthernet0/8: Other, IP

 GigabitEthernet0/9: Other, IP

 GigabitEthernet0/10: Other, IP

 GigabitEthernet0/11: Other, IP, Spanning Tree, CDP

 GigabitEthernet0/12: Other, IP

 GigabitEthernet0/13: Other, IP, CDP

 GigabitEthernet0/14: Other, IP, Spanning Tree, CDP

 GigabitEthernet0/15: Other, IP, Spanning Tree, CDP

 GigabitEthernet0/16: Other, IP, Spanning Tree, CDP

 GigabitEthernet0/17: Other, IP

 GigabitEthernet0/18: Other, IP

 GigabitEthernet0/19: Other, IP

 GigabitEthernet0/20: Other, IP

<output truncated>

This is an example of output from the show interfaces counters trunk command. It displays trunk counters for all interfaces.

Switch# show interfaces counters trunk

Port        TrunkFramesTx   TrunkFramesRx   WrongEncap

Gi0/1                4207           29123            0

Gi0/2                4207           14672            0

Gi0/3                4230           36486            0

Gi0/4                   0               0            0

Gi0/5                   0               0            0

Gi0/7                   0               0            0

Gi0/8                   0               0            0

Gi0/9                   0               0            0

Gi0/10                  0               0            0

Gi0/11                  0               0            0

Gi0/12                  0               0            0

Gi0/13               4228               0            0

Gi0/14                  0               0            0

Gi0/15                  0               0            0

Gi0/16                  0               0            0

Gi0/17                  0               0            0

Gi0/18                  0               0            0

Gi0/19                  0               0            0

Gi0/20                  0               0            0

Gi0/21                  0               0            0

<output truncated>

Related Commands

Command	Description
show interfaces	Displays additional interface characteristics.

show interfaces rep

To display Resilient Ethernet Protocol (REP) configuration and status for a specified interface or for all interfaces, use the show interfaces rep command in user EXEC mode.

show interfaces [interface-id] rep [detail] [ | {begin | exclude | include} expression]

Syntax Description

interface-id	(Optional) Displays REP configuration and status for a specified physical interface or port channel ID.
detail	(Optional) Displays detailed REP configuration and status information.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

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

In the show interfaces rep command output, ports configured as edge no-neighbors are designated with an asterisk (*) in front of Primary Edge or Secondary Edge. In the output of the show interfaces rep detail command, No-Neighbor is spelled out.

The output of this command is also included in the show tech-support privileged EXEC command output.

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

Examples

This is sample output from the show interface rep command:

Switch # show interface rep 

Interface                Seg-id   Type        LinkOp     Role

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

GigabitEthernet 0/1        1    Primary Edge  TWO_WAY    Open

GigabitEthernet 0/2        1    Edge          TWO_WAY    Open

FastEthernet 0/4           2                  INIT_DOWN  Fail

This is sample output from the show interface rep command when the edge port is configured to have no REP neighbor. Note the asterisk (*) next to Primary Edge.

Switch# show interface rep

Interface              Seg-id Type            LinkOp      Role

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

GigabitEthernet0/1     2                      TWO_WAY     Open

GigabitEthernet0/2     2      Primary Edge*   TWO_WAY     Open

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

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

GigabitEthernet0/1        1                 NO_NEIGHBOR FailNoNbr 

GigabitEthernet0/2        2                 NO_NEIGHBOR FailLogOpen

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

Switch # show interface gigabitethernet0/2 rep detail

GigabitEthernet0/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

To display the physical properties of a small form-factor pluggable (SFP) module interface, use the show interfaces transceiver command in privileged EXEC mode.

show interfaces [interface-id] transceiver [detail | module number | properties | supported-list | threshold-table] [ | {begin | exclude | include} expression]

Syntax Description

interface-id	(Optional) Displays configuration and status for a specified physical interface.
detail	(Optional) Displays 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.
supported-list	(Optional) Lists all supported DoM transceivers.
threshold-table	(Optional) Displays alarm and warning threshold table. Note This keyword displays the thresholds that are programmed into SFP hardware and are not those used to determine when to send alarms or traps. To view those thresholds, enter the show interfaces transceiver detail command.
module number	(Optional) Limits 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) Displays speed, duplex, and inline power settings on an interface.
threshold-table	(Optional) Displays alarm and warning threshold table
| begin	(Optional) Display begins with the line that matches the expression
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

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.

Examples

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

Switch# show interfaces gigabitethernet0/1 transceiver properties

Diagnostic Monitoring is not implemented.

Name : Gi0/1

Administrative Speed: auto

Administrative Duplex: auto

Administrative Auto-MDIX: on

Administrative Power Inline: N/A

Operational Speed: 1000

Operational Duplex: full

Operational Auto-MDIX: on

Media Type: 10/100/1000BaseTX SFP

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

Switch# show interfaces transceiver dom-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

To display product identification (PID) information for the hardware, use the show inventory command in user EXEC mode.

show inventory [entity-name | raw] [ | {begin | exclude | include} expression]

Syntax Description

entity-name	(Optional) Displays the specified entity. For example, enter the interface (such as gigabitethernet 0/x) into which a small form-factor pluggable (SFP) module is installed to display its identity.
raw	(Optional) Displays every entity in the device.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

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

Many legacy SFPs are not programmed with PIDs and VID.s

---

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

---

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

Examples

This is example output from the show inventory command:

Switch> show inventory

NAME: "1", DESCR: "model-id"

PID: model-id , VID:Vo1 , SN: FSJC0407839

NAME: "GigabitEthernet0/1", DESCR: "100BaseBX-10U SFP"

PID:                     , VID:    , SN: NEC08440067

NAME: "GigabitEthernet0/2", DESCR: "10/100/1000BaseTX SFP"

PID:                     , VID:    , SN: 00000MTC0839048G

show ip igmp profile

To display all configured Internet Group Management Protocol (IGMP) profiles or a specified IGMP profile, use the show ip igmp profile command in privileged EXEC mode.

show ip igmp profile [profile number] [ | {begin | exclude | include} expression]

Syntax Description

profile number	(Optional) The IGMP profile number to be displayed. The range is 1 to 4294967295. If no profile number is entered, all IGMP profiles are displayed.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

52

Usage Guidelines

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

Examples

These are examples of output from the show ip igmp profile privileged EXEC command, with and without specifying a profile number. If no profile number is entered, the display includes all profiles configured on the switch.

Switch# show ip igmp profile 40

IGMP Profile 40

    permit

    range 233.1.1.1 233.255.255.255

Switch# show ip igmp profile

IGMP Profile 3

    range 230.9.9.0 230.9.9.0

IGMP Profile 4

    permit

    range 229.9.9.0 229.255.255.255

Related Commands

Command	Description
ip igmp profile	Configures the specified IGMP profile number.

show ip igmp snooping

To display the Internet Group Management Protocol (IGMP) snooping configuration of the switch or the VLAN, use the show ip igmp snooping command in user EXEC mode.

show ip igmp snooping [groups | mrouter | querier [vlan vlan-id] [detail]] [vlan vlan-id] [detail] [ | {begin | exclude | include} expression]

Syntax Description

groups	(Optional) See the show ip igmp snooping groups command.
mrouter	(Optional) See the show ip igmp snooping mrouter command.
querier	(Optional) See the show ip igmp snooping querier command.
vlan vlan-id	(Optional) Specifies a VLAN; the range is 1 to 1001 and 1006 to 4094 (available only in privileged EXEC mode).
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

---

Note Although visible in the command line interface help, the querier keyword is not supported.

---

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

Use this command to display snooping configuration for the switch or for a specific VLAN.

VLAN IDs 1002 to 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in IGMP snooping.

Although visible in the output display, output lines for source-only learning are not valid.

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

Examples

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

Switch# show ip igmp snooping vlan 1

Global IGMP Snooping configuration:

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

IGMP snooping             :Enabled

IGMPv3 snooping (minimal) :Enabled

Report suppression        :Enabled

TCN solicit query         :Disabled

TCN flood query count     :2

Last member query interval : 100

Vlan 1:

--------

IGMP snooping                       :Enabled

Immediate leave                     :Disabled

Multicast router learning mode      :pim-dvmrp

Source only learning age timer      :10

CGMP interoperability mode          :IGMP_ONLY

Last member query interval : 100

---

Note Source-only learning are not supported, and information appearing for this feature is not valid.

---

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

Switch> show ip igmp snooping 

Global IGMP Snooping configuration:

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

IGMP snooping              : Enabled

IGMPv3 snooping (minimal)  : Enabled

Report suppression         : Enabled

TCN solicit query          : Disabled

TCN flood query count      : 2

Last member query interval : 100

Vlan 1:

--------

IGMP snooping                       :Enabled

Immediate leave                     :Disabled

Multicast router learning mode      :pim-dvmrp

Source only learning age timer      :10

CGMP interoperability mode          :IGMP_ONLY

Last member query interval          : 100

Vlan 2:

--------

IGMP snooping                       :Enabled

Immediate leave                     :Disabled

Multicast router learning mode      :pim-dvmrp

Source only learning age timer      :10

CGMP interoperability mode          :IGMP_ONLY

Last member query interval          : 333

<output truncated>

Related Commands

Command	Description
ip igmp snooping	Enables and configures IGMP snooping on the switch or on a 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 querier	Displays the configuration and operation information for the IGMP querier configured on a switch.

show ip igmp snooping groups

To display the Internet Group Management Protocol (IGMP) snooping multicast table or multicast information for the switch, use the show ip igmp snooping groups command in privileged EXEC command. To display the multicast table for a specified multicast VLAN or to diplay specific multicast information, use with the vlan keyword.

show ip igmp snooping groups [count] [ | {begin | exclude | include} expression]

show ip igmp snooping groups vlan vlan-id [ip_address | count] [ | {begin | exclude | include} expression]

Syntax Description

count	(Optional) Displays the total number of entries for the specified command options instead of the actual entries.
ip_address	(Optional) Displays characteristics of the multicast group with the specified group IP address.
vlan-id	(Optional) Specifies a VLAN; the range is 1 to 1001 and 1006 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

Use this command to display multicast information or the multicast table.

VLAN IDs 1002 to 1005 are reserved for Token Ring and FDDI VLANs and cannot be used in IGMP snooping.

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

Examples

This is an example of output from the show ip igmp snooping groups command without any keywords. It displays the multicast table for the switch.

Switch# show ip igmp snooping groups

Vlan      Group          Type        Version     Port List

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

104       224.1.4.2      igmp        v2          Gi0/1, Gi0/2

104       224.1.4.3      igmp        v2          Gi0/1, Gi0/2

This is an example of output from the show ip igmp snooping groups count command. It displays the total number of multicast groups on the switch.

Switch# show ip igmp snooping groups count

Total number of multicast groups: 2

This is an example of output from the show ip igmp snooping groups vlan vlan-id ip-address command. It shows the entries for the group with the specified IP address.

Switch# show ip igmp snooping groups vlan 104 224.1.4.2

Vlan      Group          Type        Version     Port List

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

104       224.1.4.2      igmp        v2          Gi0/1, Gi0/5

Related Commands

Command	Description
ip igmp snooping	Enables and configures IGMP snooping on the switch or on a VLAN.
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

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, use the show ip igmp snooping mrouter command in privileged EXEC mode.

show ip igmp snooping mrouter [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

vlan vlan-id	(Optional) Specifies a VLAN; the range is 1 to 1001 and 1006 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

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

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

Examples

This is an example of output from the show ip igmp snooping mrouter command. It shows how to display multicast router ports on the switch.

Switch# show ip igmp snooping mrouter

Vlan    ports

----    -----

   1    Gi0/1(dynamic)

Related Commands

Command	Description
ip igmp snooping	Enables and configures IGMP snooping on the switch or a VLAN.
ip igmp snooping vlan mrouter	Adds a multicast router port to a multicast VLAN.
show ip igmp snooping	Displays the IGMP snooping configuration of the switch or VLAN.
show ip igmp snooping groups	Displays IGMP snooping multicast information for the switch or for the specified parameter.

show ipc

To display Interprocess Communications Protocol (IPC) configuration, status, and statistics, use the show ipc command in user EXEC mode.

show ipc {hog-info | mcast {appclass | groups | status} | nodes | ports [open] | queue | rpc | session {all | rx | tx} [verbose] | status [cumlulative] | zones} [ | {begin | exclude | include} expression]

Syntax Description

mcast {appclass | groups | status}	Displays the IPC multicast routing information. The keywords have these meanings: •appclass—Display the IPC multicast application classes. •groups—Display the IPC multicast groups. •status—Display the IPC multicast routing status.
nodes	Displays participating nodes.
ports [open]	Displays local IPC ports. The keyword has this meaning: •open—(Optional) Display only the open ports.
queue	Displays the contents of the IPC transmission queue.
rpc	Displays the IPC remote-procedure statistics.
session {all | rx | tx}	Displays the IPC session statistics (available only in privileged EXEC mode). The keywords have these meanings: •all—Display all the session statistics. •rx—Display the sessions statistics for traffic that the switch receives •tx—Display the sessions statistics for traffic that the switch forwards.
verbose	(Optional) Displays detailed statistics (available only in privileged EXEC mode).
status [cumlulative]	Displays the status of the local IPC server. The keyword has this meaning: •cumlulative—(Optional) Display the status of the local IPC server since the switch was started or restarted.
zones	Displays participating IPC zones. The switch supports one IPC zone.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This example shows how to display the IPC routing status:

Switch> show ipc mcast status

                           IPC Mcast Status

                                                        Tx        Rx

 Total Frames                                           0         0

 Total control Frames                                   0         0

 Total Frames dropped                                   0         0

 Total control Frames dropped                           0         0

 Total Reliable messages                                0         0

 Total Reliable messages acknowledged                   0         0

 Total Out of Band Messages                             0         0

 Total Out of Band messages acknowledged                0         0

 Total No Mcast groups                                  0         0

 Total Retries                    0  Total Timeouts                     0

 Total OOB Retries                0  Total OOB Timeouts                 0

 Total flushes                    0  Total No ports                     0

This example shows how to display the participating nodes:

Switch> show ipc nodes

There is 1 node in this IPC realm.

   ID    Type       Name           Last  Last

                                   Sent  Heard

   10000 Local      IPC Master     0      0

This example shows how to display the local IPC ports:

Switch> show ipc ports

There are 8 ports defined.

Port ID        Type       Name                    (current/peak/total)

There are 8 ports defined.

   10000.1     unicast    IPC Master:Zone

   10000.2     unicast    IPC Master:Echo

   10000.3     unicast    IPC Master:Control

   10000.4     unicast    IPC Master:Init

   10000.5     unicast    FIB Master:DFS.process_level.msgs

   10000.6     unicast    FIB Master:DFS.interrupt.msgs

   10000.7     unicast    MDFS RP:Statistics

     port_index = 0  seat_id = 0x10000    last sent = 0     last heard = 0

  0/2/159

   10000.8     unicast    Slot 1 :MDFS.control.RIL

     port_index = 0  seat_id = 0x10000    last sent = 0     last heard = 0

  0/0/0

RPC packets:current/peak/total

                                                            0/1/4

This example shows how to display the contents of the IPC retransmission queue:

Switch> show ipc queue

There are 0 IPC messages waiting for acknowledgement in the transmit queue.

There are 0 IPC messages waiting for a response.

There are 0 IPC messages waiting for additional fragments.

There are 0 IPC messages currently on the IPC inboundQ.

Messages currently in use                     :         3

Message cache size                            :      1000

Maximum message cache usage                   :      1000

0  times message cache crossed       5000 [max]

Emergency messages currently in use           :         0

There are 2 messages currently reserved for reply msg.

Inbound message queue depth 0

Zone inbound message queue depth 0

This example shows how to display all the IPC session statistics:

Switch# show ipc session all

Tx Sessions:

Port ID        Type       Name

   10000.7     Unicast    MDFS RP:Statistics

     port_index = 0  type = Unreliable      last sent = 0     last heard = 0

     Msgs requested = 180  Msgs returned = 180

   10000.8     Unicast    Slot 1 :MDFS.control.RIL

     port_index = 0  type = Reliable        last sent = 0     last heard = 0

     Msgs requested = 0    Msgs returned = 0

Rx Sessions:

Port ID        Type       Name

   10000.7     Unicast    MDFS RP:Statistics

     port_index = 0  seat_id = 0x10000    last sent = 0     last heard = 0

     No of msgs requested = 180   Msgs returned = 180

   10000.8     Unicast    Slot 1 :MDFS.control.RIL

     port_index = 0  seat_id = 0x10000    last sent = 0     last heard = 0

     No of msgs requested = 0     Msgs returned = 0

This example shows how to display the status of the local IPC server:

Switch> show ipc status cumulative

                         IPC System Status

 Time last IPC stat cleared :never

 This processor is the IPC master server.

 Do not drop output of IPC frames for test purposes.

 1000 IPC Message Headers Cached.

                                                    Rx Side     Tx Side

 Total Frames                                            12916         608

     0          0

 Total from Local Ports                                  13080         574

 Total Protocol Control Frames                             116          17

 Total Frames Dropped                                        0           0

                             Service Usage

 Total via Unreliable Connection-Less Service            12783         171

 Total via Unreliable Sequenced Connection-Less Svc          0           0

 Total via Reliable Connection-Oriented Service             17         116

<output truncated>

Related Commands

Command	Description
clear ipc	Clears the IPC multicast routing statistics.

show lacp

To display Link Aggregation Control Protocol (LACP) channel-group information, use the show lacp command in user EXEC mode.

show lacp [channel-group-number] {counters | internal | neighbor | sys-id} [ | {begin | exclude | include} expression]

Syntax Description

channel-group-number	(Optional) Number of the channel group. The range is 1 to 26.
counters	Displays traffic information.
internal	Displays internal information.
neighbor	Displays neighbor information.
sys-id	Displays the system identifier that is being used by LACP. The system identifier is made up of the LACP system priority and the switch MAC address.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

If you do not specify a channel group, information for all channel groups appears.

You can enter the channel-group-number option to specify a channel group for all keywords except sys-id.

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

Examples

This is an example of output from the show lacp counters user EXEC command. Table 2-16 describes the fields in the display.

Switch> show lacp counters

               LACPDUs         Marker      Marker Response    LACPDUs

Port         Sent   Recv     Sent   Recv     Sent   Recv      Pkts Err

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

Channel group:1

Gi0/1        19     10       0      0        0      0         0     

Gi0/2        14     6        0      0        0      0         0     

Table 3-12 show lacp counters Field Descriptions 

Field	Description
LACPDUs Sent and Recv	The number of LACP packets sent and received by a port.
Marker Sent and Recv	The number of LACP marker packets sent and received by a port.
Marker Response Sent and Recv	The number of LACP marker response packets sent and received by a port.
LACPDUs Pkts and Err	The number of unknown and illegal packets received by LACP for a port.

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

Switch> show lacp 1 internal 

Flags:  S - Device is requesting Slow LACPDUs

        F - Device is requesting Fast LACPDUs

        A - Device is in Active mode       P - Device is in Passive mode 

Channel group 1

                              LACP port     Admin     Oper    Port     Port

Port        Flags   State     Priority      Key       Key     Number   State

Gi0/1       SA      bndl      32768         0x3       0x3     0x4      0x3D  

Gi0/2       SA      bndl      32768         0x3       0x3     0x5      0x3D  

Table 2-17 describes the fields in the display.

Table 3-13 show lacp internal Field Descriptions 

Field	Description
State	State of the specific port. These are the allowed values: •- —Port is in an unknown state. •bndl—Port is attached to an aggregator and bundled with other ports. •susp—Port is in a suspended state; it is not attached to any aggregator. •hot-sby—Port is in a hot-standby state. •indiv—Port is incapable of bundling with any other port. •indep—Port is in an independent state (not bundled but able to switch data traffic. In this case, LACP is not running on the partner port). •down—Port is down.
LACP Port Priority	Port priority setting. LACP uses the port priority to put ports s in standby mode when there is a hardware limitation that prevents all compatible ports from aggregating.
Admin Key	Administrative key assigned to this port. LACP automatically generates an administrative key value as a hexadecimal number. The administrative key defines the ability of a port to aggregate with other ports. A port's ability to aggregate with other ports is determined by the port physical characteristics (for example, data rate and duplex capability) and configuration restrictions that you establish.
Oper Key	Runtime operational key that is being used by this port. LACP automatically generates this value as a hexadecimal number.
Port Number	Port number.
Port State	State variables for the port, encoded as individual bits within a single octet with these meanings: •bit0: LACP_Activity •bit1: LACP_Timeout •bit2: Aggregation •bit3: Synchronization •bit4: Collecting •bit5: Distributing •bit6: Defaulted •bit7: Expired Note In the above list, bit7 is the MSB and bit0 is the LSB.

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

Switch> show lacp neighbor 

Flags:  S - Device is sending Slow LACPDUs F - Device is sending Fast LACPDUs

        A - Device is in Active mode       P - Device is in Passive mode     

Channel group 3 neighbors

Partner's information:

          Partner               Partner                     Partner

Port      System ID             Port Number     Age         Flags

Gi0/1     32768,0007.eb49.5e80  0xC              19s        SP

          LACP Partner         Partner         Partner

          Port Priority        Oper Key        Port State

          32768                0x3             0x3C

Partner's information:

          Partner               Partner                     Partner

Port      System ID             Port Number     Age         Flags

Gi0/2     32768,0007.eb49.5e80  0xD              15s        SP

          LACP Partner         Partner         Partner

          Port Priority        Oper Key        Port State

          32768                0x3             0x3C

This is an example of output from the show lacp sys-id command:

Switch> show lacp sys-id 

32765,0002.4b29.3a00

The system identification is made up of the system priority and the system MAC address. The first two bytes are the system priority, and the last six bytes are the globally administered individual MAC address associated to the system.

Related Commands

Command	Description
clear lacp	Clears the LACP channel-group information.
lacp port-priority	Configures the LACP port priority.
lacp system-priority	Configures the LACP system priority.

show location

To display location information for a Link Layer Discovery Protocol (LLDP) endpoint, use the show location command in user EXEC mode.

show location admin-tag | [ | {begin | exclude | include} expression]

show location civic-location {identifier id number | interface interface-id | static} | [ | {begin | exclude | include} expression]

show location elin-location {identifier id number | interface interface-id | static} | [ | {begin | exclude | include} expression]

Syntax Description

admin-tag	Displays administrative tag or site information.
civic-location	Displays civic location information.
elin-location	Displays emergency location information (ELIN).
identifier id	Specifies the ID for the civic location or the elin location. The id range is 1 to 4095.
interface interface-id	Displays location information for the specified interface or all interfaces. Valid interfaces include physical ports.
static	Displays static configuration information.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

Examples

This is an example of output from the show location civic-location command that displays location information for an interface:

Switch> show location civic interface gigabitethernet 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                   : Gi0/1 

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

Identifier              : 2

Street number           : 24568

Street number suffix    : West

Landmark                : Golden Gate Bridge

Primary road name       : 19th Ave

City                    : San Francisco

Country                 : US

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

This is an example of output from the show location elin-location command that displays the emergency location information:

Switch> show location elin-location identifier 1

Elin location information

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

Identifier : 1

Elin       : 14085553881

Ports      : Gi0/2 

This is an example of output from the show location elin static command that displays all emergency location information:

Switch> show location elin static 

Elin location information

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

Identifier : 1

Elin       : 14085553881

Ports      : Gi0/2 

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

Identifier : 2

Elin       : 18002228999

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

Related Commands

Command	Description
location (global configuration)	Configures the global location information for an endpoint.
location (interface configuration)	Configures the location information for an interface.

show logging onboard

To display the on-board failure logging (OBFL) information, use the show logging onboard command in privileged EXEC mode.

show logging onboard [module [slot-number]] [clilog | environment | message |temperature | uptime | voltage] [continuous | detail | summary] [start hh:mm:ss day month year] [end hh:mm:ss day month year]} [ | {begin | exclude | include} expression]

Syntax Description

module [slot-number]	(Optional) The module slot number is always 1 and is not relevant for the switch.
clilog	Displays the OBFL CLI commands that were entered on the switch.
environment	Displays the unique device identifier (UDI) information for the switch and for all the connected devices: the product identification (PID), the version identification (VID), and the serial number.
message	Displays the hardware-related system messages generated by the switch.
temperature	Displays the temperature of the switch.
uptime	Displays the time when the switch starts, the reason the switch restarts, and the length of time the switch has been running since it last restarted.
voltage	Displays the system voltages of the switch.
continuous	(Optional) Displays the data in the continuous file. For more information, see the "Usage Guidelines" section.
summary	(Optional) Displays the data in the summary file. For more information, see the "Usage Guidelines" section.
start hh:mm:ss day month year	(Optional) Displays the data from the specified time and date. For more information, see the "Usage Guidelines" section.
end hh:mm:ss day month year	(Optional) Displays the data up to the specified time and date. For more information, see the "Usage Guidelines" section.
detail	(Optional) Displays both the continuous and summary data.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Defaults

There is no default.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

When OBFL is enabled, the switch records all the OBFL data in a continuous, circular file. When the continuous file is full, the switch combines the data into a summary file, which is also known as a historical file. The switch then continues to write new data to the continuous file.

Use the start and end keywords to display data collected only during a particular time period. When specifying the start and end times, follow these guidelines:

•hh:mm:ss—Enter the time as a 2-digit number for a 24-hour clock. Make sure to use the colons (:). For example, enter 13:32:45.

•day—Enter the day of the month. The range is from 1 to 31.

•month—Enter the month in upper-case or lower-case letters. You can enter the full name of the month, such as January or august, or the first three letters of the month, such as jan or Aug.

•year—Enter the year as a 4-digit number, such as 2008. The range is from 1993 to 2035.

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

Examples

This is an example of output from the show logging onboard clilog continuous command:

Switch# show logging onboard clilog continuous

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

CLI LOGGING CONTINUOUS INFORMATION

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

MM/DD/YYYY HH:MM:SS COMMAND

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

05/12/2006 15:33:17 show logging onboard temperature detail

05/12/2006 15:33:21 show logging onboard voltage detail

05/12/2006 16:14:09 show logging onboard temperature summary

...

<output truncated>

....

05/16/2006 13:07:53 no hw-module module logging onboard message level

05/16/2006 13:16:13 show logging onboard uptime continuous

05/16/2006 13:39:18 show logging onboard uptime summary

05/16/2006 13:45:57 show logging onboard clilog summary

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

This is an example of output from the show logging onboard message command:

Switch# show logging onboard message

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

ERROR MESSAGE SUMMARY INFORMATION

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

Facility-Sev-Name      | Count | Persistence Flag

MM/DD/YYYY HH:MM:SS

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

No historical data to display

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

This is an example of output from the show logging onboard status command:

Switch# show logging onboard status 

Devices registered with infra

                 Slot no.: 0 Subslot no.: 0, Device obfl0: 

Application name clilog : 

                 Path : obfl0:

                 CLI enable status  : enabled

                 Platform enable status: enabled

Application name environment : 

                 Path : obfl0:

                 CLI enable status  : enabled

                 Platform enable status: enabled

Application name errmsg : 

                 Path : obfl0:

                 CLI enable status  : enabled

                 Platform enable status: enabled

Application name poe : 

                 Path : obfl0:

                 CLI enable status  : enabled

                 Platform enable status: enabled

Application name temperature : 

                 Path : obfl0:

                 CLI enable status  : enabled

                 Platform enable status: enabled

Application name uptime : 

                 Path : obfl0:

                 CLI enable status  : enabled

                 Platform enable status: enabled

Application name voltage : 

                 Path : obfl0:

                 CLI enable status  : enabled

                 Platform enable status: enabled

This is an example of output from the show logging onboard temperature continuous command:

Switch# show logging onboard temperature continuous

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

TEMPERATURE CONTINUOUS INFORMATION

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

Sensor                            |   ID  |

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

Board temperature                        1

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

       Time Stamp   |Sensor Temperature 0C

MM/DD/YYYY HH:MM:SS |  1    2    3    4    5    6    7    8    9   10   11   12

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

05/12/2006 15:33:20   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 16:31:21   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 17:31:21   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 18:31:21   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 19:31:21   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 20:31:21   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 21:29:22   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 22:29:22   35   --   --   --   --   --   --   --   --   --   --   --

05/12/2006 23:29:22   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 00:29:22   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 01:29:22   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 02:27:23   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 03:27:23   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 04:27:23   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 05:27:23   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 06:27:23   35   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 07:25:24   36   --   --   --   --   --   --   --   --   --   --   --

05/13/2006 08:25:24   35   --   --   --   --   --   --   --   --   --   --   --

<output truncated>

This is an example of output from the show logging onboard uptime summary command:

Switch# show logging onboard uptime summary

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

UPTIME SUMMARY INFORMATION

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

First customer power on : 03/01/1993 00:03:50

Total uptime            :   0 years   0 weeks   3 days  21 hours  55 minutes

Total downtime          :   0 years   0 weeks   0 days   0 hours   0 minutes

Number of resets        : 2

Number of slot changes  : 1

Current reset reason    : 0x0

Current reset timestamp : 03/01/1993 00:03:28

Current slot            : 1

Current uptime          :   0 years   0 weeks   0 days   0 hours  55 minutes

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

Reset  |        |

Reason | Count  |

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

No historical data to display

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

This is an example of output from the show logging onboard voltage summary command:

Switch# show logging onboard voltage summary

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

VOLTAGE SUMMARY INFORMATION

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

Number of sensors          : 8

Sampling frequency         : 60 seconds

Maximum time of storage    : 3600 minutes

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

Sensor                            |   ID  | Maximum Voltage

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

12.00V                              0      12.567

5.00V                               1       5.198

3.30V                               2       3.439

2.50V                               3       2.594

1.50V                               4       1.556

1.20V                               5       1.239

1.00V                               6       0.980

0.75V                               7       0.768

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

Nominal Range                         Sensor ID

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

No historical data to display

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

Related Commands

Command	Description
clear logging onboard	Removes the OBFL data in the flash memory.
hw-module module logging onboard	Enables OBFL.

show mac access-group

To display the MAC access control lists (ACLs) configured for an interface or a switch, use the show mac access-group command in user EXEC mode.

show mac access-group [interface interface-id] [ | {begin | exclude | include} expression]

Syntax Description

interface interface-id	(Optional) Displays the MAC ACLs configured on a specific interface. Valid interfaces are physical ports and port channels; the port-channel range is 1 to 48 (available only in privileged EXEC mode).
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show mac-access group user EXEC command. In this display, Gigabit Ethernet interface 0/2 has the MAC access list macl_e1 applied to inbound traffic; no MAC ACLs are applied to other interfaces.

Switch> show mac access-group 

Interface GigabitEthernet0/1:

   Inbound access-list is macl_e1

   Outbound access-list is not set

Interface GigabitEthernet0/2:

   Inbound access-list is not set

   Outbound access-list is not set

Interface GigabitEthernet0/3:

   Inbound access-list is not set

   Outbound access-list is not set

Interface GigabitEthernet0/4:

   Inbound access-list is not set

   Outbound access-list is not set

Interface GigabitEthernet0/5:

   Inbound access-list is not set

   Outbound access-list is not set

<output truncated>

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

Switch# show mac access-group interface gigabitethernet0/1

Interface GigabitEthernet0/1:

   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

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, use the show mac address-table command in user EXEC mode.

show mac address-table [ | {begin | exclude | include} expression]

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show 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    Gi0/4

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

To display MAC address table information for the specified MAC address, use the show mac address-table address command in user EXEC mode.

show mac address-table address mac-address [bridge-domain number] [interface interface-id] [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

mac-address	Specifies the 48-bit MAC address; the valid format is H.H.H.
bridge-domain number]	(Optional) Displays information for the specified Ethernet Flow Point (EFP) bridge domain. The range is from 1 to 8000.
interface interface-id	(Optional) Displays information for a specific interface. Valid interfaces include physical ports and port channels.
vlan vlan-id	(Optional) Displays entries for the specific VLAN only. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch# show mac address-table address 0014.c23b.3573 

          Mac Address Table

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

Vlan    Mac Address       Type        Ports

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

   1    0014.c23b.3573    DYNAMIC     Gi0/5

   3    0014.c23b.3573    DYNAMIC     Gi0/2+Efp66

Total Mac Addresses for this criterion: 2

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

To display the aging time of a specific address table instance, or all address table instances on a specified VLAN or bridge domain or on all VLANs and bridge domains, use the show mac address-table aging-time command in user EXEC mode.

show mac address-table aging-time [bridge-domain number] [routed-mac] [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

bridge-domain number	(Optional) Displays aging time for the specified Ethernet Flow Point (EFP) bridge domain. The range is from 1 to 8000.
routed-mac	(Optional) Displays aging time for routed MAC addresses.
vlan vlan-id	(Optional) Displays aging time information for a specific VLAN. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

Examples

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

Switch> show mac address-table aging-time

Global Aging Time:  300

Vlan    Aging Time

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

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 

This is an example of output from the show mac address-table aging-time for a bridge domain:

Switch> show mac address-table aging-time bridge-domain 66

Global Aging Time:  300

BD      Aging Time

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

 66       200

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 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 bridge-domain

To display the MAC address table information for the specified bridge domain, use the show mac address-table bridge-domain command in user EXEC mode.

show mac address-table bridge-domain number [ | {begin | exclude | include} expression]

Syntax Description

number	Specifies the Ethernet Flow Point (EFP) bridge domain number. The range is 1 to 8000.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch> show mac address-table interface bridge-domain 2

          Mac Address Table

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

BD      Mac Address       Type        Ports

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

 All    0100.0000.0000    STATIC      CPU

 All    0100.0ccc.cccc    STATIC      CPU

 All    0100.0ccc.cccd    STATIC      CPU

 All    0100.0ccc.ccce    STATIC      CPU

 All    0100.0ccd.cdd0    STATIC      CPU

 All    0100.0cdd.dddd    STATIC      CPU

 All    0180.c200.0000    STATIC      CPU

 All    0180.c200.0001    STATIC      CPU

 All    0180.c200.0002    STATIC      CPU

 All    0180.c200.0003    STATIC      CPU

 All    0180.c200.0004    STATIC      CPU

 All    0180.c200.0005    STATIC      CPU

 All    0180.c200.0006    STATIC      CPU

 All    0180.c200.0007    STATIC      CPU

 All    0180.c200.0008    STATIC      CPU

 All    0180.c200.0009    STATIC      CPU

 All    0180.c200.000a    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

 All    ffff.ffff.ffff    STATIC      CPU

Total Mac Addresses for this criterion: 24 

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

To display the number of addresses present in all VLANs or the specified VLAN, use the show mac address-table count command in user EXEC mode.

show mac address-table count [bridge-domain number] [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

bridge-domain number	(Optional) Displays the number of addresses for a specific Ethernet Flow Point (EFP) bridge domain. The range is 1 to 8000.
vlan vlan-id	(Optional) Displays the number of addresses for a specific VLAN. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

Examples

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

Switch# show mac address-table count

Mac Entries for vlan 1:

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

Dynamic Address Count  : 69

Static  Address Count  : 0

Total Mac Addresses    : 69

Mac Entries for vlan 2:

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

Dynamic Address Count  : 0

Static  Address Count  : 0

Total Mac Addresses    : 0

Mac Entries for vlan 3:

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

Dynamic Address Count  : 52

Static  Address Count  : 0

Total Mac Addresses    : 52

Mac Entries for vlan 44:

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

Dynamic Address Count  : 0

Static  Address Count  : 0

Total Mac Addresses    : 0

Total Mac Address Space Available: 255879

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

To display only dynamic MAC address table entries, use the show mac address-table dynamic command in user EXEC mode.

show mac address-table dynamic [address mac-address] [bridge-domain number] [interface interface-id] [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

address mac-address	(Optional) Specifies a 48-bit MAC address; the valid format is H.H.H (available in privileged EXEC mode only).
bridge-domain number	(Optional) Displays entries for a specific Ethernet Flow Point (EFP) bridge domain number. The range is from 1 to 8000.
interface interface-id	(Optional) Displays entries for a specific interface. Valid interfaces are physical ports and port channels.
vlan vlan-id	(Optional) Displays entries for a specific VLAN. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch> show mac address-table dynamic

          Mac Address Table

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

Vlan    Mac Address       Type        Ports

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

   1    0003.e386.47f0    DYNAMIC     Gi0/5

   1    0009.9b00.dd9d    DYNAMIC     Gi0/5

   1    0009.9b01.2d25    DYNAMIC     Gi0/5

   1    000c.2925.7d4d    DYNAMIC     Gi0/5

   1    000c.298f.0d15    DYNAMIC     Gi0/5

   1    000c.299b.b392    DYNAMIC     Gi0/5

   1    000c.29d8.3445    DYNAMIC     Gi0/5

   1    000e.0c9c.3af4    DYNAMIC     Gi0/5

   1    000e.0ca8.44c8    DYNAMIC     Gi0/5

   1    000e.0cab.2012    DYNAMIC     Gi0/5

   1    000e.0cb8.88d1    DYNAMIC     Gi0/5

   1    0011.1195.1574    DYNAMIC     Gi0/5

   1    0011.1195.157c    DYNAMIC     Gi0/5

   1    0011.11f1.ee7c    DYNAMIC     Gi0/5

   1    0011.929c.5f58    DYNAMIC     Gi0/5

<output truncated>

   3    0003.e386.47f0    DYNAMIC     Gi0/2+Efp66

   3    0009.9b00.dd9d    DYNAMIC     Gi0/2+Efp66

   3    0009.9b01.2d25    DYNAMIC     Gi0/2+Efp66

   3    000c.2925.7d4d    DYNAMIC     Gi0/2+Efp66

   3    000c.299b.b392    DYNAMIC     Gi0/2+Efp66

   3    000c.29d8.3445    DYNAMIC     Gi0/2+Efp66

   3    000e.0c9c.3af4    DYNAMIC     Gi0/2+Efp66

   3    000e.0ca8.44c8    DYNAMIC     Gi0/2+Efp66

   3    000e.0cab.2012    DYNAMIC     Gi0/2+Efp66

   3    000e.0cb8.88d1    DYNAMIC     Gi0/2+Efp66

   3    0011.1195.1574    DYNAMIC     Gi0/2+Efp66

   3    0011.1195.157c    DYNAMIC     Gi0/2+Efp66

   3    0011.11f1.ee7c    DYNAMIC     Gi0/2+Efp66

   3    0011.929c.5f58    DYNAMIC     Gi0/2+Efp66

   3    0014.c23b.3573    DYNAMIC     Gi0/2+Efp66

   3    0015.600e.cffe    DYNAMIC     Gi0/2+Efp66

   3    0016.7620.e292    DYNAMIC     Gi0/2+Efp66

   3    0016.7620.f23c    DYNAMIC     Gi0/2+Efp66

   3    0019.563f.4700    DYNAMIC     Gi0/2+Efp66

<output truncated>

Total Mac Addresses for this criterion: 129

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

To display the MAC address table information for the specified interface in the specified VLAN, use the show mac address-table interface command in user EXEC mode.

show mac address-table interface interface-id [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

interface-id	Specifies an interface type; valid interfaces include physical ports and port channels.
vlan vlan-id	(Optional) Displays entries for a specific VLAN; the range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch> show mac address-table interface gigabitethernet0/2

          Mac Address Table

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

Vlan    Mac Address     Type    Ports

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

   1    0030.b635.7862  DYNAMIC Gi0/2

   1    00b0.6496.2741  DYNAMIC Gi0/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 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

To display the status of MAC address learning for all VLANs and bridge domains or the specified VLAN or bridge domain, use the show mac address-table learning command in user EXEC mode.

show mac address-table learning [bridge-domain number] [vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

bridge-domain number	(Optional) Displays information for a specific Ethernet Flow Point bridge domain. The range is 1 to 8000.
vlan vlan-id	(Optional) Displays information for a specific VLAN. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

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

Examples

This is an example of output from the show 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	Configures MAC address learning on a VLAN or bridge domain.

show mac address-table move update

To display the MAC address-table move update information on the switch, use the show mac address-table move update command in user EXEC mode.

show mac address-table move update [ | {begin | exclude | include} expression]

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show 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

Related Commands

Command	Description
clear mac address-table move update	Clears the MAC address-table move update counters.
mac address-table move update {receive | transmit}	Configures MAC address-table move update on the switch.

show mac address-table notification

To display the MAC address notification settings for all interfaces or the specified interface, use the show mac address-table notification command in user EXEC mode.

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

Syntax Description

change	Displays the MAC change notification feature parameters and the history table.
interface	(Optional) Displays information for all interfaces. Valid interfaces include physical ports and port channels.
interface-id	(Optional) Displays information for the specified interface. Valid interfaces include physical ports and port channels.
mac-move	Displays status for MAC address move notifications.
threshold	Displays status for MAC-address table threshold monitoring.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

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.

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

Examples

This is an example of output from the show 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 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

To display only static MAC address table entries, use the show mac address-table static command in user EXEC mode.

show mac address-table static [address mac-address] [bridge-domain number] [interface interface-id] [vlan vlan-id]
[ | {begin | exclude | include} expression]

Syntax Description

address mac-address	(Optional) Specifies a 48-bit MAC address; the valid format is H.H.H (available in privileged EXEC mode only).
bridge-domain number	(Optional) Displays information for a specific Ethernet Flow Point bridge domain. The range is 1 to 8000.
interface interface-id	(Optional) Displays addresses for a specific interface. Valid interface include physical ports and port channels.
vlan vlan-id	(Optional) Displays addresses for a specific VLAN. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show 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.
mac address-table static drop	Enables unicast MAC address filtering and configures the switch to drop traffic with a specific source or destination MAC address.
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 vlan	Displays the MAC address table information for the specified VLAN.

show mac address-table vlan

To display the MAC address table information for the specified VLAN, use the show mac address-table vlan command in user EXEC mode.

show mac address-table vlan vlan-id [ | {begin | exclude | include} expression]

Syntax Description

vlan-id	(Optional) Displays addresses for a specific VLAN. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show 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.0005  STATIC  CPU

   1    0180.c200.0006  STATIC  CPU

   1    0180.c200.0007  STATIC  CPU

Total Mac Addresses for this criterion: 9 

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 network-clocks

To display information about Synchronous Ethernet (SyncE) clock configuration for the switch, use the show network-clocks command in privileged EXEC mode.

show network-clocks [ | {begin | exclude | include} expression]

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC -

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show networks-clocks command:

Switch# show network-clocks

Network Clock Configuration

Input Clock BITS: invalid

Input Clock SYNCE Te0/1: valid

Input Clock SYNCE Te0/2 : valid

System Clock Lock Status (T0DPLL) : Free Run

Output Clock Generated from T4 DPLL

T4 DPLL Lock Status : Not Locked

System Clock Selected Ref: None

T4 DPLL Selected Ref: None

System Clock (T0 DPLL) Info:

Priority  Source            Type

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

 T4 DPLL Clock Info:

Priority  Source            Type

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

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

System Clock Mode : Revertive

 EEC Option Configured : Option 1

System Clock State is Automatic

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

 hold-timeout : infinite

 ESMC/SSM workaround using REP not configured

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

Measured offset freq for input BITS is +483.87ppm (3.8 ppm resolution)

Measured offset freq for input Te0/1 is +0.0ppm (3.8 ppm resolution)

Measured offset freq for input Te0/2 is +0.0ppm (3.8 ppm resolution)

Measured offset freq for current path (T4 DPLL) is Not Available

Related Commands

Command	Description
network-clock-select	Configures the network clock for the switch..
set network-clocks	Set SyncE clock selection on the switch.

show pagp

To display Port Aggregation Protocol (PAgP) channel-group information, use the show pagp command in user EXEC mode.

show pagp [channel-group-number] {counters | internal | neighbor} [ | {begin | exclude | include} expression]]

Syntax Description

channel-group-number	(Optional) Number of the channel group. The range is 1 to 26.
counters	Displays PAgP traffic information.
internal	Displays PAgP internal information.
neighbor	Displays PAgP neighbor information.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

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

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

Examples

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

Switch> show pagp 1 counters

             Information        Flush

Port         Sent   Recv     Sent   Recv

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

Channel group: 1

Gi0/1      45     42       0      0 

  Gi0/2      45     41       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

Gi0/1       SC    U6/S7   H       30s      1        128        Any      16

Gi0/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.

Gi0/1       switch-p2            0002.4b29.4600   Gi0/1          9s SC      10001 

Gi0/2       switch-p2            0002.4b29.4600   Gi0/2         24s SC      10001 

Related Commands

Command	Description
clear pagp	Clears PAgP channel-group information.

show parser macro

To display the parameters for all configured macros or for one macro on the switch, use the show parser macro command in user EXEC mode.

show parser macro [{brief | description [interface interface-id] | name macro-name}] [ | {begin | exclude | include} expression]

Syntax Description

brief	(Optional) Displays the name of each macro.
description [interface interface-id]	(Optional) Displays all macro descriptions or the description of a specific interface.
name macro-name	(Optional) Displays information about a single macro identified by the macro name.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is a partial output example from the show parser macro command:

Switch# show parser macro

Total number of macros = 2

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

Macro name : sample-macro1

Macro type : customizable

duplex full

speed auto

mdix auto

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

Macro name : test1

Macro type : customizable

no shutdown

flowcontrol receive on

speed 100

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

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

Switch# show parser macro name sample-macro1

Macro name : sample-macro1

Macro type : customizable

duplex full

speed auto

mdix auto

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

Switch# show parser macro brief

    customizable     : sample-macro1

    customizable     : test1

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.

show policy-map

To display quality of service (QoS) policy maps, which define classification criteria for incoming and outgoing traffic and the actions to be performed on the classified traffic, use the show policy-map command in user EXEC mode.

show policy-map [policy-map-name | control-plane [all] | interface [interface-id]] [input | output] [class class-name] | [service instance number]] [ | {begin | exclude | include} expression]

Syntax Description

policy-map-name	(Optional) Displays the specified policy-map name.
control-plane [all]	(Optional) Displays the control plane policy or all control plane policies.
interface [interface-id]	(Optional) Displays information and statistics about policy maps applied to all ports or the specified port. •interface-id—Displays information about policy maps on the specified physical interface.
[input | output]	(Optional) If you specify control plane or a port, you can specify additional keywords.The keywords have these meanings: •input—Displays information about input policy maps on the switch or applied to the specified port. •output—Displays information about output policy-maps on the switch or applied to the specified port.
class class-name	(Optional) Displays policy-map statistics for an individual class.
service instance number	(Optional) Displays policy map information for a service instance. The service instance number range is from 1 to 4294967295.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of the output of the show policy-map interface command showing statistics for an output policy map.

Switch# show policy-map interface gigabitethernet 0/2

 GigabitEthernet0/2

  Service-policy output: phb

    Class-map: phb (match-all)

      0 packets, 0 bytes

      5 minute offered rate 0 bps, drop rate 0 bps

      Match: cos  2

          Bandwidth 1000 (kbps)

          Queue-limit current-queue-depth 0 bytes

              Output Queue:

                Tail Packets Drop: 0

                Tail Bytes Drop: 0 

    Class-map: class-default (match-any)

      0 packets, 0 bytes

      5 minute offered rate 0 bps, drop rate 0 bps

      Match: any

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

Switch> show policy-map top2

  Policy Map top2

    Class class-default

      shape average 11111124 

      service-policy pout

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

Switch> show policy-map pout

  Policy Map pout

    Class ip1

      priority

     police cir percent 10

       conform-action transmit 

       exceed-action drop 

      queue-limit 250

      queue-limit precedence  1 100

    Class ip2

      Average Rate Traffic Shaping

      cir 5%

    Class ip3

      bandwidth percent 10

      queue-limit 200

      queue-limit precedence  3 100

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

Switch> show policy-map pin-police

Policy Map pin-police

    Class ip1

     police cir 20000000 bc 625000

       conform-action transmit 

       exceed-action drop 

       violate-action drop 

Table 2-18 describes the fields in the show policy-map interface display. The fields in the table are grouped according to the relevant QoS feature.

Table 3-14 show policy-map interface Field Descriptions 

Field	Description
Fields associated with classes or service policies
Service-policy input/output	Name of the input or output service policy applied to the specified interface.
Class-map	Class of traffic shown. Output appears for each configured class in the policy. The choice for implementing class matches (match-all or match-any) might also appear next to the traffic class.
packets	Number of packets identified as belonging to the traffic class.
Match	Match criteria specified for the class of traffic. This includes criteria such as class of service (CoS) value, discard class, IP precedence value, multiprotocol label switching (MPLS) experimental (EXP) value, Differentiated Services Code Point (DSCP) value, access groups, and QoS groups.
Fields associated with policing
police	Shown when the police command has been configured to enable traffic policing. Displays the specified committed information rate (CIR) and conform burst size (BC) used for policing packets.
conform-action	Displays the action to be taken on packets marked as conforming to a specified rate.
conform	Displays the number of packets marked as conforming to the specified rate.
exceed-action	Displays the actions to be taken on packets marked as exceeding a specified rate.
exceed	Displays the number of packets marked as exceeding the specified rate.
violate-action	Displays the actions to be taken on packets marked as exceeding the maximum rate.
violate	Displays the number of packets marked as exceeding the maximum rate.
Fields associated with queuing
Queue Limit	Queue size configured for the class in number of packets.
Output Queue	The queue created for this class of traffic.
Tail packets dropped	The number of packets dropped when the mean queue depth is greater than the maximum threshold value.
Fields associated with traffic scheduling
Traffic shaping	The rate used for shaping traffic.
Bandwidth	Bandwidth configured for this class in kbps or a percentage.
Priority	Indicates that this class is configured for priority queuing.

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 port-type

To display interface type information for the Cisco ME switch, use the show port-type command in privileged EXEC mode.

show port-type [eni | nni | uni] [ | {begin | exclude | include} expression]

---

Note All ports on the switch are network node interfaces (NNIs), so only nni output is valid.

---

Syntax Description

eni	Enhanced network interface.
nni	Network node interface.
uni	User network interface.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

If you enter the command without keywords, the output includes the interface type information for all ports on the switch. If you specify the port type (eni, nni, or uni), the output includes information for the specified port type.

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

Examples

This is an example of output from the show port-type command. The output is the same for show port-type and show port-type nni:

Switch# show port-type nni

Port      Name               Vlan       Port Type

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

Gi0/1                        trunk      Network Node Interface           (nni)

Gi0/2                        trunk      Network Node Interface           (nni)

Gi0/3                        trunk      Network Node Interface           (nni)

Gi0/4                        1          Network Node Interface           (nni)

Gi0/5                        1          Network Node Interface           (nni)

Gi0/6                        routed     Network Node Interface           (nni)

Gi0/7                        1          Network Node Interface           (nni)

Gi0/8                        1          Network Node Interface           (nni)

Gi0/9                        1          Network Node Interface           (nni)

Gi0/10                       1          Network Node Interface           (nni)

Gi0/11    testwhelshdevice   1          Network Node Interface           (nni)

Gi0/12                       1          Network Node Interface           (nni)

Gi0/13                       trunk      Network Node Interface           (nni)

Gi0/14                       1          Network Node Interface           (nni)

Gi0/15                       1          Network Node Interface           (nni)

Gi0/16                       1          Network Node Interface           (nni)

Gi0/17                       1          Network Node Interface           (nni)

Gi0/18                       1          Network Node Interface           (nni)

Gi0/19                       1          Network Node Interface           (nni)

Gi0/20                       1          Network Node Interface           (nni)

Gi0/21                       1          Network Node Interface           (nni)

Gi0/22                       1          Network Node Interface           (nni)

Gi0/23                       1          Network Node Interface           (nni)

Gi0/24                       1          Network Node Interface           (nni)

Te0/1                        1          Network Node Interface           (nni)

Te0/2                        1          Network Node Interface           (nni)

This is an example of output from the show port-type command using other keywords:

Switch# show port-type nni | exclude Gigabitethernet0/1

Port      Name               Vlan       Port Type

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

Gi0/2                        1          Network Node Interface (nni)

Related Commands

Command	Description
port-type	Sets the interface type for a port, but all ports are NNIs.

show rep topology

To display Resilient Ethernet Protocol (REP) topology information for a segment or for all segments, including the primary and secondary edge ports in the segment., use the show rep topology command in user EXEC mode.

show rep topology [segment segment_id] [archive] [detail] [ | {begin | exclude | include} expression]

Syntax Description

segment-id	(Optional) Displays REP topology information for the specified segment. The ID range is from 1 to 1024.
archive	(Optional) Displays the previous topology of the segment. This keyword can be useful for troubleshooting a link failure.
detail	(Optional) Displays detailed REP topology information.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

In the show rep topology command output, ports configured as edge no-neighbor are designated with an asterisk (*) in front of Pri or Sec. In the output of the show rep topology detail command, No-Neighbor is spelled out.

The output of this command is also included in the show tech-support privileged EXEC command output.

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

Examples

This is a sample output from the show rep topology segment privileged EXEC command:

Switch # show rep topology segment 1

REP Segment 1

BridgeName       PortName   Edge Role

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

sw1_multseg_3750 Gi1/1/1    Pri  Alt 

sw3_multseg_3400 Gi0/13          Open

sw3_multseg_3400 Gi0/14          Alt 

sw4_multseg_3400 Gi0/13          Open

sw4_multseg_3400 Gi0/14          Open

sw5_multseg_3400 Gi0/13          Open

sw5_multseg_3400 Gi0/14          Open

sw2_multseg_3750 Gi1/1/2         Open

sw2_multseg_3750 Gi1/1/1         Open

sw1_multseg_3750 Gi1/1/2    Sec  Open

This is a sample output from the show rep topology command when the edge ports are configured to have no REP neighbor:

Switch # show rep topology 

REP Segment 2

BridgeName       PortName   Edge  Role

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

sw8-ts8-51       Gi0/2      Pri*  Open

sw9-ts11-50      Gi1/0/4          Open

sw9-ts11-50      Gi1/0/2          Open

sw1-ts11-45      Gi0/2            Alt 

sw1-ts11-45      Po1              Open

sw8-ts8-51       Gi0/1      Sec*  Open

This example shows output from the show rep topology detail command:

Switch# show rep topology detail

REP Segment 2

repc_2_24ts, Fa0/2 (Primary Edge)

  Alternate Port, some vlans blocked

  Bridge MAC: 0019.e714.5380

  Port Number: 004

  Port Priority: 080

  Neighbor Number: 1 / [-10]

repc_3_12cs, Gi0/1 (Intermediate)

  Open Port, all vlans forwarding

  Bridge MAC: 001a.a292.3580

  Port Number: 001

  Port Priority: 000

  Neighbor Number: 2 / [-9]

repc_3_12cs, Po10 (Intermediate)

  Open Port, all vlans forwarding

  Bridge MAC: 001a.a292.3580

  Port Number: 080

  Port Priority: 000

  Neighbor Number: 3 / [-8]

repc_4_12cs, Po10 (Intermediate)

  Open Port, all vlans forwarding

  Bridge MAC: 001a.a19d.7c80

  Port Number: 080

  Port Priority: 000

  Neighbor Number: 4 / [-7]

repc_4_12cs, Gi0/2 (Intermediate)

  Alternate Port, some vlans blocked

  Bridge MAC: 001a.a19d.7c80

  Port Number: 002

  Port Priority: 040

  Neighbor Number: 5 / [-6]

 
<output truncated> 

This example shows output from the show rep topology segment archive command:

Switch# show rep topology segment 1 archive

REP Segment 1

BridgeName       PortName   Edge Role

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

sw1_multseg_3750 Gi1/1/1    Pri  Open

sw3_multseg_3400 Gi0/13          Open

sw3_multseg_3400 Gi0/14          Open

sw4_multseg_3400 Gi0/13          Open

sw4_multseg_3400 Gi0/14          Open

sw5_multseg_3400 Gi0/13          Open

sw5_multseg_3400 Gi0/14          Open

sw2_multseg_3750 Gi1/1/2         Alt 

sw2_multseg_3750 Gi1/1/1         Open

sw1_multseg_3750 Gi1/1/2    Sec  Open

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 spanning-tree

To display spanning-tree state information, use the show spanning-tree command in user EXEC mode.

show spanning-tree [bridge-group | active [detail] | blockedports | bridge | detail [active] | inconsistentports | interface interface-id | mst | pathcost method | root | summary [totals] | vlan vlan-id] [ | {begin | exclude | include} expression]

show spanning-tree bridge-group [active [detail] | blockedports | bridge | detail [active] | inconsistentports | interface interface-id | root | summary] [| {begin | exclude | include} expression]

show spanning-tree vlan vlan-id [active [detail] | blockedports | bridge | detail [active] | inconsistentports | interface interface-id | root | summary] [ | {begin | exclude | include} expression]

show spanning-tree {vlan vlan-id | bridge-group} bridge [address | detail | forward-time | hello-time | id | max-age | priority [system-id] | protocol] [ | {begin | exclude | include} expression]

show spanning-tree {vlan vlan-id | bridge-group} root [address | cost | detail | forward-time | hello-time | id | max-age | port | priority [system-id] [ | {begin | exclude | include} expression]

show spanning-tree interface interface-id [active [detail] | cost | detail [active] | inconsistency | portfast | priority | rootcost | state] [ | {begin | exclude | include} expression]

show spanning-tree mst [configuration [digest]] | [instance-id [detail | interface interface-id [detail]] [ | {begin | exclude | include} expression]

Syntax Description

bridge-group	(Optional) Specify the bridge group number. The range is 1 to 255.
active [detail]	(Optional) Display spanning-tree information only on active interfaces (available only in privileged EXEC mode).
blockedports	(Optional) Display blocked port information (available only in privileged EXEC mode).
bridge [address | detail | forward-time | hello-time | id | max-age | priority [system-id] | protocol]	(Optional) Display status and configuration of this switch (optional keywords available only in privileged EXEC mode).
detail [active]	(Optional) Display a detailed summary of interface information (active keyword available only in privileged EXEC mode).
inconsistentports	(Optional) Display inconsistent port information (available only in privileged EXEC mode).
interface interface-id [active [detail] | cost | detail [active] | inconsistency | portfast | priority | rootcost | state]	(Optional) Display spanning-tree information for the specified interface (all options except portfast and state available only in privileged EXEC mode). Enter each interface separated by a space. Ranges are not supported. Valid interfaces include physical interfaces and port channels. The VLAN range is 1 to 4094. The port-channel range is 1 to 26.
mst [configuration [digest]] [instance-id [detail | interface interface-id [detail]]	(Optional) Display the multiple spanning-tree (MST) region configuration and status (available only in privileged EXEC mode). The keywords have these meanings: •digest—(Optional) Display the MD5 digest included in the current MST configuration identifier (MSTCI). Two separate digests, one for standard and one for prestandard switches, appear (available only in privileged EXEC mode). The terminology was updated for the implementation of the IEEE standard, and the txholdcount field was added. The new master role appears for boundary ports. The word pre-standard or Pre-STD appears when an IEEE standard bridge sends prestandard BPDUs on a port. The word pre-standard (config) or Pre-STD-Cf appears when a port has been configured to send prestandard BPDUs and no prestandard BPDU has been received on that port. The word pre-standard (rcvd) or Pre-STD-Rx appears when a prestandard BPDU has been received on a port that has not been configured to send prestandard BPDUs. A dispute flag appears when a designated port receives inferior designated information until the port returns to the forwarding state or ceases to be designated. •instance-id—You can specify a single instance ID, a range of IDs separated by a hyphen, or a series of IDs separated by a comma. The range is 1 to 4094. The display shows the number of currently configured instances. •interface interface-id—(Optional) Valid interfaces include VLANs, physical interfaces, and port channels. The VLAN range is 1 to 4094. The port-channel range is 1 to 26. •detail—(Optional) Display detailed information for the instance or interface.
pathcost method	(Optional) Display the default path cost method (available only in privileged EXEC mode).
root [address | cost | detail | forward-time | hello-time | id | max-age | port | priority [system-id]]	(Optional) Display root switch status and configuration (all keywords available only in privileged EXEC mode).
summary [totals]	(Optional) Display a summary of port states or the total lines of the spanning-tree state section.
vlan vlan-id [active [detail] | backbonefast | blockedports | bridge [address | detail | forward-time | hello-time | id | max-age | priority [system-id] | protocol]	(Optional) Display spanning-tree information for the specified VLAN (some keywords available only in privileged EXEC mode). You can specify a single VLAN identified by VLAN ID number, a range of VLANs separated by a hyphen, or a series of VLANs separated by a comma. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

If the vlan-id variable is omitted, the command applies to the spanning-tree instance for all VLANs.

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

Examples

This is an example of output from the show spanning-tree active command:

Switch# show spanning-tree active

VLAN0001

  Spanning tree enabled protocol ieee

  Root ID    Priority    32768

             Address     0001.42e2.cdd0

             Cost        3038

             Port        24 (GigabitEthernet0/1)

             Hello Time   2 sec  Max Age 20 sec  Forward Delay 15 sec

  Bridge ID  Priority    49153  (priority 49152 sys-id-ext 1)

             Address     0003.fd63.9580

             Hello Time   2 sec  Max Age 20 sec  Forward Delay 15 sec

             Aging Time 300

  Uplinkfast enabled

Interface        Role Sts Cost      Prio.Nbr Type

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

Gi0/1            Root FWD 3019      128.24   P2p

<output truncated>

This is an example of output from the show spanning-tree detail command:

Switch# show spanning-tree detail

VLAN0001 is executing the ieee compatible Spanning Tree protocol

  Bridge Identifier has priority 49152, sysid 1, address 0003.fd63.9580

  Configured hello time 2, max age 20, forward delay 15

  Current root has priority 32768, address 0001.42e2.cdd0

  Root port is 24 (GigabitEthernet0/1), cost of root path is 3038

  Topology change flag not set, detected flag not set

  Number of topology changes 0 last change occurred 1d16h ago

  Times:  hold 1, topology change 35, notification 2

          hello 2, max age 20, forward delay 15

  Timers: hello 0, topology change 0, notification 0, aging 300

  Uplinkfast enabled

 Port 1 (GigabitEthernet0/1) of VLAN0001 is forwarding

   Port path cost 3019, Port priority 128, Port Identifier 128.24.

   Designated root has priority 32768, address 0001.42e2.cdd0

   Designated bridge has priority 32768, address 00d0.bbf5.c680

   Designated port id is 128.25, designated path cost 19

   Timers: message age 2, forward delay 0, hold 0

   Number of transitions to forwarding state: 1

   Link type is point-to-point by default

   BPDU: sent 0, received 72364

<output truncated>

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

Switch# show spanning-tree interface gigabitethernet0/1

Vlan             Role Sts Cost      Prio.Nbr Type

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

VLAN0001         Root FWD 3019      128.24   P2p

This is an example of output from the show spanning-tree summary command:

Switch# show spanning-tree summary

Switch is in pvst mode

Root bridge for: none

EtherChannel misconfiguration guard is enabled

Extended system ID   is enabled

Portfast             is disabled by default

PortFast BPDU Guard  is disabled by default

Portfast BPDU Filter is disabled by default

Loopguard            is disabled by default

Pathcost method used is short

Name                   Blocking Listening Learning Forwarding STP Active

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

VLAN0001                  1        0         0        11         12

VLAN0002                  3        0         0        1          4

VLAN0004                  3        0         0        1          4

VLAN0006                  3        0         0        1          4

VLAN0031                  3        0         0        1          4

VLAN0032                  3        0         0        1          4

<output truncated>

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

37 vlans                  109      0         0        47         156

Station update rate set to 150 packets/sec.

This is an example of output from the show spanning-tree mst configuration command:

Switch# show spanning-tree mst configuration

Name      [region1]

Revision  1

Instance  Vlans Mapped

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

0         1-9,21-4094

1         10-20

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

This is an example of output from the show spanning-tree mst configuration digest command:

Switch# show spanning-tree mst configuration

% Switch is not in mst mode

Name      []

Revision  0     Instances configured 1

Digest          0xAC36177F50283CD4B83821D8AB26DE62

Pre-std Digest  0xBB3B6C15EF8D089BB55ED10D24DF44DE

This is an example of output from the show spanning-tree mst interface interface-id command:

Switch# show spanning-tree mst interface gigabitethernet0/1

GigabitEthernet0/1 of MST00 is root forwarding

Edge port: no             (default)        port guard : none        (default)

Link type: point-to-point (auto)           bpdu filter: disable     (default)

Boundary : boundary       (STP)            bpdu guard : disable     (default)

Bpdus sent 5, received 74

Instance role state cost      prio vlans mapped

0        root FWD   200000    128  1,12,14-4094

This is an example of output from the show spanning-tree mst 0 command:

Switch# show spanning-tree mst 0

###### MST00        vlans mapped: 1-9,21-4094

Bridge      address 0002.4b29.7a00  priority  32768 (32768 sysid 0)

Root        address 0001.4297.e000  priority  32768 (32768 sysid 0)

port    Gi0/1           path cost 200038

IST master *this switch

Operational hello time 2, forward delay 15, max age 20, max hops 20

Configured  hello time 2, forward delay 15, max age 20, max hops 20

Interface              role state cost      prio type

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

GigabitEthernet0/1     root FWD   200000    128  P2P bound(STP)

GigabitEthernet0/2     desg FWD   200000    128  P2P bound(STP)

Port-channel1          desg FWD   200000    128  P2P bound(STP)

Related Commands

Command	Description
clear spanning-tree counters	Clears the spanning-tree counters.
clear spanning-tree detected-protocols	Restarts the protocol migration process.
spanning-tree bpdufilter	Prevents an interface from sending or receiving bridge protocol data units (BPDUs).
spanning-tree bpduguard	Puts an interface in the error-disabled state when it receives a BPDU.
spanning-tree cost	Sets the path cost for spanning-tree calculations.
spanning-tree extend system-id	Enables the extended system ID feature.
spanning-tree guard	Enables the root guard or the loop guard feature for all the VLANs associated with the selected interface.
spanning-tree link-type	Overrides the default link-type setting for rapid spanning-tree transitions to the forwarding state.
spanning-tree loopguard default	Prevents alternate or root ports from becoming the designated port because of a failure that leads to a unidirectional link.
spanning-tree mst configuration	Enters multiple spanning-tree (MST) configuration mode through which the MST region configuration occurs.
spanning-tree mst cost	Sets the path cost for MST calculations.
spanning-tree mst forward-time	Sets the forward-delay time for all MST instances.
spanning-tree mst hello-time	Sets the interval between hello BPDUs sent by root switch configuration messages.
spanning-tree mst max-age	Sets the interval between messages that the spanning tree receives from the root switch.
spanning-tree mst max-hops	Sets the number of hops in an MST region before the BPDU is discarded and the information held for an interface is aged.
spanning-tree mst port-priority	Configures an interface priority.
spanning-tree mst priority	Configures the switch priority for the specified spanning-tree instance.
spanning-tree mst root	Configures the MST root switch priority and timers based on the network diameter.
spanning-tree port-priority	Configures an interface priority.
spanning-tree portfast (global configuration)	Globally enables the BPDU filtering or the BPDU guard feature on Port Fast-enabled interfaces or enables the Port Fast feature on all nontrunking interfaces.
spanning-tree portfast (interface configuration)	Enables the Port Fast feature on an interface and all its associated VLANs.
spanning-tree vlan	Configures spanning tree on a per-VLAN basis.

show storm-control

To display broadcast, multicast, or unicast storm control settings on the switch or on the specified interface, or to display storm-control history, use the show storm-control command in user EXEC mode.

show storm-control [interface-id] [broadcast | multicast | unicast] [ | {begin | exclude | include} expression]

Syntax Description

interface-id	(Optional) Interface ID for the physical port (including type, module, and port number).
broadcast	(Optional) Displays broadcast storm threshold setting.
multicast	(Optional) Displays multicast storm threshold setting.
unicast	(Optional) Displays unicast storm threshold setting.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

When you enter an interface-id, the storm control thresholds appear for the specified interface.

If you do not enter an interface-id, settings appear for one traffic type for all ports on the switch.

If you do not enter a traffic type, settings appear for broadcast storm control.

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

Examples

This is an example of a partial output from the show storm-control command when no keywords are entered. Because no traffic-type keyword was entered, the broadcast storm control settings appear.

Switch> show storm-control

Interface    Filter State   Upper       Lower      Current

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

Gi0/1        Forwarding     20 pps      10 pps     5 pps

Gi0/2        Forwarding     50.00%      40.00%     0.00%

<output truncated>

This is an example of output from the show storm-control command for a specified interface. Because no traffic-type keyword was entered, the broadcast storm control settings appear.

Switch> show storm-control gigabitethernet 0/1

Interface    Filter State   Upper       Lower      Current

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

Gi0/1        Forwarding     20 pps      10 pps     5 pps

Table 2-19 describes the fields in the show storm-control display.

Table 3-15 show storm-control Field Descriptions 

Field	Description
Interface	Displays the ID of the interface.
Filter State	Displays the status of the filter: •Blocking—Storm control is enabled, and a storm has occurred. •Forwarding—Storm control is enabled, and no storms have occurred. •Inactive—Storm control is disabled.
Upper	Displays the rising suppression level as a percentage of total available bandwidth in packets per second or in bits per second.
Lower	Displays the falling suppression level as a percentage of total available bandwidth in packets per second or in bits per second.
Current	Displays the bandwidth usage of broadcast traffic or the specified traffic type (broadcast, multicast, or unicast) as a percentage of total available bandwidth. This field is only valid when storm control is enabled.

Related Commands

Command	Description
storm-control	Sets the broadcast, multicast, or unicast storm control levels for the switch.

show udld

To display UniDirectional Link Detection (UDLD) administrative and operational status for all ports or the specified port, use the show udld command in user EXEC mode.

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

Syntax Description

interface-id	(Optional) ID of the interface and port number. Valid interfaces include physical ports and VLANs. The VLAN range is 1 to 4094.
neighbors	(Optional) Displays a summary of UDLD neighbors.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

If you do not enter an interface-id, administrative and operational UDLD status for all interfaces appear.

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

Examples

This is an example of output from the show udld interface-id command. For this display, UDLD is enabled on both ends of the link, and UDLD detects that the link is bidirectional. Table 2-20 describes the fields in this display.

Switch> show udld gigabitethernet0/1

Interface gi0/1

---

Port enable administrative configuration setting: Follows device default

Port enable operational state: Enabled

Current bidirectional state: Bidirectional

Current operational state: Advertisement - Single Neighbor detected

Message interval: 60

Time out interval: 5

    Entry 1

    Expiration time: 146

    Device ID: 1

    Current neighbor state: Bidirectional

    Device name: Switch-A 

    Port ID: Gi0/1

    Neighbor echo 1 device: Switch-B

    Neighbor echo 1 port: Gi0/2 

    Message interval: 5

    CDP Device name: Switch-A

Table 3-16 show udld Field Descriptions 

Field	Description
Interface	The interface on the local device configured for UDLD.
Port enable administrative configuration setting	How UDLD is configured on the port. If UDLD is enabled or disabled, the port enable configuration setting is the same as the operational enable state. Otherwise, the enable operational setting depends on the global enable setting.
Port enable operational state	Operational state that shows whether UDLD is actually running on this port.
Current bidirectional state	The bidirectional state of the link. An unknown state appears if the link is down or if it is connected to an UDLD-incapable device. A bidirectional state appears if the link is a normal two-way connection to a UDLD-capable device. All other values mean miswiring.
Current operational state	The current phase of the UDLD state machine. For a normal bidirectional link, the state machine is most often in the Advertisement phase.
Message interval	How often advertisement messages are sent from the local device. Measured in seconds.
Time out interval	The time period, in seconds, that UDLD waits for echoes from a neighbor device during the detection window.
Entry 1	Information from the first cache entry, which contains a copy of echo information received from the neighbor.
Expiration time	The amount of time in seconds remaining before this cache entry is aged out.
Device ID	The neighbor device identification.
Current neighbor state	The neighbor's current state. If both the local and neighbor devices are running UDLD normally, the neighbor state and local state should be bidirectional. If the link is down or the neighbor is not UDLD-capable, no cache entries appear.
Device name	The device name or the system serial number of the neighbor. The system serial number appears if the device name is not set or is set to the default (Switch).
Port ID	The neighbor port ID enabled for UDLD.
Neighbor echo 1 device	The device name of the neighbors' neighbor from which the echo originated.
Neighbor echo 1 port	The port number ID of the neighbor from which the echo originated.
Message interval	The rate, in seconds, at which the neighbor is sending advertisement messages.
CDP device name	The CDP device name or the system serial number. The system serial number appears if the device name is not set or is set to the default (Switch).

Related Commands

Command	Description
udld	Enables aggressive or normal mode in UDLD or sets the configurable message timer time.
udld port	Enables UDLD on an individual interface or prevents a fiber-optic interface from being enabled by the udld global configuration command.
udld reset	Resets all interfaces shutdown by UDLD and permits traffic to begin passing through them again.

show version

To display version information for the switch hardware and firmware, use the show version command in user EXEC mode.

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

Syntax Description

| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

---

Note Though visible in the show version output, the configuration register information is not supported on the switch.

---

Switch> show version

Cisco IOS Software, ME380x Software (ME380x-UNIVERSAL-M)

Copyright (c) 1986-2010 by Cisco Systems, Inc.

Compiled Tue 12-Oct-10 02:19

Image text-base: 0x00003000, data-base: 0x020881B8

ROM: Bootstrap program is WHALES boot loader

BOOTLDR: ME380x Boot Loader (ME380X-HBOOT-M), Version 12.2 

Switch uptime is 1 minute

System returned to ROM by power-on

System image file is 
"flash:/me380x-universal-mz.122-52.1.127.EY/me380x-universal-mz.122-52.1.127.E

Y.bin"

License Level: MetroAggrServices

License Type: Permanent

Next reload license Level: MetroAggrServices

cisco ME-3800X-24FS-M (PowerPC8572) processor (revision P3) with 1015808K/32760K bytes of 
memory.

Processor board ID FOC1350X0NW

Last reset from power-on

Target IOS Version 12.2(46)EY

1 Virtual Ethernet interface

25 Gigabit Ethernet interfaces

2 Ten Gigabit Ethernet interfaces

The password-recovery mechanism is enabled.

1536K bytes of flash-simulated non-volatile configuration memory.

Base ethernet MAC Address       : 00:27:0C:AB:4E:00

Motherboard assembly number     : 73-12068-05

Motherboard serial number       : FOC13490VLP

Model revision number           : P3

Motherboard revision number     : 06

Model number                    : ME-3800X-24FS-M

System serial number            : FOC1350X0NW

Top Assembly Part Number        : 800-31465-01

Top Assembly Revision Number    : 36

Version ID                      : V01

Configuration register is 0xF

show vfi

To display information about a virtual forwarding infrastructure (VFI), use the show vfi command in user EXEC mode. VFIs are used to implement hierarchical virtual private LAN service (H-VPLS) over a multiprotocol label switching (MPLS) backbone.

show vfi vfi-name [ forwarding] [ | {begin | exclude | include} expression]

Syntax Description

vfi-name	Name of the configured VFI.
forwarding	(Optional) Displays the VFI Layer 2 forwarding table.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

User EXEC

Command History

Release	Modification
12.2.(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch> show vfi vfitest1

VFI name:vfitest1, state:UP

  Local attachment circuits:

    Vlan666

  Neighbor connected via pseudowires:11.11.11.11

This is an example of output from the show vfi command with the forwarding keyword:

Switch> show vfi vfitest1 forwarding

vcid:222, type:ether , local groupid:37, remote groupid:40 (vc is up)

client:Vfi is up, destination:11.11.11.11, Peer LDP Ident:11.11.11.11:0

local label:20, remote label:21, tunnel label:implc-null

outgoing interface:Gi1/1/2, next hop:2.2.2.1

Local MTU:1500, Remote MTU:1500

Remote interface description:Vfi

Packet totals(in/out):10/3375408

byte totals(in/out):1306/276783942 

Related Commands

Command	Description
l2vfi	Creates a VFI and enters VFI configuration mode.
debug vqpc	Displays VFI error or event debug messages.

show vlan

To display the parameters for all configured VLANs or a specified VLAN, use the show vlan command in user EXEC mode.

show vlan [access-map | brief | counters | dot1q tag native | filter | id vlan-id | mtu | name vlan-name | summary] [ | {begin | exclude | include} expression]

Syntax Description

access-map	See the show vlan access-map command.
brief	(Optional) Displays one line for each VLAN with the VLAN name, status, and its ports.
counters	(Optional) Displays VLAN traffic counters for all VLANs.
dot1q tag native	(Optional) Displays the IEEE 802.1Q native VLAN tagging status. This keyword is supported only when the switch is running the metro IP access or metro access image.
filter	See the show vlan filter command.
id vlan-id	(Optional) Displays information about a single VLAN identified by VLAN ID number. For vlan-id, the range is 1 to 4094.
mtu	(Optional) Displays a list of VLANs and the minimum and maximum transmission unit (MTU) sizes configured on ports in the VLAN.
name vlan-name	(Optional) Displays information about a single VLAN identified by VLAN name. The VLAN name is an ASCII string from 1 to 32 characters.
summary	(Optional) Displays VLAN summary information.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

---

Note Though visible in the command-line help string, the ifindex, private-vlan, remote-span, and mnit vlan keywords are not supported.

---

Command Modes

User EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

In the show vlan mtu command output, the MTU_Mismatch column shows whether all the ports in the VLAN have the same MTU. When yes appears in this column, it means that the VLAN has ports with different MTUs. Packets that are switched from a port with a larger MTU to a port with a smaller MTU might be dropped. If the VLAN does not have a switch virtual interface (SVI), the hyphen (-) symbol appears in the SVI_MTU column. If the MTU-Mismatch column displays yes, the names of the port with the MinMTU and the port with the MaxMTU appear.

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

Examples

This is an example of output from the show vlan command. Table 2-21 describes the fields in the display.

---

Note The switch supports only Ethernet VLANs. You can configure parameters for FDDI and Token Ring VLANs and view the results in the vlan.dat file, but these parameters are not supported or used.

---

Switch> show vlan

VLAN Name                             Status    Ports

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

1    default                          active    Fa0/1, Fa0/2, Fa0/3, Fa0/4

                                                Fa0/5, Fa0/6, Fa0/7, Fa0/8

                                                Fa0/9, Fa0/10, Fa0/11, Fa0/12

                                                Fa0/13, Fa0/14, Fa0/15, Fa0/16

                                                Fa0/17, Fa0/18, Fa0/19, Fa0/20

                                                Fa0/21, Fa0/22, Fa0/23, Fa0/24

                                                Gi0/1, Gi0/2

1002 fddi-default                     act/unsup

1003 token-ring-default               act/unsup

1004 fddinet-default                  act/unsup

1005 trnet-default                    act/unsup

VLAN Type  SAID       MTU   Parent RingNo BridgeNo Stp  BrdgMode Trans1 Trans2

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

1    enet  100001     1500  -      -      -        -    -        0      0

1002 fddi  101002     1500  -      -      -        -    -        0      0

1003 tr    101003     1500  -      -      -        -    -        0      0

1004 fdnet 101004     1500  -      -      -        ieee -        0      0

1005 trnet 101005     1500  -      -      -        ibm  -        0      0VLAN Name                             

VLAN Type              Ports

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

Table 3-17 show vlan Command Output Fields 

Field	Description
VLAN	VLAN number.
Name	Name, if configured, of the VLAN.
Status	Status of the VLAN (active or suspend).
Ports	Ports that belong to the VLAN.
Type	Media type of the VLAN.
SAID	Security association ID value for the VLAN.
MTU	Maximum transmission unit size for the VLAN.
Parent	Parent VLAN, if one exists.
RingNo	Ring number for the VLAN, if applicable.
BrdgNo	Bridge number for the VLAN, if applicable.
Stp	Spanning Tree Protocol type used on the VLAN.
BrdgMode	Bridging mode for this VLAN—possible values are source-route bridging (SRB) and source-route transparent (SRT); the default is SRB.
Trans1	Translation bridge 1.
Trans2	Translation bridge 2.
Remote SPAN VLANs	Identifies any RSPAN VLANs that have been configured.
Primary/Secondary/ Type/Ports	Includes any configured private VLANs, including the primary VLAN ID, the secondary VLAN ID, the type of secondary VLAN (community or isolated), and the ports that belong to it.
VLAN Type/Ports	Displays any configured UNI-ENI VLANs, the type (community or isolated), and the ports that belong to it.

This is an example of output from the show vlan dot1q tag native command:

Switch> show vlan dot1q tag native

dot1q native vlan tagging is disabled

This is an example of output from the show vlan mtu command:

Switch> show vlan mtu

VLAN    SVI_MTU    MinMTU(port)      MaxMTU(port)     MTU_Mismatch

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

1    1500          1500              1500              No

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

Switch> show vlan summary

Number of existing VLANs           : 45

 Number of existing VTP VLANs      : 0

 Number of existing extended VLANs : 0

This is an example of output from the show vlan id command.

Switch# show vlan id 2

VLAN Name                             Status    Ports

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

2    VLAN0200                         active    Gi0/1, Gi0/2

VLAN Type  SAID       MTU   Parent RingNo BridgeNo Stp  BrdgMode Trans1 Trans2

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

2    enet  100002     1500  -      -      -        -    -        0      0

Remote SPAN VLAN

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

Disabled

Related Commands

Command	Description
switchport mode	Configures the VLAN membership mode of a port.
vlan	Enables VLAN configuration mode where you can configure VLANs 1 to 4094.

show vlan access-map

To display information about a particular VLAN access map or for all VLAN access maps, use the show vlan access-map command in privileged EXEC mode.

show vlan access-map [mapname] [ | {begin | exclude | include} expression]

Syntax Description

mapname	(Optional) Name of a specific VLAN access map.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

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

Switch# show vlan access-map

Vlan access-map "SecWiz"  10

  Match clauses:

    ip  address: SecWiz_Fa1_0_3_in_ip

  Action:

    forward

Related Commands

Command	Description
show vlan filter	Displays information about all VLAN filters or about a particular VLAN or VLAN access map.
vlan access-map	Creates a VLAN map entry for VLAN packet filtering.
vlan filter	Applies a VLAN map to one or more VLANs.

show vlan filter

To display information about all VLAN filters or about a particular VLAN or VLAN access map, use the show vlan filter command in privileged EXEC mode.

show vlan filter [access-map name | vlan vlan-id] [ | {begin | exclude | include} expression]

Syntax Description

access-map name	(Optional) Displays filtering information for the specified VLAN access map.
vlan vlan-id	(Optional) Displays filtering information for the specified VLAN. The range is 1 to 4094.
| begin	(Optional) Display begins with the line that matches the expression.
| exclude	(Optional) Display excludes lines that match the expression.
| include	(Optional) Display includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(52)EY	This command was introduced.

Usage Guidelines

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

Examples

This is an example of output from the show vlan filter command:

Switch# show vlan filter 

VLAN Map map_1 is filtering VLANs:

  20-22

Related Commands

Command	Description
show vlan access-map	Displays information about a particular VLAN access map or for all VLAN access maps.
vlan access-map	Creates a VLAN map entry for VLAN packet filtering.
vlan filter	Applies a VLAN map to one or more VLANs.