|
|
This chapter describes the command-line interfaces (CLI) available on the Catalyst 5000, 4000, 2948G, and 2926G series switches and contains the following sections:
For definitions of any terms listed in this publication, refer to the Internetworking Terms and Acronyms publication; "Acronyms," contains a list of acronyms.
The Catalyst 5000, 4000, 2948G, and 2926G series switches are multimodule systems. Commands you enter from the CLI can apply to the entire system or to a specific module, port, or VLAN.
You can configure and maintain the Catalyst 5000, 4000, 2948G, and 2926G series switches series Ethernet, Fast Ethernet, Gigabit Ethernet, CDDI, and FDDI modules by entering commands from the switch CLI. The CLI is a basic command-line interpreter similar to the UNIX C shell. Using the CLI session command, you can access the router configuration software and perform tasks such as history substitution and alias creation.
To configure the ATM module on the Catalyst 5000 and 2926G series switches, you must use the ATM module CLI. For more information about the ATM module CLI, refer to the "ATM CLI" section.
You can access the switch CLI from a console terminal connected to an EIA/TIA-232 port or through a Telnet session. The CLI allows fixed baud rates. Telnet sessions disconnect automatically after remaining idle for a user-defined time period.
To access the switch through the console (EIA/TIA-232) port, perform these steps:
| Task | Command |
|---|---|
Step 1 From the Cisco Systems Console prompt, press Return. |
|
Step 2 At the prompt, enter the system password. The Console> prompt appears indicating that you have accessed the CLI in normal mode. | <password> |
Step 3 Enter the necessary commands to complete your desired tasks. | Appropriate commands |
Step 4 When finished, exit the session. | quit |
After connecting through the console port, you see this display:
Cisco Systems Console Enter password: Console> Console>
To access the switch through a Telnet session, you must first set the IP address for the switch. You can open multiple sessions to the switch via Telnet.
To access the switch from a remote host with Telnet, perform these steps:
| Task | Command |
|---|---|
Step 1 From the remote host, enter the telnet command and the name or IP address of the switch you want to access. | telnet hostname | ip_addr |
Step 2 At the prompt, enter the password for the CLI. If no password has been configured, press Return. | <password> |
Step 3 Enter the necessary commands to complete your desired tasks. | Appropriate commands |
Step 4 When finished, exit the Telnet session. | quit |
After connecting through a Telnet session, you see this display:
host% telnet cat5000-1.cisco.com Trying 172.16.44.30 ... Connected to cat5000-1.
This section describes command modes and functions that allow you to operate the switch CLI.
The CLI has two modes of operation: normal and privileged. Both are password-protected. Use normal-mode commands for everyday system monitoring. Use privileged commands for system configuration and basic troubleshooting.
After you log in, the system enters normal mode, which gives you access to normal-mode commands only. You can enter privileged mode by entering the enable command followed by the enable password. Privileged mode is indicated by the word "enable" in the system prompt. To return to normal mode, enter the disable command at the prompt.
The following example shows how to enter privileged mode:
Console> enable Enter password: <password> Console> (enable)
Switch commands are not case sensitive. You can abbreviate commands and parameters as long as they contain enough letters to be different from any other currently available commands or parameters. You can scroll through the last 20 commands stored in the history buffer, and enter or edit the command at the prompt. (See Table 1-1.)
| Keystroke | Function |
|---|---|
Ctrl-A | Jumps to the first character of the command line. |
Ctrl-B or the left arrow key | Moves the cursor back one character. |
Ctrl-C | Escapes and terminates prompts and tasks. |
Ctrl-D | Deletes the character at the cursor. |
Ctrl-E | Jumps to the end of the current command line. |
Ctrl-F or the right arrow key1 | Moves the cursor forward one character. |
Ctrl-K | Deletes from the cursor to the end of the command line. |
Ctrl-L; Ctrl-R | Repeats current command line on a new line. |
Ctrl-N or the down arrow key1 | Enters next command line in the history buffer. |
Ctrl-P or the up arrow key1 | Enters previous command line in the history buffer. |
Ctrl-U; Ctrl-X | Deletes from the cursor to the beginning of the command line. |
Ctrl-W | Deletes last word typed. |
Esc B | Moves the cursor back one word. |
Esc D | Deletes from the cursor to the end of the word. |
Esc F | Moves the cursor forward one word. |
Delete key or Backspace key | Erases mistake when entering a command; reenter command after using this key. |
| 1The arrow keys function only on ANSI-compatible terminals such as VT100s. |
Catalyst 5000 and 2926G series software release 4.3 and above and Catalyst 4000 series software release 4.4 and above include an enhanced editing mode that provides a set of editing key functions similar to those of the Emacs editor. You can enter commands in uppercase, lowercase, or a mix of both. Only passwords are case sensitive. You can abbreviate commands and keywords to the number of characters that allow a unique abbreviation.
For example, you can abbreviate the show command to sh. After entering the command at the system prompt, press Return to execute the command.
Although enhanced editing mode is enabled automatically, you can disable it and revert to the editing mode of previous software releases. See the "Ending a Session" section.
To reenable the enhanced editing mode for the current terminal session, perform this task in privileged mode:
| Task | Command |
|---|---|
Enable the enhanced editing features for the current terminal session. | terminal editing1 |
| 1This command is documented in the Cisco Access Connection Guide. |
To reconfigure a specific line in enhanced editing mode, perform this task in privileged mode:
| Task | Keystrokes |
|---|---|
Enable the enhanced editing features. | editing |
Perform one of these tasks to move the cursor around on the command line for corrections or changes:
| Task | Keystrokes |
|---|---|
| Press Ctrl-B or press the left arrow key.1 |
| Press Ctrl-F or press the right arrow key.1 |
| Press Ctrl-A. |
| Press Ctrl-E. |
| Press Esc B. |
| Press Esc F. |
| 1The arrow keys function only on ANSI-compatible terminals such as VT100s. |
If you enter a set of characters that could indicate more than one command, the system beeps to indicate an error. Enter a question mark (?) to obtain a list of commands that begin with that set of characters. Do not leave a space between the last letter and the question mark (?). For example, three commands in privileged mode start with co. To see what they are, enter co? at the privileged prompt. The system displays all commands that begin with co, as follows:
Console> (enable) co? configure connect copy
The system provides a buffer that contains the last ten items you deleted. You can recall these items and paste them in the command line by performing this task:
| Task | Keystrokes |
|---|---|
Step 1 Recall the most recent entry in the buffer. | Press Ctrl-Y. |
Step 2 Recall the next buffer entry. | Press Esc Y. |
The buffer contains only the last ten items you have deleted or cut. If you press Esc Y more than ten times, you cycle back to the first buffer entry.
The editing command set provides a wraparound feature for commands that extend beyond a single line on the screen. When the cursor reaches the right margin, the command line shifts ten spaces to the left. You cannot see the first ten characters of the line, but you can scroll back and check the syntax at the beginning of the command. To scroll back, perform this task:
| Task | Keystrokes |
|---|---|
Return to the beginning of a command line to verify that you have entered a lengthy command correctly. | Press Ctrl-B or the left arrow key repeatedly until you scroll back to the beginning of the command entry, or press Ctrl-A to return directly to the beginning of the line1. |
| 1The arrow keys function only on ANSI-compatible terminals such as VT100s. |
For an example of this feature, refer to the "Using the Editing Features" section.
Use line wrapping with the command history feature to recall and modify previous complex command entries. See the "Using History Substitution" section for information about recalling previous command entries.
The system assumes your terminal screen is 80 columns wide. If your screen has a different width, enter the terminal width command to tell the router the correct width of your screen.
Perform one of these tasks to delete command entries if you make a mistake or change your mind:
| Task | Keystrokes |
|---|---|
| Press the Delete or Backspace key. |
| Press Ctrl-D. |
| Press Ctrl-K. |
| Press Ctrl-U or Ctrl-X. |
| Press Ctrl-W. |
| Press Esc D. |
When you use the help facility to list the commands in a particular mode, the list is often longer than the terminal screen can display. In such cases, a ---More--- prompt is displayed at the bottom of the screen. To view the next line or screen, perform these tasks:
| Task | Keystrokes |
|---|---|
| Press the Return key. |
| Press the Spacebar. |
If you enter a command and the system suddenly sends a message to your screen, you can recall your current command line entry. To do so, perform this task:
| Task | Keystrokes |
|---|---|
Redisplay the current command line. | Press Ctrl-L or Ctrl-R. |
If you mistype a command entry, you can transpose the mistyped characters by performing this task:
| Task | Keystrokes |
|---|---|
Transpose the character to the left of the cursor with the character located at the cursor. | Press Ctrl-T. |
You can change words to uppercase or lowercase, or capitalize a set of letters, with simple keystroke sequences:
| Task | Keystrokes |
|---|---|
| Press Esc C. |
| Press Esc L. |
| Press Esc U. |
You can use a particular keystroke as an executable command. Perform this task:
| Task | Keystrokes |
|---|---|
Insert a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not an editing key. | Press Ctrl-V or Esc Q. |
Like regular commands, aliases are not case sensitive. However, unlike regular commands, some aliases cannot be abbreviated. See Table 1-2 for a list of switch CLI aliases that cannot be abbreviated.
| Alias | Command |
|---|---|
? | help |
batch | configure |
di | show |
earl | cam |
exit | quit |
logout | quit |
Commands that you enter during each terminal session are stored in a history buffer, which stores the last 20 commands you entered during a terminal session. History substitution allows you to access these commands without retyping them by using special abbreviated commands. (See Table 1-3.)
| Command | Function |
|---|---|
| To repeat recent commands: | |
!! | Repeat the most recent command. |
!-nn | Repeat the nnth most recent command. |
!n | Repeat command n. |
!aaa | Repeat the command beginning with string aaa. |
!?aaa | Repeat the command containing the string aaa. |
| To modify and repeat the most recent command: | |
^aaa^bbb | Replace the string aaa with the string bbb in the most recent command. |
| To add a string to the end of a previous command and repeat it: | |
!!aaa | Add string aaa to the end of the most recent command. |
!n aaa | Add string aaa to the end of command n. |
!aaa bbb | Add string bbb to the end of the command beginning with string aaa. |
!?aaa bbb | Add string bbb to the end of the command containing the string aaa. |
To see a list of top-level commands and command categories, type help or ? in normal or privileged mode. Context-sensitive help (usage and syntax information) for individual commands can be seen by appending help or ? to any specific command. If you enter a command using the wrong number of arguments or inappropriate arguments, usage and syntax information for that command is displayed. Additionally, appending help or ? to a command category displays a list of commands in that category.
In normal mode, use the help or ? command to display a list of top-level commands and command categories, as follows:
Console> help Commands: ----------------------------------------------------------------------cd Set default flash devicedir Show list of files on flash deviceenable Enable privileged modehelp Show this messagehistory Show contents of history substitution bufferping Send echo packets to hostspwd Show default flash devicequit Exit from the Admin sessionsession Tunnel to ATM or Router moduleset Set, use 'set help' for more infoshow Show, use 'show help' for more infotraceroute Trace the route to a hostverify Verify checksum of file on flash devicewait Wait for x secondswhichboot Which file bootedConsole>
In privileged mode, enter the help or ? command to display a list of top-level commands and command categories, as follows:
Console> (enable) help Commands: ----------------------------------------------------------------------cd Set default flash deviceclear Clear, use 'clear help' for more infoconfigure Configure system from networkcopy Copy files between TFTP/module/flash devicesdelete Delete a file on flash devicedir Show list of files on flash devicedisable Disable privileged modedisconnect Disconnect user sessiondownload Download code to a processorenable Enable privileged modeformat Format a flash devicehelp Show this messagehistory Show contents of history substitution bufferping Send echo packets to hostspwd Show default flash devicequit Exit from the Admin sessionreconfirm Reconfirm VMPSreload Force software reload to linecardreset Reset system or modulesession Tunnel to ATM or Router moduleset Set, use 'set help' for more infoshow Show, use 'show help' for more infoslip Attach/detach Serial Line IP interfacesqueeze Reclaim space used by deleted filesswitch Switch to standby <clock|supervisor>telnet Telnet to a remote hosttest Test, use 'test help' for more infotraceroute Trace the route to a hostundelete Undelete a file on flash deviceupload Upload code from a processorverify Verify checksum of file on flash devicewait Wait for x secondswhichboot Which file bootedwrite Write system configuration to terminal/networkConsole> (enable)
On some commands (such as clear, set, and show), typing help or ? after the command provides a list of commands in that category. For example, the following display shows a partial list of commands for the clear category:
Console> (enable) clear help Clear commands: ----------------------------------------------------------------------------clear alias Clear aliases of commandsclear arp Clear ARP table entriesclear banner Clear Message Of The Day bannerclear boot Clear booting environment variableclear cam Clear CAM table entries...
Usage and syntax information for individual commands can be seen by appending help or ? to any specific command. For example, the following display shows usage and syntax information for the set length command:
Console> set length help
Usage: set length <screenlength>
(screenlength = 5..512, 0 to disable 'more' feature)
Console>
The Catalyst 5000, 4000, 2948G, and 2926G series modules (module slots), ports, and VLANs are numbered starting with 1. The supervisor module is module 1, residing in the top slot. If you are using a Catalyst 5505 switch or a Catalyst 5500 switch with a redundant supervisor engine, the supervisor modules reside in slots 1 and 2. On each module, port 1 is the leftmost port. To reference a specific port on a specific module, the command syntax is mod_num/port_num. For example, 3/1 denotes module 3, port 1. In some commands, such as set trunk, set cam, and set vlan, you can enter lists of ports and VLANs.
If you are using a Catalyst 2948G series switch, the Catalyst 2948G is a fixed configuration switch. All ports are located on "module 2;" for this reason, if you enter the module and port number as 1/N, an error message will be displayed.
To reference ports or a range of ports on a specific module, the command syntax is displayed as mod/ports..., mod/port..., or mod_num/port_num. You can designate ports by entering the module and port number pairs, separated by commas. To specify a range of ports, use a dash (-) between the module number and port number pairs. Dashes take precedence over commas. The following examples show several ways of designating ports:
Example 1: 2/1,2/3 denotes module 2, port 1 and module 2, port 3.
Example 2: 2/1-12 denotes module 2, ports 1 through 12.
Example 3: 2/1-2/12 also denotes module 2, ports 1 through 12.
Each VLAN is designated by a single number. You can specify lists of VLANs the same way you do for ports. Individual VLANs are separated by commas (,); ranges are separated by dashes (-). In the following example, VLANs 1 through 10 and VLAN 1000 are specified:
1-10,1000
Some commands require a MAC address, IP address, or IP alias, which you must designate in a standard format. The MAC address format must be six hexadecimal numbers separated by hyphens, as shown in this example:
00-00-0c-24-d2-fe
The IP address format is 32 bits, written as four octets separated by periods (dotted decimal format). IP addresses are made up of a network section, an optional subnet section, and a host section, as shown in this example:
126.2.54.1
If the IP alias table is configured, you can use IP aliases in place of the dotted decimal IP address. This is true for most commands that use an IP address, except commands that define the IP address or IP alias.
Table 1-4 identifies each command in the switch command set, shows the command syntax, provides a short description, and specifies the mode for the command. The available modes are:
| Command | Syntax | Description | Mode |
|---|---|---|---|
cd [[m/]device:] | Sets the default Flash device. | P | |
clear alias {name | all} | Clears the specified alias of a command. | P | |
clear arp {ip_addr | all} | Clears ARP table entries. | P | |
clear banner motd | Clears the message-of-the-day banner. | P | |
clear boot system all [mod] | Clears the boot value. | P | |
clear cam {mac_addr | dynamic | static | permanent} [vlan_num] | Clears CAM table entries. | P | |
clear cgmp statistics | Clears CGMP statistical information. | P | |
clear config mod_num | Clears the configuration and resets the system. | P | |
clear counters | Clears MAC and port counters. | P | |
clear drip statistics | Clears DRiP statistical information. | P | |
clear gmrp statistics {vlan | all} | Clears GMRP statistical information. | P | |
clear gvrp statistics {mod/port | all} | Clears GVRP statistical information. | P | |
clear igmp statistics | Clears IGMP statistical information. | P | |
clear ip alias {name | all} | Clears IP address aliases. | P | |
clear ip dns domain | Clears the default DNS domain name. | P | |
clear ip dns server {ip_addr | all} | Clears the IP address of a DNS server. | P | |
clear ip permit {ip_addr | all}[mask] | Clears hosts from the IP permit list. | P | |
clear ip route all | Clears IP routing table entries. | P | |
clear log [mod_num] | Deletes all entries in the system error log. | P | |
clear logging buffer | Clears the system logging buffer. | P | |
clear logging server ip_addr | Deletes a syslog server from the configuration. | P | |
clear mls include [ip | ipx] {{ip_addr} | all} | Clears the MLS feature in the Catalyst 5000 and 2926G series switches. | P | |
clear mls multicast include{ip_addr | all} | Removes a router from the list of routers participating in IP multicast MLS | P | |
clear multicast router all | Clears multicast router ports. | P | |
clear ntp server {ip_addr | all} | Deletes an NTP server from the server table. | P | |
clear port broadcast mod/ports... | Disables broadcast/multicast suppression on one or more ports. | P | |
clear port filter [mod_num/port_num] [mac_addr | protocol_type | all] | Clears all configured MAC addresses or protocol filters or those filters configured on a specific port. | P | |
clear port qos mod/ports.. cos | Returns the values set by the set port qos cos command to the factory-set default values for all ports. | P | |
clear qos config | Returns the values set by various QoS commands to the factory-set default values. | P | |
clear qos ip-filter [ACE#] | Returns the values set by the set qos ip-filter command to the factory-set default values for all ports. | P | |
clear qos mac-cos dest_mac [vlan] | Returns the values set by the set qos mac-cos command to the factory-set default values. | P | |
clear qos map port_type | Returns the values set by the set qos map command to the factory-set default values. | P | |
clear qos router-mac mac_address vlan | Returns the values set by the set qos router-mac command to the factory-set default values. | P | |
clear snmp trap {rcvr_addr | all} | Clears SNMP trap receiver addresses. | P | |
clear spantree portvlancost mod_num/port_num preferred_vlans | Clears spanning-tree path cost to a VLAN on a port. | P | |
clear spantree portvlanpri mod_num/port_num vlans | Clears spanning-tree port VLAN priority. | P | |
clear spantree root [vlans] | Restores the switch priority and Spanning-Tree Protocol parameters to the default values. | P | |
clear spantree statistics mod_num/port_num | Clears spanning-tree statistics. | P | |
clear spantree uplinkfast | Turns off the UplinkFast features and returns the switch priority and port costs to the factory default values. | P | |
clear tacacs key | Clears the key used for TACACS+ authentication and encryption. | P | |
clear tacacs server {ip_addr | all} | Removes a host from the list of TACACS+ servers. | P | |
clear timezone | Clears NTP time zone information. | P | |
clear top {all | report_num} | Stops the TopN process. | P | |
clear trunk mod/ports... [vlans] | Resets trunk ports and clears information from the trunk table. | P | |
clear vlan vlan_num | Deletes a VLAN from a management domain. | P | |
clear vlan mapping dot1q {1q_vlan_num | all} | Deletes existing 802.1Q VLAN to ISL VLAN-mapped pairs. | P | |
clear vmps server ip_addr | Removes a VMPS server from the VMPS table. | P | |
clear vmps statistics | Deletes VMPS statistics. | P | |
clear vtp pruneeligible vlan_num | Turns off the pruning eligibility of a VLAN. | P | |
clear vtp statistics | Deletes VTP statistics. | P | |
configure {host} {file} | Downloads a configuration file from the network and executes each command in the file. | P | |
copy file-id {tftp | flash | file-id | config} | Copies software images between a Supervisor Engine III and the Catalyst 4000 and 2948G series switch supervisor engine modules and a host. | P | |
delete [[m/]device:] filename | Deletes a file. | P | |
dir [[m/]device:][filename] [all | deleted | long] | Displays a list of files on a Flash device (switch command). | N | |
disable | Returns the CLI to normal mode. | P | |
disconnect {ip_addr | console} | Closes an active console port or Telnet session. | P | |
download {host} {file} [mod_num] | Copies a software image from a host to a module's Flash memory. | P | |
download vmps | Downloads VMPS database information. | P | |
enable | Activates CLI privileged mode. | N | |
format [spare spare-num] [m/]device1:[[device2:][monlib_filename]] | Formats a Flash device. | P | |
history | Shows the contents of the command history buffer. | N | |
ping [-s] host [packet_size] [packet_count] | Sends ICMP echo request packets to another node on the network. | N | |
pwd [mod] | Shows the current setting of the cd command. | P | |
quit | Exits the CLI session. | N | |
reconfirm vmps | Reconfirms the current dynamic port VLAN membership with VMPS. | P | |
reload mod_num | Forces a Gigabit EtherChannel switching module to accept a download. | P | |
reset [system] | Sets the system to its default values or configures the system as an individual module. | P | |
session mod_num | Connects the CLI to a session on a module (such as the ATM or RSM modules). | P | |
set alias name command [parameter] [parameter] | Creates an alias for a command. | P | |
set arp agingtime agingtime | Creates an ARP table entry and sets the ARP entry aging time. | P | |
set authentication login tacacs enable | disable [console | telnet | both] [primar | Sets authentication method. | P | |
set banner motd c [text] c | Sets the message-of-the-day banner. | P | |
set boot config-register 0xvalue [mod_num] | Sets the boot configuration register attributes. | P | |
set boot system flash device:[filename][prepend] [mod_num] | Sets the boot system flash device. | P | |
set bridge apart {enable | disable} | Enables or disables APaRT on FDDI. | P | |
set bridge fddicheck {enable | disable} | Enables or disables FDDICHECK on FDDI. | P | |
set bridge ipx 8022toether {8023 | snap | eii | 8023raw} | Sets the default mode for translating IPX frames from FDDI 802.2 to Ethernet. | P | |
set bridge ipx 8023rawtofddi {8022 | snap | fddiraw} | Sets the default mode for translating IPX frames from Ethernet 802.3 raw to FDDI. | P | |
set bridge ipx snaptoether {8023 | snap | eii | 8023raw} | Sets the default mode for translating IPX FDDI SNAP frames to Ethernet frames. | P | |
set cam agingtime vlan agingtime | Creates a CAM table entry and sets the CAM aging time. | P | |
set cdp {enable | disable} {mod/ports...} | Enables, disables, and configures CDP on a port. | P | |
set cdp interval interval | Sets the message interval for CDP. | P | |
set cgmp {enable | disable} | Enables or disables CGMP. | P | |
set cgmp leave {enable | disable} | Enables or disables CGMP leave processing. | P | |
set enablepass | Sets the enable (privileged) password. | P | |
set fddi alarm mod_num/port_num value | Sets the LER-alarm value. | P | |
set fddi cutoff mod_num/port_num value | Sets the LER-cutoff value. | P | |
set fddi tlmin mod_num/port_num microseconds | Sets the TL_MIN value for an FDDI port. | P | |
set fddi tnotify mod_num time | Sets the T_Notify timer value for an FDDI port. | P | |
set fddi treq mod_num time | Sets the TRequest value for an FDDI module. | P | |
set fddi userdata mod_num [userdata_string] | Sets the user-data string in the SMT MIB of an FDDI module. | P | |
set garp timer {timer_type} {timer_value} | Adjusts the values of the join, leave, and leaveall timers. | P | |
set gmrp {enable | disable} | Enables or disables the GMRP feature on this switch, in all VLANs, and on all ports. | P | |
set gmrp fwdall {enable | disable} mod/port... | Enables or disables the Forward All feature on a specifed port. | P | |
set gmrp registration registration-type mod/port... | Specifies the GMRP registration type. | P | |
set gmrp timer{timer_type} {timer_value} | Adjusts the values of the join, leave, and leaveall timers. | P | |
set gvrp {enable | disable} | Enables or disables the GVRP feature on this switch, in all VLANs, and on all ports. | P | |
set gvrp applicant {normal | active} {mod/port...} | Specifies whether or not a VLAN is declared out of blocking ports. | P | |
set gvrp dynamic-vlan-creation {enable | disable} | Enables or disables dynamic VLAN creation. | P | |
set gvrp registration {normal | fixed | forbidden} [mod/port...] | Sets the administrative control of an outbound port. | P | |
set gvrp timer {timer_type} {timer_value} | Adjusts the values of the join, leave, and leaveall timers. | P | |
set igmp {enable | disable} | Enables or disables IGMP snooping on the switch. | P | |
set interface {sc0 | sl0 | me1} {up | down} | Sets a network interface configuration and enables or disables standard SNMP trap operation. | P | |
set ip alias name ip_addr | Creates an alias for an IP address. | P | |
set ip dns {enable | disable} | Enables or disables DNS. | P | |
set ip dns domain name | Sets the default DNS domain name. | P | |
set ip dns server ip_addr [primary] | Sets the IP address of a DNS server. | P | |
set ip fragmentation {enable | disable} | Enables or disables IP fragmentation for packets bridged between FDDI and Ethernet networks. | P | |
set ip permit {enable | disable} | Enables or disables the IP permit list and creates entries in the IP permit list. | P | |
set ip redirect {enable | disable} | Enables or disables ICMP redirect messages. | P | |
set ip route default gateway [metric][primary] | Adds entries to the IP routing table. | P | |
set ip unreachable {enable | disable} | Enables or disables ICMP unreachable messages. | P | |
set length number [default] | Sets the number of lines in the terminal display screen. | N | |
set logging buffer buffer_size | Limits the messages buffered. | P | |
set logging console {enable | disable} | Enables and disables system message logging to the console. | P | |
set logging history syslog_history_table_size | Sets the size of the syslog history table. | P | |
set logging level facility severity [default] | Sets the facility and severity level for system message logging. | P | |
set logging server {enable | disable} | Enables, disables, or configures system message logging to syslog servers and adds syslog servers to the system logging server table. | P | |
set logging session {enable | disable} | Enables or disables system logging messages to the current login session. | P | |
set logging timestamp {enable | disable} | Enables or disables the timestamp display on system logging messages. | P | |
set logout timeout | Sets the number of minutes before an automatic logout. | P | |
set mls agingtime [ip | ipx] [agingtime] | Configures the MLS feature in the Catalyst 5000 and 2926G series switches. | P | |
set mls agingtime fast [fastagingtime] [pkt_threshold] | Configures the MLS fast-aging time feature in the Catalyst 5000 and 2926G series switches. | P | |
set mls flow destination | destination-source | full | Specifies the minimum flow mask used for MLS. | P | |
set mls multicast enable | Configures the IP multicast MLS feature in the Catalyst 5000 and 2926G series switches. | P | |
set mls nde {disable | enable} | Configures the NDE feature to allow command exporting statistics to the preconfigured collector. | P | |
set module disable mod_num | Disables a module. | P | |
set module enable mod_num | Enables a module. | P | |
set module name mod_num [mod_name] | Sets the name of a module. | P | |
set multicast router mod_num/port_num | Configures multicast router ports. | P | |
set ntp authenticatation enable | disable | Enables or disables the NTP authentication feature. | P | |
set ntp broadcastclient {enable | disable} | Enables or disables NTP in broadcast-client mode. | P | |
set ntp broadcastdelay microseconds | Configures a delay for the receiving of broadcast NTP packets. | P | |
set ntp client {enable | disable} | Enables or disables the switch as an NTP client. | P | |
set ntp key public_keynum trusted | untrusted | Defines an NTP authentication key pair or specifies a key to be trusted or untrusted. |
| |
set ntp server ip_addr [key public_keynum] | Configures an authentication key to an NTP server. | P | |
set password | Sets the console password. | P | |
set port broadcast mod_num/port_num threshold[%] | Sets the broadcast/multicast suppression for one or more ports. | P | |
set port channel port_list [on | off | desirable | auto] | Configures Fast EtherChannel on two or more ports. | P | |
set port disable mod_num/port_num | Disables a port. | P | |
set port duplex mod_num/port_num {full | half} | Sets the port duplex mode. | P | |
set port enable mod_num/port_num | Enables a port or a range of ports. | P | |
set port filter mod_num/port_num {mac_addr | protocol_type} {permit | deny} | Configures a MAC address filter or a protocol filter. | P | |
set port flowcontrol {mod_num/port_num} {receive | send} {off | on | desired} | Sets the receive flow-control value for a particular port. | P | |
set port gmrp {mod/ports...} {enable | disable} | Enables or disables GMRP on specified ports, in all VLANs. | P | |
set port gvrp {mod/ports...} {enable | disable} | Enables or disables GVRP on specified ports, in all VLANs. | P | |
set port level mod_num/port_num {normal | high} | Sets the priority level of a port. | P | |
set port membership mod_num/port_num {dynamic | static} | Dynamically or statically assigns a port to a VLAN membership. | P | |
set port name mod_num/port_num [port_name] | Sets the name of a port. | P | |
set port negotiation mod_num/port_num {enable | disable} | Sets the link negotiation protocol for a port. | P | |
set port protocol mod/ports... {ip | ipx | group} {on | off | auto} | Enables or disables protocol membership of ports. | P | |
set port qos mod/ports.. cos cos_value | Assigns CoS value to a port. | P | |
set port security mod/ports... {enable | disable} [mac_addr] | Enables or disables port security on a port of an Ethernet module. | P | |
set port speed mod_num/port_num {4 | 10 | 16 | 100 | auto} | Sets the port speed. | P | |
set port trap mod_num/port_num {enable | disable} | Enables or disables the standard SNMP link trap (up or down) for a port. | P | |
set prompt prompt_string | Sets the CLI prompt. | P | |
set protocolfilter {enable | disable} | Activates or deactivates protocol filtering. | P | |
set qos enable | disable | Enables or disables QoS functionality. | P | |
set qos ip-filter cos {src_ip_addr_spec} {dest_ip_addr_spec} [before ACE# | modify ACE#] | Creates a new IP ACE. | P | |
set qos mac-cos dest_mac vlan cos | Assigns a CoS value to all frames. | P | |
set qos map port_type q# thr# cos coslist | Assigns CoS values to a transmit drop threshold. | P | |
set qos router-mac mac_address vlan | Assigns a MAC address to a router. | P | |
set qos wred-threshold port_type [tx] queue {q# thr1 thr2 thr3 thr4}[wred_threshold] | Configures the transmit drop thresholds for all ports on the switch. | P | |
set radius deadtime minutes | Sets time to skip RADIUS servers that do not reply. | P | |
set radius key key | Sets RADIUS encryption key. | P | |
set radius retransmit count | Sets iterations of RADIUS server list. | P | |
set radius server ipaddr [auth-port port] [primary] | Sets RADIUS server address. | P | |
set radius deadtime seconds | Sets time to wait for RADIUS server reply. | P | |
set rsmautostate {enable | disable} | Sets the line protocol state determination of the RSMs due to Catalyst 5000 and 2926G series port state changes. | P | |
set snmp community {read-only | read-write | read-write-all} [community_string] | Sets SNMP communities and associated access types. | P | |
set snmp extendedrmon {enable | disable} | Enables or disables the Network Analysis Module. | P | |
set snmp extendedrmon netflow {enable password | disable} | Enables or disables the Netflow extended SNMP RMON support. | P | |
set snmp extendedrmon vlanagent {enable | disable} | Enables or disables the VLANagent option. | P | |
set snmp extendedrmon vlanmode {enable | disable} | Enables or disables the VLAN mode for extended SNMP RMON. | P | |
set snmp rmon {enable | disable} | Enables or disables SNMP RMON support. | P | |
set snmp trap {enable | disable} [all | module | chassis | bridge | repeater | auth | vtp | ippermit | vmps | config | entity | stpx] | Enables or disables SNMP traps. Also sets the SNMP trap receiver address and community. | P | |
set span disable [dest_mod/dest_port | all] | Enables or disables SPAN. Also sets the source and destination SPAN ports. | P | |
set spantree backbonefast {enable | disable} | Enables or disables the Spanning-Tree Backbone Fast Convergence feature. | P | |
set spantree disable all | Disables spanning tree. | P | |
set spantree enable all | Enables spanning tree. | P | |
set spantree fwddelay delay [vlan] | Sets the bridge forward delay for a VLAN. | P | |
set spantree hello interval [vlan] | Sets the bridge hello interval for a VLAN. | P | |
set spantree maxage agingtime [vlan] | Sets the bridge maximum aging time for a VLAN. | P | |
set spantree multicast-address trbrf_num {ieee | ibm} | Specifies the bridge functional address instead of the IEEE Spanning-Tree Protocol address. | P | |
set spantree portcost {mod_num/port_num | trcf} cost | Sets the bridge path cost for a port. | P | |
set spantree portfast mod_num/port_num {enable | disable} | Enables or disables fast-start mode on a port. | P | |
set spantree portpri {mod_num/port_num | trcrf} [priority | trcrf_priority] | Sets the bridge priority for a spanning-tree port. | P | |
set spantree portstate trcf {block | forward | auto} [trbrf] | Sets the forwarding state for a spanning-tree port. | P | |
set spantree portvlancost mod_num/port_num [cost cost_value] [preferred_vlans] | Assigns a lower path cost to a set of VLANs on a port. | P | |
set spantree portvlanpri mod_num/port_num priority [vlans] | Sets the port priority for a subset of VLANs in the trunk port. | P | |
set spantree priority bridge_priority [vlan] | Sets the bridge priority for a VLAN. | P | |
set spantree root [secondary] [vlan_list] [dia network_diameter] [hello hello_time] | Sets the primary or secondary root for specific VLANs or for all VLANs of the switch. | P | |
set spantree uplinkfast enable [rate station_update_rate] [all-protocols {off | on}] | Enables fast switchover to alternate ports when the root port fails. | P | |
set summertime {enable | disable} [zone] | Sets the clock adjustment for daylight saving time. | P | |
set system baud rate | Sets the console port baud rate. | P | |
set system contact [contact_string] | Sets the system contact information. | P | |
set system location [location_string] | Sets the system location information. | P | |
set system modem {enable | disable} | Enables or disables modem control lines on the console port. | P | |
set system name [name_string] | Sets the system name. | P | |
set tacacs attempts count | Sets the maximum number of TACACS+ login attempts allowed. | P | |
set tacacs directedrequest {enable | disable} | Sets the TACACS+ directed-request option. | P | |
set tacacs key key | Sets the TACACS+ authentication and encryption key. | P | |
set tacacs server ip_addr [primary] | Sets the IP address of TACACS+ servers. | P | |
set tacacs timeout seconds | Sets the response timeout interval for the TACACS+ server daemon. | P | |
set time [day_of_week] [mm/dd/yy] [hh:mm:ss] | Sets the system time. | P | |
set timezone [zone_name] [hours [minutes]] | Sets the time zone. | P | |
set tokenring acbits mod_num/port_num {enable | disable | sronly | never | always} | Sets whether AC bits are set unconditionally when a port forwards certain LLC frames. | P | |
set tokenring configloss mod_num/port_num [threshold thresh_num] [interval int_num] | Sets thresholds that, when exceeded, cause the port to be administratively disabled. | P | |
set tokenring distrib-crf {enable | disable} | Enables or disables distribution of TrCRF VLANs. | P | |
set tokenring etr mod_num/port_num {enable | disable} | Enables or disables the early token release procedure when transmitting frames. | P | |
set tokenring locallearning mod_num/port_num enable | disable | Enable or disables local MAC address learning on a Token Ring port. | P | |
set tokenring portaging mod_num/port_num agingtime | Specifies the address aging limits for a Token Ring port. | P | |
set tokenring portmode mod_num/port_num {auto | fdxcport | hdxcport | fdxstation | hdxstation | riro} | Specifies the connection type and access protocol used by a port. | P | |
set tokenring priority mod_num/port_num {threshold thresh_num | minxmit min_num} | Specifies the highest and lowest Token Ring frame priority. | P | |
set tokenring reduction {enable | disable} | Reduces broadcast storms in an externally looped network. | P | |
set trunk mod_num/port_num [on | off | desirable | auto | nonegotiate] [vlan_range] [isl | dot1q | dot10 | lane | negotiate] | Configures trunk ports. | P | |
set udld enable | disable mod/ports... | Enables or disables UDLD on a port. | P | |
set vlan vlan_num mod_num/port_list | Creates and configures options for VLANs. | P | |
set vlan mapping dot1q 1q_vlan_num isl isl_vlan_num | Maps 802.1Q VLANs to ISL VLANs. | P | |
set vmps server ip_addr [primary] | Sets the IP address of the VMPS server. | P | |
set vmps state {enable | disable} | Enables or disables VMPS. | P | |
set vmps tftpserver ip_addr [filename] | Specifies the IP address of the VMPS TFTP server. | P | |
set vtp [domain domain_name] [mode {client | server | transparent}] [passwd passwd] [pruning {enable | disable}] [v2 {enable | disable}] | Sets VTP options. | P | |
set vtp pruneeligible vlans | Configures pruning eligibility for the device. | P | |
show alias [name] | Shows aliases for commands. | N | |
show arp [ip_addr | hostname][noalias] | Shows the ARP table. | N | |
show authentication | Displays authentication information. | N | |
show boot [mod_num] | Displays the contents of the BOOT environment variables and the configuration register setting. | N | |
show bridge | Displays bridge information. | N | |
show cam [count]{dynamic | static | permanent | system} [vlan] | Shows the CAM table. | N | |
show cam agingtime | Shows CAM aging time information for all configured VLANs. | N | |
show cam mlsrp {ip_addr}[vlan] | Shows the specified router entries in the MLS forwarding table. | N | |
show cdp | Displays CDP information. | N | |
show cgmp leave | Displays CGMP leave feature statistical information. | N | |
show cgmp statistics [vlan_id] | Displays CGMP statistical information. | N | |
show config | Shows the current system configuration. | P | |
show counters mod/port | Displays hardware counters for a port. | N | |
show drip statistics | Displays DRiP statistical information. | P | |
show dvlan statistics | Displays DVLAN statistical information. | N | |
show fddi | Displays the settings of the FDDI/CDDI modules. | N | |
show fddicam mod_num [fddi] [mac_addr] | Displays the CAM table for the FDDI/CDDI modules. | N | |
show flash [[m/]device:] [all | chips | filesys] | Lists Flash code information. | N | |
show gmrp configuration | Displays complete GMRP-related configuration information. | N | |
show gmrp statistics [vlan] | Displays all the GMRP-related statistics for a specified VLAN. | N | |
show gmrp timer | Displays all the values for the GARP timers. | N | |
show gvrp configuration | Displays all the GVRP configuration information. | N | |
show gvrp statistics [mod/port] | Displays all the GVRP-related statistics. | N | |
show ifindex number | Displays ifIndex information. | N | |
show igmp statistics [vlan_id] | Displays IGMP statistics for a particular VLAN. | N | |
show imagemib flash | filename | Displays image information provided in the CISCO-IMAGE-MIB for a particular image. | N | |
show interface | Shows information about network interfaces and standard SNMP link trap operation | N | |
show ip alias [name] | Shows aliases for IP addresses. | N | |
show ip dns | Shows the DNS name server and the default domain name. | N | |
show ip permit [noalias] | Shows IP permit list information. | N | |
show ip route [noalias] | Displays the IP routing table. | N | |
show log [mod_num] | Displays system and module error logs. | N | |
show logging [noalias] | Displays the system message log configuration. | N | |
show logging buffer [-] [number_of_messages] | Displays system messages from the internal buffer. | N | |
show mac [mod_num[/port_num]] | Shows MAC counters. | N | |
show microcode | Displays the switch microcode version. | N | |
show mls [ip | ipx] | Displays MLS shortcut information. | N | |
Displays a list of all MLS-related debugging information. | P | ||
show mls multicast entry [rp ip_addr] [vlan vlan_id] [group ip_addr] [source ip_addr] [all] [short | long] | Displays MLS multicast information. | N | |
show mls statistics protocol | Displays MLS statistical information. | N | |
show module [mod_num] | Shows module information. | N | |
show moduleinit [mod_num] [log lognum | -logcount] | Displays contents of the information stored in the system module bringup log. | N | |
show multicast group [mac_addr] [vlan_id] | Displays the multicast group configuration. | N | |
show multicast group count [vlan_id] | Shows the total count of multicast addresses (groups) in a VLAN. | N | |
show multicast router [cgmp | igmp] [mod_num/port_num] [vlan_id] | Displays the multicast router configuration. | N | |
show netstat [tcp | udp | ip | icmp | routes | stats | interfaces] | Shows currently active network connections and network statistics for the TCP/IP stack. | N | |
show ntp | Displays the current NTP status. | N | |
show port [mod_num[/port_num]] | Shows port status and counters. | N | |
show port broadcast [mod_num[/port_num]] | Displays broadcast information. | N | |
show port capabilities [mod_num[/port_num]] | Displays the capabilities of the modules and ports in a switch. | N | |
show port cdp [mod_num[/port_num]] | Displays port CDP information. | N | |
show port channel [mod][info | statistics] | Shows EtherChannel information. | N | |
show port counters [mod_num/port_num] | Displays the counters for a port. | N | |
show port filter [mod_num] [canonical] | Displays configured MAC addresses and protocol filters. | N | |
show port flowcontrol [mod_num[/port_num]] | Displays per port flow control status and statistics. | N | |
show port ifindex [mod_num] | Displays ifIndex information on a per-port or per-module basis. | N | |
show port negotiation [mod_num[/port_num]] | Displays the link negotiation protocol setting for the specified port. | N | |
show port protocol [mod_num[/port_num]] | Displays protocol filters. | N | |
show port qos mod_num/port_num | Displays QoS-related information for a specifc port or all ports on a module. | N | |
show port status [mod_num[/port_num]] | Displays port status information. | N | |
show proc [cpu | mem] | Displays CPU and process information. | P | |
show protocolfilter | Displays enabled or disabled status of protocol filters. | N | |
show qos info {runtime | config} {mod_num/port_num} | Displays the currently configured QoS-related information for a specified port. | N | |
show qos ip | Displays the access control list. | N | |
show qos mac-cos dest_mac [vlan] | Displays the currently configured QoS-related information MAC/VLAN pair. | N | |
show qos router-mac [mac_addr | vlan] | Displays QoS router information for the MAC address and VLAN pair. | N | |
show qos statistics {mod_num[/port_num]} | Displays the various QoS-related counters for a specified port. | N | |
show radius [noalias] | Displays configured RADIUS parameters. | N | |
show rif [vlan_num] | Displays RIF information. | N | |
show rsmautostate mod_num | Displays the line protocol state determination of the RSMs. | N | |
show snmp [noalias] | Shows SNMP information. | N | |
show span | Shows SPAN port monitoring information. | N | |
show spantree [vlan | mod_num/port_num] [active] | Shows spanning-tree information. | N | |
show spantree backbonefast | Displays whether the spanning-tree Backbone Fast Convergence feature is enabled. | N | |
show spantree blockedports [vlan_num] | Displays only the blocked ports. | N | |
show spantree portstate [trcrf ] | Determines the current spanning-tree state of a Token Ring port within a spanning tree. | N | |
show spantree portvlancost mod_num/port_num | Displays the path cost for the VLANs on a port. | N | |
show spantree statistics mod_num/port_num [vlan] | Displays spanning-tree statistical information. | N | |
show spantree summary | Displays a summary of spanning-tree information. | N | |
show spantree uplinkfast | Displays UplinkFast settings information. | N | |
show standbyports | Displays the current status of the standby ports feature. | N | |
show station controltable [mod_num[/port_num]] | Displays a collection of statistics and status information associated with each Token Ring station on the local ring. | N | |
show station ordertable [mod_num[/port_num]] | Displays a listing of the order of stations on the monitored rings. | N | |
show summertime | Displays the current status of the summertime feature. | N | |
show system | Shows system information. | N | |
show tacacs [noalias] | Displays the TACACS+ configuration. | N | |
show test [mod_num] | Shows the results of diagnostic tests. | N | |
show time | Shows the current system time. | N | |
show timezone | Shows the current time zone and offset. | N | |
show tokenring | Displays various Token Ring configuration parameters. | N | |
show top [N] [metric] [interval interval] [port_type] [background] | Starts the TopN process. | N | |
show top report [report_num] | Lists all TopN processes and specific TopN reports. | N | |
show traffic | Displays traffic/peak information. | N | |
show trunk [mod_num[/port_num]][detail] | Shows trunking information for the switch. | N | |
show udld | Displays UDLD information. | N | |
show users [noalias] | Shows whether the console port is active. Also lists all active Telnet sessions. | N | |
show version | Shows software and hardware version information. | N | |
show vlan [trunk] | Shows VLAN information. | N | |
show vlan mapping | Shows VLAN mapping information. | N | |
show vmps [noalias] | Displays VMPS configuration information. | N | |
show vmps mac [mac_addr] | Displays the MAC-address-to-VLAN mapping table. | N | |
show vmps statistics | Displays VMPS statistics. | N | |
show vmps vlan vlan_name | Displays MAC address to VLAN mappings in the VMPS table. | N | |
show vmps vlanports vlan_name | Displays ports belonging to a restricted VLAN. | N | |
show vtp domain | Shows VTP domain information. | N | |
show vtp statistics | Shows VTP statistics. | N | |
slip {attach | detach} | Attaches or detaches SLIP for the console port. | P | |
squeeze [m/]device: | Permanently deletes Flash files. | P | |
switch {clock | supervisor} | Switches between clocks or from the active to the standby supervisor. | P | |
telnet host [port_num] | Starts a Telnet connection to a remote host. | P | |
test snmp trap trap_num [specific_num] | Sends an SNMP trap message to the trap receivers. | P | |
traceroute [-n] [-w wait_time] [-i initial_ttl] [-m max_ttl] [-p dest_port] [-q nqueries] [-t tos] host [data_size] | Displays a hop-by-hop path through an IP network from the Catalyst 5000, 4000, 2948G, and 2926G series switches to a specific destination host. | P | |
undelete index [[m/]device:] | Undeletes a file. | P | |
upload host file [mod_num] | Uploads a software image to a network host. | P | |
verify [[m/]device:] filename | Verifies the checksum of a file on a Flash device. | P | |
wait seconds | Causes the CLI to pause for a specified number of seconds. | N | |
whichboot | Displays the name of the active boot device. | P | |
write {host file | network | terminal} | Uploads the current configuration to a host or displays it on the terminal. | P | |
write erase | Erases the configuration information in NVRAM. | P | |
write memory | Copies the configuration information in running memory to NVRAM. | P | |
write terminal | Displays the system configuration information currently in running memory. | P |
You can configure and maintain the Catalyst 5000 and 2926G series ATM module by entering commands from the ATM module CLI. The ATM module CLI uses a subset of the Cisco IOS software commands. Generally, Cisco IOS software works the same on the ATM module as it does on routers.
The Catalyst 4000 and 2948G series switches do not support the ATM module CLI.
You can open a session with the ATM module on Catalyst 5000 and 2926G series switches by using the session mod_num command from the switch CLI Console> prompt. After you enter this command, the switch responds with the Enter Password prompt. Enter atm as the default password. At this point, you are at the ATM> prompt, and you have direct access only to the ATM module with which you have established a session.
This example shows how to establish a session with the ATM module (in this case, module 5):
Console> (enable) session 5 Trying ATM-5... Connected to ATM-5. Escape character is '^]'. ATM>
This section describes the command modes and functions that allow you to access and operate the ATM module CLI.
This section describes how to access and list the commands in each of the command modes in the Cisco IOS user interface and explains the primary uses for each command mode. Cisco IOS software provides two levels of access to commands: user and privileged. The user mode is called user EXEC mode. The privileged mode is called privileged EXEC mode. The default password to access the privileged EXEC mode on the ATM module is atm. The commands available in user EXEC mode are a subset of those available in privileged EXEC mode.
Table 1-5 lists the command modes, how to access each mode, the prompt you see while you are in that mode, the main uses for each configuration mode, and the method to exit that mode. The prompts listed assume the default name ATM.
| Command Mode | Access Method | Prompt | Exit Method |
|---|---|---|---|
User EXEC | Use the session command in the switch CLI. | ATM> | Enter the logout command. |
Privileged EXEC | From user EXEC mode, enter the enable EXEC command. Enter the enable password at the prompt (default is atm). | ATM# | Enter the disable command. |
Global configuration | From privileged EXEC mode, enter the configure privileged EXEC command. | ATM(config)# | Enter the exit or end command, or press Ctrl-Z. |
Interface configuration | From global configuration mode, enter the interface interface_num command. | ATM (config-if)# | To exit to global configuration mode, enter the end command. To exit to privileged EXEC mode, enter the exit command, or press Ctrl-Z. |
Subinterface configuration | From interface configuration mode, enter the interface sub_interface_num command. | ATM (config-subif)# | To exit to global configuration mode, enter the end command. To exit to privileged EXEC mode, enter the exit command, or press Ctrl-Z. |
Line configuration | From global configuration mode, enter the line line_number command. | ATM (config-line)# | To exit to global configuration mode, enter the exit command. To exit to privileged EXEC mode, enter the end command, or press Ctrl-Z. |
LANE database configuration | From global configuration mode, enter the lane database command. | ATM (config-if)# | To exit to global configuration mode, enter the exit command. To exit to privileged EXEC mode, enter the end command, or press Ctrl-Z. |
After you log in to the ATM module, you are automatically in user EXEC command mode. The user EXEC commands are a subset of the privileged EXEC commands. The user EXEC commands allow you to change terminal settings on a temporary basis, perform basic tests, and list system information.
To list the commands available in user EXEC mode, enter a question mark (?) at the ATM> prompt.
The user EXEC-level prompt is:
ATM>
Because many privileged commands set operating parameters, privileged access is password-protected to prevent unauthorized use. The privileged command set includes all of the commands available in user EXEC mode, as well as the debug commands and the configure command, which is used to access the other configuration command modes.
To access and list the privileged EXEC commands, perform this task:
| Task | Command |
|---|---|
Step 1 Enter privileged EXEC mode. | enable password |
Step 2 List privileged EXEC commands. | ? |
If the system administrator has set a password, you are prompted to enter the password before you are allowed access to privileged EXEC mode. The password is not displayed on the screen and is case sensitive. If an enable password has not been set, you can only access privileged EXEC mode from the console. The default password for the ATM module is atm.
This example shows how to access privileged EXEC mode:
ATM> enable Password: ATM#
From privileged EXEC mode, you can access global configuration mode. For instructions, see the next section "Global Configuration Mode."
To return from privileged EXEC mode to user EXEC mode, enter the disable command.
Global configuration commands apply to features that affect the ATM module as a whole. Use the configure privileged EXEC command to enter global configuration mode. When you enter this command, the EXEC prompts you for the source of the configuration commands:
Configuring from terminal, memory, or network [terminal]?
You can specify either the terminal or NVRAM as the source of configuration commands (refer to the Cisco IOS configuration guide and command reference publications for complete information on Cisco IOS commands). The default is to enter commands from the console terminal. Press Return to enter terminal configuration mode.
To access and list the global configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 At the console terminal, from privileged EXEC mode, enter global configuration mode. | configure |
Step 2 List the global configuration commands. | ? |
This example shows how to access global configuration mode:
ATM#configure terminal Enter configuration commands, one per line. End with CNTL/Z. ATM(config)#
To exit global configuration command mode and return to privileged EXEC mode, enter the exit or end command or press Ctrl-Z.
Interface configuration commands modify the operation of the ATM interface. Interface configuration commands always follow an interface global configuration command, which identifies the interface type and number.
To access and list the interface configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, enter interface configuration mode. | interface atm0 |
Step 2 List the interface configuration commands. | ? |
Step 3 From interface configuration mode, enter subinterface configuration mode. | interface atm0.sub_interface_num mul |
Step 4 List the subinterface configuration commands. | ? |
This example shows how to access interface configuration mode:
ATM(config)#interface atm0 ATM(config-if)#
This example shows how to access subinterface configuration mode:
ATM(config-if)#interface atm0.1 ATM(config-subif)#
To exit interface configuration mode and return to global configuration mode, enter the exit command.
To exit global configuration mode and return to privileged EXEC mode, enter the end command or press Ctrl-Z.
Line configuration commands modify the operation of a virtual terminal line. Line configuration commands always follow a line global configuration command, which identifies the line number. These commands change terminal parameter settings either on a line-by-line basis or for a range of lines.
To access and list the virtual terminal line configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, configure a virtual terminal line. | line [vty] line-number [ending-line-number]1 |
Step 2 List the line configuration commands. | ? |
| 1This command is documented in the "Terminal Lines and Modem Support Commands" chapter in the Router Products Command Reference publication. |
This example shows how to enter line configuration mode for virtual terminal line 4:
ATM(config)# line 0 4 ATM(config-line)#
To exit line configuration mode and return to global configuration mode, enter the exit command.
To exit global configuration mode and return to privileged EXEC mode, enter the end command or press Ctrl-Z.
This section describes how to perform ATM-related tasks on the Catalyst 5000 and 2926G series ATM module.
Entering a question mark (?) at the system prompt displays a list of commands for each command mode. You can also use ? to see the keywords and arguments associated with a command.
To get help specific to a command mode, a command, a keyword, or arguments, perform one of these tasks:
| Task | Command Mode | Command |
|---|---|---|
| Any | ? |
| Any | help |
The user interface provides error isolation with an error indicator (^). The ^ symbol appears at the point in the command string where you have entered an incorrect command, keyword, or argument. The error location indicator and interactive help system allow you to find and correct syntax errors.
The ATM module CLI provides a history or record of commands you have entered. This feature is useful for recalling long or complex commands or entries.
By default, the system records ten command lines in its history buffer. To alter the behavior of the command history feature, perform one of these tasks:
| Task | Command |
|---|---|
| terminal history [size number-of-lines]1 |
| terminal no history [size]1 |
| 1This command is documented in the "User Interface Commands" chapter of the Cisco IOS Configuration Fundamentals Command Reference publication. |
The command history feature is enabled automatically. To disable it for the current terminal session, complete this task in EXEC mode:
| Task | Command |
|---|---|
Disable the command history feature for the current session. | terminal no history1 |
| 1This command is documented in the "User Interface Commands" chapter of the Cisco IOS Configuration Fundamentals Command Reference publication. |
Catalyst 5000 and 2926G series software release 4.3 and above includes an enhanced editing mode that provides editing key functions similar to those of the Emacs editor. You can enter commands in uppercase, lowercase, or a mix of both. Only passwords are case sensitive.
You can abbreviate commands and keywords by using enough characters to form a unique abbreviation. For example, you can abbreviate the show command to sh because show is the only command that begins with "sh."
The enhanced editing mode is enabled automatically, but you can disable it using the no editing command.
Use the following keystrokes to move the cursor around on the command line to make corrections or changes:
Ctrl-B or press the left arrow key1. Ctrl-F or press the right arrow key1. Ctrl-A Ctrl-E Esc B Esc F
Task
Keystrokes
1The arrow keys function only on ANSI-compatible terminals such as a VT100.
If you cannot remember a complete command name, enter the first few letters of a command and press the Tab key to allow the system to complete a partial entry.
The system provides a buffer that contains the last ten items you deleted. You can recall these items and paste them in the command line by performing these tasks:
| Task | Keystrokes |
|---|---|
| Ctrl-Y |
| Esc Y |
The editing command set has a wraparound feature. When the cursor reaches the right margin, the command line shifts ten spaces to the left. You cannot see the first ten characters of the line, but you can scroll back and check the syntax at the beginning of the command. To scroll back, perform this task:
| Task | Keystrokes |
|---|---|
Return to the beginning of a command line to verify that you have entered a lengthy command correctly. | Press Ctrl-B or the left arrow key repeatedly until you scroll back to the beginning of the command entry, or press Ctrl-A to return directly to the beginning of the line1. |
| 1The arrow keys function only on ANSI-compatible terminals such as VT100. |
In this example, the lane config-atm-address command entry extends beyond one line. When the cursor reaches the end of the line, the line shifts ten spaces to the left and is redisplayed. The dollar sign ($) indicates that the line scrolled to the left. Each time the cursor reaches the end of the line, the line shifts ten spaces to the left.
ATM(config-subif)# lane config-atm-address 39.000000000000014155551211.080020 ATM(config-subif)#$ -atm-address 39.000000000000014155551211.0800200c1001.00 When you complete the entry, press Ctrl-A to check the complete syntax, and then press Return to execute the command. The dollar sign ($) appears at the end of the line to indicate that the line scrolled to the right: ATM(config-subif)# lane config-atm-address 39.000000000000014155551211.080020 $
The system assumes your terminal screen is 80 columns wide. If your screen has a different width, enter the terminal width command to tell the router the correct width of your screen.
Perform any of these tasks to delete command entries if you make a mistake or change your mind:
| Task | Keystrokes |
|---|---|
| Delete or Backspace |
| Ctrl-D |
| Ctrl-K |
| Ctrl-U or Ctrl-X |
| Ctrl-W |
| Esc D |
When you use help to list the commands in a particular mode, the list is often longer than the terminal screen can display. In such cases, a ---More--- prompt displays at the bottom of the screen. To view the next line or screen, complete these tasks:
| Task | Keystrokes |
|---|---|
| Return |
| Spacebar |
If you enter a command and the system sends a message to your screen (such as the output of a debug command), you can recall your current command line entry by performing this task:
| Task | Keystrokes |
|---|---|
Redisplay the current command line. | Ctrl-L or Ctrl-R |
If you mistype a command entry, you can transpose the mistyped characters by performing this task:
| Task | Keystrokes |
|---|---|
Transpose the character to the left of the cursor with the character located at the cursor. | Ctrl-T |
You can capitalize or lowercase words or capitalize a set of letters by performing these tasks:
| Task | Keystrokes |
|---|---|
| Esc C |
| Esc L |
| Esc U |
Sometimes you might want to use a particular keystroke as an executable command. Complete this task to insert a system code for this purpose:
| Task | Keystrokes |
|---|---|
Insert a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not an editing key. | Ctrl-V or Esc Q |
After entering configuration commands or performing other tasks, exit the ATM module and quit the session by entering the quit command.
Table 1-6 identifies each command in the ATM module command set, gives the command syntax, provides a short description, and specifies the command type and mode. The command type and mode indicate the following:
The commands listed in this section are not supported by the Catalyst 4000 and 2948G series switches.
| Command | Syntax | Description | Type | Mode |
|---|---|---|---|---|
atm-address atm-address | Overrides the control ATM address. | ATM | IC | |
atm bind pvc vlan vcd vlan_num | Binds a PVC to a specified VLAN. | ATM | IC | |
atm clock internal | Specifies the transmit clock source. | ATM | IC | |
atm ds-3 scramble | Enables or disables scrambling on the current port. | ATM | IC | |
atm framing [m23adm | cbitplcp | m23plcp] | Changes the default DS3 line framing. | ATM | IC | |
Enables or disables the ILMI. | ATM | IC | ||
atm ilmi-keepalive seconds | Enables ILMI keepalives. | ATM | IC | |
atm lbo {short | long} | Sets the line buildout corresponding to the cable length. | ATM | IC | |
atm preferred phy {A | B} | Changes the preferred PHY. | ATM | IC | |
atm pvc vcd vpi vci [aal5snap | ilmi | qsaal] | Creates a PVC on the ATM interface. | ATM | IC | |
atmsig close atm0 vcd | Disconnects an SVC. | ATM | IC | |
atm sonet {stm-1 | sts-3c} {stm-4 | sts-12c} | Sets the mode of operation and control type for cell-rate decoupling. | ATM | IC | |
atm traffic-shape rate 1-155 | Configures output throttling on the ATM module. | ATM | IC | |
atm uni-version version_num | Specifies the UNI version to be used. | ATM | GC | |
atm vc-per-vp num | Sets the maximum number of VCIs to support per VCI. | ATM | IC | |
clear mpoa client [name mpc_name] cache [ingress | egress] [ip-address ip-address] | Clears ingress/egress cache entries of one or all MPCs. | ATM | EXEC | |
client-atm-address atm-address-template name elan-name | Adds a LANE address entry to the configuration server's database. | ATM | Dbase | |
debug mpoa client {all | data | egress | general | ingress | keep-alives | platform-specific} [name mpc_name] | Displays debug information for the MPC. | ATM | EXEC | |
default-name elan-name | Provides a default ELAN name in the configuration server's database. | ATM | Dbase | |
disable [level] | Exits privileged EXEC mode and returns to user EXEC mode. | ATM | EXEC | |
display-databases | Displays all the LECS database tables. | ATM | Dbase | |
editing | Enables enhanced editing mode. | ATM | Line | |
enable | Enters privileged EXEC mode. | ATM | EXEC | |
end | Exits configuration mode. | ATM | GC | |
exit | Exits any command mode or closes an active terminal session and terminates the EXEC. | ATM | All | |
help | Displays the help commands. | ATM | All | |
history [size number-of-lines] | Enables the command history function. | ATM | Line | |
interface atm_num[.sub_interface_num mul] | loopback_num | Enters the configure interface or subinterface mode. | ATM | IC | |
lane [config] auto-config-atm-address | Specifies the ATM address is computed automatically. | ATM | IC | |
lane bus-atm-address bus_name atm-addr | Sets the ATM address for the BUS. | ATM | IC | |
lane client [ethernet vlan_num [elan-name]] | Activates a LANE client. | ATM | IC | |
lane client-atm-address atm-address-template | Specifies an ATM address for the LANE client (overriding automatic assignment). | ATM | IC | |
lane client mpoa client name mpc-name | Binds a LEC to the named MPC. | ATM | IC | |
lane config-atm-address atm-address-template | Specifies the ATM address of a given configuration server. | ATM | IC | |
lane config database database-name | Associates a named configuration database with the configuration server on the selected ATM interface. | ATM | GC | |
lane database database-name | Creates a named configuration database that can be associated with a configuration server. | ATM | GC | |
lane le-arp mac-addr atm-addr | Adds a static entry to the LE ARP table. | ATM | IC | |
lane register vcd mac-addr atm-addr | Registers a LANE client. | ATM | IC | |
lane server-atm-address les_name atm-address-template | Configures the LES ATM address template. | ATM | IC | |
lane server-bus {ethernet | tokenring} elan_name [elan-id id] | Configures the LES and BUS for the specified ELAN on the subinterface. | ATM | IC | |
mac-address ieee-address | Defines the MAC layer address. | ATM | IC | |
mpoa client config name mpc-name | Defines an MPC with a specified name. | ATM | IC | |
mpoa client name mpc-name | Attaches an MPC to a major ATM interface. | ATM | IC | |
mtu size | Sets the interface MTU size. | ATM | IC | |
name elan-name elan-id id {local-seg-id | new-name | preempt | restricted | server-atm-address | un-restricted} atm-addr | Assigns a unique ELAN name to a LES.4 | ATM | Dbase | |
reload | Reloads the operating system. | ATM | EXEC | |
shortcut-frame-count count | Specifies the maximum number of times a packet can be routed to the default router within the shortcut-frame time before an MPOA resolution request is sent. | ATM | MPC | |
shortcut-frame-time time | Sets the shortcut-setup frame time (in seconds) for the MPC. | ATM | MPC | |
show atm ilmi-status atm mod_num/subcard_num/port_num | Displays ILMI information about the ATM interface. | ATM | EXEC | |
show atm interface atm0 | Displays information about the ATM interface. | ATM | EXEC | |
show atm traffic | Displays global ATM traffic information. | ATM | EXEC | |
show atm vc [vcd] | Displays the active ATM virtual circuits. | ATM | EXEC | |
show atm vlan [vlan_num] | Displays the active VLAN-to-PVC bindings. | ATM | IC | |
show history | Lists the command history for the current EXEC session. | ATM | EXEC | |
show lane [interface atm0[.subinterface] | name elan-name] [brief] | Displays global and per-VCC LANE information. | ATM | EXEC | |
show lane bus [interface atm0[.subinterface] | name elan-name] [brief] | Displays LANE information for the configured BUS. | ATM | EXEC | |
show lane client [interface atm0[.subinterface] | name elan-name] [brief] | Displays global and per-VCC LANE information. | ATM | EXEC | |
show lane config [interface atm0] [brief] | Displays LANE information for the LECS. | ATM | EXEC | |
show lane default-atm-addresses | Displays default ATM addresses for dual PHYs. | ATM | EXEC | |
show lane le-arp [interface atm0[.subinterface] | name elan-name] | Displays the LE ARP table. | ATM | EXEC | |
show lane server [interface atm0[.subinterface] | name elan-name] [brief] | Displays LANE information about the configured LES. | ATM | EXEC | |
show mpoa client [name mpc-name] [brief] | Displays a summary of information regarding one/all MPCs. | ATM | EXEC | |
show mpoa client [name mpc-name] cache [ingress | egress] [ip-address ip-address] | Displays the ingress and/or egress cache entries matching the IP addresses for the MPCs. | ATM | EXEC | |
show mpoa client [name mpc-name] statistics | Displays all the statistics collected by an MPC. | ATM | EXEC | |
show mpoa default-atm-addresses | Displays the default ATM addresses for the MPC. | ATM | EXEC | |
show sscop | Displays SSCOP details for all ATM interfaces. | ATM | EXEC | |
show version | Displays version information for the ATM module. | ATM | EXEC | |
shutdown | Shuts down or restarts a physical interface. | Config | IC | |
sscop cc-timer msecs | Changes (in msecs) the SSCOP connection control timer value. | ATM | IC | |
sscop keepalive-timer msecs | Changes the SSCOP keepalive timer period (in msecs). | ATM | IC | |
sscop max-cc retries | Changes the maximum number of retries for connection control operations. | ATM | IC | |
sscop max-stat entries | Changes the maximum number of entries in a Stat frame. | ATM | IC | |
sscop poll-timer msecs | Changes the maximum time (in msecs) to wait for a response before sending a POLL PDU. | ATM | IC | |
sscop receive-window packets | Changes the size of the SSCOP receiver window. | ATM | IC | |
sscop send-window packets | Changes the size of the SSCOP transmitter window. | ATM | IC | |
terminal length [screen-length] | Sets the number of lines displayed on the terminal. | ATM | EXEC | |
write terminal | Displays the ATM configuration information currently in running memory. | ATM | EXEC |
The ROM monitor is a ROM-based program that executes upon platform power-up, reset, or when a fatal exception occurs. The system enters ROM monitor mode if the switch does not find a valid system image, if the nonvolatile RAM (NVRAM) configuration is corrupted, or if the configuration register is set to enter ROM monitor mode.
The system enters ROM monitor mode if the switch does not find a valid system image, if the NVRAM configuration is corrupted, or if the configuration register is set to enter ROM monitor mode. From the ROM monitor mode, you can load a system image manually from Flash memory, from a network server file, or from bootflash.
You can also enter ROM monitor mode by restarting the switch and pressing the Break key during the first 60 seconds of startup.
To access the ROM monitor through a terminal server, you can escape to the Telnet prompt and enter the send break command for your terminal emulation program to break into ROM monitor mode.
Once you are in ROM monitor mode, the prompt changes to rommon#>. Use the ? command to see the available ROM monitor commands.
The ROM monitor commands are used to load and copy system images, microcode images, and configuration files. System images contain the system software. Microcode images contain microcode to be downloaded to various hardware devices. Configuration files contain commands entered to customize the function of Cisco IOS software.
The manual boot command has the following syntax:
Once you are in ROM monitor mode, the prompt changes to rommon #>.
Table 1-7 identifies each command in the switch command set, shows the command syntax, provides a short description, and specifies the mode for the command.
| Command | Syntax | Description |
|---|---|---|
alias [name=value] | Sets and displays aliases. | |
boot [-xv] [device][imagename] | Boots up an external process. | |
confreg [num] | Configures the configuration register utility. | |
dev | Lists the device IDs available on a platform. | |
dir device | Lists the files of the named device. | |
history | Displays the command history (the last 16 commands executed in the monitor environment). | |
meminfo [-l] | Displays switch memory information. | |
repeat [num | string] | Repeats a specified command. | |
reset {mod_num | system} | Performs a soft reset of the switch. | |
set | Displays all of the monitor variable names with their values, or sets a monitor variable. | |
sync | Saves changes to the ROM monitor configuration. | |
unalias name | Removes the alias name and associated value from the alias list. | |
unset=varname | Removes a variable name from the variable list. | |
varname=value | Assigns a variable to a value. |
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Mon Jul 19 13:13:00 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.