This chapter provides a summary of the command-line interface (CLI) commands included in the Cisco Application and Content Networking Software Command Reference. The command summary tables are grouped alphabetically in five categories: user-level EXEC commands, privileged-level EXEC commands, global configuration commands, interface configuration commands, and show EXEC commands. The CLI can be accessed through the console port or Telnet.
Using Command-Line Processing
ACNS software 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.)
Deletes from the cursor to the end of the command line.
Ctrl-L
Repeats the current command line on a new line.
Ctrl-N or the down arrow key1
Enters the next command line in the history buffer.
Ctrl-P or the up arrow key1
Enters the previous command line in the history buffer.
Ctrl-T
Transposes the character at the cursor with the character to the left of the cursor.
Ctrl-U; Ctrl-X
Deletes from the cursor to the beginning of the command line.
Ctrl-W
Deletes the 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 a mistake when entering a command; reenter the command after using this key.
1The arrow keys function only on ANSI-compatible terminals such as VT100s.
Command Modes
The four modes are:
EXEC
Domain configuration
Global configuration
Interface configuration
EXEC Mode
The two EXEC access levels are privileged and user. The enable and disable commands switch between the two levels. The user-level EXEC command line is available to users if they enter a valid password. The user-level EXEC commands are a subset of the privileged-level EXEC commands. The user-level EXEC prompt is the host name followed by a right angle bracket (>). The prompt for the privileged-level EXEC command line is the pound sign (#). To execute an EXEC command, enter the command at the EXEC system prompt and press the Return key. In the following example, a user accesses the privileged-level EXEC command line from the user level.
Console> enable
Console#
Use the Delete or Backspace key sequences to edit commands when you type commands at the EXEC prompt.
As a shortcut, you can abbreviate commands to the fewest letters that make them unique. For example, the letters sho can be entered for the show command.
Certain EXEC commands display multiple screens with the following prompt at the bottom of the screen:
--More--
Press the Spacebar to continue the output, or press Return to display the next line. Press any other key to return to the prompt. Also, at the --More-- prompt, you can enter a ? to display the help message.
To leave EXEC mode, use the exit command at the system prompt:
Console# exit
Domain Configuration Mode
Domain configuration mode allows you to configure the Content Engine as a content routing agent for specific domains. To enter domain configuration mode, use theboomerang dns global configuration command. You must be in domain configuration mode to enter domain configuration commands.
Console(config)# boomerang dns domain www.foobar.com
Console(config-domain)#
To exit domain configuration mode, use the end global configuration command:
Console(config-domain)# end
You can also exit domain configuration mode by entering theexitcommand or by pressing Ctrl-Z.
Note For a description of how to configure the Content Engine as a content routing agent, refer to the Cisco
Cache Software Configuration Guide, Release 2.5. For more information about the boomerang
content routing process, refer to the Cisco Content Routing Software Configuration Guide and
Command Reference.
Global Configuration Mode
To enter the global configuration mode, use theconfigureEXEC command. You must be in global configuration mode to enter global configuration commands.
Console# configure
Console(config)#
To exit global configuration mode, use the end global configuration command:
Console(config)# end
You can also exit global configuration mode by entering theexitcommand or by pressing Ctrl-Z.
Interface Configuration Mode
To enter interface configuration mode, use the interface global configuration command. The following example demonstrates how to enter interface configuration mode:
Console# config
Console(config)# interface ?
FastEthernet Select a fast ethernet interface to configure
GigabitEthernet Select a gigabit ethernet interface to configure
To exit interface configuration mode, enter exit to return to global configuration mode:
Console(config-if)# exit
Console(config)#
Check Command Syntax
The user interface provides error isolation in the form of an error indicator, a caret symbol (^). The ^ symbol appears at the point in the command string where you have entered an incorrect command, keyword, or argument.
In the following example, suppose you want to set the clock. Use context-sensitive help to check the syntax for setting the clock.
An example of a mistake is:
Console# clock 1222
^
%Invalid input detected at `^' marker.
Console# clock ?
read-calendar Read the calendar and update system clock
set Set the time and date
update-calendar Update the calendar with system clock
Console# clock
The help output shows that the set keyword is required. Check the syntax for entering the time:
Console# clock set ?
<0-23>: Current Time (hh:mm:ss)
Console# clock set
Enter the current time in 24-hour format with hours, minutes, and seconds separated by colons:
Console# clock set 13:32:00
% Incomplete command.
The system indicates that you need to provide additional arguments to complete the command. Press the Up Arrow to automatically repeat the previous command entry. Then add a space and question mark (?) to display the additional arguments:
Console# clock set 13:32:00 ?
<1-31> Day of the month
January Month of the year
February
March
. . .
Enter the day and month as prompted and use the question mark for additional instructions.
Console# clock set 13:32:00 23 December ?
<1993-2035> Year
Now you can complete the command entry by entering the year:
Console# clock set 13:32:00 23 December 00
^
%Invalid input detected at '^' marker.
Console#
The caret symbol (^) and help response indicate an error with the 00 entry. To display the correct syntax, press Ctrl-P or the Up Arrow. You can also reenter the command string, and then enter a space character, a question mark, and press Enter:
Console# clock set 13:32:00 23 December ?
<1993-2035> Year
Console#clock set 13:32:00 23 December
Enter the year using the correct syntax and press Return to execute the command:
Console#clock set 13:32:00 23 December 2000
WARNING: Setting the clock may cause a temporary service interruption.
Do you want to proceed? [no] yes
Sat Dec 23 13:32:00 EST 2000
Console#
System Help
You can obtain help when you enter commands by using the following methods:
For a brief description of the context-sensitive help system, enter help.
To list all commands for a command mode, enter a question mark (?) at the system prompt.
To obtain a list of commands that start with a particular character set, enter an abbreviated command immediately followed by a question mark (?).
Console# cl ?
clear clock
To list the command keywords or arguments, enter a space and a question mark (?) after the command:
Console# clock ?
clear Clear the current time from the battery-backed clock
save Save the current time into the battery-backed clock
set Set the local time and date
Save Configuration Changes
To avoid losing new configurations, save them to NVRAM using the copy or write commands, as shown in the following example:
Console# copy running-config startup-config
or
Console# write
See the command description for the copy running-config startup-configcommand for more information on "running" and "saved" configuration modes.
EXEC Command Summary
The EXEC commands are entered in the EXEC mode. Table 1-2 lists the user-level EXEC commands. Table 1-3 lists the privileged-level EXEC commands.
Table 1-2 ACNS Software User-Level EXEC Commands
User EXEC Command
Syntax
Description
cd
cddirectoryname
Changes the current directory.
cpfile
cpfileoldfilename newfilename
Copies sysfs files.
delfile
delfilename
Deletes a file.
deltree
deltreedirectory
Deletes directory and all subdirectories.
dir
dir[directory]
Displays files in long list format.
dnslookup
dnslookup {hostname | domainname}
Resolves host name (DNS).
enable
enable
Accesses privileged EXEC commands.
exit
exit
Exits from terminal session.
help
help
Provides assistance for command line-interface.
lls
lls[directory]
Displays directory files in long list format.
ls
ls [directory]
Displays files in directory.
mkdir
mkdirdirectory
Makes directory.
mkfile
mkfile filename
Makes file (for testing).
ping
ping {hostname | ip-address}
Sends echo packets.
pwd
pwd
Displays path name of the present working directory.
