Catalyst 6500 Series Command Reference, 7.6
clear mls multicast statistics to clear vtp pruneeligible

Table Of Contents

clear mls multicast statistics

clear mls nde flow

clear mls statistics

clear mls statistics entry

clear module password

clear multicast router

clear ntp server

show ntpclear ntp timezone

clear pbf

clear pbf-map

clear port broadcast

clear port cops

clear port host

clear port qos cos

clear port security

clear pvlan mapping

clear qos acl

clear qos config

clear qos cos-dscp-map

clear qos dscp-cos-map

clear qos ipprec-dscp-map

clear qos mac-cos

clear qos map

clear qos policed-dscp-map

clear qos policer

clear qos statistics

clear radius

clear rcp

clear rgmp statistics

clear security acl

clear security acl capture-ports

clear security acl log flow

clear security acl map

clear snmp access

clear snmp access-list

clear snmp community

clear snmp community-ext

clear snmp group

clear snmp ifalias

clear snmp notify

clear snmp targetaddr

clear snmp targetparams

clear snmp trap

clear snmp user

clear snmp view

clear spantree detected-protocols

clear spantree mst

clear spantree portcost

clear spantree portinstancecost

clear spantree portinstancepri

clear spantree portpri

clear spantree portvlancost

clear spantree portvlanpri

clear spantree root

clear spantree statistics

clear spantree uplinkfast

clear tacacs key

clear tacacs server

clear timezone

clear top

clear trunk

clear vlan

clear vlan counters

clear vlan mapping

clear vmps rcp

clear vmps server

clear vmps statistics

clear vtp pruneeligible


22

clear mls multicast statistics

To remove MLS multicast statistics maintained by the MSFC on the switch, use the clear mls multicast statistics command.

clear mls multicast statistics [mod]

Syntax Description

mod

(Optional) Number of the MSFC; valid values are 15 and 16.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you enter the clear mls multicast statistics command on a Catalyst 6500 series switch without MLS, this warning message is displayed:

MLS Multicast is not supported on feature card.

If you place the MFSC on a supervisor engine installed in slot 1, the MFSC is recognized as module 15. If you install the supervisor engine in slot 2, the MFSC is recognized as module 16.

The mod option is not supported on switches configured with the Supervisor Engine 2 with Layer 3 Switching Engine II (PFC2).

Examples

This example shows how to clear MLS statistics on a switch configured with the Supervisor Engine 1 with Layer 3 Switching Engine WS-F6K-PFC (Policy Feature Card):

Console> (enable) clear mls multicast statistics
All statistics for the MLS routers in include list are cleared.
Console> (enable)

This example shows how to clear MLS statistics on a switch configured with the Supervisor Engine 2 with Layer 3 Switching Engine II (PFC2):

Console> (enable) clear mls multicast statistics
All statistics cleared.
Console> (enable)

Related Commands

show mls statistics

clear mls nde flow

To reset the NDE filters in the Catalyst 6500 series switches, use the clear mls nde flow command.

clear mls nde flow

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Clearing both exclusion and inclusion filters results in exporting of all flows.

Examples

This example shows how to clear the NDE exclusion and inclusion filters and export all flows:

Console> (enable) clear mls nde flow
Netflow data export filter cleared.
Console> (enable)

Related Commands

set mls nde
show mls exclude protocol

clear mls statistics

To clear hardware-installed MLS statistics entries, use the clear mls statistics command.

clear mls statistics

clear mls statistics protocol {protocol port} | all

Syntax Description

statistics

Clears total packets switched and total packets exported (for NDE).

statistics protocol

Clears protocols for statistics collection.

protocol

Number of the protocol in the protocol statistics list.

port

Number of the port.

all

Clears all entries from the statistics protocol list.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

To use a router as an MLS, you must meet these conditions:

The router must be included (either explicitly or automatically) in the MLS-SE.

The MLS feature must be enabled in the Catalyst 6500 series switches.

Catalyst 6500 series switches must know the router's MAC-VLAN pairs.

If you enter any of the clear mls statistics commands on a Catalyst 6500 series switch without MLS, this warning message displays:

Feature not supported in hardware.

When you remove an MSM from the Catalyst 6500 series switch, it is removed immediately from the inclusion list and all the MLS entries for the MSM are removed.

Examples

This example shows how to clear IP MLS statistics, including total packets switched and total packets exported (for NDE):

Console> (enable) clear mls statistics 
Netflow data export statistics cleared.
Console> (enable)

This example shows how to clear protocol 17, port 19344 from the statistics collection:

Console> (enable) clear mls statistics protocol 17 19344
Protocol 17 port 1934 cleared from protocol statistics list.
Console> (enable)

Related Commands

set mls statistics protocol
show mls statistics

clear mls statistics entry

To clear statistics for MLS entries, use the clear mls statistics entry command.

clear mls statistics entry [ip | ipx] all

clear mls statistics entry ip [destination ip_addr_spec] [source ip_addr_spec]
[protocol protocol] [src-port src_port] [dst-port dst_port]

clear mls statistics entry ipx destination ipx_addr_spec

Syntax Description

ip

(Optional) Specifies IP MLS.

ipx

(Optional) Specifies IPX MLS.

all

Purges all matching MLS entries.

destination

(Optional) Specifies the destination IP address.

ip_addr_spec

(Optional) Full IP address or a subnet address in these formats: ip_addr, ip_addr/netmask, or ip_addr/maskbit.

source

(Optional) Specifies the source IP address.

protocol protocol

(Optional) Specifies additional flow information (protocol family and protocol port pair) to be matched; valid values are from 0 to 255 or ip, ipinip, icmp, igmp, tcp, and udp.

src-port src_port

(Optional) Specifies the source port IP address; valid values are from 1 to 65535, dns, ftp, smtp, telnet, x (X-Windows), www.

dst-port dst_port

(Optional) Specifies the destination port IP address; valid values are from 1 to 65535, dns, ftp, smtp, telnet, x (X-Windows), www.

ipx_addr_spec

(Optional) Full IPX address or a subnet address in these formats: src_net/[mask], dest_net.dest_node, or dest_net/mask.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you specify the ip keyword or do not enter a keyword, the command supports IP MLS. If you specify the ipx keyword, the command supports IPX only.

When you remove an MSM from the Catalyst 6500 series switch, it is removed immediately from the inclusion list and all the MLS entries for the MSM are removed.

When entering the IPX address syntax, use the following format:

IPX net address—1..FFFFFFFE

IPX node address—x.x.x where x is 0..FFFF

IPX address—ipx_net.ipx_node (for example 3.0034.1245.AB45, A43.0000.0000.0001)

Up to 16 routers can be included explicitly as MLS-RPs.

To use a router as an MLS, you must meet these conditions:

The router must be included (either explicitly or automatically) in the MLS-SE.

The MLS feature must be enabled in the Catalyst 6500 series switches.

Catalyst 6500 series switches must know the router's MAC-VLAN pairs.

Use the following syntax to specify an IP subnet address:

ip_subnet_addr—This is the short subnet address format. The trailing decimal number 00 in an IP address YY.YY.YY.00 specifies the boundary for an IP subnet address. For example, 172.22.36.00 indicates a 24-bit subnet address (subnet mask 172.22.36.00/255.255.255.0), and 173.24.00.00 indicates a 16-bit subnet address (subnet mask 173.24.00.00/255.255.0.0). However, this format can identify only a subnet address of 8, 16, or 24 bits.

ip_addr/subnet_mask—This is the long subnet address format. For example, 172.22.252.00/255.255.252.00 indicates a 22-bit subnet address. This format can specify a subnet address of any bit number. To provide more flexibility, the ip_addr is a full host address, such as 172.22.253.1/255.255.252.00.

ip_addr/maskbits—This is the simplified long subnet address format. The mask bits specify the number of bits of the network masks. For example, 172.22.252.00/22 indicates a 22-bit subnet address. The ip_addr is a full host address, such as 193.22.253.1/22, which has the same subnet address as the ip_subnet_addr.

A 0 value for src_port and dest_port clears all entries. Unspecified options are treated as wildcards, and all entries are cleared.

If you enter any of the clear mls commands on a Catalyst 6500 series switch without MLS, this warning message displays:

Feature not supported in hardware.

Examples

This example shows how to clear all specific MLS entries:

Console> (enable) clear mls statistics entry ip all
Multilayer switching entry cleared
Console> (enable)

This example shows how to clear specific IPX MLS entries for a destination IPX address:

Console> (enable) clear mls statistics entry ipx destination 1.0002.00e0.fefc.6000
MLS IPX entry cleared.
Console> (enable)

Related Commands

show mls

clear module password

To clear the password set by the password [username] NAM command, use the clear module password command.

clear module password mod

Syntax Description

mod

Number of the NAM.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is supported by the NAM only.

The password [username] command is a NAM command and not a supervisor engine console command.

A message is displayed when the password is successfully cleared. See the "Examples" section for an example of the message.

Examples

This example shows how to clear the password from the NAM:

Console> (enable) clear module password 6
Module 6 password cleared.
Console> (enable) 2000 Apr 07 11:03:06 %SYS-5-MOD_PASSWDCLR:Module 6 password cl
eared from telnet/10.6.1.10/tester
Console> (enable) 

Related Commands

password (refer to the NAM Installation and Configuration Note)

clear multicast router

To clear manually configured multicast router ports from the multicast router port list, use the clear multicast router command.

clear multicast router {mod/port | all}

Syntax Description

mod/port

Number of the module and the port on the module.

all

Specifies all multicast router ports to be cleared.


Defaults

The default configuration has no multicast router ports configured.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear multicast router port 1 on module 3:

Console> (enable) clear multicast router 3/1 
Port 3/1 cleared from multicast router port list.
Console> (enable)

Related Commands

set multicast router
show multicast router

clear ntp server

To remove one or more servers from the NTP server table, use the clear ntp server command.

clear ntp server {ip_addr | all}

Syntax Description

ip_addr

IP address of the server to remove from the server table.

all

Specifies all server addresses in the server table to be removed.


Defaults

The default configuration has no NTP servers configured.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to remove a specific NTP server from the server table:

Console> (enable) clear ntp server 172.20.22.191
NTP server 172.20.22.191 removed.
Console> (enable)

This example shows how to remove all NTP servers from the server table:

Console> (enable) clear ntp server all
All NTP servers cleared.
Console> (enable)

Related Commands

show ntpclear ntp timezone

To return the time zone to its default, UTC, use the clear ntp timezone command.

clear ntp timezone

Syntax Description

This command has no arguments or keywords.

Defaults

The default time zone is UTC.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The clear ntp timezone command functions only when NTP is running. If you set the time manually and NTP is disengaged, the clear ntp timezone command has no effect.

Examples

This example shows how to clear the time zone:

Console> (enable) clear ntp timezone
This command will clear NTP timezone and summertime zonename
Do you want to continue (y/n) [n]? y
Timezone name and offset cleared
Console> (enable) 

Related Commands

set ntp timezone
show ntp

clear pbf

To remove the MAC address for the PFC2, use the clear pbf command.

clear pbf

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Refer to the "Configuring Policy-Based Forwarding" section of Chapter 16, "Configuring Access Control," in the Catalyst 6500 Series Switch Software Configuration Guide for detailed information about PBF.

Examples

Console> (enable) clear pbf
PBF cleared
Console> (enable)

Related Commands

set pbf
show pbf

clear pbf-map

To clear PBF map information, use the clear pbf-map command.

clear pbf-map {vlan vlan} | all | {ip_addr_1} {mac_addr_1} {vlan_1} {ip_addr_2} {mac_addr_2} {vlan_2}

Syntax Description

vlan vlan

Clears the ACL with the name PBF_MAP_ACL_vlan and the adjacency table used by this ACL.

all

Clears all adjacency information and ACLs that were created by entering the set pbf-map command.

ip_addr_1

IP address of host 1.

mac_addr_1

MAC address of host 1.

vlan_1

Number of the first VLAN.

ip_addr_2

IP address of host 2.

mac_addr_2

MAC address of host 2.

vlan_2

Number of the second VLAN.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

When you enter clear pbf-map {ip_addr_1} {mac_addr_1} {vlan_1} {ip_addr_2} {mac_addr_2} {vlan_2}, all ACEs that were created by entering the set pbf-map command are cleared, except permit ip any any. This command removes entries that enable traffic between hosts with ip_addr_1 and ip_addr_2 on the two specified VLANs.

Use the clear pbf-map command to delete the redirect-to-adjacency ACEs and adjacency information contained in the PBF_MAP_ACL_(VLAN_ID) ACL.

Use the clear security acl command to clear all other ACE types that are part of the PBF_MAP_ACL_(VLAN_ID) ACL.

If entries were already deleted by using the clear security acl command, a message displays stating that the specified entries were already cleared.

Examples

This example shows how to clear the ACL with the name PBF_MAP_ACL_11:

Console> (enable) clear pbf-map vlan 11
ACL 'PBF_MAP_ACL_11' successfully deleted.
Console> (enable) Commit operation successfull.
Console> (enable)

This example shows how to clear all adjacency information and ACLs that were created by entering the set pbf-map command:

Console> (enable) clear pbf-map all
ACL 'PBF_MAP_ACL_11' successfully deleted.
Console> (enable)
ACL 'PBF_MAP_ACL_22' successfully deleted.
Console> (enable)

This example shows how to clear all entries that enable traffic between the two specified hosts:

Console> (enable) clear pbf-map 1.1.1.1 0-0-0-0-0-1 11 2.2.2.2 0-0-0-0-0-2 22
ACL 'PBF_MAP_ACL_11' successfully committed.
Console> (enable)
ACL 'PBF_MAP_ACL_22' successfully committed.
Console> (enable)

Related Commands

clear security acl
set pbf-map
show pbf-map

clear port broadcast

To disable broadcast/multicast suppression on one or more ports, use the clear port broadcast command.

clear port broadcast mod/port

Syntax Description

mod/port

Number of the module and the port on the module.


Defaults

The default configuration has broadcast/multicast suppression cleared (that is, unlimited broadcast/multicast traffic allowed).

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to disable broadcast/multicast suppression:

Console> (enable) clear port broadcast 2/1
Broadcast traffic unlimited on ports 2/1.
Console> (enable)

Related Commands

set port broadcast
show port broadcast

clear port cops

To clear port roles, use the clear port cops command.

clear port cops mod/port roles role1 [role2]...

clear port cops mod/port all-roles

Syntax Description

mod/port

Number of the module and the port on the module.

roles role#

Specifies the roles to clear.

all-roles

Clears all roles.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The clear port cops command detaches the roles from the port only; it does not remove them from the global table.

Examples

This example shows how to remove specific roles from a port:

Console> (enable) clear port cops 3/1 roles backbone_port main_port
Roles cleared for port(s) 3/1-4.
Console> (enable)

This example shows how to remove all roles from a port:

Console> (enable) clear port cops 3/1 all-roles
All roles cleared for port 3/1-4.
Console> (enable)

Related Commands

set port cops
show port cops

clear port host

To clear the port configuration for optimizing a host connection, use the clear port host command.

clear port host mod/port

Syntax Description

mod/port

Number of the module and the port on the module.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

The clear port host command sets channel mode to auto, disables spanning tree PortFast, and sets the trunk mode to auto.

Examples

This example shows how to remove specific roles from a port:

Console> (enable) clear port host 5/5
Port(s)  5/5 trunk mode set to auto.
Spantree port  5/5 fast start disabled.
Port(s) 5/5 channel mode set to auto.
Console> (enable)

Related Commands

set port host

clear port qos cos

To return the values set by the set port qos cos command to the default settings for all specified ports, use the clear port qos cos command.

clear port qos mod/ports.. cos

Syntax Description

mod/ports..

Number of the module and ports on the module.


Defaults

The default CoS for a port is 0.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to return the values set by the set port qos cos command to the default settings for module 2, port 1:

Console> (enable) clear port qos 2/1 cos
Port 2/1 qos cos setting cleared.
Console> (enable) 

Related Commands

set port qos cos
show port qos

clear port security

To clear all MAC addresses or a specific MAC address from the list of secure MAC addresses on a port, use the clear port security command.

clear port security mod/port {mac_addr | all}

Syntax Description

mod/port

Number of the module and the port on the module.

mac_addr

MAC address to be deleted.

all

Removes all MAC addresses.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to remove a specific MAC address from a port's list of secure addresses:

Console> (enable) clear port security 4/1 00-11-22-33-44-55
00-11-22-33-44-55 cleared from secure address list list for port 4/1.
Console> (enable) 

Related Commands

set port security
show port security

clear pvlan mapping

To delete a private VLAN mapping, use the clear pvlan mapping command.

clear pvlan mapping primary_vlan {isolated_vlan | community_vlan | twoway_community_vlan} mod/port

clear pvlan mapping mod/port

Syntax Description

primary_vlan

Number of the primary VLAN.

isolated_vlan

Number of the isolated VLAN.

community_vlan

Number of the community VLAN.

twoway_community_vlan

Number of the two-way community VLAN.

mod/port

Number of the module and promiscuous port.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you do not specify the mapping to clear, all the mappings of the specified promiscuous ports are cleared.

Examples

This example shows how to clear the mapping of VLAN 902 to 901, previously set on ports 3/2-5:

Console> (enable) clear pvlan mapping 901 902 3/2-5
Successfully cleared mapping between 901 and 902 on 3/2-5 
Console> (enable) 

Related Commands

clear config pvlan
clear vlan
set pvlan
set pvlan mapping
set vlan
show pvlan
show pvlan mapping
show vlan

clear qos acl

To remove various ACL configurations, use the clear qos acl command.

clear qos acl acl_name [editbuffer_index]

clear qos acl default-action {ip | ipx | mac | all}

clear qos acl map {acl_name} {mod/port | vlan}

clear qos acl map {acl_name | mod/port | vlan | all}

Syntax Description

acl_name

Unique name that identifies the list to which the entry belongs.

editbuffer_index

(Optional) ACE position in the ACL.

default-action

Removes default actions.

ip

Clears IP ACE default actions.

ipx

Clears IPX ACE default actions.

mac

Clears MAC-layer ACE default actions.

all

Clears all ACE default actions.

map

Detaches an ACL.

mod/port

Number of the module and the port on the module.

vlan

Number of the VLAN; valid values are from 1 to 1000 and from 1025 to 4094.

all

Detaches an ACL from all interfaces.


Defaults

The default is no ACLs are attached.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Changes you make by entering this command are saved to NVRAM and hardware only after you enter the commit command.

Use the show qos acl editbuffer command to display the ACL list.

Examples

This example shows how to detach an ACL from all interfaces:

Console> (enable) clear qos acl map my_acl all
Hardware programming in progress...
ACL my_acl is detached from all interfaces.
Console> (enable) 

This example shows how to detach an ACL from a specific VLAN:

Console> (enable) clear qos acl map ftp_acl 4
Hardware programming in progress...
ACL ftp_acl is detached from vlan 4.
Console> (enable) 

This example shows how to delete a specific ACE:

Console> (enable) clear qos acl my_ip_acl 1
ACL my_ip_acl ACE# 1 is deleted.
my_ip_acl editbuffer modified. Use `commit' command to apply changes.
Console> (enable) 

This example shows how to delete an ACL:

Console> (enable) clear qos acl my_ip_acl
ACL my_ip_acl is deleted.
my_ip_acl editbuffer modified. Use `commit' command to apply changes.
Console> (enable) 

This example shows how to detach a specific ACL from all interfaces:

Console> (enable) clear qos acl map my_acl all
Hardware programming in progress...
ACL my_acl is detached from all interfaces.
Console> (enable) 

This example shows how to detach a specific ACL from a specific VLAN:

Console> (enable) clear qos acl map ftp_acl 4
Hardware programming in progress...
ACL ftp_acl is detached from vlan 4.
Console> (enable) 

This example shows how to delete IP ACE default actions configured by the set qos acl default-action command:

Console> (enable) clear qos acl default-action ip
Hardware programming in progress...
QoS default-action for IP ACL is restored to default setting.
Console> (enable) 

Related Commands

commit
rollback
show qos acl editbuffer

clear qos config

To the default settings and delete the CoS assigned to MAC addresses, use the clear qos config command to return the values set by the set qos command.

clear qos config

Syntax Description

This command has no arguments or keywords.

Defaults

The default is QoS is disabled.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to return the values set by the set qos command to the default settings and delete the CoS assigned to MAC addresses:

Console> (enable) clear qos config
This command will disable QoS and take values back to factory default.
Do you want to continue (y/n) [n]? y
QoS config cleared.
Console> (enable) 

Related Commands

set qos
show qos info

clear qos cos-dscp-map

To clear CoS-to-DSCP mapping set by the set qos cos-dscp-map command and return to the default setting, use the clear qos cos-dscp-map command.

clear qos cos-dscp-map

Syntax Description

This command has no arguments or keywords.

Defaults

The default CoS-to-DSCP configuration is listed in Table 2-2.

Table 2-2 CoS-to-DSCP Default Mapping

CoS

0

1

2

3

4

5

6

7

DSCP

0

8

16

24

32

40

48

56


Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the CoS-to-DSCP mapping table:

Console> (enable) clear qos cos-dscp-map
QoS cos-dscp-map setting restored to default.
Console> (enable) 

Related Commands

set qos cos-dscp-map
show qos maps

clear qos dscp-cos-map

To clear DSCP-to-CoS mapping set by the set qos dscp-cos-map command and return to the default setting, use the clear qos dscp-cos-map command.

clear qos dscp-cos-map

Syntax Description

This command has no arguments or keywords.

Defaults

The default DSCP-to-CoS configuration is listed in Table 2-3.

Table 2-3 DSCP-to-CoS Default Mapping

DSCP

0 to 7

8 to 15

16 to 23

24 to 31
32 to 39
40 to 47
48 to 55
56 to 63
CoS

0

1

2

3

4

5

6

7


Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the DSCP-to-CoS mapping table:

Console> (enable) clear qos dscp-cos-map
QoS dscp-cos-map setting restored to default.
Console> (enable) 

Related Commands

set qos dscp-cos-map
show qos maps

clear qos ipprec-dscp-map

To reset the mapping set by the set qos ipprec-dscp-map command to the default setting, use the clear qos ipprec-dscp-map command.

clear qos ipprec-dscp-map

Syntax Description

This command has no arguments or keywords.

Defaults

The default IP precedence-to-DSCP configuration is listed in Table 2-4.

Table 2-4 IP Precedence-to-DSCP Default Mapping

IPPREC

0

1

2

3

4

5

6

7

DSCP

0

8

16

24

32

40

48

56


Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the IP precedence-to-DSCP mapping table:

Console> (enable) clear qos ipprec-dscp-map
QoS ipprec-dscp-map setting restored to default.
Console> (enable) 

Related Commands

set qos ipprec-dscp-map
show qos maps


clear qos mac-cos

To clear the values set by the set qos mac-cos command, use the clear qos mac-cos command.

clear qos mac-cos dest_mac [vlan]

clear qos mac-cos all

Syntax Description

dest_mac

Number of the destination host MAC address.

vlan

(Optional) Number of the VLAN; valid values are from 1 to 1000 and from 1025 to 4094.

all

Clears CoS values for all MAC/VLAN pairs.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If the vlan value is not entered, all entries for the MAC address are cleared.

Examples

This example shows how to clear the values set by the set qos mac-cos command and return to the default settings for all MAC address and VLAN pairs:

Console> (enable) clear qos mac-cos all
All CoS to Mac/Vlan entries are cleared.
Console> (enable) 

This example shows how to clear the values set by the set qos mac-cos command and return to the default settings for a specific MAC address:

Console> (enable) clear qos mac-cos 1-2-3-4-5-6 1
CoS to Mac/Vlan entry for mac 01-02-03-04-05-06 vlan 1 is cleared.
Console> (enable) 

Related Commands

set qos mac-cos
show qos mac-cos

clear qos map

To return the values to the default settings, use the clear qos map command.

clear qos map port_type tx | rx

Syntax Description

port_type

Port type; valid values are 2q2t, 1p3q1t, and 1p2q2t for transmit and 1p1q4t and 1p1q0t for receive. See the "Usage Guidelines" section for additional information.

tx | rx

Specifies the transmit or receive queue.


Defaults

The default mappings for all ports are shown in Table 2-5 and Table 2-6 and apply to all ports.

Table 2-5 Default Transmit Queue and Drop-Threshold Mapping of CoS Values

Port Type
Drop Threshold Type
Low Delay (Queue 2)
High Delay (Queue 1)
Priority Delay (Queue 3)

2q2t

Low drop (Threshold 2)

7, 6

3, 2

N/A

High drop (Threshold 1)

5, 4

1, 0

N/A

1p2q2t

Low drop (Threshold 2)

7

3, 2

N/A

High drop (Threshold 1)

5, 4

1, 0

5


Table 2-6 Default Receive Drop-Threshold Mapping of CoS Values

Port Type
Threshold 1
(highest drop)
Threshold 2
Threshold 3
Threshold 4
(lowest drop)
Priority Queue

1p1q0t

0, 1

2, 3

4, 5

7

6

1p1q4t

0, 1

2, 3

4, 5

7

6


Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The 1p2q1t and 1p1q8t port types are not supported.

Examples

This example shows how to return the values to the default settings:

Console> (enable) clear qos map 2q2t
This command will take map values back to factory default.
QoS map cleared.
Console> (enable) 

Related Commands

set qos map
show qos maps

clear qos policed-dscp-map

To reset the policer-to-dscp mapping table to the defaults, use the clear qos policed-dscp-map.

clear qos policed-dscp-map

Syntax Description

This command has no arguments or keywords.

Defaults

The default is the identity function; for example, DSCP 63 to policed DSCP 63 and DSCP 62 to policed DSCP 62.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to reset the mapping to the defaults:

Console> (enable) clear qos policed-dscp-map
QoS policed-dscp-map setting restored to default.
Console> (enable) 

Related Commands

set qos policed-dscp-map
show qos maps

clear qos policer

To clear policing rules from NVRAM, use the clear qos policer command.

clear qos policer microflow microflow_name | all

clear qos policer aggregate aggregate_name | all

Syntax Description

microflow microflow_name

Specifies the name of the microflow policing rule.

aggregate aggregate_name

Specifies the name of the aggregate policing rule.

all

Clears all policing rules.


Defaults

This command has no default setting in systems configured with the Supervisor Engine 1 with Layer 3 Switching Engine (PFC); in systems configured with Supervisor Engine 2 with Layer 3 Switching Engine II (PFC2), the default is to apply the given map to the normal rate only.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Policing is the process by which the switch limits the bandwidth consumed by a flow of traffic. Policing can mark or drop traffic.

You cannot clear an entry that is currently being used in an ACE. You must first detach the ACEs from the interface.

You cannot use the all keyword if a microflow rate limit is currently being used in an ACE.

The normal and excess keywords are supported on systems configured with the Supervisor Engine 2 with Layer 3 Switching Engine II (PFC2) only. With these keywords, you can specify a map for the normal rate and one for the excess rate. Because this selection is optional in the CLI, the default (unspecified) action is to apply the given map to the normal rate only.

Examples

This example shows how to clear a specific microflow policing rule:

Console> (enable) clear qos policer microflow my_micro 
my_micro QoS microflow policer cleared.
Console> (enable) 

This example shows how to clear all microflow policing rules:

Console> (enable) clear qos policer microflow all
All QoS microflow policers cleared.
Console> (enable) 

This example shows how to clear a specific aggregate policing rule:

Console> (enable) clear qos policer aggregate my_micro 
my_micro QoS microflow policer cleared.
Console> (enable) 

This example shows how to clear all aggregate policing rules:

Console> (enable) clear qos policer aggregate all
All QoS aggregate policer cleared.
Console> (enable)

Related Commands

set qos policer
show qos policer

clear qos statistics

To clear QoS statistic counters, use the clear qos statistics command.

clear qos statistics [aggregate-policer [policer_name]]

Syntax Description

aggregate-policer

(Optional) Clears QoS aggregate policer statistics.

policer_name

(Optional) Name of the aggregate policer.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you enter the clear qos statistics command without the entering the aggregate-policer keyword, all QoS statistics are cleared, including all QoS aggregate policer statistics.

If you enter the aggregate-policer keyword without specifying a policer name, all aggregate policer statistics are cleared.

Examples

This example shows how to clear the QoS statistic counters:

Console> (enable) clear qos statistics
QoS statistical cleared.
Console> (enable)

This example shows how to clear all QoS aggregate policer statistics:

Console> (enable) clear qos statistics aggregate-policer
QoS aggregate policers statistical counters cleared.
Console> (enable)

This example shows how to clear the QoS aggregate policer statistics for aggr_1:

Console> (enable) clear qos statistics aggregate-policer aggr_1
Aggregate policer 'aggr_1' statistical counters cleared.
Console> (enable)

Related Commands

show qos statistics

clear radius

To clear one or all of the RADIUS servers from the RADIUS server table or remove a shared key entry, use the clear radius command.

clear radius server all

clear radius server ipaddr

clear radius key

Syntax Description

server

Specifies RADIUS servers.

all

Specifies all RADIUS servers.

ipaddr

Number of the IP address or IP alias.

key

Specifies the RADIUS shared key.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The ipaddr value is an IP alias or an IP address in dot notation; for example, 101.102.103.104.

Examples

This example shows how to clear the RADIUS key:

Console> (enable) clear radius key
Radius server key cleared.
Console> (enable) 

This example shows how to clear a specific RADIUS server from the RADIUS server table:

Console> (enable) clear radius server 128.56.45.32
128.56.45.32 cleared from radius server table.
Console> (enable) 

Related Commands

set radius key
set radius server
show radius

clear rcp

To clear rcp information for file transfers, use the clear rcp command.

clear rcp

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear rcp information:

Console> (enable) clear rcp
Console> (enable) 

Related Commands

set rcp username
show rcp

clear rgmp statistics

To clear RGMP statistics information for all VLANs, use the clear rgmp statistics command.

clear rgmp statistics

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the RGMP statistics on the switch:

Console> (enable) clear rgmp statistics 
RGMP statistics cleared.
Console> (enable)

Related Commands

set rgmp
show rgmp statistics

clear security acl

To remove a specific access control entry (ACE) or all ACEs from a VACL and to delete the VACLs from the edit buffer, use the clear security acl command.

clear security acl all

clear security acl acl_name

clear security acl capture-ports {all | mod/ports}

clear security acl log flow

clear security acl acl_name [editbuffer_index]

clear security acl adjacency adjacency_name

clear security acl map {acl_name [vlan] | vlan | all}

clear security acl arp-inspection statistics [acl_name]

Syntax Description

all

Removes ACEs for all the VACLs.

acl_name

Name of the VACL whose ACEs are to be removed.

capture-ports

Removes ports from the capture list.

all

Removes all ports from the capture list.

mod/ports

Variable to remove specific port from the capture list; mod/num is the number of the module and the port on the module.

log flow

Removes logging table flow entries.

editbuffer_index

(Optional) Index number of the ACE in the VACL.

adjacency

Removes an adjacency ACE.

adjacency_name

Name of the adjacency ACE.

map

Clears security ACL to a VLAN mapping.

vlan

Variable to clear ACL mappings for a specific VLAN.

all

Clears all ACL VLAN mappings.

arp-inspection statistics

Clears ARP inspection statistics.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Changes you make by entering this command are saved to NVRAM and hardware only after you enter the commit command.

Use the show security acl command to display the VACL list.

The adjacency ACE cannot be cleared before the redirect ACE. The redirect ACE and the adjacency ACE in PBF VACLs should be cleared in the following order:

1. Clear the redirect ACE.

2. Commit the VACL.

3. Clear the adjacency ACE.

4. Commit the adjacency.

When you enter the clear security acl arp-inspection statistics command, if you do not specify an ACL name, the system clears all counters for ARP inspection global statistics and ARP inspection statistics for all ACLs.

Examples

This example shows how to remove ACEs for all the VACLs:

Console> (enable) clear security acl all
All editbuffer modified. Use `commit' command to apply changes.
Console> (enable)

This example shows how to remove a specific ACE from a specific VACL:

Console> (enable) clear security acl IPACL1 2
IPACL1 editbuffer modified. Use `commit' command to apply changes.
Console> (enable)

This example shows how to remove an adjacency ACE:

Console> (enable) clear security acl adjacency a_1
a_1 editbuffer modified. Use 'commit' command to apply changes.
Console> (enable)

This example shows how to clear the ARP inspection global statistics and the ARP inspection statistics for all ACLs:

Console> (enable) clear security acl arp-inspection statistics
Console> (enable)

Related Commands

commit
rollback
show security acl

clear security acl capture-ports

To remove a port from the capture port list, use the clear security acl capture-ports command.

clear security acl capture-ports {mod/ports...}

Syntax Description

mod/ports...

Number of the module and the ports on the module.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Configurations you make by entering this command are saved in NVRAM. This command does not require that you enter the commit command.

If you have several ports and a few are removed, the remaining ports continue to capture the traffic.

Examples

This example shows how to remove entries from the capture port list:

Console> (enable) clear security acl capture-ports 1/1,2/1
Successfully cleared the following ports:
1/1,2/1
Console> (enable) 

Related Commands

set security acl capture-ports
show security acl capture-ports

clear security acl log flow

To clear all flows in the security ACL log table, use the clear security acl log flow command.

clear security acl log flow

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is supported on systems configured with Supervisor Engine 2 with Layer 3 Switching Engine II (PFC2) only.

Examples

This example shows how to clear all flows in the security ACL log table:

Console> (enable) clear security acl log flow   
Security acl log table cleared successfully
Console> (enable) 

Related Commands

set security acl log
show security acl log

clear security acl map

To remove VACL-to-VLAN mapping, use the clear security acl map command.

clear security acl map acl_name vlan

clear security acl map {acl_name | vlan | all}

Syntax Description

acl_name

Name of the VACL whose VLAN is to be deleted.

vlan

Number of the VLAN whose mapping is to be deleted; valid values are from 1 to 1000 and from 1025 to 4094.

all

Removes all VACL-to-VLAN mappings.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Changes you make by entering this command are saved to NVRAM; you do not need to enter the commit command.

Use the show security acl command to display the ACL list.

Examples

This example shows how to remove a VACL-to-VLAN mapping from a specific VLAN:

Console> (enable) clear security acl map ip1 3
Map deletion in progress.

Successfully cleared mapping between ACL ip1 and VLAN 3.
Console> (enable)

This example shows how to remove a specific VACL-to-VLAN mapping from all VLANs:

Console> (enable) clear security acl map ip1
Map deletion in progress.

Successfully cleared mapping between ACL ip1 and VLAN 5.

Successfully cleared mapping between ACL ip1 and VLAN 8.
Console> (enable)

This example shows how to remove all VACL-to-VLAN mappings from a specific VLAN:

Console> (enable) clear security acl map 5
Map deletion in progress.

Successfully cleared mapping between ACL ipx1 and VLAN 5.

Successfully cleared mapping between ACL mac2 and VLAN 5.
Console> (enable)

This example shows how to remove all VACL-to-VLAN mappings from all VLANs:

Console> (enable) clear security acl map all
Map deletion in progress.

Successfully cleared mapping between ACL ip2 and VLAN 12.

Successfully cleared mapping between ACL ipx1 and VLAN 12.

Successfully cleared mapping between ACL ipx1 and VLAN 45.

Successfully cleared mapping between ACL ip2 and VLAN 47.

Successfully cleared mapping between ACL ip3 and VLAN 56.
Console> (enable)

Related Commands

commit
rollback
show security acl

clear snmp access

To remove the access rights of an SNMP group, use the clear snmp access command.

clear snmp access [-hex] {groupname} {security-model {v1 | v2c}}

clear snmp access {security-model v3 {noauthentication | authentication | privacy}}
[context [-hex] contextname]

Syntax Description

-hex

(Optional) Displays the groupname or contextname in a hexadecimal format.

groupname

SNMP access table name.

security-model v1 | v2c

Specifies the security model v1 or v2c.

security-model v3

Specifies security model v3.

noauthentication

Specifies groups with security model type set to noauthentication.

authentication

Specifies groups with security model type authentication protocol.

privacy

Specifies groups with security model type privacy.

context contextname

(Optional) Specifies the name of a context string.


Defaults

The default contextname is a NULL string.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for groupname (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

If you do not enter a context name, a NULL context string is used.

Examples

This example shows how to clear SNMP access for a group:

Console> (enable) clear snmp access cisco-group security-model v3 authentication
Cleared snmp access cisco-group version v3 level authentication.
Console> (enable) 

Related Commands

set snmp access
show snmp access
show snmp context

clear snmp access-list

To clear the IP address of a host that is associated with an access list number, use the clear snmp access-list command.

clear snmp access-list access_number IP_address [[IP_address] ...]

Syntax Description

access_number

Number that specifies a list of hosts that are permitted to use a specific community string; valid values are 1 to 65535.

IP_address

IP address that is associated with the access list. See the "Usage Guidelines" section for more information.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you specify more than one IP address, separate each IP address with a space.

Examples

This example shows how to clear the IP address of a host from access list number 2:

Console> (enable) clear snmp access-list 2 172.20.60.8
Access number 2 no longer associated with 172.20.60.8
Console> (enable)

This example shows how to clear all IP address from access list number 101:

Console> (enable) clear snmp access-list 101
All IP addresses associated with access-number 101 have been cleared.
Console> (enable)

Related Commands

set snmp access-list

clear snmp community

To clear an SNMP community table, use the clear snmp community command.

clear snmp community index [-hex] {index_name}

Syntax Description

index

Specifies clearing an index.

-hex

(Optional) Displays the index_name value in a hexadecimal format.

index_name

Name of the SNMP index.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for the index_name value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

If you do not enter an index_name value, a NULL context string is used.

Examples

This example shows how to clear SNMP access for a group:

Console> (enable) clear snmp community index ind1
Cleared snmp community ind1.
Console> (enable) 

Related Commands

set snmp community
show snmp community

clear snmp community-ext

To clear an existing community string, use the clear snmp community-ext command.

clear snmp community-ext community_string

Syntax Description

community_string

Name of the SNMP community.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

When you clear a community string, corresponding entries in the vacmAccessTable and vacmSecurityToGroup tables are also removed.

Examples

This example shows how to clear an existing community string:

Console> (enable) clear snmp community-ext public1
Community string public1 has been removed.
Console>(enable)

Related Commands

set snmp community-ext

clear snmp group

To remove the SNMP user from an SNMP group, use the clear snmp group command.

clear snmp group [-hex] groupname {user [-hex] username} {security-model {v1 | v2c | v3}}

Syntax Description

-hex

(Optional) Displays the groupname and username as a hexadecimal format.

groupname

Name of the SNMP group that defines an access control.

user

Specifies the SNMP group username.

username

Name of the SNMP user.

security model v1 | v2c | v3

Specifies security model v1, v2c, or v3.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for the groupname value or the username value (nonprintable delimiters for these parameters), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

Examples

This example shows how to remove an SNMP user from a group:

Console> (enable) clear snmp group cisco-group user joe security-model v3
Cleared snmp group cisco-group user joe version v3.
Console> (enable)

Related Commands

set snmp group
show snmp group

clear snmp ifalias

To clear an SNMP interface alias, use the clear snmp ifalias command.

clear snmp ifalias {ifindex | all}

Syntax Description

ifindex

Interface index number.

all

Clears all interface aliases.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear SNMP interface index 1:

Console> (enable) clear snmp ifalias 1
Console> (enable)

This example shows how to clear all SNMP interface aliases:

Console> (enable) clear snmp ifalias all
Console> (enable)

Related Commands

set snmp ifalias
show snmp ifalias

clear snmp notify

To clear the SNMP notifyname in the snmpNotifyTable, use the clear snmp notify command.

clear snmp notify [-hex] {notifyname}

Syntax Description

-hex

(Optional) Displays the notifyname value as a hexadecimal format.

notifyname

Identifier to index the snmpNotifyTable.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for the notifyname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

Examples

This example shows how to clear an SNMP notifyname from the snmpNotifyTable:

Console> (enable) clear snmp notify joe
Cleared SNMP notify table joe.
Console> (enable) 

Related Commands

set snmp notify
show snmp notify

clear snmp targetaddr

To clear the SNMP target address entry in the TargetAddressTable, use the clear snmp targetaddr command.

clear snmp targetaddr [-hex] {addrname}

Syntax Description

-hex

(Optional) Displays the addrname value as a hexadecimal format.

addrname

Name of the target agent; the maximum length is 32 bytes.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for the addrname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

Examples

This example shows how to clear an SNMP target address entry in the snmpTargetAddressTable:

Console> (enable) clear snmp targetaddr joe
Cleared SNMP targetaddr joe.
Console> (enable)

Related Commands

set snmp targetaddr
show snmp targetaddr

clear snmp targetparams

To clear the SNMP target parameters used in the snmpTargetParamsTable, use the clear snmp targetparams command.

clear snmp targetparams [-hex] {paramsname}

Syntax Description

-hex

(Optional) Displays the paramsname value as a hexadecimal format.

paramsname

Name of the target parameter in the snmpTargetParamsTable; the maximum length is 32 bytes.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for the paramsname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

Examples

This example shows how to remove the SNMP target parameters:

Console> (enable) clear snmp targetparams joe
Cleared SNMP targetparams table joe.
Console> (enable) 

Related Commands

set snmp targetparams
show snmp targetparams

clear snmp trap

To clear an entry from the SNMP trap receiver table, use the clear snmp trap command.

clear snmp trap {rcvr_addr} [all]

Syntax Description

rcvr_addr

IP address or IP alias of the trap receiver (the SNMP management station) to clear.

all

(Optional) Specifies every entry in the SNMP trap receiver table.


Defaults

The default configuration has no entries in the SNMP trap receiver table.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear an entry from the SNMP trap receiver table:

Console> (enable) clear snmp trap 192.122.173.82
SNMP trap receiver deleted.
Console> (enable)

Related Commands

set snmp trap
show port counters
test snmp trap

clear snmp user

To remove an SNMP user, use the clear snmp user command.

clear snmp user [-hex] {username} [remote engineid]

Syntax Description

-hex

(Optional) Displays the username value as a hexadecimal format.

username

Name of the user on the host that connects to the agent.

remote engineid

(Optional) Specifies the username value on a remote SNMP engine.


Defaults

If a remote engine ID is not provided, the default local SNMP engine ID is used.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for the username value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

Examples

This example shows how to remove a user from an SNMP group:

Console> (enable) clear snmp user joe
Cleared SNMP user joe.
Console> (enable) 

This example shows how to remove a user on a remote SNMP engine:

Console> (enable) clear snmp user joe remote 00:00:00:09:00:d0:00:4c:18:00
Cleared SNMP user.
Console> (enable) 

Related Commands

set snmp user
show snmp user

clear snmp view

To remove the MIB view entry from the vacmViewTreeFamilyTable, use the clear snmp view command.

clear snmp view [-hex] {viewname subtree}

Syntax Description

-hex

(Optional) Displays the viewname value as a hexadecimal format.

viewname

Name of a MIB view.

subtree

Name of the subtree.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you use special characters for the viewname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.

A MIB subtree used with a mask defines a view subtree that can be in OID format or a text name mapped to a valid OID.

Examples

This example shows how to clear the SNMP MIB viewname:

Console> (enable) clear snmp view myview 1.1.3
Cleared snmp view myview with subtree 1.1.3
Console> (enable)

Related Commands

set snmp view
show snmp view

clear spantree detected-protocols

To detect legacy bridges and the boundary ports of the MST region, use the clear spantree detected-protocols command.

clear spantree detected-protocols mod/port

Syntax Description

mod/port

Number of the module and the port on the module. See "Usage Guidelines" for more information.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The clear spantree detected-protocols command is available in MST mode and Rapid-PVST+ mode only and is not saved in NVRAM. If you do not specify a mod/port number when you enter the clear spantree detected-protocols command, protocol detection occurs on all connected ports.

The clear spantree detected-protocols command and the set spantree mst redetect-protocol command have the same functionality.

Examples

This example shows how to set protocol detection of legacy bridges and boundary ports on port 2 or module 3:

Console> (enable) clear spantree detected-protocols 3/2
Spanning tree protocol detection forced on port 3/2
Console> (enable)

Related Commands

clear spantree mst
set spantree mode
set spantree mst config

clear spantree mst

To clear the mapping of VLANs to an MST instance, use the clear spantree mst command.

clear spantree mst instance [vlan vlans]

Syntax Description

instance

Number of the instance or range of instances; valid values are from 0 to 15. See the "Usage Guidelines" section for more information.

vlan vlans

(Optional) Specifies the VLAN number; valid values are from 1 to 1005 and from 1025 to 4094.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you enter only one instance number, you also can enter a VLAN number. If you enter a range of instance numbers, you cannot enter a VLAN number.

If you do not specify a VLAN, all VLANs are unmapped from the specified instance and added to MST instance 0 (IST).

Examples

This example shows you how to clear VLAN 2 from MST instance 2:

Console> (enable) clear spantree mst 2 vlan 2
Console> (enable)

Related Commands

show spantree mst

clear spantree portcost

To clear the port cost of a port on the switch, use the clear spantree portcost command.

clear spantree portcost mod/port [mst]

Syntax Description

mod/port

Number of the module and the port on the module.

mst

(Optional) Restores the default path cost to an MST instance on a port.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to restore the default path cost on a port:

Console> (enable) clear spantree portcost 3/1
Port 3/1 is using the cost 0.
Console> (enable)

This example shows how to restore the default path cost to all MST instances on a port:

Console> (enable) clear spantree portcost 8/1 mst
Port 8/1 MST is using the cost 20000 in MST mode.
Console> (enable)

Related Commands

set spantree portcost
show spantree statistics

clear spantree portinstancecost

To restore the default path cost to an instance on a port, use the clear spantree portinstancecost command.

clear spantree portinstancecost mod/port [mst] instances

Syntax Description

mod/port

Number of the module and the port on the module.

mst

(Optional) Restores the default path cost to an MST instance on a port.

instances

Number of the instance; valid values are from 0 to 15.


Defaults

The default path cost is based on port speed; see Table 2-7 for default settings.

Table 2-7 Default Port Cost—Short Mode

Port Speed
Default Port Cost

4 Mb

250

10 Mb

100

16 Mb

62

100 Mb

19

155 Mb

14

1 Gb

4

10 Gb

2


Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is valid in MISTP and MST modes only.

Examples

This example shows how to restore the default path cost to an instance on a port:

Console> (enable) clear spantree portinstancecost 5/1 2
Port 5/1 mistp-instance 1-16 have path cost 200000.
Console> (enable)

This example shows how to restore the default path cost to all MST instances on a port:

Console> (enable) clear spantree portinstancecost 8/1 mst 0-15
Port 8/1 MST Instance 0-15 have path cost 20000.
Console> (enable)

Related Commands

set spantree portinstancecost
show spantree statistics

clear spantree portinstancepri

To restore the default path cost to an instance on a port, use the clear spantree portinstancepri command.

clear spantree portinstancepri mod/port [mst] [instances]

Syntax Description

mod/port

Number of the module and the port on the module.

mst

(Optional) Resets the spanning tree port MST instance priority.

instances

(Optional) Number of the instance; valid values are from 0 to 15.


Defaults

The default is the port priority is set to 0 with no instances specified.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is valid in MISTP and MST modes only.

Examples

This example shows how to reset the spanning tree port instance priority:

Console> (enable) clear spantree portinstancepri 5/1 2
Port 5/1 instances 1-16 using portpri 32.
Console> (enable)

This example shows how to reset the spanning tree port priority for all MST instances:

Console> (enable) clear spantree portinstancepri 8/1 mst 0-15
Port 8/1 MST Instances 0-15 using portpri 32
Console> (enable)

Related Commands

set spantree portinstancepri
show spantree

clear spantree portpri

To clear the port priority of a port on the switch, use the clear spantree portpri command.

clear spantree portpri mod/port [mst]

Syntax Description

mod/port

Number of the module and the port on the module.

mst

(Optional) Resets the MST port priority.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the spanning tree port priority:

Console> (enable) clear spantree portpri 3/1
Port 3/1 is using the cost 32.
Console> (enable)

This example shows how to clear the MST port priority:

Console> (enable) clear spantree portpri 8/1 mst
Port 8/1 is using the priority 32 in MST mode.
Console> (enable)

Related Commands

set spantree portpri
show spantree

clear spantree portvlancost

To restore the default path cost to a VLAN on a port, use the clear spantree portvlancost command.

clear spantree portvlancost mod/port [vlans]

Syntax Description

mod/port

Number of the module and the port on the module.

vlans

(Optional) Number of the VLAN; valid values are from 1 to 1000 and from 1025 to 4094.


Defaults

The default path cost is based on port speed; see Table 2-8 and Table 2-9 for default settings.

Table 2-8 Default Port Cost—Short Mode

Port Speed
Default Port Cost

4 Mb

250

10 Mb

100

16 Mb

62

100 Mb

19

155 Mb

14

1 Gb

4

10 Gb

2


Table 2-9 Default Port Cost—Long Mode

Port Speed
Default Port Cost

100 Kb

200,000,000

1 Mb

20,000,000

10 Mb

2,000,000

100 Mb

200,000

1 Gb

20,000

10 Gb

2,000

100 Gb

200

1 Tb

20

10 Tb

2


Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is valid in PVST+ mode only.

If you do not specify a VLAN, all VLANs are cleared.

Examples

These examples show how to restore the default path cost to a VLAN on a port:

Console> (enable) clear spantree portvlancost 2/10 1-10
Port 2/10 VLANs 11-21 have path cost 6
Port 2/10 VLANs 1-10,22-1000 have path cost 10.
Console> (enable)

Console> (enable) clear spantree portvlancost 2/10
Port 2/10 VLANs 1-1000 have path cost 10.
Console> (enable)

Related Commands

set spantree portvlancost
show spantree statistics

clear spantree portvlanpri

To reset the spanning tree port VLAN priority, use the clear spantree portvlanpri command.

clear spantree portvlanpri mod/port [vlans]

Syntax Description

mod/port

Number of the module and the port on the module.

vlans

(Optional) Number of the VLAN; valid values are from 1 to 1000 and from 1025 to 4094.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to reset the spanning tree port VLAN priority:

Console> (enable) clear spantree portvlanpri 1/2 23-40
Port 1/2 vlans 3,6-20,23-1000 using portpri 32
Port 1/2 vlans 1-2,4-5,21-22 using portpri 30
Console> (enable)

Related Commands

set spantree portvlanpri
show spantree

clear spantree root

To restore the spanning tree bridge priority, hello time, maxage, and forward delay on the switch to their default values, use the clear spantree root command.

clear spantree root [vlans]

clear spantree root mistp-instance instances

clear spantree root mst instances

Syntax Description

vlans

(Optional) Number of the VLAN; valid values are from 1 to 1000 and from 1025 to 4094.

mistp-instance instances

Specifies the instance number; valid values are from 1 to 16.

mst instances

Specifies the MST instance number; valid values are 0 to 15.


Defaults

The defaults are as follows:

switch priority is 32768

forward delay is 15 seconds

hello time is 2 seconds

maxage is 20 seconds

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the spanning tree root on a range of VLANs:

Console> (enable) clear spantree root 1-20 
VLANs 1-20 bridge priority set to 32678.
VLANs 1-20 bridge hello time set to 2 seconds.
VLANs 1-20 bridge max aging time set to 20 seconds.
VLANs 1-20 bridge forward delay set to 15 seconds.

This example shows how to clear the spanning tree root on two specific VLANs:

Console> (enable) clear spantree root 22,24
VLANs 22,24 bridge priority set to 32678.
VLANs 22,24 bridge hello time set to 2 seconds.
VLANs 22,24 bridge max aging time set to 20 seconds.
VLANs 22,24 bridge forward delay set to 15 seconds.
Console> (enable)

This example shows how to clear the spanning tree root on an instance:

Console> (enable) clear spantree root mistp-instance 1
Instance 1 bridge priority set to 32768.
Instance 1 bridge max aging time set to 20.
Instance 1 bridge hello time set to 2.
Instance 1 bridge forward delay set to 15.
Console> (enable)

This example shows how to clear the spanning tree root on an MST instance:

Console> (enable) clear spantree root mst 0 
MST Instance s 0 bridge priority set to 32768. 
Instances 0 bridge max aging time set to 20. 
Instances 0 bridge hello time set to 2. 
Instances 0 bridge forward delay set to 15. 
Console> (enable)

Related Commands

set spantree root
show spantree

clear spantree statistics

To clear the spanning tree statistics, use the clear spantree statistics command.

clear spantree statistics mod/port

clear spantree statistics vlans

clear spantree statistics mistp-instance instances

clear spantree statistics mst instances

Syntax Description

mod/port

Number of the module and the port on the module.

vlans

(Optional) Number of the VLAN; valid values are from 1 to 1000 and from 1025 to 4094.

mistp-instance instances

Specifies the instance number; valid values are from 1 to 16.

mst instances

Specifies the MST instance number; valid values are from 0 to 15.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the spanning tree statistics for VLAN 1:

Console> (enable) clear spantree statistics 1
Cleared all VLAN counters for VLAN 1
Statistics cleared for vlans 1
Console> (enable)

This example shows how to clear the spanning tree statistics for a port:

Console> (enable) clear spantree statistics 3/1
Statistics cleared for module 3/1
Console> (enable)

This example shows how to clear the spanning tree statistics for an instance:

Console> (enable) clear spantree statistics mistp-instance 2
Statistics cleared for instances 2
Console> (enable)

This example shows how to clear the spanning tree statistics for an MST instance:

Console> (enable) clear spantree statistics mst 0
Statistics cleared for MST instance: 0
Console> (enable)

Related Commands

show spantree statistics

clear spantree uplinkfast

To turn off the UplinkFast feature and to return the switch priority and port costs to the default settings, use the clear spantree uplinkfast command.

clear spantree uplinkfast

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

In some cases, this command could cause load balancing on the switch to be lost.

Examples

This example shows how to turn off the UplinkFast feature and to return the switch priority to the default settings:

Console> (enable) clear spantree uplinkfast
This command will cause all portcosts, portvlancosts, and the 
bridge priority on all vlans to be set to default.
Do you want to continue (y/n) [n]? y
VLANs 1-1005 bridge priority set to 32768.
The port cost of all bridge ports set to default value.
The portvlancost of all bridge ports set to default value.
uplinkfast disabled for bridge.
Console> (enable)

Related Commands

set spantree uplinkfast
show spantree uplinkfast

clear tacacs key

To remove the key setting used for TACACS+ authentication and encryption, use the clear tacacs key command.

clear tacacs key

Syntax Description

This command has no arguments or keywords.

Defaults

The default key value is null.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the key setting used for authentication and encryption:

Console> (enable) clear tacacs key
TACACS server key cleared.
Console> (enable) 

Related Commands

set tacacs key
show tacacs

clear tacacs server

To remove a host from the list of TACACS+ servers, use the clear tacacs server command.

clear tacacs server ip_addr

Syntax Description

ip_addr

IP address of the server to be removed from the list of TACACS+ servers.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to remove a server from the list of TACACS+ servers:

Console> (enable) clear tacacs server 170.1.2.20
170.1.2.20 cleared from TACACS table
Console> (enable)

Related Commands

show tacacs

clear timezone

To return the time zone to its default, UTC, use the clear timezone command.

clear timezone

Syntax Description

This command has no arguments or keywords.

Defaults

The default time zone is UTC.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The clear timezone command functions only when NTP is running. If you set the time manually and NTP is disengaged, the clear timezone command has no effect.

Examples

This example shows how to clear the time zone:

Console> (enable) clear timezone
Timezone name and offset cleared.
Console> (enable)

Related Commands

set timezone

clear top

To stop the TopN process, use the clear top command.

clear top {all | report_num}

Syntax Description

all

Stops all nonpending TopN results.

report_num

TopN report number to kill; valid values are from 1 to 5.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The clear top all command will not kill any pending TopN reports. Only the reports with a done status are killed.

You can terminate TopN processes without the background option (use the show top background command to find out if the background option is used) by pressing Ctrl-C in the same Telnet/console session, or by entering the clear top [report_num] command from a separate Telnet/console session. The prompt is not printed before the TopN report is completely displayed. Other commands will be blocked until the report has been displayed.

Examples

This example shows how to stop the TopN 1 process from a console session:

Console> (enable) clear top 1
10/29/1998,12:05:38:MGMT-5: TopN report 1 killed by Console//.
Console> (enable)

This example shows how to stop the TopN 4 process from a Telnet session:

Console> (enable) clear top 4 
10/29/1998,12:06:00:MGMT-5: TopN report 4 killed by telnet/172.22.34.2/.
Console> (enable)

Related Commands

show top
show top report

clear trunk

To restore a trunk port to its default trunk type and mode or to clear specific VLANs from the allowed VLAN list for a trunk port, use the clear trunk command.

clear trunk mod/port [vlans]

Syntax Description

mod/port

Number of the module and the port on the module.

vlans

(Optional) Number of the VLAN to remove from the allowed VLAN list; valid values are from 2 to 1005 and 1025 to 4094.


Defaults

For all ports except Multilayer Switch Module (MSM) ports, the default is auto negotiate. For MSM ports, the default is off negotiate mode.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you specify VLANs, those VLANs are removed from the list of VLANs allowed on the trunk. Default VLANs cannot be cleared on the trunk.

Traffic for the removed VLANs are not forwarded over a trunk port. To add VLANs that you have removed, use the set trunk mod/port vlans command.

If you are trying to clear extended-range VLANs and sufficient space in NVRAM is not available, a warning message displays and the command fails.

Examples

This example shows how to clear VLANs 200 through 500 from the  trunk port on port 2 of module 1:

Console> (enable) clear trunk 1/2 200-500
Removing Vlan(s) 200-500 from allowed list.
Port 1/2 allowed vlans modified to 1-199,501-1000.
Console> (enable)

This example shows the output if you attempt to clear a trunk when not enough NVRAM space is available:

Console> (enable) clear trunk 2/18 1030-1999
Failed to clear extended range vlans from allowed list.
Not enough NVRAM space. Use the `set trunk' command to restore 
       some existing entries to the default value.
Console> (enable) 

Related Commands

set trunk
show trunk

clear vlan

To delete an existing VLAN from a management domain or to clear VLANs that are secured by a Firewall Services Module, use the clear vlan command.

clear vlan vlans

clear vlan {vlans} firewall-vlan {mod}

Syntax Description

vlans

Number of the VLAN; valid values are from 2 to 1000 and from 1025 to 4094.

firewall-vlan

Clears VLANs that are secured by a Firewall Services Module.

mod

Number of the module.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Follow these guidelines for deleting VLANs:

When you delete a normal-range Ethernet VLAN in VTP server mode, the VLAN is removed from all switches in the same VTP domain.

When you delete a normal-range VLAN in VTP transparent mode, the VLAN is deleted only on the current switch.

You can delete an extended-range VLAN only on the switch where it was created.

When you clear a VLAN, all ports assigned to that VLAN become inactive. However, the VLAN port assignments are retained until you move the ports to another VLAN. If the cleared VLAN is reactivated, all ports that are still configured on that VLAN are also reactivated. A warning is displayed if you clear a VLAN that exists in the mapping table.

When you clear a private VLAN (primary, isolated, or community), the ports are set to inactive and are not assigned to any VLAN. The private VLAN mappings for the selected VLAN are also cleared. ACL to VLAN mappings are also deleted.

Examples

This example shows how to clear existing VLAN 4000 from a management domain:

Console> (enable) clear vlan 4000 
This command will de-activate all ports on vlan 4 
in the entire management domain 
Do you want to continue(y/n) [n]? y 
VLAN 4 deleted
Console> (enable) 

Related Commands

set vlan
show vlan

clear vlan counters

To return the software-cached counters to 0 for all VLANs, use the clear vlan counters command.

clear vlan counters {vlans | all}

Syntax Description

vlans

Number of the VLAN or range of VLANs; valid values are from 1 to 1005 and from 1025 to 4094

all

Clears counters for all VLANs.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear counters for VLAN 1005:

Console> (enable) clear vlan counters 1005
This command will reset vlan couters for vlan 1005
Do you want to continue (y/n) [n]?y
Console> (enable)

Related Commands

show vlan counters

clear vlan mapping

To delete existing IEEE 802.1Q VLAN-to-ISL VLAN mappings or reserved-to-nonreserved VLAN mapping, use the clear vlan mapping command.

clear vlan mapping dot1q {dot1q_vlan | all}

clear vlan mapping reserved {reserved_vlan | all}

Syntax Description

dot1q dot1q_vlan

Clears the IEEE 802.1Q VLAN-to-ISL VLAN mapping.

dot1q all

Clears all IEEE 802.1Q VLAN-to-ISL VLAN mappings.

reserved reserved_vlan

Clears the specified reserved-to-nonreserved VLAN mapping.

reserved all

Clears all reserved-to-nonreserved VLAN mappings.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

When you clear a VLAN, all ports assigned to that VLAN become inactive. However, the VLAN port assignments are retained until you move the ports to another VLAN. If the cleared VLAN is reactivated, all ports that are still configured on that VLAN are also reactivated.

Examples

This example shows how to clear an existing mapped VLAN from the dot1q mapping table:

Console> (enable) clear vlan mapping dot1q 444
Vlan Mapping 444 Deleted.
Console> (enable) 

This example shows how to clear all mapped VLANs from the mapping table:

Console> (enable) clear vlan mapping dot1q all
All Vlan Mapping Deleted.
Console> (enable) 

This example shows how to clear mapped reserved VLANs from the mapping table:

Console> (enable) clear vlan mapping reserved 1007
Vlan Mapping 1007 Deleted.
Console> (enable) 

Related Commands

set vlan
show vlan

clear vmps rcp

To delete the VMPS rcp username from the VMPS server table, use the clear vmps rcp command.

clear vmps rcp username

Syntax Description

username

Username up to 14 characters long.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you do not enter a username, all rcp usernames are deleted.

Examples

This example shows how to clear a specific VMPS rcp username from the VMPS table:

Console> (enable) clear vmps rcp jdoe
Console> (enable)

Related Commands

set rcp username

clear vmps server

To delete a VMPS server from the VMPS server table, use the clear vmps server command.

clear vmps server ip_addr

Syntax Description

ip_addr

IP address or host name of the VMPS server to be deleted.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear a VMPS server from the VMPS table:

Console> (enable) clear vmps server 192.168.255.255
VMPS domain server 192.168.255.255 cleared from VMPS table.
Console> (enable)

This example shows the results of trying to clear a nonexistent VMPS server from the VMPS table:

Console> (enable) clear vmps server 192.168.255.255
VMPS domain server 192.168.255.255 not in VMPS table.
Console> (enable)

Related Commands

reconfirm vmps
set vmps server

clear vmps statistics

To delete existing VMPS statistics, use the clear vmps statistics command.

clear vmps statistics

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to delete existing VMPS statistics:

Console> (enable) clear vmps statistics
VMPS and dynamic vlan statistics cleared.
Console> (enable)

Related Commands

show vmps statistics

clear vtp pruneeligible

To specify which VLANs in the VTP domain are ineligible for pruning, use the clear vtp pruneeligible command.

clear vtp pruneeligible vlans...

Syntax Description

vlans...

Number of VLANs to make pruning ineligible; valid values are from 1 to 1005.


Defaults

The default is VLANs 2 through 1005 are eligible for pruning.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

VTP pruning causes information about each pruning-eligible VLAN to be removed from VTP updates if no stations belong to that VLAN out a particular switch port. Use the set vtp command to enable VTP pruning.

By default, VLANs 2 through 1000 are pruning eligible. Use the clear vtp pruneeligible command to make VLANs pruning ineligible.

If VLANs are pruning ineligible, use the set vtp pruneeligible command to make the VLANs pruning eligible again.

Examples

This example shows how to make VLANs 200 through 500 pruning ineligible:

Console> (enable) clear vtp pruneeligible 200-500
Vlans 1,200-500,1001-1005 will not be pruned on this device.
VTP domain Company modified.
Console> (enable)

Related Commands

set vtp
set vtp pruneeligible
show vtp domain