Table Of Contents
del
delete
dir—ROM monitor
dir—switch
disable
disconnect
download
enable
format
help—ROM monitor
history—ROM monitor
history—switch
l2trace
meminfo
ping—ROM monitor
ping—switch
pwd
quit
reconfirm vmps
repeat
reset—ROM monitor
reset—switch
session
del
Use the del command to delete files.
del device:filename
Syntax Description
device:
|
Variable that specifies the name of the device.
|
filename
|
Variable that specifies the name of the system image or configuration file.
|
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The Catalyst 4000 family, 2948G, and 2980G switches support only the bootflash: Flash device.
A file cannot be undeleted if a valid file with the same name exists. In this case, you must delete the existing one first and then undelete the other file. A file can be deleted or undeleted up to 15 times. To permanently delete all deleted files on a device, use the squeeze command. You need to use the squeeze command to reclaim the space used by the deleted file.
Examples
This example shows how to delete a file:
rommon 1 > del bootflash:cat4000.6-1-1.bin
Related Commands
squeeze—ROM monitor
undelete—ROM monitor
delete
Use the delete command to delete a file on a Flash device.
delete [file-id]
Syntax Description
file-id
|
Variable that specifies the file to delete, 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 no module is specified.
device: = Device where the file is located. Valid Flash devices are bootflash:, slot0:, and slot1:. The colon (:) is required after the device name.
filename = Name of the system image or configuration file.
|
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The Catalyst 4000 family, 2948G, and 2980G switches support only the bootflash: Flash device:
Use the undelete (switch) command to recover a deleted file.
A file cannot be undeleted if a valid file with the same name exists. Instead, you must delete the existing one first and then undelete the desired file. A file can be deleted or undeleted up to 15 times. To permanently delete all deleted files on a device, use the squeeze (switch) command.
Examples
This example shows how to delete a file from a Flash device:
Console> (enable) delete bootflash:switch_config.cfg
Related Commands
dir—switch
show flash
squeeze—switch
undelete—switch
dir—ROM monitor
Use the dir command to list the files on a Flash device.
dir device
Syntax Description
device
|
Variable that specifies the name of the Flash device.
|
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to list the files on a Flash device:
rommon 1 > dir bootflash:
File size Checksum File name
14086 bytes (0x3706) 0xa6a84c93 switch_config.cfg (deleted)
5415 bytes (0x1527) 0x53bbccda 5509_config.cfg
446464 bytes (0x6d000) 0x8503219d cat5000-sup3.5-1-1.bin (deleted)
4231861 bytes (0x4092b5) 0x1d6092f4 cat5000-sup3.5-2-1.bin
dir—switch
Use the dir command to display a list of files on a Flash device.
dir file-id [all | deleted | long]
Syntax Description
file-id
|
Variable that specifies the file on which to perform the copy action, where file-id is of 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 no module is specified.
device: = 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 = Name of the system image or configuration file.
|
all
|
(Optional) Keyword that displays all files on the device, including deleted files.
|
deleted
|
(Optional) Keyword that displays only deleted files.
|
long
|
(Optional) Keyword that displays files that have not been deleted.
|
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal and privileged.
Usage Guidelines
When you use one of the keywords, the system displays file information in long format.
When you omit all keywords, the system displays file information in short format.
Table 2-3 explains the short format output.
Table 2-3 Short Format File Information
Column Heading
|
Description
|
#
|
File index number
|
length
|
File length
|
date/time
|
Date and time the file was created
|
name
|
Filename
|
Table 2-4 explains the long format output.
Table 2-4 Long Format File Information
Column Heading
|
Description
|
#
|
File index number
|
ED
|
Letter to indicate whether the file contains an error (E) or is deleted (D)
|
type
|
File type (1 = configuration file, 2 = image file); when the file type is unknown, the system displays a zero or FFFFFFFF in this field
|
crc
|
File cyclic redundancy check
|
seek
|
Offset into the file system of the next file
|
nlen
|
Filename length
|
length
|
File length
|
date/time
|
Date and time the file was created
|
name
|
Filename
|
Examples
This example shows how to display the file information in short format:
-#- -length- -----date/time------ name
2 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin
3 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin
21040 bytes available (11382224 bytes used)
This example shows how to display the file information in long format:
Console> (enable) dir long
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
2 .. ffffffff d69fff2c 781794 25 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin
3 .. ffffffff d3b83f6b b1add0 25 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin
21040 bytes available (11382224 bytes used)
This example shows the file with index number 1 deleted:
Console> (enable) dir all
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
1 .D ffffffff 9be31a86 3eb168 28 3846376 Jun 14 2000 14:13:10 cat4000-k4.6-1-0-104-ORL.bin
2 .. ffffffff d69fff2c 781794 25 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin
3 .. ffffffff d3b83f6b b1add0 25 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin
21040 bytes available (11382224 bytes used)
Related Commands
show flash
disable
Use the disable command to return to normal mode from privileged mode.
disable
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 to normal mode:
Console> (enable) disable
Related Commands
enable
disconnect
Use the disconnect command to close an active console port or Telnet session.
disconnect {ip_addr | console}
Syntax Description
ip_addr
|
Variable that specifies the source IP address or IP alias of the session to disconnect; in dot notation, for example, 101.102.103.104.
|
console
|
Keyword that deletes an active session on the console port.
|
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If multiple sessions from the same IP address exist, the system checks if the current session originated from the specified IP address. If the session did not originate from the specified IP address, all Telnet sessions from the address are disconnected. If the session does originate from the specified address, all sessions, other than the current session, are disconnected. The system prompts whether to disconnect the current Telnet session. Enter n to remain connected or enter y to be disconnected.
Examples
This example shows how to close a Telnet session to host 192.168.255.255 (the 1 in parenthesis indicates the number of active sessions disconnected):
Console> (enable) disconnect 192.168.255.255
Telnet session from 192.168.255.255 disconnected. (1)
This example shows how to close the current console session:
Console> (enable) disconnect console
Console session disconnected.
Related Commands
telnet
download
Use the download command to copy a software image from a specified host to the Flash memory of the supervisor engine or a designated module.
download host file [mod_num] [rcp]
download serial [mod_num]
Syntax Description
host
|
Variable that specifies the name or IP address of the host.
|
file
|
Variable that specifies the name of the file to be downloaded.
|
mod_num
|
(Optional) Variable that specifies the number of the module to receive the downloaded image.
|
rcp
|
(Optional) Keyword that copies the image from a specified host to Flash memory using rcp.
|
serial
|
Keyword that downloads the image through the serial (console) port.
|
Defaults
If a module number is not specified, the image is downloaded to all modules for which the image
is valid.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The Catalyst 4000 family switches download new code to the processors using Kermit serial download through the EIA/TIA-232 console port.
The download command downloads code to the Flash memory. Catalyst 4000 family switch software rejects an image if it is not a valid image for the module.
The download serial command uses Kermit through the serial EIA/TIA-232 console port. The download serial command is not allowed from a Telnet session.
Caution 
After starting the serial download using Kermit, do not attempt to abort the serial download by pressing
Ctrl-C. Pressing
Ctrl-C interrupts the download process and might leave the switch in a problematic state. If this occurs, reboot the switch.
If you specify the module number, the download goes to the specified module, but the download will fail if the module is of a different type than is indicated by the download header. If you do not specify the module number, the download goes to all modules of that type.
Note
You can use the download command as part of a minimal downtime software upgrade. For complete information on performing a minimal downtime software upgrade, refer to the Software Configuration Guide for your switch.
The download serial command uses the Kermit protocol through the serial EIA/TIA-232 console port. The download serial command is not allowed from a console session (the console port must be available for the serial download).
Examples
This example shows how to download a file named cat4000.6-1-2.bin from host called mercury to the supervisor engine module (by default):
Console> (enable) download mercury cat4000.6-1-2.bin
Download image cat4000.6-1-2.bin from mercury to module 1FLASH (y/n) [n]? y
Finished network single module download. (2418396 bytes)
Intel 28F008 20000000 NMP (P3) 4MB SIM
Erasing flash sector...done.
Programming flash sector...done.
Erasing flash sector...done.
Programming flash sector...done.
The system needs to be reset to run the new image.
This sample session shows how to connect to a remote terminal from a workstation and how to use the download serial command to copy a software image to the supervisor engine module:
C-Kermit 5A(172) ALPHA, 30 Jun 95, SUNOS 4.0 (BSD)
Type ? or 'help' for help
C-Kermit> set line /dev/ttyb
Connecting to /dev/ttyb, speed 9600.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
Console> (enable) set system baud 19200
[Back at local workstation]
C-Kermit> set speed 19200
Connecting to /dev/ttyb, speed 19200.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
Console> (enable) download serial
Download Supervisor image via console port (y/n) [n]? y
Concentrator Boot ROM (Ver 1.00)
Return to your local Machine by typing its escape sequence
Issue Kermit send command from there[ Send `Filename`]
C-Kermit> send c4000_xx.bin
c5000_xx.bin => C4000_XX.BIN, Size: 1233266
X to cancel file, CR to resend current packet
Z to cancel group, A for status report
E to send Error packet, Ctrl-C to quit immediately:...................................
......................................................................................
Related Commands
reset—switch
show flash
upload
enable
Use the enable command to activate privileged mode. In privileged mode, additional commands are available, and certain commands display additional information.
enable
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
The (enable) in the prompt indicates that privileged commands can be entered.
Examples
This example shows how to enter privileged mode:
Related Commands
disable
format
Use the format command to format a Flash device. Flash PC cards must be formatted before they can be used.
format [spare spare_num m/] {device1:} [device2: monlib_filename]
Syntax Description
spare spare_num
|
(Optional) Keyword and variable that specifies the number of spare sectors to reserve for use if other sectors fail; valid values are from 0 to 16.
|
m/
|
(Optional) Variable that specifies the module number of the supervisor engine containing the Flash device.
|
device1:
|
Variable that specifies the flash device to be formatted. A colon (:) is required after the specified device.
|
device2:
|
(Optional) Variable that specifies the flash device that contains the monlib file to be used to format device1:. A colon (:) is required after the specified device.
|
monlib_filename
|
(Optional) Variable that specifies the name of the monlib file to be used to format device1:.
|
Defaults
By default, the number of spare sectors is 0.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You can reserve up to 16 spare sectors for use when other sectors fail. If you do not reserve spare sectors and later some sectors on the device fail, you will have to reformat the entire Flash device, which will delete all existing data.
The monlib file is the ROM monitor library used by the ROM monitor to access files in the Flash file system. The file is also compiled into the system image. In the command syntax, device1: is the device to format and device2: contains the monlib file to use.
When you omit the [device2:][monlib_filename]] argument, the system formats device1: using the monlib that is bundled with the system software.
When you omit device2: from the [[device2:][monlib_filename]] argument, the system formats device1: using the named monlib file from the default Flash device (specified by the cd command).
When you omit monlib_filename from the [[device2:][monlib_filename]] argument, the system formats device1: using the monlib file from device2:. When you specify the whole [[device2:][monlib_filename]] argument, the system formats device1: using the specified monlib file from the specified device.
You can also specify device1:monlib_filename as the device and filename to be used, as follows:
format device1: [device1: [monlib_filename]]
If monlib_filename is omitted, the system formats device1: using the built-in monlib file on the device.
Note
When the system cannot find a monlib file, the system terminates the formatting process.
Examples
This example shows how to format a Flash device (Flash PC card in slot 1):
Console> (enable) format slot1:
All sectors will be erased, proceed (y/n) [n]?y
Enter volume id (up to 31 characters):
Format device slot1 completed.
help—ROM monitor
Use the help command to display a listing of commands you can use to set switch features.
help
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 display the commands list:
alias set and display aliases command
dir list files in file system
squeeze remove deleted files
history monitor command history
repeat repeat a monitor command
boot boot an image from flash/network
clear clear configurations, use 'clear help' for more info
help print list of available commands
set show/set environment vars, use 'set help' for more info
show show config parameters, use 'show help' for more info
sprom display sprom contents
version display version info
history—ROM monitor
Use the history command to display the command history (the last 16 commands run in the ROM monitor environment).
history
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
For convenience you can use the alias h for this command.
Examples
This example shows how to display the command history:
=============================================================================
history—switch
Use the history command to show the contents of the command history buffer.
history
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
The history buffer size is fixed at 20 commands. See "Chapter 1, "Switch CLI"" for more information about the command history feature.
Examples
This example shows how to display the command history and execute the second entry in the command history buffer:
l2trace
Use the l2trace command to display the Layer 2 path taken by the packets that start at a specified source address and end at a specified destination address.
l2trace src_mac_addr dest_mac_addr [vlan] [detail]
l2trace src_ip_addr dest_ip_addr [detail]
Syntax Description
src_mac_addr
|
Variable that specifies the source MAC address.
|
dest_mac_addr
|
Variable that specifies the destination MAC address.
|
vlan
|
(Optional) Variable that specifies the number of the VLAN.
|
detail
|
(Optional) Keyword that provides detailed information.
|
src_ip_addr
|
Variable that specifies the source IP address or alias.
|
dest_ip_addr
|
Variable that specifies the destination IP address or alias.
|
Defaults
This command has no default settings.
Command Types
Switch command.
Command Types
Privileged.
Usage Guidelines
All the intermediate devices should be Catalyst 4000, Catalyst 5000, or Catalyst 6000 family switches running Supervisor Engine software release 6.1 or later.
The l2trace command displays the Layer 2 path when the specified source and destination addresses belong to the same VLAN. If you specify source and destination address which belong to different VLANs, l2trace aborts with an error message.
You must enable CDP on all the Catalyst 4000, 5000, or 6000 family switches in the network.
When the switch detects a device in the Layer 2 path that does not belong to the Catalyst 4000, Catalyst 5000, or Catalyst 6000 family switch, the switch continues to send Layer 2 trace queries and lets them time out.
This command is rejected if you enter a multicast source or destination MAC address.
If a source or destination address belongs to multiple VLANs, you must specify the VLAN to be used for determining the Layer 2 path.
The Layer 2 trace feature is not supported when multiple devices are attached to one port via hubs (for example, when multiple CDP neighbors are detected on a port). When more than one CDP neighbor is detected on the port, l2trace is aborted.
If you specify the IP address of the source and destination systems instead of the MAC addresses, the switch looks at the ARP table to determine the IP-address-to-MAC-address mapping of the source and destination systems. If an ARP entry exists for the specified IP address, the corresponding MAC address is used. If no matching ARP entry exists, the system does an ARP query and tries to resolve the IP address. If this is the case, a restriction is imposed that requires the source and destination systems to be in the same subnet as the switch in order for the ARP query to be resolved.
Examples
This example shows how to display the Layer 2 packet path for the specified source and destination MAC addresses:
Console> (enable) l2trace 00-01-22-33-44-55 10-22-33-44-55-66 detail
l2trace vlan number is 10.
00-01-22-33-44-55 found in C5500 named wiring-1 on port 4/1 10Mb half duplex
C5500: wiring-1: 192.168.242.10: 4/1 10Mb half duplex -> 5/2 100MB full duplex
C5000: backup-wiring-1: 192.168.242.20: 1/1 100Mb full duplex -> 3/1-4 FEC attached
C5000: backup-core-1: 192.168.242.30: 4/1-4 FEC attached -> 1/1-2 GEC attached
C6000: core-1: 192.168.242.40: 1/1-2 GEC attached -> 2/1 10MB half duplex.
10-22-33-44-55-66 found in C6000 named core-1 on port 2/1 10MB half duplex.
This example shows how to display the Layer 2 packet path for the specified source and destination IP aliases:
Console> (enable) l2trace user-1-pc user-2-pc detail
Mapping IP address to MAC Address
user-1-pc -> 00-01-22-33-44-55
user-2-pc -> 10-22-33-44-55-66
l2trace vlan number is 10
00-01-22-33-44-55 found in C5500 named wiring-1 on port 4/1 10Mb half duplex
C5500: wiring-1: 192.168.242.10: 4/1 10Mb half duplex -> 5/2 100MB full duplex
C5000: backup-wiring-1: 192.168.242.20: 1/1 100Mb full duplex -> 3/1-4 FEC attached
C5000: backup-core-1: 192.168.242.30: 4/1-4 FEC attached -> 1/1-2 GEC attached
C6000: core-1: 192.168.242.40: 1/1-2 GEC attached -> 2/1 10MB half duplex.
10-22-33-44-55-66 found in C6000 named core-1 on port 2/1 10MB half duplex.
This example shows how to display a summary of Layer 2 packet path information for the specified source and destination MAC addresses:
Console> (enable) l2trace 00-01-22-33-44-55 10-22-33-44-55-66
This example show how to display a summary of Layer 2 packet path information for the specified source and destination IP addresses:
Console> (enable) l2trace 9.7.0.7 9.7.0.6
meminfo
Use the meminfo command to display information about the main memory, packet memory, and NVRAM.
meminfo [-l]
Syntax Description
-l
|
(Optional) Keyword that specifies the long listing of the supported DRAM configurations.
|
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The hyphen (-) is required with the -l option.
Examples
This example shows how to use the meminfo command:
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.
ping—ROM monitor
Use the ping command to send ICMP echo-request packets to another node on the network.
ping host
Syntax Description
host
|
Variable that specifies the IP address of the host.
|
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
You must enter the IP address of the node because ROM monitor does not support DNS name resolution.
Examples
This example shows how to ping 10.1.1.1:
ping—switch
Use the ping command set to send ICMP echo-request packets to another node on the network. You can also use the ping command without arguments to configure ping.
ping -s host
ping -s host [packet_size] [packet_count]
Syntax Description
-s
|
Keyword that specifies for the ping command to send one datagram per second, printing one line of output for every response received.
|
host
|
Variable that specifies the IP address or IP alias of the host.
|
packet_size
|
(Optional) Variable that specifies the number of bytes in a packet, from 56 to 1472 bytes.
|
packet_count
|
(Optional) Variable that specifies the number of packets to send; valid values are from 0 to 2147483647.
|
Defaults
The defaults for ping -s are:
•
packet_size is 56 bytes
•
packet_count is 2,147,483,647
The defaults for ping with no arguments following the host name are:
•
packet_size is 56 bytes
•
packet_count is 5
•
Wait time is 2 seconds
•
Target IP address is none (this is a mandatory field)
•
Source address is the host IP address
Command Types
Switch command.
Command Modes
Normal. Privileged to configure ping.
Usage Guidelines
The following are general ping command guidelines:
•
A hyphen (-) is required with the -s option.
•
Pinging stops when you press Ctrl-C.
•
A continuous ping occurs when packets are generated continuously and are dispatched to the host unless you press Ctrl-C to stop pinging.
•
Because the switch adds header information, the actual packet size is 8 bytes larger than the size you specify.
•
Normal response—The normal response occurs in 1 to 10 seconds, depending on network traffic.
The following guidelines are for the ping -s command:
•
The maximum waiting time before timing out is 2 seconds.
•
A new ping packet is generated after one second of sending the previous packet, regardless of whether an echo-reply is received.
•
A continuous ping occurs if you do not enter a packet count.
•
Network or host unreachable—The switch found no corresponding entry in the route table.
•
Destination does not respond—If the host does not respond, a "no answer from host" appears in 2 seconds.
•
Destination unreachable—This destination gateway indicates that the destination is unreachable.
The following guidelines are for the ping command without arguments beyond the IP address:
•
The ping ip_address command is accepted in normal mode only. The parameters take the default values automatically.
•
The target IP address is a mandatory field to be entered.
•
The maximum waiting time is configurable.
•
A new ping packet is generated only when a echo-reply is received.
•
A continuous ping occurs if you enter a packet count of 0.
•
Output returns only when a response is received or you press Return. This is available in privileged mode only.
•
When configuring ping, you must either press Return or enter a response. Valid responses and appropriate values are as follows:
–
Target IP address—IP address or host name of the destination node you plan to ping.
–
Number of Packets—Number of ping packets to be sent to the destination address. Valid values are from 0 to 2,147,483,647 (0 specifies continuous ping).
–
Datagram size—Size of the ping packet. Valid values are from 56 to 1472 bytes.
–
Timeout in seconds—Timeout interval. Valid values are from 0 to 3600 seconds.
–
Source IP Address [(default)]—IP address or IP alias of the source.
This example shows how to ping a host with IP alias elvis a single time:
-----172.20.52.19 PING Statistics------
5 packets transmitted, 5 packets received, 0% packet loss
round-trip (ms) min/avg/max = 1/1/1
This example shows how to ping a host with the IP alias elvis once per second until you press Ctrl-C to stop pinging:
ping elvis: 56 data bytes
64 bytes from elvis: icmp_seq=0. time=11 ms
64 bytes from elvis: icmp_seq=1. time=8 ms
64 bytes from elvis: icmp_seq=2. time=8 ms
64 bytes from elvis: icmp_seq=3. time=7 ms
64 bytes from elvis: icmp_seq=4. time=11 ms
64 bytes from elvis: icmp_seq=5. time=7 ms
64 bytes from elvis: icmp_seq=6. time=7 ms
----elvis PING Statistics----
7 packets transmitted, 7 packets received, 0% packet loss
round-trip (ms) min/avg/max = 7/8/11
This example shows how to configure ping:
Target IP Address []: 172.20.52.19
Timeout in seconds [2]: 1
Source IP Address [172.20.52.18]:
----172.20.52.19 PING Statistics----
6 packets transmitted, 6 packets received, 0% packet loss
round-trip (ms) min/avg/max = 1/1/1
Related Commands
set interface
set ip route—switch
show interface—switch
show ip route—switch
pwd
Use the pwd command to display the current default Flash device.
pwd [mod]
Syntax Description
mod
|
(Optional) Variable that specifies the module number of the supervisor engine for which to display the current default Flash device.
|
Defaults
By default, pwd defaults to the active supervisor engine if a module number is not specified.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to display the current default Flash device:
Default flash device set to slot0.
quit
Use the quit command to exit a CLI session.
quit
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
The exit and logout command aliases perform the same function as the quit command.
Examples
This example shows how to exit a CLI session:
Connection closed by foreign host.
reconfirm vmps
Use the reconfirm vmps command to apply the current dynamic port VLAN membership assignments with the VMPS server.
reconfirm vmps
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
VMPS database changes are not conveyed automatically to switches participating in VMPS. Therefore, after making a VMPS database change, use this command on VMPS clients and servers to apply the database changes.
Examples
This example shows how to apply the current dynamic port VLAN membership with VMPS:
Console (enable) reconfirm vmps
reconfirm process started
Use 'show dvlan statistics' to see reconfirm status
Related Commands
set vmps server
show dvlan statistics
show vmps
show vmps statistics
repeat
Use the repeat ROM monitor command to repeat a command.
repeat [num | string]
Syntax Description
num
|
(Optional) Variable that specifies the number of the command (from the command history buffer list).
|
string
|
(Optional) Variable that specifies the string that uniquely matches a command in the command history buffer list.
|
Defaults
By default, the last command is repeated if an argument is not specified.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The optional num and string arguments specify which command in the command history buffer to repeat.
If you specify a string to match, the most recent command in the buffer to begin with the specified string is executed again.
If the string contains blank spaces, you must use quotation marks.
For convenience, you can use the alias r for this command.
Examples
These examples show how to repeat the most recent dir command, repeat the most recent command, and repeat command with the ID 15. You use the history command to display the list of previously entered commands:
File size Checksum File name
1973032 bytes (0x1e1b28) 0xdadf5e24 llue
File size Checksum File name
1973032 bytes (0x1e1b28) 0xdadf5e24 llue
Main memory size: 0x1000000
Available main memory starts at 0xa000e000, size 0xff2000
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
==========================================================================
reset—ROM monitor
Use the reset ROM monitor command to perform a soft reset of the switch.
reset {mod_num | system}
Syntax Description
mod_num
|
Variable that specifies the number of the module to be reset.
|
system
|
Keyword that resets the entire switch.
|
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to reset the switch:
System Bootstrap, Version 3.1(1.69)
Copyright (c) 1994-1997 by cisco Systems, Inc.
Supervisor III processor with 16384 Kbytes of main memory
===========================================================================
reset—switch
Use the reset command to restart the system or an individual module or to schedule a system reset at a specific time.
reset [mod_num | system | mindown]
reset [mindown] at {hh:mm} [mm/dd] [reason]
reset [mindown] in [hh:] {mm} [reason]
reset cancel
Syntax Description
mod_num
|
(Optional) Variable that specifies the number of the module to be restarted.
|
system
|
(Optional) Keyword that resets the system.
|
mindown
|
(Optional) Keyword that performs a reset as part of a minimal downtime software upgrade in a system with redundant supervisor engine modules.
|
at
|
Keyword that schedules a system reset at a specific future time.
|
hh:mm
|
Variable that specifies the hour and minute of the scheduled reset.
|
mm/dd
|
(Optional) Variable that specifies the month and day of the scheduled reset.
|
in
|
Keyword that schedules a system reset after a specified time.
|
hh:
|
(Optional) Variable that specifies how many hours into the future to reset the switch.
|
mm
|
Variable that specifies how many minutes into the future to reset the switch.
|
reason
|
(Optional) Variable indicating the reason for the reset.
|
cancel
|
Keyword that cancels a scheduled reset.
|
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you do not specify a module number (either a switching module or the active supervisor engine module), the command resets the entire system.
You can use the reset mod_num command to switch to the redundant supervisor engine, where mod_num is the module number of the active supervisor.
In software release 5.2 and later, you can use the reset mindown command to reset the switch as part of a minimal downtime software upgrade in a system with redundant supervisor engine modules. For complete information on performing a minimal downtime software upgrade, refer to the Software Configuration Guide-Catalyst 4000 Family, 2948G, and 2980G Switches.
Caution 
If you make configuration changes after entering the
reset mindown command but before the active supervisor engine resets, the changes are not saved. Input from the CLI is still accepted by the switch while the standby supervisor engine is reset, but any changes you make to the configuration between the time when you enter the
reset mindown command and the time when the supervisor engine comes online running the new software image are not saved or synchronized with the standby supervisor engine.
Examples
This example shows how to reset module 4:
Console> (enable) reset 4
This command will reset module 4 and may disconnect your telnet session.
Do you want to continue (y/n) [n]? y
This example shows how to schedule a reset at a specific future time and include a reason for the reset:
Console> (enable) reset at 23:00 08/18 Software upgrade to 5.3(1).
Reset scheduled at 23:00:00, Wed Aug 18 2000.
Reset reason: Software upgrade to 5.3(1).
Proceed with scheduled reset? (y/n) [n]? y
Reset scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).
This example shows how to schedule a reset with minimum down time.
Console> (enable) reset mindown at 23:00 08/18 Software upgrade to 5.3(1).
Reset scheduled at 23:00:00, Wed Aug 18 2000.
Reset reason: Software upgrade to 5.3(1).
Proceed with scheduled reset? (y/n) [n]? y
Reset mindown scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).
This example shows how to schedule a reset after a specified time:
Console> (enable) reset in 05:20 Configuration update
Reset scheduled in 5 hours 20 minutes.
Reset reason: Configuration update
Proceed with scheduled reset? (y/n) [n]? y
Reset scheduled for 19:56:01, Wed Aug 18 2000 (in 5 hours 20 minutes).
Reset reason: Configuration update
This example shows how to cancel a scheduled reset:
Console> (enable) reset cancel
Cancel reset scheduled for 19:56:01, Wed Aug 18 2000 (in 5 hours 20 minutes).
session
Use the session command to access the CLI of an intelligent module such as a Catalyst 5000 family RSM, RSFC, or ATM module.
session mod
Syntax Description
mod
|
Variable that specifies the number of the module.
|
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
After you enter this command, the system responds with the Enter Password: prompt, if a password is configured on the module.
To end the session with the intelligent module, enter the quit command.
Examples
This example shows how to open a session with an ATM module (module 4):
Escape character is `^]'.
2