clear mis through copy

clear ip route
clear log
clear logging buffer
clear logging server
clear mls
clear mls multicast
clear mpoa client cache
clear multicast router
clear ntp key
clear ntp server
clear port broadcast
clear port filter
clear port qos cos
clear qos config
clear qos ip-filter
clear qos mac-cos
clear qos map
clear qos router-mac
clear radius
clear snmp trap
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 mapping
clear vmps server
clear vmps statistics
clear vtp pruneeligible
clear vtp statistics
client-atm-address name
configure
confreg

all	Keyword to delete all IP routing table entries.
destination	IP address of the host or network. An IP alias or a host name that can be resolved through DNS can also be used.
gateway	IP address or alias of the gateway router.

mod_num	(Optional) Module number.

ip_addr	IP address of the syslog server to be deleted.

clear mls

Use the clear mls command set to clear the IP or IPX MLS feature in the Catalyst 5000 and 2926G series switches.

clear mls include [ip | ipx] all
clear mls include [ip | ipx] {ip_addr... }
clear mls nde flow
clear mls statistics
clear mls statistics protocol protocol port | all
clear mls entry [ip] [destination ip_addr_spec] [source ip_addr_spec]
[flow protocol src_port dst_port]
clear mls entry [ipx] [destination ipx_addr_spec] [source ipx_addr_spec]

Syntax Description


include	Keyword to remove the inclusion of the specified routers.
ip	(Optional) Keyword to specify IP MLS.
ipx	(Optional) Keyword to specify IPX MLS.
ip_addr...	Route-processor IP address or name of the route processor if DNS is enabled.
all	Keyword to remove all routers from participation in the flow.
nde flow	Keywords to reset the filter to the defaults.
statistics	Keyword to clear these statistics: total packets switched and total packets exported (for NDE).
statistics protocol	Keywords to clear protocols for statistics collection.
protocol	Number of the protocol in the protocol statistics list.
port	Number of the port.
all	Keyword to remove all protocols from statistics collection.
entry	Keyword to purge the specified MLS entry or all entries if all is specified. All matching MLS entries are purged.
destination	(Optional) Keyword to specify the destination IP address.
ip_addr_spec	(Optional) Full IP address or a subnet address in these formats: ip_addr or ip_addr/netmask or ip_addr/maskbit.
source	(Optional) Keyword to specify the source IP address.
flow	(Optional) Keyword to specify additional flow information (protocol family and protocol port pair) to be matched.
protocol	(Optional) Keyword to specify flow information.
protocol	Flow information; valid values include tcp, udp, icmp, or a decimal number for other protocol families.
src_port	(Optional) Source port IP address.
dst_port	(Optional) Destination port IP address.
ipx_addr_spec	(Optional) Full IP address or a subnet address in these formats: src_net/[mask] or dest_net.dest_node or dest_net/mask.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

This command is not supported by the Catalyst 4000 and 2948G series switches.

When specifying the ip | ipx keyword, if you specify ip or do not enter a keyword, this means that the command is for IP MLS. If you specify ipx, this means the command is for IPX only.

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)

If you enter any of the clear mls commands on a Catalyst 5000 or 2926G series switch without MLS, this warning message is displayed:

Feature not supported in hardware.

When you remove an RSM from the Catalyst 5000 or 2926G series switch, it is removed immediately from the inclusion list and all the MLS entries for the RSM are removed.

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 5000 and 2926G series switches.
The Catalyst 5000 and 2926G 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.

If you do not use the all argument in the clear mls entry command, you must specify at least one of the other three keywords (source, destination, or flow) and its arguments.

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

Examples

This example shows how to disable IP MLS for the Stargate router (IP address 172.20.15.1):

Console> (enable) clear mls include Stargate
Multilayer switching is disabled for router 172.20.15.1 (Stargate)
Console>(enable)

This example shows how to clear the NDE filter and export all flows:

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

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 statistics collection:

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

This example shows how to clear the MLS entries with destination IP address 172.20.26.22:

Console>(enable) clear mls entry destination 172.20.26.22 
Multilayer switching entry cleared.
Console>(enable)

This example shows how to clear specific IP MLS entries for destination IP address 172.20.26.22:

Console>(enable) clear mls entry destination 172.20.26.22 source 172.20.22.113 flow tcp 520 320
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 entry ipx destination 1.00e0.fefc.6000 source 3.0034.1245.AB45 
IPX Multilayer switching entry cleared
Console>(enable)

Related Commands

set mls nde
show mls
show mls statistics

clear mls multicast

Use the clear mls multicast command set to remove a router from the list of routers participating in IP multicast MLS.

clear mls multicast include {ip_addr | all}
clear mls multicast statistics rp

Syntax Description


include	Keyword to remove the inclusion of the specified routers.
ip_addr	Route-processor IP address or name of the route processor if DNS is enabled.
all	Keyword to remove all routers from participation in the flow.
statistics rp	Keyword to clear MLS statistics from the route processors.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

This command is not supported by the Catalyst 4000 and 2948G series switches.

If you enter any of the clear mls multicast commands on a Catalyst 5000 or 2926G series switch without MLS, this warning message is displayed:

MLS Multicast is not supported on feature card.

When you remove an RSM from the Catalyst 5000 or 2926G series switch, it is not removed immediately from the inclusion list. you must specifically clear the router from the inclusion list.

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 5000 and 2926G series switches.
The Catalyst 5000 and 2926G series switches must know the router's MAC-VLAN pairs.

Examples

This example shows how to remove all routers from the include list:

Console> (enable) clear mls multicast include all
All MLS routers are deleted from the include list.
Console>(enable)

This example shows how to remove a specific router from the include list using its IP address:

Console> (enable) clear mls multicast include 1.2.3.4 
MLS Router 1.2.3.4 is deleted from the include list.
Console>(enable)

This example shows how to clear MLS statistics:

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

Related Commands

set mls multicast
show mls multicast

clear mpoa client cache

Use the clear mpoa client cache command to clear the ingress and egress cache entries of one or all MPCs.

clear mpoa client [name mpc-name] cache [ingress | egress] [ip-address ip-address]

Syntax Description


name mpc-name	(Optional) Keyword that specifies the name of the MPC with the specified name.
ingress	(Optional) Keyword that clears ingress cache entries associated with the MPC.
egress	(Optional) Keyword that clears egress cache entries associated with the MPC.
ip-address ip-address	(Optional) Keyword that clears matching cache entries with the specified IP address.

Defaults

The system defaults are:

All MPC cache entries are cleared.
Both caches are cleared.
Entries matching only the specified destination IP address are cleared.

Command Type

Cisco IOS ATM command.

Command Mode

EXEC.

Usage Guideline

This command is not supported by the Catalyst 4000 and 2948G series switches.

Example

This example shows how to clear the ingress and egress cache entries for the MPC named ip_mpc:

ATM#clear mpoa client name ip_mpc cache
ATM#

Related Command

show mpoa client cache

clear multicast router

Use the clear multicast router command to clear manually configured multicast router ports from the multicast router port list.

clear multicast router all
clear multicast router {mod/ports...}

Syntax Description


all	Keyword that specifies all multicast router ports to be cleared.
mod/ports...	Number of the module and the ports on the module.

Default

The default configuration has no multicast router ports configured.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The Catalyst 2948G is a fixed configuration switch. All ports are located on "module 2;" for this reason, if you enter 1/N for the module/port number, an error message is displayed.

Example

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 key

Use the clear ntp key command to remove all or a specific authentication key.

clear ntp key public_keynum
clear ntp key all

Syntax Description


public_keynum	Number of the key pair; valid values are 1 to 4292945295.
all	(Optional) Keyword to remove all authentication keys.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to define an NTP authentication key:

Console> (enable) clear ntp key 435
NTP key 435 cleared.
Console> (enable)

Related Command

set ntp key

clear ntp server

Use the clear ntp server command to remove one or more servers from the NTP server table.

clear ntp server {ip_addr | all}

Syntax Description


ip_addr	IP address of the server to remove from the server table.
all	Keyword that specifies all server addresses in the server table to be removed.

Default

The default configuration has no NTP servers configured.

Command Type

Switch command.

Command Mode

Privileged.

Examples

These examples show how to use the clear ntp server command to remove NTP servers from the server table:

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

Related Commands

set ntp server
show ntp

clear port broadcast

Use the clear port broadcast command to disable broadcast/multicast suppression on one or more ports.

clear port broadcast mod/ports...

Syntax Description


mod/ports...	Number of the module and the ports.

Default

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

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

This command is not supported by the Catalyst 4000 and 2948G series switches.

Example

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

clear port filter

Use the clear port filter command to clear MAC address or protocol filters, filters configured on a specific port, or to clear all configured filters.

clear port filter [mod_num/port_num] [mac_addr | protocol_type | all]

Syntax Description


mod_num/ port_num	(Optional) Number of the module and the ports on the module.
mac_addr	(Optional) MAC address on which the filter that you want to clear is based. This address can be entered in canonical format (00-11-33-44-55) or in noncanonical format (00:11:22:33:44:55).
protocol_type	(Optional) Protocol type on which the filter that you want to clear is based.
all	(Optional) Keyword to specify for all filters to be cleared.

Default

The command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The Catalyst 2948G is a fixed configuration switch. All ports are located on "module 2;" for this reason, if you enter 1/N for the module/port number, an error message is displayed.

Example

This example shows how to clear a MAC address filter (00:40:0b:01:bc:65) configured on port 2 of module 3:

Console> (enable) clear port filter 3/2 00:40:0b:01:bc:65
Port 3/2 filter Mac Address 00:40:0b:01:bc:65 cleared.
Console> (enable)

Related Commands

set port filter
show port filter

clear port qos cos

Use the clear port qos cos command to return the values set by the set port qos cos command to the factory-set default values for all specified ports.

clear port qos mod/ports.. cos

Syntax Description


mod/ports..	Number of the module and ports.

Default

The default CoS for a port is 0.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to return the values set by the set port qos cos command to the factory-set default values 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 qos config

Use the clear qos config command to return the values set by the set qos command to the factory-set default values and delete the CoS assigned to MAC addresses.

clear qos config

Syntax Description

This command has no arguments or keywords.

Default

Refer to Table 2-1 for the QoS default settings:

Table 2-1: QoS Default Settings
Parameter Default

QoS enabled

WRR

100:255

Transmit queue size

80:20

CoS to threshold map

threshold 1 - 0 and 1
threshold 2 - 2 and 3
threshold 3 - 4 and 5
threshold 4 - 6 and 7

Default port CoS

Zero

Transmit drop threshold

100% for all thresholds

QoS disabled

Transmit drop threshold

100% for all thresholds

WRR

255:1

Transmit queue size

100:0

CoS to threshold map

threshold 1 - 0, 1, 2, 3, 4, 5, 6, 7

**Table 2-1: QoS Default Settings**
Parameter	Default
QoS enabled
WRR	100:255
Transmit queue size	80:20
CoS to threshold map	threshold 1 - 0 and 1 threshold 2 - 2 and 3 threshold 3 - 4 and 5 threshold 4 - 6 and 7
Default port CoS	Zero
Transmit drop threshold	100% for all thresholds
QoS disabled
Transmit drop threshold	100% for all thresholds
WRR	255:1
Transmit queue size	100:0
CoS to threshold map	threshold 1 - 0, 1, 2, 3, 4, 5, 6, 7

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to return the values set by the set qos command to the factory-set default values 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 ip-filter

Use the clear qos ip-filter command to delete an entry from the ACE list or all the entries.

clear qos ip-filter ACE#
clear qos ip-filter all

Syntax Description


ACE#	Number of the current position in the ACE list.
all	Keyword to specify all the entries in the ACE list.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If the ACE# is not specified, all entries are deleted.

Examples

This example shows how to remove a specific entry from the ACE list:

Console> (enable) clear qos ip-filter 3
qos ip-filter 3 is cleared.
Console>(enable)

This example shows how to remove all entries from the ACE list:

Console>(enable) clear qos ip all
qos ip-filter are all cleared.
Console>(enable)

Related Commands

set qos ip-filter
show qos ip

clear qos mac-cos

Use the clear qos mac-cos command to clear the values set by the set 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.
all	Keyword to clear CoS values for all MAC/VLAN pairs.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If the vlan number 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 factory-set default values 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 factory-set default values 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

Use the clear qos map command to return the values set by the set qos map command to the factory-set default values.

clear qos map port_type

Syntax Description


port_type	Port type value; the only valid value is 1q4t.

Default

The default mappings for all ports are shown in Table 2-1.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to return the values set by the set qos map command to the factory-set default values:

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

Related Commands

set qos map
show qos info

clear qos router-mac

Use the clear qos router-mac command to remove a router from the QoS configuration.

clear qos router-mac mac_address vlan
clear qos router-mac all

Syntax Description


mac_addr	(Optional) MAC address on which the filter that you want to clear is based. This address can be entered in canonical format (00-11-33-44-55) or in noncanonical format (00:11:22:33:44:55).
vlans	List of the VLAN numbers to clear; valid values are 1 to 1005.
all	Keyword to all routers from the QoS configuration.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to clear a specific router from the QoS configuration:

Console> (enable) clear qos router-mac 00-40-0b-30-03-48 2
QoS Router MAC/Vlan(s) cleared.
Console> (enable)

Related Commands

set qos router-mac
show qos info

c lear radius

Use the clear radius command set to clear all or one of the RADIUS servers from the RADIUS server table.

clear radius server all
clear radius server ipaddr
clear radius key

Syntax Description


server	Keyword to specify RADIUS servers.
all	Keyword to specify all RADIUS servers.
ipaddr	Number of the IP address or IP alias.
key	Keyword to specify the RADIUS shared key.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

ipraddr is an IP alias or and 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

show radius
set radius key
set radius server

clear snmp trap

Use the clear snmp trap command to clear an entry from the SNMP trap receiver table.

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	Keyword that specifies every entry in the SNMP trap receiver table.

Default

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

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

rcvr_addr is an IP alias or and IP address in dot notation, for example, 101.102.103.104.

Example

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

Use the clear spantree portvlancost command to restore the default path cost to a VLAN on a port.

clear spantree portvlancost mod_num/port_num preferred_vlans

Syntax Description


mod_num	Number of the module.
port_num	Number of the port.
preferred_vlans	List of VLANs to clear; valid values are 1 to 1005.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The Catalyst 2948G is a fixed configuration switch. All ports are located on "module 2;" for this reason, if you enter 1/N for the module/port number, an error message is displayed.

Example

This example shows 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)

Related Commands

set spantree portfast
show spantree statistics

clear spantree portvlanpri

Use the clear spantree portvlanpri command to reset the spanning-tree port VLAN priority.

clear spantree portvlanpri mod_num/port_num vlans
clear spantree portvlanpri trcrf | trbrf

Syntax Description


mod_num	Number of the module.
port_num	Number of the port on the module.
vlans	Number of the VLANs.
trcrf	Keyword to specify the TRCRF spanning-tree port VLAN priority.
trbrf	Keyword to specify the TRBRF spanning-tree port VLAN priority.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The Catalyst 2948G is a fixed configuration switch. All ports are located on "module 2;" for this reason, if you enter 1/N for the module/port number, an error message is displayed.

Example

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

Use the clear spantree root command to restore the switch priority and Spanning-Tree Protocol parameters to the factory default values.

clear spantree root vlans

Syntax Description


vlans	List of the VLAN numbers to clear; valid values are 1 to 1005.

Default

The default configuration has the switch priority set to 32768.

Command Type

Switch command.

Command Mode

Privileged.

Examples

These examples show how to clear the spantree root:

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

Related Commands

set spantree root
show spantree

clear spantree statistics

Use the clear spantree statistics command to clear the spanning-tree statistics on a specified module or VLAN.

clear spantree statistics mod_num/port_num
clear spantree statistics vlan

Syntax Description


mod_num	Number of the module.
port_num	Number of the port on the module.
vlan	List of the VLAN numbers to clear.

Default

This command has no defaults.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The Catalyst 2948G is a fixed configuration switch. All ports are located on "module 2;" for this reason, if you enter 1/N for the module/port number, an error message is displayed.

Example

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)

Related Command

show spantree statistics

clear spantree uplinkfast

Use the clear spantree uplinkfast command to turn off the uplinkfast feature and return the switch priority and portcosts to the factory default values.

clear spantree uplinkfast

Syntax Description

This command has no arguments or keywords.

Default

This command has no defaults.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

This command could cause load balancing to be lost in some cases.

Example

This example shows how to turn off the uplinkfast feature and return the switch priority to the factory default values:

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

Use the clear tacacs key command to remove the key setting used for TACACS+ authentication and encryption.

clear tacacs key

Syntax Description

This command has no arguments or keywords.

Default

The default key value is null.

Command Type

Switch command.

Command Mode

Privileged.

Example

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

Use the clear tacacs server command to remove a host from the list of TACACS+ servers.

clear tacacs server {ip_addr | all}

Syntax Description


all	Keyword to remove all hosts from the list of TACACS+ servers.
ip_addr	IP address of the server to be removed from the list of TACACS+ servers.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Example

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 Command

show tacacs

clear timezone

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

clear timezone

Syntax Description

This command has no arguments or keywords.

Default

The default time zone is UTC.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

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.

Example

This example shows how to clear the time zone:

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

Related Command

set timezone

clear t op

Use the clear top command to stop the TopN process.

clear top {all | report_num}

Syntax Description


all	Keyword that stops all nonpending TopN results.
report_num	TopN report number to kill; valid values are 1 to 5.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

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/18/1998,12:05:38:MGMT-5: TopN report 1 killed by Console//.
Console> (enable)

This example shows how to stop all nonpending TopN reports:

Console> (enable) clear top all
10/18/1998, 12:07:06:MGMT-5: TopN report 1 killed by Console//.
10/18/1998, 12:07:06:MGMT-5: TopN report 2 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/18/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

Use the clear trunk command 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.

clear trunk mod/ports... [vlans]

Syntax Description


mod	Number of the module.
ports...	Number of the ports on the module.
vlans	(Optional) One or more VLANs to remove from the allowed VLAN list for the trunk port; valid values are 2 to 1005.

Default

If you do not specify any VLANs, the mode is set to auto for ISL trunk ports and off for other trunk ports (except ATM LANE trunks, which are always on). For more information about auto and off modes, see the set trunk command.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

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

Traffic for the removed VLANs are not forwarded over a trunk port.

Default VLANs cannot be cleared on the trunk.

To add VLANs that you have removed, use the set trunk mod_num/port_num vlan_range command.

The Catalyst 2948G is a fixed configuration switch. All ports are located on "module 2;" for this reason, if you enter 1/N for the module/port number, an error message is displayed.

Examples

This example shows how to clear VLANs 200 to 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 how to clear the trunk on port 2 of module 1:

Console> (enable) clear trunk 1/2
Port(s) 1/2 trunk mode set to auto.
Port(s) 1/2 trunk type set to isl.
Console> (enable)

Related Commands

set trunk
show trunk

clear vlan

Use the clear vlan command to delete an existing VLAN from a management domain.

clear vlan vlan_num

Syntax Description


vlan_num	Number of the VLAN; valid value is 2 to 1000.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

Caution
When you clear a VLAN, depending on the VTP configuration in the network, it might delete the VLAN from the entire VTP domain, which means every switch in the domain could delete that VLAN.

If the configured switch is a VTP server and all or some of the other switches in the network are VTP clients, the change propagates to all the clients. For example, those clients will remove the VLAN from their configuration. Servers and transparent switches are unaffected; they keep the VLAN even if the VLAN is deleted by another server.

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 still configured on that VLAN are also reactivated.

Example

This example shows how to clear an existing VLAN (VLAN 4) from a management domain:

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

Related Commands

set vlan
show vlan

clear vlan mapping

Use the clear vlan mapping command to delete existing 802.1Q VLAN to ISL VLAN-mapped pairs.

clear vlan mapping dot1q {1q_vlan_num | all}

Syntax Description


dot1q	Keyword to specify the 802.1Q VLAN.
1q_vlan_num	Number identifying the 802.1Q VLAN.
all	Keyword to clear the mapping table of all entries.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Examples

This example shows how to clear an existing mapped VLAN (VLAN 1044) from the mapping table:

Console> (enable) clear vlan mapping dot1q 1044
Vlan Mapping 1044 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)

Related Commands

set vlan mapping
show vlan mapping

clear vmps server

Use the clear vmps server command to delete a VMPS server from the VMPS table.

clear vmps server ip_addr

Syntax Description


ip_addr	IP address of the VMPS server to be deleted.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Examples

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

Console> (enable) clear vmps server 172.0.0.1
VMPS domain server 172.0.0.1 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 182.0.0.1
VMPS domain server 182.0.0.1 not in VMPS table.
Console> (enable)

Related Command

reconfirm vmps

clear vmps statistics

Use the clear vmps statistics command to delete existing VMPS statistics.

clear vmps statistics

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to delete existing VMPS statistics:

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

Related Command

show vmps statistics

clear vtp pruneeligible

Use the clear vtp pruneeligible command to specify which VLANs in the VTP domain are ineligible for pruning.

clear vtp pruneeligible vlan_num

Syntax Description


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

Default

By default, VLANs 2 to 1000 are eligible for pruning.

Command Type

Switch command.

Command Mode

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 to 1000 are pruning eligible. Use the clear vtp pruneeligible command to make VLANs pruning ineligible.

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

Example

This example shows how to make VLANs 200 to 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 statistics

clear vtp statistics

Use the clear vtp statistics command to delete the VTP statistics.

clear vtp statistics

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to clear the VTP statistics:

Console> (enable) clear vtp statistics
vtp statistics cleared.
Console> (enable)

Related Commands

set vtp
show vtp statistics

client-atm-address name

Use the client-atm-address name command to add a LANE address entry to the configuration server's database. The no form of this command removes a client address entry from the table.

client-atm-address atm-address-template name elan-name
no client-atm-address atm-address-template

Syntax Description


atm-address-template	Template that specifies an ATM address explicitly or a specific part of an ATM address and uses wildcard characters for other parts of the ATM address. Wildcard characters can replace any nibble or group of nibbles in the prefix, the ESI, or the selector fields of the ATM address.
name	Keyword to specify the name of the ELAN.
elan-name	Name of the ELAN. The maximum length of elan-name is 32 characters.

Default

By default, no address and no ELAN name are configured.

Command Type

Cisco IOS ATM command.

Command Mode

Database configuration.

Usage Guidelines

This command is not supported by the Catalyst 4000 and 2948G series switches.

This command binds to the specified ELAN any client whose address matches the specified template. When a client comes up, it consults the LANE configuration server, which responds with the ATM address of the LANE server for the ELAN. The client then initiates join procedures with the LANE server.

You must create the ELAN specified by the elan-name argument using the name server-atm-address command before you use the client-atm-address command.

If an existing entry in the configuration server's database binds the LANE client ATM address to a different ELAN, the new command is rejected.

This command affects only the bindings in the named configuration server database. It has no effect on the LANE components themselves.

A LANE ATM address has the same syntax as an NSAP but is not a network-level address:

A 13-byte prefix that includes the following fields defined by the ATM Forum: AFI field (1 byte), DCC or ICD field (2 bytes), DFI field (1 byte), Administrative Authority field (3 bytes), Reserved field (2 bytes), Routing Domain field (2 bytes), and Area field (2 bytes).
A 6-byte system identifier (ESI).
A 1-byte selector field.

LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character and an ellipsis (...) to match any number of leading or trailing characters.

In LANE, a prefix template matches the prefix explicitly but uses wildcards for the ESI and selector fields. An ESI template matches the ESI field explicitly but uses wildcards for the prefix and selector.

In our implementation of LANE, the prefix corresponds to the specific subinterface of the interface.

Examples

This example uses an ESI template to specify the part of the ATM address corresponding to an interface. This template allows any client on any subinterface of the interface that corresponds to the displayed ESI value, no matter which switch the router is connected to, to join the engineering ELAN:

ATM(lane-config-database)#client-atm-address ...0800.200c.1001.** name engineering

This example uses a prefix template to specify the part of the ATM address corresponding to the switch. This template allows any client on the subinterface of any interface connected to the switch that corresponds to the displayed prefix to join the marketing ELAN:

ATM(lane-config-database)#client-atm-address 47.000014155551212f.00.00... name marketing

Related Commands

default-name
lane database
name

c onfigure

Use the configure command to download a configuration file from a host and execute each command in that file.

configure {host} {file}

Syntax Description


host	IP address or IP alias of the host.
file	Name of the configuration file.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

Refer to the Software Configuration Guide for your switch on how to construct a configuration file to download using the configure command.

Examples

The following is a sample file called system5.cfg in the /tftpboot directory:

begin
show time
set ip alias conc7 198.133.219.207
set ip alias montreux 198.133.119.42
set ip alias cres 192.122.174.42
set prompt system5>
set password
# empty string old password
 
pingpong
pingpong
end
#

Each line contains a command, except lines that begin with ! or #.

This example shows how to download the system5.cfg configuration file from the 192.122.174.42 host:

Console> (enable) configure 192.122.174.42 system5.cfg
Configure using system5.cfg from 192.122.174.42 (y/n) [n]? y
/
Done.  Finished Network Download.  (446 bytes)
>> show time
Wed Nov 11 1998, 17:42:50
>> set ip alias conc7 198.133.219.207
IP alias added.
>> set ip alias montreux 198.133.219.40
IP alias added.
>> set ip alias cres 192.122.174.42
IP alias added.
>> set prompt system5>
>> set password
Enter old password: 
Enter new password: pingpong
Retype new password: pingpong
Password changed.
system5> (enable)

Related Commands

show config
copy

c onfreg

Use the confreg command to configure the configuration register utility.

confreg [num]

Syntax Description


num	(Optional) Valid values are 0 = ROM monitor, 1 = the boot helper image, and 2-15 = boot system.

Default

This command has no defaults.

Command Type

ROM monitor command.

Command Mode

Normal.

Usage Guidelines

Executed with the argument num, confreg changes the VCR to match the number specified.

Without the argument, confreg dumps the contents of the VCR and allows you to alter the contents.

You are prompted to change or keep the information held in each bit of the VCR. In either case, the new VCR value is written into NVRAM and does not take effect until you reset or power cycle the platform.

You must issue a sync command to save the change; otherwise, a reset will remove your change.

Example

This example shows how to use the confreg command:

rommon 7 > confreg
 
Configuration Summary
enabled are:
console baud: 9600
boot: the ROM Monitor
 
do you wish to change the configuration? y/n  [n]:  y
enable  "diagnostic mode"? y/n  [n]:  y
enable  "use net in IP bcast address"? y/n  [n]:  
enable  "load rom after netboot fails"? y/n  [n]:  
enable  "use all zero broadcast"? y/n  [n]:  
enable  "break/abort has effect"? y/n  [n]:  
enable  "ignore system config info"? y/n  [n]:  
change console baud rate? y/n  [n]:  y
enter rate: 0 = 9600,  1 = 4800,  2 = 1200,  3 = 2400
            4 = 19200, 5 = 38400, 6 = 57600, 7 = 115200  [0]: 0
change the boot characteristics? y/n  [n]:  y
enter to boot:
 0 = ROM Monitor
 1 = the boot helper image
 2-15 = boot system
    [0]:  0
 
 
Configuration Summary
enabled are:
diagnostic mode
console baud: 9600
boot: the ROM Monitor
 
do you wish to change the configuration? y/n  [n]:

You must reset or power cycle for new config to take effect

Related Command

sync

Table of Contents

Syntax Description

Default

Command Type

Command Mode

Example

Related Commands

Syntax Description

Default

Command Type

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Command Type

Command Mode

Example

Related Command

Syntax Description

Default

Command Type

Command Mode

Example

Related Commands

Syntax Description

Default

Command Type

Command Mode

Usage Guidelines

Examples

Related Commands

Syntax Description

Default

Command Type

Command Mode

Usage Guidelines

Examples

Related Commands

Syntax Description

Defaults

Command Type

Command Mode

Usage Guideline

Example

Related Command

Syntax Description

Default

Command Type

Command Mode

Usage Guideline

Example

Related Commands

Syntax Description

Default

Command Type

Command Mode

Example

Related Command

Syntax Description

Default

Command Type

Command Mode

Examples

Related Commands

Syntax Description

Default

Command Type

Command Mode

Usage Guideline

Example

Related Commands

Syntax Description

Default

Command Type

Command Mode

Usage Guideline

Example

Related Commands