Table Of Contents

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands

alias

boot

cd

clear alias

clear arp

clear banner motd

clear boot—ROM monitor

clear boot—switch

clear cam

clear cgmp statistics

clear config pvlan

clear config—ROM monitor

clear config—switch

clear counters

clear crypto key rsa

clear dot1x config

clear dot1x guest-vlan

clear gmrp statistics

clear gvrp statistics

clear igmp filter

clear ip alias

clear ip dns domain

clear ip dns server

clear ip permit

clear ip route—ROM monitor

clear ip route—switch

clear kerberos clients mandatory

clear kerberos credentials forward

clear kerberos creds

clear kerberos realm

clear kerberos server

clear kerberos srvtab entry

clear key config-key

clear lacp-channel statistics

clear localusers

clear log

clear log command

clear logging buffer

clear logging level

clear logging server

clear multicast router

clear ntp key

clear ntp server

clear ntp timezone

clear port host

clear port security

clear pvlan mapping

clear qos config

clear qos defaultcos

clear qos map

clear radius key

clear radius server

clear rcp

clear snmp access

clear snmp access-list

clear snmp community

clear snmp community-ext

clear snmp group

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 portvlancost

clear spantree portpri

clear spantree portvlanpri

clear spantree redetected-protocols

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 rcp

clear vmps server

clear vmps statistics

clear vtp pruning

clear vtp statistics

configure

confreg

copy

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands

---

This chapter contains an alphabetical listing of all switch and ROM monitor commands available on the Catalyst 4000 family, Catalyst 2948G, and Catalyst 2980G switches.

alias

To set and display aliases, use the alias command.

alias [name=value]

Syntax Description

name=	(Optional) Alias name.
value	(Optional) Value of the alias.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Usage Guidelines

If value contains blank spaces or other special (shell) characters, you must enclose the entry in quotation marks. If value has a space as its last character, the next command line word is checked for an alias (Normally, only the first word on a command line is checked).

Without an argument, this command prints a list of all alias names and their values.

An equal sign (=) is required between the name and value of the alias.

Examples

This example shows how to display a list of available alias commands and how to create an alias for the set command:

rommon 1 > alias

r=repeat

h=history

?=help

b=boot

i=reset

rommon 2 > alias s=set

rommon 3 > alias

r=repeat

h=history

?=help

b=boot

i=reset

s=set

rommon 4 > s 

PS1=rommon ! > 

BOOT=bootflash:RTSYNC_llue_11,1;slot0:f1,1;

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

Related Commands

unalias

boot

To invoke an external process, use the boot command.

boot [-x] [-v] [device] [imagename]

Syntax Description

-x	(Optional) Loads an image but does not run it.
-v	(Optional) Toggles verbose mode.
device	(Optional) ID of the device.
imagename	(Optional) Name of the image.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Usage Guidelines

With no arguments, boot will boot the first image in Flash memory. Specify an image by typing its name. Specify the device by typing the device ID.

You must specify a device name.

Examples

This example shows how to use the boot command:

rommon 1 > boot -x bootflash:cat5000-sup3.6-1-0-59.bin

CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC

Uncompressing file:  
##########################################################################################
##########################################################################################
################################################################################

rommon 2 >

cd

To set the default Flash device for the system, use the cd command.

cd [[m/]device:]]

Syntax Description

m/	(Optional) Module number of the supervisor engine containing the Flash device.
device:	(Optional) Flash device name; valid devices include bootflash:, slot0:, and slot1:.

Defaults

device is bootflash

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

A colon (:) is required after the specified device.

For those commands for which device is an option, the device set by cd is used if a Flash device is not specified.

This command is supported on the Supervisor Engine III only.

Examples

This example shows how to set the system default Flash device to bootflash:

Console> (enable) cd bootflash:

Console> (enable)

Related Commands

pwd

clear alias

To delete the abbreviated versions of commands, use the clear alias command.

clear alias {name | all}

Syntax Description

name	Alternate identifier of the command.
all	Every alternate identifier that has been created.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete the arpdel alias:

Console> (enable) clear alias arpdel

Command alias deleted.

Console> (enable)

This example shows how to delete all aliases:

Console> (enable) clear alias all

Command alias table cleared. (1)

Console> (enable)

(1) indicates the number of entries deleted.

Related Commands

set alias
show alias

clear arp

To delete a specific entry or all entries from the ARP table, use the clear arp command.

clear arp [all | dynamic | permanent | static]

clear arp ip_addr

Syntax Description

all	(Optional) Deletes all ARP entries.
dynamic	(Optional) Deletes all dynamic ARP entries.
permanent	(Optional) Deletes all permanent ARP entries.
static	(Optional) Deletes all static ARP entries.
ip_addr	Specific IP address that you want to delete from the ARP table.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete a specific IP address from the ARP table:

Console> (enable) clear arp 198.133.219.209

ARP entry deleted.

Console> (enable)

This example shows how to delete all entries from the ARP table:

Console> (enable) clear arp all

ARP table cleared. (1)

Console> (enable)

(1) indicates the number of entries deleted.

This example shows how to delete all ARP entries of a specific type:

Console> (enable) clear arp dynamic

Unknown host

Dynamic ARP entries cleared. (3) 

Console> (enable)

Related Commands

set arp
show alias

clear banner motd

To delete the message-of-the-day banner, use the clear banner motd command.

clear banner motd

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

You can use the clear banner motd command to delete the message-of-the-day banner or use the set banner motd text command to replace the message-of-the-day banner.

Examples

This example shows how to delete the message-of-the-day banner:

Console> (enable) clear banner motd

MOTD banner cleared

Console> (enable)

Related Commands

set banner motd

clear boot—ROM monitor

To clear the contents of the BOOT environment variable and the autoboot state machine, use the clear boot command.

clear boot

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Examples

This example shows how to clear the contents of the BOOT environment variable:

rommon 1 > clear boot

rommon 2 >

Related Commands

boot
show boot—ROM monitor

clear boot—switch

To clear the contents of the BOOT environment variable and the configuration register setting, use the clear boot command.

clear boot system all [mod]

clear boot system flash device:[filename] [mod]

clear boot auto-config [mod]

Syntax Description

all	Clears the whole BOOT environment variable.
mod	(Optional) Module number of the supervisor engine on which to clear the BOOT environment variable.
flash	Deletes the contents of the Flash file system.
device:	Device name; valid devices include bootflash, slot0, and slot1.
filename	(Optional) Filename for the system image on the Flash device.
auto-config	Deletes the contents of the auto-config file.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

If you want to rearrange the booting order, you can use the prepend keyword with the set boot system flash command or you can clear the entire BOOT environment variable using the clear boot system command and then redefine the list.

This command is supported on the Supervisor Engine III only.

Examples

This example shows how to clear the contents of the Flash device:

Console> (enable) clear boot system all

BOOT variable = 

Console> (enable)

This example shows how to delete the auto-config file:

Console> (enable) clear boot auto-config

CONFIG_FILE variable =

Console> (enable)

Related Commands

show boot—switch

clear cam

To delete a specific entry or all entries from the CAM table, and to clear the CAM notification log or counters, use the clear cam command.

clear cam {mac_addr | dynamic | static | permanent} [vlan]

clear cam notification {all | counters | history}

Syntax Description

mac_addr	One or more MAC addresses to clear from the CAM table.
dynamic	Clears the dynamic CAM entries from the CAM table.
static	Clears the static CAM entries from the CAM table.
permanent	Clears the permanent CAM entries from the CAM table.
vlan	(Optional) Number of the VLAN associated with the CAM entries.
all	Clears the CAM notification counters and history log.
counters	Clears the CAM notification counters.
history	Clears the CAM notification history log.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

When you use the clear cam command, the EARL CAM table entries are cleared, or the CAM notification counters or history are cleared.

Examples

This example shows how to delete MAC address 00-40-0b-a0-03-fa from the CAM table:

Console> (enable) clear cam 00-40-0b-a0-03-fa

CAM table entry cleared.

Console> (enable)

This example shows how to clear dynamic entries from the CAM table:

Console> (enable) clear cam dynamic

Dynamic CAM entries cleared.

Console> (enable) 

This example shows how to clear all CAM notification counters:

Console> (enable) clear cam notification all

MAC address notification counters and history log cleared.

Console> (enable)

This example shows how to clear CAM notification counters:

Console> (enable) clear cam notification counters

MAC address notification counters cleared.

Console> (enable)

This example shows how to clear the CAM notification history log:

Console> (enable) clear cam notification history

MAC address notification history log cleared.

Console> (enable)

Related Commands

set cam agingtime
set cam notification
set snmp trap
show cam

clear cgmp statistics

To delete CGMP statistical information, use the clear cgmp statistics command.

clear cgmp statistics

Syntax DescriptionDescription

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 CGMP statistical information:

Console> (enable) clear cgmp statistics

CGMP statistics cleared.

Console> (enable) 

Related Commands

set cgmp
show cgmp leave
show cgmp statistics

clear config pvlan

To delete all private VLAN configurations in the system, including port mappings, use the clear config pvlan command.

clear config pvlan

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 all private VLAN configurations in the system:

Console> (enable) clear config pvlan

This command will clear all private VLAN configurations.

Do you want to continue (y/n) [n]? y

VLAN 15 deleted 
VLAN 16 deleted 
VLAN 17 deleted 
VLAN 18 deleted

Private VLAN configuration cleared. 
Console> (enable) 

Related Commands

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

clear config—ROM monitor

To delete information about the system or module configuration stored in NVRAM, use the clear config command.

clear config all

Syntax Description

all	Deletes all information about modules and system configuration, including the IP address.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Usage Guidelines

When you delete the configuration using the clear config all command, the default switch configuration is restored. The information that is deleted includes manually configured IP addresses and IP addresses learned through DHCP or RARP.

When you delete the configuration, the IP address and subnet mask on the me1 and sc0 interfaces are set to 0.0.0.0. The me1 interface is brought down, and the sc0 interface is brought up.

---

Note Before using the clear config all command, save a backup of the configuration.

---

Examples

This example shows how to delete all the configuration information:

rommon 1 > set boot config-register ignore-config enable

rommon 2 > boot -x bootflash:cat4000.6-1-1.bin

CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCCCCCC#############################

Starting Off-line Diagnostics

    [ output of Off-line Diagnostics ]

Exiting Off-line Diagnostics

IP address for Catalyst not configured

DHCP/BOOTP will commence after the ports are online

Ports are coming online ...

Cisco Systems, Inc. Console

Enter password:

2000 Jun 24 06:29:21 %SYS-4-NVLOG:initBootNvram:ignore-config enabled:clear config all

Console> 

Related Commands

configure
show config

clear config—switch

To delete the system or module configuration information stored in NVRAM, use the clear config command.

clear config {mod | rmon | all | snmp | acl nvram}

Syntax Description

mod	Number of the module.
rmon	Deletes all RMON configurations, including the historyControlTable, the alarmTable, the eventTable, and the ringStation ControlTable.
all	Deletes all module and system configuration information, including the IP address.
snmp	Deletes all SNMP configurations.
acl nvram	Deletes all ACL configurations.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

When you delete the configuration using the clear config all command, the default switch configuration is restored. The information that is deleted includes manually configured IP addresses and IP addresses learned through DHCP or RARP.

When you delete the configuration, the IP address and subnet mask on the sc0 interface are set to 0.0.0.0.

---

Note Before using the clear config all command, save a backup of the configuration.

---

Examples

This example shows how to delete the configuration information in NVRAM on module 2:

Console> (enable) clear config 2

This command will clear module 2 configuration.

Do you want to continue (y/n) [n]? y

..............................

Module 2 configuration cleared.

Console> (enable)

This example shows how to delete the configuration information stored in NVRAM on module 1 (supervisor engine):

Console> (enable) clear config 1

This command will clear module 1 configuration.

Do you want to continue (y/n) [n]? y

......

Module 1 configuration cleared.

host%

Console> (enable)

This example shows how to delete all the configuration information:

Console> (enable) clear config all

This command will clear all configuration in NVRAM.

This command will cause ifIndex to be reassigned on the next system startup.

Do you want to continue (y/n) [n]? y

Releasing IP address...Done

......

.................

.....................................................

System configuration cleared.

Console> (enable) 

This example shows how to delete all the SNMP configuration information:

Console> (enable) clear config snmp

This command will clear SNMP configuration in NVRAM.

Do you want to continue (y/n) [n]? y

...........................................

Connection closed by foreign host

host%

This example shows how to delete all ACL configuration information from NVRAM:

Console> (enable) clear config acl nvram

ACL configuration has been deleted from NVRAM.

Warning:Use the copy commands to save the ACL configuration to a file

and the 'set boot config-register auto-config' commands to configure the

auto-config feature.

Console> (enable)

Related Commands

configure
show config

clear counters

To clear MAC and port counters, use the clear counters command.

clear counters

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 also clears ATM module counters.

Examples

This example shows how to reset MAC and port counters to zero:

Console> (enable) clear counters

MAC and Port counters cleared.

Console> (enable)

Related Commands

show port

clear crypto key rsa

To delete all RSA public-key pairs, use the clear crypto key rsa command.

clear crypto key rsa

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete RSA key pairs:

Console> (enable) clear crypto key rsa 

Do you really want to clear RSA keys (y/n) [n]? y

RSA keys has been cleared.

Console> (enable) 

Related Commands

set crypto key rsa
show crypto key

clear dot1x config

To disable dot1x on all ports and return the values to the factory default settings, use the clear dot1x config command.

clear dot1x config

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to disable dot1x and return the values to the factory default settings:

Console> (enable) clear dot1x config

This command will disable Dot1x and take values back to factory default.

Do you want to continue (y/n) [n]? y

Dot1x config cleared.

Console> (enable) 

Related Commands

set dot1x
set port dot1x
show dot1x
show port dot1x

clear dot1x guest-vlan

To remove any active 802.1x auto ports from the guest VLAN, use the clear dot1x guest-vlan command.

clear dot1x guest-vlan

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to clear the guest VLAN:

Console> (enable) clear dot1x guest-vlan

This command will deactivate all the ports on dot1x guest-vlan

Do you wnat to continue (y/n) [n]? y

Dot1x guest-vlan cleared

Console> (enable)

Related Commands

set dot1x
set port dot1x
show dot1x
show port dot1x

clear gmrp statistics

To delete all of the GMRP statistics information from a specified VLAN or from all VLANs, use the clear gmrp statistics command.

clear gmrp statistics {vlan | all}

Syntax Description

vlan	Number of the VLAN.
all	Deletes all GMRP statistics information from all VLANs.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete GMRP statistical information from all VLANs:

Console> (enable) clear gmrp statistics all

GMRP statistics cleared.

Console> (enable) 

This example shows how to delete GMRP statistical information from VLAN 1:

Console> (enable) clear gmrp statistics 1

GMRP statistics cleared from VLAN 1.

Console> (enable) 

Related Commands

show gmrp statistics

clear gvrp statistics

To delete all of the GVRP statistics information, use the clear gvrp statistics command.

clear gvrp statistics {mod/port | all}

Syntax Description

mod/port	Number of the module and port.
all	Deletes the GVRP statistics information for all ports.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete GVRP statistical information:

Console> (enable) clear gvrp statistics all

GVRP statistics cleared for all ports.

Console> (enable) 

This example shows how to delete GVRP statistical information for module 2, port 1:

Console> (enable) clear gvrp statistics 2/1

GVRP statistics cleared on port 2/1.

Console> (enable) 

Related Commands

set gvrp
show gvrp statistics

clear igmp filter

To delete all IGMP multicast filter profiles, use the clear igmp filter all command.

clear igmp filter all

To delete an IP address from an IGMP multicast filter profile or to delete the filter profile, use the clear igmp filter profile command.

clear igmp filter profile profile_id {ip_addr [- ip_addr]| all}

To delete the association between IGMP multicast filter profiles and associated ports, use the clear igmp filter map command.

clear igmp filter map {port_list | all}

Syntax Description

profile_id	Arbitrary number assigned to a profile.
ip_addr	Address of the IP. Can be 1 or a range.
port_list	Module/port value or range of values.
all	Deletes the association between all IGMP multicast filter profiles and associated ports.

Defaults

The default settings are as follows:

•IGMP multicast filter feature deletes all IGMP multicast filters.

•Profile ID value must be established using the clear igmp filter profile command.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

The administrator of the switch can view the configuration of this feature using the CLI and SNMP interfaces.

When you delete an IGMP filter the filter is deleted and all the associations between the filter and associated ports are deleted.

When you clear an association between IGMP filters the association is deleted, not the filter.

Examples

This example shows how to delete all IGMP multicast filters.

Console> (enable) clear igmp filter all

Successfully remove all the profile(s)

Console> (enable) 

This example shows how to delete an IP address (226.1.1.1) from an IGMP multicast filter profile (1) or to delete the filter profile:

Console> (enable) clear igmp filter profile 1 226.1.1.1

Console> (enable) 

This example shows how to delete the association of IGMP multicast filter profiles with a port or list of ports.

Console> (enable) clear igmp filter map all

Console> (enable) 

Related Commands

set igmp filter
show igmp filter

clear ip alias

To delete IP aliases that are set using the set ip alias command, use the clear ip alias command.

clear ip alias {name | all}

Syntax Description

name	IP address alias to delete.
all	Deletes all previously set IP address aliases.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete a previously defined IP alias named babar:

Console> (enable) clear ip alias babar

IP alias deleted.

Console> (enable)

Related Commands

set ip alias
show ip alias

clear ip dns domain

To delete the default DNS domain name, use the clear ip dns domain command.

clear ip dns domain

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 the default DNS domain name:

Console> (enable) clear ip dns domain

Default DNS domain name cleared.

Console> (enable)

Related Commands

set ip dns domain
show ip dns

clear ip dns server

To delete a DNS server from the DNS server listing, use the clear ip dns server command.

clear ip dns server {ip_addr | all}

Syntax Description

ip_addr	IP address of the DNS server that you want to delete. An IP alias or host name that can be resolved through DNS can also be used.
all	Deletes all IP addresses in the DNS server listing.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete the DNS server at IP address 192.168.255.255 from the DNS server listing:

Console> (enable) clear ip dns server 192.168.255.255

192.168.255.255 cleared from DNS table.

Console> (enable)

Related Commands

set ip dns server
show ip dns

clear ip permit

To delete a specified IP address and mask or all IP addresses and masks from the permit list, use the clear ip permit command.

clear ip permit {ip_addr} [mask] [telnet | ssh | snmp | all]

To delete all entries in the IP permit list, use the clear ip permit all command.

clear ip permit all

Syntax Description

ip_addr	IP address to be deleted. An IP alias or host name that can be resolved through DNS can also be used.
mask	(Optional) Subnet mask of the specified IP address.
telnet	(Optional) Deletes an IP address from the Telnet IP permit list.
ssh	(Optional) Deletes an IP address from the SSH permit list.
snmp	(Optional) Deletes an IP address from the SNMP IP permit list.
all	(Optional) Deletes an IP address from the SNMP and Telnet IP permit lists.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

The clear ip permit all command deletes the permit list but does not change the state of the IP permit feature. A warning is displayed if all IP addresses are deleted from the permit list, and the feature is enabled. If a mask other than the default (255.255.255.255) has been configured, you must provide both the address and mask to delete a specific entry.

If the telnet, ssh, snmp, or all keywords are not specified, the IP address is deleted from both the SNMP and Telnet permit lists.

Examples

These examples show how to delete specified IP addresses:

Console> (enable) clear ip permit 172.100.101.102

172.100.101.102 cleared from IP permit list.

Console> (enable)

Console> (enable) clear ip permit 172.160.161.0 255.255.192.0 snmp

172.160.128.0 with mask 255.255.192.0 cleared from snmp permit list.

Console> (enable)

Console> (enable) clear ip permit 172.100.101.102 telnet

172.100.101.102 cleared from telnet permit list.

Console> (enable)

Console> (enable) clear ip permit 172.100.101.102 ssh 

172.100.101.102 cleared from secure shell permit list. 

Console> (enable) 

Console> (enable) clear ip permit all

IP permit list cleared.

WARNING

IP permit list is still enabled.

Console> (enable)

Related Commands

set ip permit
show ip permit
show port counters

clear ip route—ROM monitor

To delete IP routes that are set using the set ip command, use the clear ip route command.

clear ip route all

Syntax Description

all	Deletes all previously set IP address routes.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Examples

This example shows how to delete previously defined IP routes:

rommon 1 > clear ip route all

rommon 2 >

Related Commands

set ip route—ROM monitor
show ip route—ROM monitor

clear ip route—switch

To delete IP routing table entries, use the clear ip route command.

clear ip route all

clear ip route destination gateway

Syntax Description

all	Deletes 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.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete the route table entries using the clear ip route command:

Console> (enable) clear ip route 172.16.2.2 elvis

Route deleted.

Console> (enable)

Related Commands

set ip route—switch
show ip route—switch

clear kerberos clients mandatory

To disable mandatory Kerberos authentication for services on the network, use the clear kerberos clients mandatory command.

clear kerberos clients mandatory

Syntax Description

This command has no arguments or keywords.

Defaults

Kerberos clients are not set to mandatory.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to authenticate to a host on the network. However, if forwarding is not enabled and a user tries to list credentials after authenticating to a host, the output will show no Kerberos credentials present.

You can optionally configure the switch to forward users' TGTs with them as they authenticate from the switch to Kerberized remote hosts on the network when using Kerberized Telnet.

As an added layer of security, you can optionally configure the switch so that after users authenticate to it, they can authenticate to other services on the network only with Kerberos clients. If you do not make Kerberos authentication mandatory and Kerberos authentication fails, the application attempts to authenticate users using the default method of authentication for that network service. For example, Telnet prompts for a password.

Examples

This example shows how to delete mandatory Kerberos authentication:

Console> (enable) clear kerberos clients mandatory 

Kerberos clients mandatory cleared

Console> (enable)

Related Commands

set kerberos clients mandatory
set kerberos credentials forward

clear kerberos credentials forward

To disable credentials forwarding, use the clear kerberos credentials forward command.

clear kerberos credentials forward

Syntax Description

This command has no arguments or keywords.

Defaults

Kerberos credentials forwarding is disabled.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to authenticate to a host on the network. However, if forwarding is not enabled and a user tries to list credentials after authenticating to a host, the output will show no Kerberos credentials present.

You can optionally configure the switch to forward users' TGTs with them as they authenticate from the switch to Kerberized remote hosts on the network when using Kerberized Telnet.

Examples

This example shows how to disable Kerberos credentials forwarding:

Console> (enable) clear kerberos credentials forward 

Kerberos credentials forwarding disabled

Console> (enable) 

Related Commands

set kerberos clients mandatory
set kerberos credentials forward

clear kerberos creds

To delete all the Kerberos credentials, use the clear kerberos creds command.

clear kerberos creds

Syntax Description

This command has no arguments or keywords.

Defaults

Kerberos credentials forwarding is disabled.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to authenticate to a host on the network. This command deletes all Kerberos credentials.

Examples

This example shows how to delete all Kerberos credentials:

Console> (enable) clear kerberos creds

Console> (enable) 

Related Commands

set kerberos credentials forward

clear kerberos realm

To delete an entry that is mapping the name of a Kerberos realm to a DNS domain name or a host name, use the clear kerberos realm command.

clear kerberos realm {dns-domain | host} kerberos-realm

Syntax Description

dns-domain	DNS domain name to map to a Kerberos realm.
host	IP address or name to map to a Kerberos realm.
kerberos-realm	IP address or name of a Kerberos realm.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

The name of the Kerberos realm can sometimes be mapped to a DNS domain name or a host name. This mapping can be done with the set kerberos realm command.

Examples

This example shows how to delete an entry mapping a Kerberos realm to a domain name:

Console> (enable) clear kerberos realm CISCO CISCO.COM

Kerberos DnsDomain-Realm entry CISCO - CISCO.COM deleted

Console> (enable) 

Related Commands

set kerberos local-realm
set kerberos realm

clear kerberos server

To delete a specified key distribution center (KDC) entry, use the clear kerberos server command.

clear kerberos server kerberos-realm {hostname | ip-address} [port_num]

Syntax Description

kerberos-realm	Name of a Kerberos realm.
hostname	Name of host running the KDC.
ip-address	IP address of host running the KDC.
port_num	Number of the port on the module.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

You can specify to the switch which KDC to use in a Kerberos realm. This command deletes a server entry from the table.

Examples

This example shows how to delete a KDC server entered on the switch:

Console> (enable) clear kerberos server CISCO.COM 187.0.2.1 750

Kerberos Realm-Server-Port entry CISCO.COM-187.0.2.1-750  deleted

Console> (enable) 

Related Commands

set kerberos server

clear kerberos srvtab entry

To delete the SRVTAB file that is entered directly into the switch from the command line, use the clear kerberos srvtab entry command.

clear kerberos srvtab entry kerberos-principal principal-type

Syntax Description

kerberos-principal	Service on the switch.
principal-type	Version of the Kerberos SRVTAB.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete a SRVTAB file entered directly into the switch:

kerberos> (enable) clear kerberos srvtab entry host/niners.cisco.com@CISCO.COM 0

kerberos> (enable)

Related Commands

set kerberos srvtab entry
set kerberos srvtab remote

clear key config-key

To delete the configuration key, use the clear key config-key command.

clear key config-key

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 a DES key:

Console> (enable) clear key config-key

Console> (enable)

Related Commands

set key config-key

clear lacp-channel statistics

To delete LACP statistical information, use the clear lacp-channel statistics command.

clear lacp-channel statistics

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to delete LACP statistical information:

Console> (enable) clear lacp-channel statistics

LACP channel counters are cleared.

Console> (enable)

Related Commands

set channelprotocol
set lacp-channel system-priority
set port lacp-channel
set spantree channelcost
set spantree channelvlancost
show lacp-channel
show port lacp-channel

clear localusers

To delete a local user account from the switch, use the clear localusers command.

clear localusers username

Syntax Description

username

Local user account.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete a local user account:

Console> (enable) clear localuser troy

Local user cleared.

Console> (enable)

Related Commands

set localuser
show localusers

clear log

To clear module, system error log, or dump log entries, use the clear log command.

clear log [mod]

clear log dump

Syntax Description

mod	(Optional) Module number.
dump	Clears dump log entries.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

If you do not specify a module number, the system error log for the entire system is cleard.

Examples

This example shows how to clear the system error log:

Console> (enable) clear log

System error log cleared.

Console> (enable) 

This example shows how to clear the dump log:

Console> (enable) clear log dump

Console> (enable) 

Related Commands

show kerberos
show log

clear log command

To delete the command log entry table, use the clear log command command.

clear log command [mod]

Syntax Description

mod	(Optional) Module number.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

The command log entry table is a history log of the commands input to the switch from the console or from Telnet.

Examples

This example shows how to delete the command log table for module 3:

Console> (enable) clear log command 3

Module 3 log cleared.

Console> (enable) 

Related Commands

show log command

clear logging buffer

To clear the system logging buffer, use the clear logging buffer command.

clear logging buffer

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 system logging buffer:

Console> (enable) clear logging buffer

System logging buffer cleared.

Console> (enable)

Related Commands

show logging buffer

clear logging level

To reset the default logging level of all facilities to their default factory settings, use the clear logging level command.

clear logging level [facility | all]

Syntax Description

facility	(Optional) Name of facility to reset. For facility types, see set logging level.
all	(Optional) Resets all facilities.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to reset all facilities back to their factory default settings:

Console> (enable) clear logging level all

Default logging level for all facilities cleared.

Console> (enable)

This example shows how to reset a system back to its factory default settings:

Console> (enable) clear logging level system

Default logging level for facility <sys> cleared.

Console> (enable)

clear logging server

To delete a syslog server from the system log server table, use the clear logging server command.

clear logging server ip_addr

Syntax Description

ip_addr

IP address of the syslog server to be deleted.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete a syslog server from the configuration:

Console> (enable) clear logging server 192.168.255.255 
System log server 192.168.255.255 removed from system log server table.

Console> (enable) 

Related Commands

set logging server
show logging

clear multicast router

To delete 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	Deletes all multicast router ports.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete port 1 on module 3 from the list of multicast router ports:

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

To delete all authentication keys or a specific authentication key, use the clear ntp key command.

clear ntp key {public_keynum | all}

Syntax Description

public_keynum	Number of the key pair; valid values are from 1 to 4,292,945,295.
all	Deletes all authentication keys.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete an NTP authentication key:

Console> (enable) clear ntp key 435

NTP key 435 cleared.

Console> (enable) 

Related Commands

set ntp key

clear ntp server

To delete 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 delete from the server table.
all	Deletes all server addresses in the server table.

Defaults

No NTP servers are configured.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete 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 delete all NTP servers from the server table:

Console> (enable) clear ntp server all

All NTP servers cleared.

Console> (enable)

Related Commands

set ntp server
show ntp

clear ntp timezone

To return the time zone to its default, Coordinated Universal Time (UTC), use the clear ntp timezone command.

clear ntp timezone

Syntax Description

This command has no arguments or keywords.

Defaults

The 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, this command has no effect.

Examples

This example shows how to delete the time zone:

Console> (enable) clear ntp timezone

Timezone name and offset cleared.

Console> (enable)

Related Commands

set ntp timezone
show ntp

clear port host

To return access ports back to the system default configuration, use the clear port host command.

clear port host

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 port host 1 on module 2:

Console> (enable) clear port host 2/1

Port(s)  2/1 trunk mode set to auto.

Spantree port  2/1 fast start disabled.

Port(s) 2/1 channel mode set to auto.

Console> (enable) 

This example shows how to delete port hosts 1 to 4 on module 2:

Console> (enable) clear port host 2/1-4

Port(s)  2/1 trunk mode set to auto.

Port(s)  2/2 trunk mode set to auto.

Port(s)  2/3 trunk mode set to auto.

Port(s)  2/4 trunk mode set to auto.

Spantree ports 2/1-4 fast start disabled.

Port(s) 2/1 channel mode set to auto.

Port(s) 2/2 channel mode set to auto.

Port(s) 2/3 channel mode set to auto.

Port(s) 2/4 channel mode set to auto.

console> (enable) 

Related Commands

set port host

clear port security

To delete 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	(Optional) Number of the module and the ports on the module.
mac_addr	MAC address to be deleted.
all	Deletes all MAC addresses.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete 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}{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.
mod/port	Number of the module and promiscuous port on the module.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

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

Examples

This example shows how to delete the mapping of VLAN 902 to 901, previously set on module 3, ports 2 to 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 config

To return the values set by the set qos command to the default values and delete the Class of Service-to-MAC address mappings, use the clear qos config command.

clear qos config

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 return the values set by the set qos command to the default values and delete the Class of Service (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 status

clear qos defaultcos

To restore the default Class of Service (CoS) value for the entire switch, use the clear qos defaultcos command.

clear qos defaultcos

Syntax Description

This command has no arguments or keywords.

Defaults

CoS is 0

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to restore the default CoS value for the entire switch:

Console> (enable) clear qos defaultcos

qos defaultcos setting cleared.

Console> (enable)

Related Commands

set qos
show qos status

clear qos map

To return the CoS-to-transmit queue and drop threshold values to their default values, use the clear qos map command.

clear qos map port_type

Syntax Description

port_type

Port type; valid port types are 1q4t and 2q1t.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to return the CoS-to-transmit queue and drop threshold mappings to the default values on 1q4t ports:

Console> (enable) clear qos map 1q4t 

Qos map setting cleared.

Console> (enable) 

Related Commands

set qos map
show qos status

clear radius key

To delete all or one of the RADIUS shared keys from the RADIUS shared key table, use the clear radius key command.

clear radius key

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 the RADIUS key:

Console> (enable) clear radius key

Radius server key cleared.

Console> (enable) 

Related Commands

set radius key
show radius

clear radius server

To delete all or one of the RADIUS servers from the RADIUS server table, use the clear radius server command.

clear radius server all

clear radius server ip_addr

Syntax Description

all	Deletes all RADIUS servers from the RADIUS server table.
ip_addr	IP address of the RADIUS server you want to delete.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

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

Console> (enable) clear radius server 192.168.255.255

192.168.255.255 cleared from radius server table.

Console> (enable) 

Related Commands

set radius server
show radius

clear rcp

To delete 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 delete rcp information:

Console> (enable) clear rcp

Console> (enable) 

Related Commands

set rcp username
show rcp

clear snmp access

To delete the access rights of an SNMP group with a specific security model and security level, use the clear snmp access command.

clear snmp access [-hex] {groupname security-model {v1 | v2c | v3} {noauthentication | authentication | privacy}

Syntax Description

-hex	(Optional) Displays the groupname in hexadecimal format.
groupname	SNMP access table name.
security-model v1 | v2c	Deletes the access rights of security model v1 or v2c.
security-model v3	Deletes the access rights of security model v3.
noauthentication	Sets the security model to not use the authentication protocol.
authentication	Indicates the type of authentication protocol.
privacy	Protects messages sent on behalf of the user from disclosure.

Defaults

This command has no default settings.

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.

Examples

This example shows how to delete 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

clear config—switch
set snmp access
show snmp

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 pemitted to use a specific community string; valid values are from 1 to 65535.
IP_address	IP address that is associated with the access list. See "Usage Guidelines" 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 remove an exisitng community string and to remove the mappings between different community strings and security modes, use the clear snmp community command.

clear snmp community {read-only | read-write | read-write-all} community_string

clear snmp community index [-hex] {index_name}

Syntax Description

read-only	Removes read-only access to the specified SNMP community.
read-write	Removes read-write access to the specified SNMP community.
read-write-all	Removes read-write access to the specified SNMP community.
community_string	Name of the SNMP community.
index	Deletes an index.
-hex	(Optional) Displays the index_name in 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 index_name (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, a NULL context string is used.

Examples

This example shows how to clear an SNMP community string:

Console> (enable) clear snmp community read-only public1

Community string public1 with access read-only has been removed

Console> (enable)

This example shows how to delete 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 delete 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 in hexadecimal format.
groupname	Name of the SNMP group that defines an access control.
user	SNMP group user name.
username	Name of the SNMP user.
security model v1 | v2c | v3	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 groupname or username (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 delete the SNMP group from the vacmAccessTable:

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

clear snmp notify

To delete the SNMP notifyname in the SNMP Notify Table, use the clear snmp notify command.

clear snmp notify [-hex] {notifyname}

Syntax Description

-hex	(Optional) Displays the notifyname in hexadecimal format.
notifyname	Unique 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 notifyname (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 delete an SNMP notifyname from the SNMP NotifyTable:

Console> (enable) clear snmp notify joe

Cleared SNMP notify table joe.

Console> (enable) 

Related Commands

set snmp notify
show snmp

clear snmp targetaddr

To delete 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 in hexadecimal format.
addrname	Arbitrary but unique 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 addrname (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 delete an SNMP target address entry in the SNMP TargetAddressTable:

Console> (enable) clear snmp targetaddr joe

Cleared SNMP targetaddr joe.

Console> (enable)

Related Commands

set snmp targetaddr
show snmp

clear snmp targetparams

To delete 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 in 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 paramsname (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 delete the SNMP target parameters in the snmpTargetParamsTable:

Console> (enable) clear snmp targetparams joe

Cleared SNMP targetparams table joe.

Console> (enable) 

Related Commands

set snmp targetparams
show snmp

clear snmp trap

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

clear snmp trap {rcvr_addr | all}

clear snmp trap rcvr_addr [port rcvr_port] [owner rcvr_owner] [index rcvr_index]

Syntax Description

rcvr_addr	IP address or IP alias of the trap receiver (the SNMP management station) to delete, in dotted decimal notation, such as 101.102.103.104.
all	Deletes every entry in the SNMP trap receiver table.
port rcvr_port	(Optional) UDP port and port number. The value for rcvr_port can be from 0 to 65535.
owner rcvr_owner	(Optional) Identifies the user who configured the settings for snmp trap. The rcvr_owner can be from 1 to 21 characters in length.
index rcvr_index	(Optional) Identifies this entry. The rcvr_index is a value from 1 to 65535.

Defaults

The SNMP trap receiver table is empty.

Command Types

Switch command

Command Modes

Privileged

Examples

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

Console> (enable) clear snmp trap 192.168.255.255

SNMP trap receiver deleted.

Console> (enable)

Related Commands

set snmp trap
show port counters
test snmp trap

clear snmp user

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

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

Syntax Description

-hex	(Optional) Displays the username in hexadecimal format.
username	Name of the user on the host that connects to the agent.
remote engineid	(Optional) Username on a remote SNMP engine.

Defaults

The local SNMP engine ID is used (if a remote engine ID is not provided).

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

If you use special characters for username (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 delete a user from an SNMP group:

Console> (enable) clear snmp user joe

Cleared SNMP user joe.

Console> (enable) 

This example shows how to delete 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

clear snmp view

To delete the MIB viewname from the vacmViewTreeFamilyTable, use the clear snmp view command.

clear snmp view [-hex] {viewname} {subtree}

Syntax Description

-hex	(Optional) Displays the viewname in 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 viewname (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 in conjunction 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 delete 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

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.

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 delete 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; valid values are from 0 to 15. See "Usage Guidelines" for more information.
vlan vlans	(Optional) 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 can not 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 delete the 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 delete 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 settings are shown in the following table:

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 mode 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 reset the spanning tree port instance priority, use the clear spantree portinstancepri command.

clear spantree portinstancepri mod/port [instances]

Syntax Description

mod/port	Number of the module and the port on the module.
instances	(Optional) Number of the instance; valid values are from 0 to 15.

Defaults

Port priority is 0

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

This command is valid in MISTP mode 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 portvlancost

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

clear spantree portvlancost mod/port preferred_vlans

Syntax Description

mod/port	Number of the module and the port on the module.
preferred_vlans	List of VLANs for which to restore the default spanning tree port VLAN cost; valid values are from 1 to 1005.

Defaults

The default settings are shown in the following table:

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

Examples

This example shows how to restore the default spanning tree port VLAN cost for VLANs 1 through 10 on port 2/10:

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 portpri

To delete 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 spanning tree MST port priority.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete 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 delete the spanning tree 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 portvlanpri

To restore the default spanning tree port VLAN priority on a port, use the clear spantree portvlanpri command.

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	List of VLANs for which to restore the default spanning tree port VLAN priority; valid values are from 1 to 1005.
trcrf	TrCRF for which to delete the spanning tree port VLAN priority.
trbrf	TrBRF for which to delete the spanning tree port VLAN priority.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to restore the default spanning tree port VLAN priority for VLANs 23 to 40 on module 1 port 2:

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

clear spantree portinstancecost
show spantree mistp-instance
show spantree

clear spantree redetected-protocols

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

clear spantree redetected-protocol 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 redetected-protocol 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 redetected-protocol command, protocol detection occurs on all connected ports.

Examples

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

Console> (enable) clear spantree redetected-protocol 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 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	List of the VLANs for which to restore the spanning tree default settings; valid values are from 1 to 1005.
mistp-instance instances	Instance number; valid values are from 1 to 16.
mst instances	MST instance number; valid values are from 0 to 15.

Defaults

The default settings are shown in the following table:

Value	Default Setting
switch priority	32768
forward delay	15 seconds
hello time	2 seconds
maxage	20 seconds

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete 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 delete 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 delete 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 delete 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 delete the spanning tree statistics on a specified port or VLAN, 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 instance

Syntax Description

mod/port	Number of the module and number of the port on the module.
vlans	List of the VLAN numbers to delete.
mistp-instance instances	MST instance number; valid values are from 1 to 16.
mst instance	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 delete 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 delete 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 delete 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 delete 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 disable UplinkFast and return the spanning tree bridge priority, port priorities, and port costs to their default values, 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

This command changes spanning tree port priorities and port costs, which might affect VLAN load-balancing configurations.

Examples

This example shows how to turn off the UplinkFast feature and return the spanning tree bridge priority, port priorities, and port costs to their 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

To delete the TACACS+ authentication and encryption server key, use the clear tacacs key command.

clear tacacs key

Syntax Description

This command has no arguments or keywords.

Defaults

The key value is NULL.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete the TACACS+ server key 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 delete a host from the list of TACACS+ servers, use the clear tacacs server command.

clear tacacs server {ip_addr | all}

Syntax Description

ip_addr	IP address of the server to be deleted from the list of TACACS+ servers.
all	Deletes all hosts 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 delete a server from the list of TACACS+ servers:

Console> (enable) clear tacacs server 192.168.255.255

192.168.255.255 cleared from TACACS table

Console> (enable)

Related Commands

show tacacs

clear timezone

To return the time zone to its default, Coordinated Universal Time (UTC), use the clear timezone command.

clear timezone

Syntax Description

This command has no arguments or keywords.

Defaults

The time zone is UTC.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

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

Examples

This example shows how to delete the time zone:

Console> (enable) clear timezone

Timezone name and offset cleared.

Console> (enable)

Related Commands

set timezone

clear top

To terminate any TopN report processes that are running, use the clear top command.

clear top {all | report_num}

Syntax Description

all	Terminates all nonpending TopN results.
report_num	TopN report number to terminate; 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 reports with a done status are killed.

You can terminate TopN processes without the background option by pressing Ctrl-C in the same Telnet or console session, or by entering the clear top [report_num] command from a separate Telnet or console session. Use the show top background command to find out if the background option is used.

The prompt is not displayed before the TopN report is completely displayed. Other commands will be blocked until the report has been displayed.

Examples

These examples show how to stop the TopN process 1 from a console session or a Telnet session:

Console> (enable) clear top 1

Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by Console//

Console> (enable)

Console> (enable) clear top 1

Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by telnet/172.20.52.124//

Console> (enable)

This example shows how to stop all nonpending TopN report processes:

Console> (enable) clear top all

Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by Console//

%MGMT-5-TOPN_TERMINATE:Report 2 terminated by Console//

%MGMT-5-TOPN_TERMINATE:Report 3terminated by Console//

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 delete specific VLANs from the allowed VLAN list for a trunk port, use the clear trunk command.

clear trunk mod/ports [vlans]

Syntax Description

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

Defaults

Sets the mode to auto for ISL and IEEE 802.1Q trunk ports if a VLAN is not specified. For more information about auto and off modes, see the set trunk command.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

If you specify VLANs, those VLANs are deleted from the list of VLANs allowed on the trunk. Traffic for the deleted VLANs is not forwarded over the trunk port.

Default VLANs cannot be deleted from the allowed VLAN list on the trunk.

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

Examples

This example shows how to delete 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 delete 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

To delete an existing VLAN from a management domain, use the clear vlan command.

clear vlan vlan

Syntax Description

vlan	Number of the VLAN; valid values are from 2 to 1000.

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

---

Caution When you delete a VLAN on a switch configured as a VTP server, the VLAN is deleted from the entire VTP domain. Every switch in that VTP domain will delete the VLAN.

---

---

Caution When you delete 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 deleted VLAN is reactivated, all ports still configured on that VLAN are also reactivated.

---

When you delete 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 deleted. ACL to VLAN mappings are also deleted.

Examples

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

Console> (enable) clear vlan 4 
This command will deactivate 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 mapping

To delete existing 802.1Q VLAN to ISL VLAN mapped pairs, use the clear vlan mapping command.

clear vlan mapping dot1q {1q_vlan_num | all}

Syntax Description

dot1q	802.1Q VLAN.
1q_vlan_num	802.1Q VLAN from which to delete the mapping.
all	Deletes the mapping table of all entries.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to delete an existing mapped 802.1Q 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 delete all mapped 802.1Q 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

clear vmps rcp

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

clear vmps rcp username

Syntax Description

username

Username, which can be up to 14 characters in length.

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 delete the VMPS RCP username jdoe from the VMPS server table:

Console> (enable) clear vmps rcp jdoe

Console> (enable)

Related Commands

set rcp username
show rcp

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 delete 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 delete 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 client 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 pruning

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

clear vtp pruning vlan_num

Syntax Description

vlan_num

Number of VLANs to be made ineligible for pruning; valid values are from 1 to 1005.

Defaults

VLANs 2 to 1000 are eligible for pruning.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

VTP pruning prevents traffic in each pruning-eligible VLAN from being transmitted on a VLAN trunk if no stations belonging to that VLAN are located across that trunk. Use the set vtp command to enable VTP pruning.

Use the set vtp pruning command to make the VLANs eligible for pruning again.

Examples

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

Console> (enable) clear vtp pruning 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
show vtp statistics

clear vtp statistics

To delete the VTP statistics, use the clear vtp statistics command.

clear vtp 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 the VTP statistics:

Console> (enable) clear vtp statistics

vtp statistics cleared.

Console> (enable)

Related Commands

set vtp
show vtp statistics

configure

To download a configuration file from a host and run each command in that file, use the configure command.

configure host file [rcp]

Syntax Description

host	IP address or IP alias of the host.
file	Name of the configuration file.
rcp	(Optional) Remote copy protocol (rcp) as the file transfer method to be used.

Defaults

The file transfer method is TFTP.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

Refer to the Software Configuration Guide-Catalyst 4000 Family, 2948G, and 2980G Switches for information on how to construct a configuration file to download using the configure command.

Examples

The following is a sample configuration file. Each line contains a command, except for the lines that begin with ! or #. On some servers (NT), the TFTP directory might not be /tftpboot.

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

#

This example shows how to configure the switch using a configuration file downloaded from a TFTP server:

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.

Related Commands

copy
show config

confreg

To set the configuration register value or to modify the configuration register using the configuration register utility, use the confreg command.

confreg [hexvalue]

Syntax Description

hexvalue

(Optional) Hexadecimal value of the configuration register.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Usage Guidelines

If you specify hexvalue, the confreg command changes the configuration register value to the hexadecimal value specified.

If you do not specify hexvalue, the confreg command shows the current configuration register values and prompts you to keep or change the current values.

The new configuration register value is written into NVRAM and does not take effect until you reset or power cycle the switch.

Examples

This example shows how to use the confreg command:

rommon 1 > 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]:<Return> 

enable  "use net in IP bcast address"? y/n  [n]:<Return> 

enable  "load rom after netboot fails"? y/n  [n]:<Return>  

enable  "use all zero broadcast"? y/n  [n]:<Return> 

enable  "break/abort has effect"? y/n  [n]:<Return> 

enable  "ignore system config info"? y/n  [n]:<Return> 

change console baud rate? y/n  [n]:<Return> 

change the boot characteristics? y/n  [n]: y

enter to boot:

 0 = ROM Monitor

 1 = the boot helper image

 2-15 = boot system

    [0]: 2

Configuration Summary

enabled are:

console baud:9600

boot:image specified by the boot system commands

      or default to:cisco2-Presto

do you wish to change the configuration? y/n  [n]:<Return> 

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

rommon 2 > 

Related Commands

sync

copy

To upload or download a Flash image or a switch configuration to or from a Flash device, rcp server, or TFTP server, use the copy command.

copy file-id {config | flash | rcp | tftp}

copy config {file-id | flash | rcp| tftp} [all]

copy tftp {file-id | flash | config}

copy rcp {file-id | flash | config}

copy flash {file-id | tftp | rcp | config}

Syntax Description

file-id	File to be copied, where file-id is in the format [[m/]device:][filename]. m/ = The module where the Flash device is located (such as the standby supervisor engine, an FDDI module, or an ATM module). Module 1 is assumed if a different module is not specified. device: = The device where the file is located. Valid Flash devices are bootflash:, slot0:, and slot1:. You can also specify tftp: as the device name. The colon (:) is required after the device name. filename = The name of the system image or configuration file.
config	Copies the switch configuration file to the specified file, or specifies the file to be used to configure the switch.
flash	Copies the file to or from the Flash file system.
rcp	Copies the file to or from an rcp server.
tftp	Copies the file to or from a TFTP server.
all	(Optional) Copies the entire configuration to the specified destination configuration file. If you do not use the all keyword, only nondefault commands are copied to the destination configuration file.

Defaults

The default settings are as follows:

•Default Flash device (specified by the cd command) is used if a source or destination Flash device is not specified.

---

Note Use the pwd command to display the current default Flash device. If the destination filename is omitted, the system uses the source filename.

---

•If a system name is provided, the system stores image and configuration files in the sysname.cfg file. Otherwise, the system uses the default myswitch.cfg file.

•If a module for the file-id variable is not specified, then module 1 is assumed.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

The Catalyst 4000 family switches support only the bootflash: Flash device.

If you use the flash keyword as the copy source or destination, you are prompted for the Flash device name. If you are copying a software image to multiple intelligent switching modules of the same type, use the flash keyword as the copy destination. The switch automatically determines which modules to copy the image to based on the header in the source image file. If you want to copy a software image to a single intelligent switching module in a switch with multiple modules of the same type, you must specify the destination file-id as m/bootflash: (do not specify a filename).

Examples

This example shows how to upload the non-default switch configuration to a file named cat.cfg on the slot0: Flash device:

Console> (enable) copy config slot0:cat.cfg

Upload configuration to slot0:cat.cfg 

649324 bytes available on device slot0, proceed (y/n) [n]? y

.........

/

Configuration has been copied successfully. (10200 bytes)

Console> (enable)

This example shows how to upload both the default and non-default switch configuration to a file named lab2.cfg on a TFTP server:

Console> (enable) copy config tftp:lab2.cfg all

IP address or name of remote host [172.20.22.7]? y

Upload configuration to imgFile:lab2.cfg (y/n) [n]? y

.........

/

Configuration has been copied successfully. (10299 bytes).

Console> (enable)

This example shows how to upload the non-default switch configuration to the cat.cfg file on the slot1: Flash device:

Console> (enable) copy config flash

Flash device [bootflash]? slot1:

Name of file to copy to [configFile]? cat.cfg

Upload configuration to slot1:cat.cfg 

749124 bytes available on device slot1, proceed (y/n) [n]? y

.........

/

Configuration has been copied successfully. (200345 bytes).

Console> (enable)

This example shows how to upload an image from a remote host into Flash using rcp:

Console> (enable) copy rcp flash

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? cat5000-sup3.4-2-1.bin

Flash device [bootflash]?

Name of file to copy to [cat5000-sup3.4-2-1.bin]?

4369664 bytes available on device bootflash, proceed (y/n) [n]? y

CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC

File has been copied successfully.

Console> (enable) 

This example shows how to upload the running configuration on a Catalyst 4000 family, Catalyst 2948G, or Catalyst 2980G switch to an rcp server for storage:

Console> (enable) copy config rcp

IP address or name of remote host []? 172.20.52.3

Name of file to copy to []? cat5000_config.cfg

Upload configuration to rcp:cat5000_config.cfg, (y/n) [n]? y

.....

/

Configuration has been copied successfully.

Console> (enable)

This example shows how to configure a switch using a configuration file downloaded from an rcp server:

Console> (enable) copy rcp config

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? dns-config.cfg

Configure using rcp:dns-config.cfg (y/n) [n]? y

/

Finished network download.  (134 bytes)

>>

>> set ip dns server 172.16.10.70 primary

172.16.10.70 added to DNS server table as primary server.

>> set ip dns server 172.16.10.140

172.16.10.140 added to DNS server table as backup server.

>> set ip dns enable

DNS is enabled

>> set ip dns domain corp.com

Default DNS domain name set to corp.com

Console> (enable)

This example shows how to configure the switch using a configuration file on a Flash device:

Console> (enable) copy flash config

Flash device [bootflash]? 

Name of configuration file? test.cfg

Configure using bootflash:test.cfg (y/n) [n]? y

/

Finished download. (10900 bytes)

>> set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set prompt Console>

>> set length 24 default

Screen length set to 24.

>> set logout 20

.....

Console> (enable)

This example shows how to copy a file from a TFTP server to a Flash device:

Console> (enable) copy tftp bootflash:

Address or name of remote host [172.20.22.7]?

Enter source file name [cat4000-sup.4-5-1.bin]?

Enter destination file name [cat4000-sup.4-5-1.bin]?

6942528 bytes available in flash, proceed (y/n) [n]? y

Console> (enable)

Related Commands

configure
write