Rommon Commands

ROM Monitor CommandsC H A P T E R 5

ROM Monitor CommandsThis chapter provides detailed descriptions of some of the ROM monitor commands used to load andcopy system images, microcode images, and configuration files. System images contain the systemsoftware. Microcode images contain microcode to be downloaded to various hardware devices.Configuration files 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 chapter5-1

alias

aliasUse the alias command to set and display aliases.

alias [name=value]

Syntax Description

DefaultThis command has no default settings.

Command TypeROM monitor command.

Command ModeNormal.

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

name Name you give to the alias.

value Value of the alias.Catalyst 5000 Series Command Reference5-2

alias

ExampleThis example shows how to use the alias command:

rommon 1 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stackrommon 2 > alias s=setrommon 3 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stacks=setrommon 4 > sPS1=rommon ! >BOOT=bootflash:RTSYNC_llue_11,1;slot0:f1,1;=========================================================================

Related Commandunalias ROM Monitor Commands 5-3

boot

bootUse the boot command to boot up an external process.

boot [-xv] [device][imagename]

Syntax Description

DefaultThis command has no defaults.


Command ModeNormal.

Usage GuidelineWith no arguments, boot will boot the first image in Flash. An image may be specified by typing itsname. The device can be specified 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 IDon to the boot helper image.

ExampleThis example shows how to use the boot command:

rommon> boot -x bootflash:cat5000-sup3.3-1-180.binCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCUncompressing file:#####################################################################################################################################################################################################################################################################

-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.Catalyst 5000 Series Command Reference5-4

boot

############################################################################################################################################################################################################################rommon 11 > boot -v bootflash:cat5000-sup3.3-1-180.binrommon 1 > boot -v bootflash:164boot: bootstring is: "bootflash:164"loading section to address 0x80008000 from file position 0x16c, size is 0xa090loading section to address 0x800120a8 from file position 0xa214, size is 0x2678loading section to address 0x80014720 from file position 0xc88c, size is 0x40open(): Open Error = -9loadprog: error - on file openboot: cannot load "bootflash:164"rommon 2 > dir bootflash: File size Checksum File name 1973032 bytes (0x1e1b28) 0xdadf5e24 lluerommon 3 > b -v bootflash:llueboot: bootstring is: "bootflash:llue"loading section to address 0x80008000 from file position 0x16c, size is 0xa090loading section to address 0x800120a8 from file position 0xa214, size is 0x2678loading section to address 0x80014720 from file position 0xc88c, size is 0x40CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCloading section to address0x80010000 from file position 0x16c, size is 0x970loading section to address 0x80010988 from file position 0xaf4, size is 0x158loading section to address 0x80010ae0 from file position 0xc4c, size is 0x10Uncompressing file:#################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################loading section to address 0x80020000 from file position 0x10000, size is 0x315420loading section to address 0x80335438 from file position 0x325438, size is 0x8e778loading section to address 0x803c3bb0 from file position 0x3b3bb0, size is 0x32bf0loading section to address 0x803f67a0 from file position 0x3e67a0, size is 0x10System Power On DiagnosticsNVRAM Size .. .................512KBID Prom Test ..................PassedDPRAM Size ....................16KBDPRAM Data 0x55 Test ..........PassedDPRAM Data 0xaa Test ..........PassedDPRAM Address Test ............PassedClearing DPRAM ................DoneSystem DRAM Memory Size .......16MBDRAM Data 0x55 Test ...........PassedDRAM Data 0xaa Test ...........PassedDRAM Address Test ............PassedClearing DRAM .................DoneEARL++ ........................PresentEARL RAM Test .................PassedEARL Serial Prom Test .........PassedLevel2 Cache ..................PresentLevel2 Cache test..............PassedBoot image: bootflash:llueCisco Systems Console

12/8/1997,23:11:59:SYS-5:Module 1 is onlineEnter password:

Console> ROM Monitor Commands 5-5

confreg

confregUse the confreg command to configure the configuration register utility.

confreg [num]

Syntax Description



Command ModeNormal.

Usage GuidelinesExecuted with the argument num, confreg will change the Virtual Configuration Register to matchthe number specified.

Without the argument, confreg will dump the contents of the VCR in plain English and allow theuser to alter the contents.

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

You must issue a sync command or the change is not saved and a reset will remove your change.

num (Optional) Valid values are 0 = ROM Monitor, 1 = the boot helperimage, 2-15 = boot system.Catalyst 5000 Series Command Reference5-6

confreg

ExampleThis example shows how to use the confreg command:

rommon 7 > confreg

Configuration Summaryenabled are:console baud: 9600boot: the ROM Monitor

do you wish to change the configuration? y/n [n]: yenable diagnostic mode? y/n [n]: yenable 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]: yenter rate: 0 = 9600, 1 = 4800, 2 = 1200, 3 = 2400 4 = 19200, 5 = 38400, 6 = 57600, 7 = 115200 [0]: 0change the boot characteristics? y/n [n]: yenter to boot: 0 = ROM Monitor 1 = the boot helper image 2-15 = boot system [0]: 0

Configuration Summaryenabled are:diagnostic modeconsole baud: 9600boot: 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

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

dev



Command ModeNormal.

ExampleThis example shows how to use the dev command:

rommon 10 > devDevices in device table: id name flash: flash slot0: PCMCIA slot 0 slot1: PCMCIA slot 1 eprom: epromCatalyst 5000 Series Command Reference5-8

dir

dirUse the dir command to list the files of the named device.

dir device

Syntax Description



Command ModeNormal.

ExampleThis example shows how to use the dir command:

rommon 11 > dir flash: File size Checksum File name 65 bytes (0x41) 0xb49d clev/oddfile65 2229799 bytes (0x220627) 0x469e clev/sierra-k.Z

device ID of the device. ROM Monitor Commands 5-9

history

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

history



Command ModeNormal.

ExampleThis example shows how to use the history command:

rommon 13 > history

1 help2 break -s 0x200903 break -s 100904 break -s 0xa00010005 cont6 help7 dev8 dir9 dir bootflash:10 dis11 dis 0xa000100012 dis 0xbe00000013 history=============================================================================Catalyst 5000 Series Command Reference5-10

meminfo

meminfoUse this command to display information about the main memory, packet memory, and NVRAM.With the -l option, the supported DRAM configurations are displayed.

meminfo [-l]

Syntax Description



Command ModeNormal.

Usage GuidelineDo 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.

ExampleThis 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 16328KBIO (packet) memory size: 25 percent of main memory.NVRAM size: 32KB

-l (Optional) Long listingdisplays DRAM configurations. ROM Monitor Commands 5-11

meminfo

On a Cisco 3640, meminfo -l will display the following tables. The size of the SIMM indicated isits total size. The -DUAL attached to the size indicates that the SIMM is a dual-bank SIMM. Forexample, 8M indicates that the SIMM is a single bank with a total size of 8 MB. 8M-DUALindicates 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-DUAL16M 16M16M 16M 4M 4M16M 16M 8M 8M16M 16M 8M-DUAL 8M-DUAL16M 16M 16M 16M32M-DUAL 32M-DUAL32M-DUAL 32M-DUAL 4M 4M32M-DUAL 32M-DUAL 8M 8M32M-DUAL 32M-DUAL 8M-DUAL 8M-DUAL32M-DUAL 32M-DUAL 16M 16M32M-DUAL 32M-DUAL 32M-DUAL 32M-DUAL

Supported 32 bit configurations:


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 4M16M16M 4M16M 8M16M 16M 4M16M 16M 8M16M 16M 16M16M 16M 4M 8M16M 16M 4M 16M16M 16M 8M 4M16M 16M 8M 16M16M 16M 16M 4M16M 16M 16M 8MCatalyst 5000 Series Command Reference5-12

meminfo

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

Supported memory configurations:


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 8M16M16M 4M16M 8M16M 16M16M 16M 4M16M 16M 8M16M 16M 16M16M 16M 4M 4M16M 16M 4M 8M16M 16M 4M 16M16M 16M 8M 4M16M 16M 8M 8M16M 16M 8M 16M16M 16M 16M 4M16M 16M 16M 8M16M 16M 16M 16M ROM Monitor Commands 5-13

repeat

repeatUse the repeat command to repeat a command.

repeat [number | string]

Syntax Description

DefaultIf no argument is specified, the last command is repeated.


Command ModeNormal.

Usage GuidelinesThe optional command number (from the history list) or match string specifies which command torepeat.

In the case of the match string, the most recent command to begin with the specified string will bere-executed.

If the string contains white space it must be quoted.

This command is usually aliased to the letter r.

number Number of the command.

string Command string.Catalyst 5000 Series Command Reference5-14

repeat

ExampleThis example shows how to use the repeat command:

rommon 22 > history

8 dir9 dir bootflash:10 dis11 dis 0xa000100012 dis 0xbe00000013 history14 meminfo15 meminfo -l16 meminfo17 meminfo -l18 meninfo19 meminfo20 meminfo -l21 meminfo -l22 historyrommon 23 > repeat dirdir bootflash: File size Checksum File name 1973032 bytes (0x1e1b28) 0xdadf5e24 lluerommon 24 > repeatdir bootflash: File size Checksum File name 1973032 bytes (0x1e1b28) 0xdadf5e24 lluerommon 25 > repeat 15meminfo -l

Main memory size: 16 MB.Packet memory size: 0 MBMain memory size: 0x1000000Available main memory starts at 0xa000e000, size 0xff2000NVRAM size: 0x20000

Parity Map for the DRAM BanksSocket 0 in Bank 0 Has No ParitySocket 1 in Bank 0 Has No ParitySocket 0 in Bank 1 Has No ParitySocket 1 in Bank 1 Has No Parity========================================================================== ROM Monitor Commands 5-15

reset

resetUse the reset command to soft reset the switch.

reset {mod_num | system}

Syntax Description

DefaultThe default Flash device is slot0.


Command ModeNormal.

ExampleThis 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 >===========================================================================

mod_num Number of the module to be reset.

system Keyword to reset the entire switch.Catalyst 5000 Series Command Reference5-16

set

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

set

DefaultThis command has no default.


Command ModeNormal.

ExampleThis example shows how to use the set command:

rommon 2 > setPS1=rommon ! >BOOT=?=0

Related Commandvarname ROM Monitor Commands 5-17

sync

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

sync



Command ModeNormal.

ExampleThis example shows how to use the sync command:

rommon> syncCatalyst 5000 Series Command Reference5-18

unalias

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

unalias name

Syntax Description


Command ModeNormal.

ExampleThis example shows how to use the unalias command:

rommon 5 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stacks=setrommon 6 > unalias srommon 7 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stackrmmon 8 > smonitor: command "s" not found===========================================================================

Related Commandalias

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

varname=value

name Name of the alias. ROM Monitor Commands 5-19

varname

Syntax Description



Command ModeNormal.

ExampleThis example shows how to assign a variable name to a value:

rommon> s=setrommon> s

PS1=rommon ! >BOOT=?=0

varname Name of the variable.

value Any ROM monitor command.Catalyst 5000 Series Command Reference5-20

Rommon Commands

Documents

Transcript of Rommon Commands