C H A P TER

ROM Monitor Commands

This chapter provides detailed descriptions of some of the ROM monitor commands used to load and copy system images, microcode images, and conguration les. System images contain the system software. Microcode images contain microcode to be downloaded to various hardware devices. Conguration les contain commands entered to customize the function of the Cisco IOS software. Other commands are described elsewhere in this publication: Switch CLI:

General commands are described in the General Switch Commands chapter Flash commands are described in the Switch Flash Commands chapter clear commands are described in the Switch clear Commands chapter set commands are described in the Switch set Commands chapter show commands are described in the Switch show Commands chapter

ATM module CLI: General commands are described in the General ATM Commands chapter show commands are described in the ATM show Commands chapter

ROM Monitor Commands 5-1

alias

alias
Use the alias command to set and display aliases. alias [name=value]

Syntax Description
name

Name you give to the alias. Value of the alias.

value

Default
This command has no default settings.

Command Type
ROM monitor command.

Command Mode
Normal.

Usage Guidelines
If value contains white space or other special (shell) characters, it must be quoted. If value has a space as its last character, the next command line word is also checked for an alias (normally only the rst word on a command line is checked). Without an argument, this command will print a list of all aliased names with their values.

5-2

Catalyst 5000 Series Command Reference

alias

Example
This example shows how to use the alias 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

ROM Monitor Commands 5-3

boot

boot
Use the boot command to boot up an external process. boot [-xv] [device][imagename]

Syntax Description
-x -v device imagename (Optional) Load the image but do not execute. (Optional) Toggle verbose mode. (Optional) ID of the device. (Optional) Name of the image.

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Usage Guideline
With no arguments, boot will boot the rst image in Flash. An image may be specied by typing its name. The device can be specied by typing the device ID. If no device is given with an imagename the image will be net booted. If a device name is not recognized by the monitor it will assume netbooting and pass the device ID on to the boot helper image.

Example
This example shows how to use the boot command:
rommon> boot -x bootflash:cat5000-sup3.3-1-180.bin CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC Uncompressing file: ####################################################################################### ####################################################################################### #######################################################################################

5-4

Catalyst 5000 Series Command Reference

boot

####################################################################################### ####################################################################################### ############################################## rommon 11 > boot -v bootflash:cat5000-sup3.3-1-180.bin rommon 1 > boot -v bootflash:164 boot: bootstring is: "bootflash:164" loading section to address 0x80008000 from file position 0x16c, size is 0xa090 loading section to address 0x800120a8 from file position 0xa214, size is 0x2678 loading section to address 0x80014720 from file position 0xc88c, size is 0x40 open(): Open Error = -9 loadprog: error - on file open boot: cannot load "bootflash:164" rommon 2 > dir bootflash: File size Checksum File name 1973032 bytes (0x1e1b28) 0xdadf5e24 llue rommon 3 > b -v bootflash:llue boot: bootstring is: "bootflash:llue" loading section to address 0x80008000 from file position 0x16c, size is 0xa090 loading section to address 0x800120a8 from file position 0xa214, size is 0x2678 loading section to address 0x80014720 from file position 0xc88c, size is 0x40 CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCloading section to address 0x80010000 from file position 0x16c, size is 0x970 loading section to address 0x80010988 from file position 0xaf4, size is 0x158 loading section to address 0x80010ae0 from file position 0xc4c, size is 0x10 Uncompressing file: ####################################################################################### ####################################################################################### ####################################################################################### ####################################################################################### ####################################################################################### ############################################## loading section to address 0x80020000 from file position 0x10000, size is 0x315420 loading section to address 0x80335438 from file position 0x325438, size is 0x8e778 loading section to address 0x803c3bb0 from file position 0x3b3bb0, size is 0x32bf0 loading section to address 0x803f67a0 from file position 0x3e67a0, size is 0x10 System Power On Diagnostics NVRAM Size .. .................512KB ID Prom Test ..................Passed DPRAM Size ....................16KB DPRAM Data 0x55 Test ..........Passed DPRAM Data 0xaa Test ..........Passed DPRAM Address Test ............Passed Clearing DPRAM ................Done System DRAM Memory Size .......16MB DRAM Data 0x55 Test ...........Passed DRAM Data 0xaa Test ...........Passed DRAM Address Test ............Passed Clearing DRAM .................Done EARL++ ........................Present EARL RAM Test .................Passed EARL Serial Prom Test .........Passed Level2 Cache ..................Present Level2 Cache test..............Passed Boot image: bootflash:llue Cisco Systems Console

12/8/1997,23:11:59:SYS-5:Module 1 is online Enter password: Console>

ROM Monitor Commands 5-5

confreg

confreg
Use the confreg command to congure the conguration register utility. confreg [num]

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

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Usage Guidelines
Executed with the argument num, confreg will change the Virtual Conguration Register to match the number specied. Without the argument, confreg will dump the contents of the VCR in plain English and allow the user to alter the contents. You are prompted to change or keep the information held in each bit of the VCR. In either case, the new VCR value is written into NVRAM and does not take effect until you reset or power cycle the platform. You must issue a sync command or the change is not saved and a reset will remove your change.

5-6

Catalyst 5000 Series Command Reference

confreg

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

[0]: 0

Configuration Summary enabled are: diagnostic mode console baud: 9600 boot: the ROM Monitor do you wish to change the configuration? y/n [n]:

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

ROM Monitor Commands 5-7

dev

dev
Use the dev command to list the device IDs available on a platform. dev

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to use the dev command:
rommon 10 > dev Devices in device table: id name flash: flash slot0: PCMCIA slot 0 slot1: PCMCIA slot 1 eprom: eprom

5-8

Catalyst 5000 Series Command Reference

dir

dir
Use the dir command to list the les of the named device. dir device

Syntax Description
device ID of the device.

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to use the dir command:
rommon 11 > dir flash: File size 65 bytes (0x41) 2229799 bytes (0x220627) Checksum 0xb49d 0x469e File name clev/oddfile65 clev/sierra-k.Z

ROM Monitor Commands 5-9

history

history
Use this command to display the command history (the last 16 commands executed in the monitor environment). This command is aliased to h by the monitor for convenience. history

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to use the history command:
rommon 13 > history 1 help 2 break -s 0x20090 3 break -s 10090 4 break -s 0xa0001000 5 cont 6 help 7 dev 8 dir 9 dir bootflash: 10 dis 11 dis 0xa0001000 12 dis 0xbe000000 13 history =============================================================================

5-10

Catalyst 5000 Series Command Reference

meminfo

meminfo
Use this command to display information about the main memory, packet memory, and NVRAM. With the -l option, the supported DRAM congurations are displayed. meminfo [-l]

Syntax Description
-l

(Optional) Long listingdisplays DRAM congurations.

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Usage Guideline
Do not place white space around the equal sign. If there is white space in varvalue, it must be quoted. We recommend that variable names are spelled with all uppercase letters to make them conspicuous.

Example
This example shows how to use the meminfo command:
rommon 9 > meminfo Main memory size: 16 MB in 32 bit mode. Available main memory starts at 0xa000e000, size 16328KB IO (packet) memory size: 25 percent of main memory. NVRAM size: 32KB

ROM Monitor Commands 5-11

meminfo

On a Cisco 3640, meminfo -l will display the following tables. The size of the SIMM indicated is its total size. The -DUAL attached to the size indicates that the SIMM is a dual-bank SIMM. For example, 8M indicates that the SIMM is a single bank with a total size of 8 MB. 8M-DUAL indicates that the SIMM is dual bank with a total size of 8 MB (4MB on each bank).
rommon 10 > meminfo -l Supported 64 bit configurations: SIMM 0 SIMM 1 SIMM 2 SIMM 3 -------------------------------------4M 4M 4M 4M 8M 8M 8M-DUAL 8M-DUAL 8M 8M 4M 4M 8M-DUAL 8M-DUAL 4M 4M 8M 8M 8M 8M 8M 8M 8M-DUAL 8M-DUAL 8M-DUAL 8M-DUAL 8M 8M 8M-DUAL 8M-DUAL 8M-DUAL 8M-DUAL 16M 16M 16M 16M 4M 4M 16M 16M 8M 8M 16M 16M 8M-DUAL 8M-DUAL 16M 16M 16M 16M 32M-DUAL 32M-DUAL 32M-DUAL 32M-DUAL 4M 4M 32M-DUAL 32M-DUAL 8M 8M 32M-DUAL 32M-DUAL 8M-DUAL 8M-DUAL 32M-DUAL 32M-DUAL 16M 16M 32M-DUAL 32M-DUAL 32M-DUAL 32M-DUAL Supported 32 bit configurations: SIMM 0 SIMM 1 SIMM 2 SIMM 3 -------------------------------------4M 4M 4M 4M 8M 4M 16M 4M 4M 4M 4M 4M 8M 8M 8M 4M 8M 16M 8M 8M 4M 8M 8M 8M 8M 8M 16M 8M 8M 4M 8M 8M 8M 8M 4M 16M 16M 4M 16M 8M 16M 16M 4M 16M 16M 8M 16M 16M 16M 16M 16M 4M 8M 16M 16M 4M 16M 16M 16M 8M 4M 16M 16M 8M 16M 16M 16M 16M 4M 16M 16M 16M 8M

5-12

Catalyst 5000 Series Command Reference

meminfo

On a Cisco 3620, meminfo -l will display the following table:

rommon 10 > meminfo -l Supported memory configurations: SIMM 0 SIMM 1 SIMM 2 SIMM 3 -------------------------------------4M 4M 4M 4M 8M 4M 16M 4M 4M 4M 4M 4M 8M 4M 4M 4M 4M 8M 8M 4M 8M 8M 8M 16M 8M 8M 4M 8M 8M 8M 8M 8M 16M 8M 8M 4M 4M 8M 8M 4M 8M 8M 8M 8M 4M 8M 8M 8M 8M 16M 16M 4M 16M 8M 16M 16M 16M 16M 4M 16M 16M 8M 16M 16M 16M 16M 16M 4M 4M 16M 16M 4M 8M 16M 16M 4M 16M 16M 16M 8M 4M 16M 16M 8M 8M 16M 16M 8M 16M 16M 16M 16M 4M 16M 16M 16M 8M 16M 16M 16M 16M

ROM Monitor Commands 5-13

repeat

repeat
Use the repeat command to repeat a command. repeat [number | string]

Syntax Description
number string Number of the command. Command string.

Default
If no argument is specied, the last command is repeated.

Command Type
ROM monitor command.

Command Mode
Normal.

Usage Guidelines
The optional command number (from the history list) or match string species which command to repeat. In the case of the match string, the most recent command to begin with the specied string will be re-executed. If the string contains white space it must be quoted. This command is usually aliased to the letter r.

5-14

Catalyst 5000 Series Command Reference

repeat

Example
This example shows how to use the repeat command:
rommon 22 > history 8 dir 9 dir bootflash: 10 dis 11 dis 0xa0001000 12 dis 0xbe000000 13 history 14 meminfo 15 meminfo -l 16 meminfo 17 meminfo -l 18 meninfo 19 meminfo 20 meminfo -l 21 meminfo -l 22 history rommon 23 > repeat dir dir bootflash: File size 1973032 bytes (0x1e1b28) rommon 24 > repeat dir bootflash: File size 1973032 bytes (0x1e1b28) rommon 25 > repeat 15 meminfo -l

Checksum File name 0xdadf5e24 llue

Checksum File name 0xdadf5e24 llue

Main memory size: 16 MB. Packet memory size: 0 MB Main memory size: 0x1000000 Available main memory starts at 0xa000e000, size 0xff2000 NVRAM size: 0x20000 Parity Map for the DRAM Banks Socket 0 in Bank 0 Has No Parity Socket 1 in Bank 0 Has No Parity Socket 0 in Bank 1 Has No Parity Socket 1 in Bank 1 Has No Parity ==========================================================================

ROM Monitor Commands 5-15

reset

reset
Use the reset command to soft reset the switch. reset {mod_num | system}

Syntax Description
mod_num system Number of the module to be reset. Keyword to reset the entire switch.

Default
The default Flash device is slot0.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to use the reset command:
rommon 26 > reset System Bootstrap, Version 3.1(1.69) Copyright (c) 1994-1997 by cisco Systems, Inc. Supervisor III processor with 16384 Kbytes of main memory rommon 1 > ===========================================================================

5-16

Catalyst 5000 Series Command Reference

set

set
Use the set command to display all of the monitor variable names with their values, or to set a monitor variable. set

Default
This command has no default.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to use the set command:
rommon 2 > set PS1=rommon ! > BOOT= ?=0

Related Command
varname

ROM Monitor Commands 5-17

sync

sync
Use the sync command to write the working in-core copy of environment variables and aliases out to NVRAM so they are read on the next reset. sync

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to use the sync command:
rommon> sync

5-18

Catalyst 5000 Series Command Reference

unalias

unalias
Use the unalias command to remove the alias name and associated value from the alias list. unalias name

Syntax Description
name Name of the alias.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to use the unalias command:
rommon 5 > alias r=repeat h=history ?=help b=boot ls=dir i=reset k=stack s=set rommon 6 > unalias s rommon 7 > alias r=repeat h=history ?=help b=boot ls=dir i=reset k=stack rmmon 8 > s monitor: command "s" not found ===========================================================================

Related Command
alias

varname
Use this syntax to assign a variable name to a value. Note that the syntax varname= sets the variable to a NULL string. varname=value

ROM Monitor Commands 5-19

varname

Syntax Description
varname value Name of the variable. Any ROM monitor command.

Default
This command has no defaults.

Command Type
ROM monitor command.

Command Mode
Normal.

Example
This example shows how to assign a variable name to a value:
rommon> s=set rommon> s PS1=rommon ! > BOOT= ?=0

5-20

Catalyst 5000 Series Command Reference