cc/td/doc/product/lan/cat5000/rel_5_2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Catalyst 5000 Family, 4000 Family, 2926G Series, and 2948G Switch and ROM Monitor Commands

Catalyst 5000 Family, 4000 Family, 2926G Series, and 2948G Switch and ROM Monitor Commands

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

alias

Use the alias command to set and display aliases.

alias [name=value]

Syntax Description

name=

(Optional) Name you give to the alias.

value

(Optional) Value of the alias.

Default

This command has no default settings.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

ROM monitor command.

Command Mode

Normal.

Usage Guidelines

If value contains white space or other special (shell) characters, you must use 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 aliased names with their values.

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

Example

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
ls=dir
i=reset
k=stack
rommon 2 > alias s=set
rommon 3 > alias
r=repeat
h=history
?=help
b=boot
ls=dir
i=reset
k=stack
s=set
rommon 4 > s 
PS1=rommon ! > 
BOOT=bootflash:RTSYNC_llue_11,1;slot0:f1,1;
=========================================================================
Related Command

unalias

boot

Use the boot command to boot up an external process.

boot [-xv] [device][imagename]

Syntax Description

-x

(Optional) Load the image but do not execute.

-v

(Optional) Toggle verbose mode.

device

(Optional) ID of the device.

imagename

(Optional) Name of the image.

Default

This command has no default setting.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

ROM monitor command.

Command Mode

Normal.

Usage Guidelines

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

You must specify a device name.

Example

This example shows how to use the boot command:

rommon> boot -x bootflash:cat5000-sup3.5-1-0-59.bin
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
Uncompressing file:  ####################################################################################################################################################################################################################################################################

cd

Use the cd command to set the default Flash device for the system.

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

Default

The default Flash device is bootflash.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

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

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

In the Catalyst 5000 family switches, this command is supported on the Supervisor Engine III and III F.

Example

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

Console> (enable) cd bootflash:
Console> (enable)
Related Command

pwd

clear alias

Use the clear alias command to clear the shorthand versions of commands.

clear alias {name | all}

Syntax Description

name

Alternate identifier of the command.

all

Keyword that identifies every alternate identifier previously created.

Default

This command has no default setting.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Examples

This example shows how to erase the arpdel alias:

Console> (enable) clear alias arpdel
Command alias deleted.
Console> (enable)
 

This example shows how to erase all the aliases:

Console> (enable) clear alias all
Command alias table cleared. (1)
Console> (enable)
 

(1) indicates the number of entries cleared.

Related Commands

set alias
show alias

clear arp

Use the clear arp command to delete a specific entry or all entries from the ARP table.

clear arp {ip_addr | all}

Syntax Description

ip_addr

Specific IP address in the ARP table to be cleared. An IP alias or host name that can be resolved through the DNS can be specified instead of an IP address.

all

Keyword that specifies every IP address in the ARP table.

Default

This command has no default setting.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Examples

This example shows how to remove IP address 198.133.219.209 from the ARP table:

Console> (enable) clear arp 198.133.219.209
ARP entry deleted.
Console> (enable)
 

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

Console> (enable) clear arp all
ARP table cleared. (1)
Console> (enable)
 

(1) indicates the number of entries cleared.

Related Commands

set arp
show arp

clear banner motd

Use the clear banner motd command to clear the message-of-the-day banner.

clear banner motd

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can use either the clear banner motd command or the set banner motd ## command to clear the message-of-the-day banner.

Example

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

Console> (enable) clear banner motd
MOTD banner cleared
Console> (enable)
Related Command

set banner motd

clear boot

Use the clear boot command to clear the contents of the BOOT environment variable and the configuration register setting.

clear boot system all [mod]
clear boot system flash device:[filename] [mod]
clear boot auto-config [mod]

Syntax Description

all

Keyword to specify clearing the whole BOOT environment variable.

mod

(Optional) Module number of the supervisor engine on which to clear the BOOT environment variable.

flash

Keyword to specify the Flash file system.

device:

(Optional) Valid devices include bootflash, slot0, and slot1 for Catalyst 5000 family and 2926G series switches and bootflash for the Catalyst 4000 family and 2948G switches.

filename

(Optional) Filename of the system image on the Flash device.

auto-config

Keyword to specify the auto-config file.

Default

This command has no default setting.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

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

In the Catalyst 5000 family switches, this command is supported on the Supervisor Engine III and III F.

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 clear the auto-config file:

Console> (enable) clear boot auto-config
CONFIG_FILE variable =
Console> (enable)
Related Command
show boot

hometocprevnextglossaryfeedbacksearchhelp
Posted: Tue Oct 5 10:57:03 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.