cc/td/doc/product/webscale/cr
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Command-Line Interface

Command-Line Interface

This chapter provides a summary of the commands included in Cisco Content Routing software, Release 1.1. The command summary tables are grouped alphabetically in categories: user level (EXEC) commands, privileged level (EXEC) commands, interface configuration commands, global configuration commands, domain configuration commands, client list configuration commands, and show (EXEC) commands.


Note   For more detailed information about each command, refer to "Cisco Content Routing Software, Release 1.1 Commands."

EXEC Mode

To execute a command, enter the command at the EXEC system prompt and press the Return key.

There are two EXEC prompt levels: 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 greater-than sign (>). The prompt for the privileged level EXEC command line is the pound sign (#). 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

The EXEC commands are listed and described in the"EXEC Commands" section.

Global Configuration Mode

To enter global configuration mode, use the configure EXEC 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 the exit command or pressing Ctrl-Z.

The global configuration commands are listed and described in the "Global Configuration Commands" section.

Interface Configuration Mode

To enter interface configuration mode, from the global configuration mode prompt, enter the number of the interface you wish to configure:

Console(config)# interface ethernet 0 Console(config-if)#

The interface configuration commands are listed and described in the "Interface Configuration Commands" section.

To exit interface configuration mode, enter exit to return to global configuration mode:

Console(config-if)# exit Console(config)#

Domain Configuration Mode

To enter domain configuration mode, from the global configuration mode prompt, enter the boomerang dns domain domain-name command.

Console(config)# boomerang dns domain www.foo.com Console(config-domain)#

The domain configuration commands are listed and described in the "Domain Configuration Commands" section.

To exit domain configuration mode, enter exit to return to global configuration mode:

Console(config-domain)# exit

Console(config)#

Client List Configuration Mode

To enter client list configuration mode, from the global configuration mode prompt, enter the boomerang client-list list-name command. For example:

Console(config)# boomerang client-list List_C Console(config-client-lis)#

The client list configuration command is described in the "Client List Configuration Command" section.

To exit client list configuration mode, enter exit to return to global configuration mode:

Console(config-client-lis)# 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 set 1222 ^ %Invalid input detected at '^' marker. Console# clock ? set Set the time and date Console# clock

The help output shows that the set keyword is required. Check the syntax for entering the time:

Console# clock set ? hh:mm:ss Current time Console# clock set

Enter the current time:

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 reveal the additional arguments:

Console# clock set 13:32:00 ? <1-31> Day of the month January Month of the year

Now you can complete the command entry:

Console# clock set 13:32:00 23 February 97 ^ %Invalid input detected at '^' marker.

The caret symbol (^) and help response indicate an error at 97. To list the correct syntax, enter the command up to the point where the error occurred and then enter a question mark (?):

Console# clock set 13:32:00 23 February ? <1993-2035> Year Console# clock set 13:32:00 23 February

Enter the year using the correct syntax and press Return to execute the command:

Console# clock set 13:32:00 23 February 2001

System Help

You can obtain help when you enter commands by using the following methods:

    Console# cl? clear clock
    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-config command for more information on the running versus saved configuration modes.

EXEC Commands

The EXEC commands are entered in the EXEC mode. User level EXEC commands are listed in Table B-1. Privileged level EXEC commands are listed in Table B-2.


Table B-1: Content Routing Software, Release 1.1 User Level EXEC Commands
User EXEC Commands Syntax Description

cd

cd {directoryname}

Changes directory

cpfile

cpfile oldfilename newfilename

Copies dosfs files

del

del filename

Removes file

deltree

deltree directory

Removes directory recursively

dir

dir [directory]

Displays long list files in directory

disable

disable

Turns off privileged EXEC commands

enable

enable

Turns on privileged EXEC commands

exit

exit

Exits from the EXEC command line

help

help

Assistance for command-line interface

lls

lls [directory]

Displays directory files in long list format

ls

ls [directory]

Displays files in directory

mkdir

mkdir directory

Makes directory

mkfile

mkfile filename

Makes file (for testing)

ping

ping {hostname | ip-address}

Sends echo packets

pwd

pwd

Present working directory

rename

rename sourcefile destinationfile

Renames a file (pathname)

rmdir

rmdir directory

Removes directory

show

See the "show Commands" section.

See the "show Commands" section.

type

type filename

Displays a file

whoami

whoami

Displays current user's name


Table B-2: Content Routing Software, Release 1.1 Privileged Level EXEC Commands
Privileged EXEC Commands Syntax Description

boomerang database

boomerang database {dump | restore}

Generates and restores a database file of recent DNS race winners

boomerang send-packet

boomerang send-packet {tcp | udp} dest-port source-port {dest-ip-address | dest-hostname} {source-ip-address | source-hostname}

Sends test packets to determine whether or not a network allows traffic with boomerang-altered source IP addresses

cd

cd {directoryname}

Changes directory

check

check superuser passwords

Checks whether superuser accounts are password-protected

clear

clear {boomerang | interface serial number | logging | statistics {all | boomerang | history | ip}| runningservices | tcp | transaction-logs} transaction-log}

Resets functions

clock

clock {clear | save | set hh:mm:ss day month year}

Sets system clock

configure

configure

Enters global configuration mode

copy

copy {disk {flash imagename | startup-config filename} | flash {disk imagename} | running-config {disk filename |
startup-config | tftp}| startup-config {disk filename | tftp} | tech-support {disk filename | tftp} | tftp {disk | flash}}

Copies configuration or image data

cpfile

cpfile oldfilename newfilename

Copies dosfs files

debug

debug

Debugging functions

del

del filename

Removes file

deltree

deltree directory

Removes directory recursively

dir

dir [directory]

Displays long list files in directory

disable

disable

Turns off privileged EXEC commands

disk

disk {erase-all-partitions devname | manufacture devname | partition devname | prepare devname}

Disk management commands

dosfs

dosfs {check volname [force | verbose
[force]] | format volname | label volname vol-label | mount volname {rdonly | rdwr} | repair {automatic | interactive} volname [force | verbose [force]] | sync syncdevice | unmount volname}

DOS file system commands

enable

enable

Turns on privileged EXEC commands

exit

exit

Exits from the EXEC command line

help

help

Assistance for command line-interface

install

install paxfilename

Installs a new version of the system software

lls

lls [directory]

Displays directory files in long list format

ls

ls [directory]

Displays files in directory

mkdir

mkdir directory

Makes directory

mkfile

mkfile filename

Makes file (for testing)

no debug

no debug

Disables debugging functions

ntpdate

ntpdate {hostname | ip-address}

Sets the Network Time Protocol (NTP) server name

ping

ping {hostname | ip-address}

Sends echo packets

pwd

pwd

Present working directory

reload

reload

Halts and performs a cold restart

rename

rename sourcefile destinationfile

Renames a file (pathname)

rmdir

rmdir directory

Removes directory

tclsh

The tclsh command is for Cisco Systems internal use only.

Shell for TCL

terminal

terminal monitor

Current terminal commands

transaction-log force

transaction-log force {archive | export}

Forces the immediate creation of a transaction log.

type

type filename

Displays a file

undebug

undebug

Disables debugging functions (see also debug)

whoami

whoami

Displays current user's name

write

write [erase | memory | terminal]

Writes running configuration to memory or terminal

Global Configuration Commands

The Content Routing software global configuration commands are entered in global configuration mode. The global configuration commands are listed in Table B-3.


Table B-3: Content Routing Software, Release 1.1 Global Configuration Commands
Global Configuration Command Syntax Description

boomerang annealing

boomerang annealing past-winners win-number agent-count agent-number

Sets annealing parameters

boomerang client-list

boomerang client-list list-name

Enters client list configuration mode

boomerang dns

boomerang dns enable {direct-mode | wccp-mode}

boomerang dns domain domain-name

Enables boomerang on the Content Router

Enters domain configuration mode for the specified domain

boomerang timing

boomerang timing decay decayvalue sample-freq samp-freqvalue

Sets boomerang timing parameters

clock timezone

clock timezone {zone hours} [minutes]

Configures time-of-day clock

cron

cron {del-tab entryid | file tabfile | save-tab | tab-entry tabentry}

Cron commands

end

end

Exits configuration mode

exception debug

exception debug

Exception handling

exec-timeout

exec-timeout timeout

Configures EXEC mode timeout interval

exit

exit

Exits configuration mode

help

help

Assistance for command-line interface

hostname

hostname name

Configures the Content Router network name

inetd

inetd {enable service}

Configures inetd

interface

interface ethernet number

Configures an Ethernet interface

ip

ip {default-gateway ipaddress | domain-name domainname | name-server ipaddress | route destaddrs netmask gateway}

Internet Protocol configuration commands

logging

logging {hostname | ip-address | console
loglevels | disk filename loglevels | event-export events loglevels facility | facility facility | on | recycle size | trap loglevels}

Configures system logging (syslog)

no

no command

Negates a global configuration command or sets its defaults

ntp

ntp server {hostname | ip-address}

Configures Network Time Protocol (NTP)

snmp-server community

snmp-server community string

Enables SNMP; sets community string

snmp-server contact

snmp-server contact line

Text for MIB object sysContact

snmp-server enable traps

snmp-server enable traps

Enables SNMP traps

snmp-server host

snmp-server host {hostname | ip-address} communitystring

Specifies SNMP trap host

snmp-server location

snmp-server location line

Text for MIB object sysLocation

tcp

tcp {client-mss maxsegsize | client-receive-buffer kbytes | client-rw-timeout seconds | client-satellite | client-send-buffer kbytes | cwnd-base factor | init-ssthresh value | keepalive-probe-cnt count | keepalive-probe-interval seconds | keepalive-timeout seconds | listen-queue length | server-mss maxsegsize | server-receive-buffer kbytes | server-rw-timeout seconds | server-satellite | server-send-buffer kbytes}

Configures TCP parameters

terminal

terminal length lines

Current terminal commands

tftp-server

tftp-server dir directory

Configures TFTP server

transaction-logs

transaction-logs {archive {files maxnumfiles | interval {seconds | every-day {at time | every hour} | every-hour {at minute | every interval} | every-week [on days [at time]]} | enable | export {enable | ftp-server {hostname | servipaddrs} login passw directory} | interval {minutes | every-day {at time | every hour} | every-hour {at minute | every interval} | every-week [on days [at time]]}} | file-marker | sanitize}

Configures transaction logging

trusted-host

trusted-host {hostname | ip-address | domain-lookup}

Configures a trusted host

user add

user add username [password [ 0 | 1] password] [capability [admin-access | ftp-access | http-access | telnet-access]] [uid userid]

Adds user accounts

user delete

user delete {username username | uid userid}

Deletes user accounts

user modify

user modify {uid number | username name}{[add-capability [admin-access | ftp-access | http-access | telnet-access]] | [del-capability [admin-access | ftp-access | http-access | telnet-access]] | [password [ 0 | 1] password]}

Modifies user accounts

wccp dns-boomerang router-list-num

wccp dns-boomerang router-list-num number [l2-redirect] [password passw] [weight percentage]

Configures a router list for a Content Router in WCCP mode

wccp flow-redirect

wccp flow-redirect enable

Redirects moved flows

wccp port-list

wccp port-list listnum portnum

Port list for use in WCCP services

wccp router-list

wccp router-list number ip-address

Router list for use in WCCP services

wccp shutdown

wccp shutdown max-wait seconds

WCCP shutdown parameter

wccp slow-start

wccp slow-start enable

Accepts load in slow-start mode

wccp version

wccp version 2

Enables WCCP Version 2

Interface Configuration Commands

The Content Routing software interface configuration commands are entered in interface configuration mode.

To enter interface configuration mode, from global configuration mode, use the interface command. For example:

Console(config)# interface ethernet 1

To exit the interface configuration mode, enter exit to return to the global configuration mode.

Console(config-if)# exit Console(config)#

Interface configuration commands are listed in Table B-4.


Table B-4: Content Routing Software, Release 1.1 Interface Configuration Commands
Interface Command Syntax Description

autosense

autosense

Enables autosense on an interface

bandwidth

bandwidth mbits

Interface speed

exit

exit

Exits from interface mode

fullduplex

fullduplex

Interface full-duplex mode

halfduplex

halfduplex

Interface half-duplex mode

ip

ip {address ip-address ip-subnet | broadcast-address ip-address}

Interface Internet Protocol configuration commands

no

no {autosense | bandwidth |
fullduplex | halfduplex | ip}

Negates a command or sets its defaults

Domain Configuration Commands

The Content Routing software domain configuration commands are entered in domain configuration mode. The domain configuration commands are listed in Table B-5.


Table B-5: Content Routing Software, Release 1.1 Domain Configuration Commands
Domain Configuration Command Syntax Description

alias

alias domain-name

Establishes alternative domain names

bloat

bloat bytes

Sets a level of artificial padding in the DNS Answer packet

client-group

client-group list-name

Assigns a client-list to a domain

dns-ttl

dns-ttl seconds

Specifies the DNS Time To Live (TTL) value contained in the agent's DNS response

fragment-size

fragment-size bytes

Sets an IP fragment size for DNS responses sent by agents

ip-ttl

ip-ttl hops

Specifies the IP Time To Live value contained in the agent's DNS response

key

key {0 | 7} word

Specifies a keyword that is used to encrypt packets sent between the Content Router and agents

max-propagation-delay

max-propagation-delay msec

Specifies the maximum one-way propagation delay from the Content Router to the content routing agents

no

no command

Negates a domain configuration mode command or sets its defaults

origin-server

origin-server ip-address

Specifies the IP address and domain name of the origin server

server-delay

server-delay msec

Specifies a delay in the DNS response sent by the Content Router to the origin server

Client List Configuration Command

The Content Routing software client list configuration command is entered in client list configuration mode. The client list configuration command is described in Table B-6.


Table B-6: Content Routing Software, Release 1.1 Client List Configuration Commands
Client List Configuration Command Syntax Description

client

client {ip-address | hostname} [nickname name] [delay delay-value]

Specifies the content routing agents in a client list

show Commands

The Content Routing software show commands are entered in EXEC mode. The show commands are listed in Table B-7.


Table B-7: Content Routing Software, Release 1.1 show Commands
EXEC show Command Syntax Description

show arp

show arp

Displays ARP entries

show boomerang

show boomerang {all | client-list list-name | domain domain-name | global}

Displays Content Router and agent information

show clock

show clock [detail]

Displays the system clock

show cron

show cron

Displays cron information

show debugging

show debugging

Displays the state of each debugging option

show disk-partitions

show disk-partitions devname

Displays disk partitions

show disks

show disks

Displays disk names

show events

show events number {all | critical | notice | warning}

Displays system events

show file-descriptors

show file-descriptors

Displays file descriptors

show flash

show flash

Displays Flash memory content

show hardware

show hardware

Displays system hardware status

show hosts

show hosts

Displays IP domain name, name servers, and host table

show inetd

show inetd

Displays the inetd daemon activity information

show interface

show interface {ethernet number | scsi number}

Displays hardware interface information

show ip routes

show ip routes

Displays IP routing table

show logging

show logging

Displays system logging (syslog)

show memory

show memory [free]

Displays memory blocks and statistics

show ntp

show ntp status

Displays the NTP parameters

show processes

show processes [cpu | memory]

Displays processes

show running-config

show running-config [boomerang {client-list list-name | domain domain-name}]

Displays current operating configuration

show snmp

show snmp

Displays SNMP statistics

show stacktrace

show stacktrace {task-ID | exception}

Displays task stack trace

show startup-config

show startup-config

Displays startup configuration

show statistics

show statistics {icmp | ip |
mbuf | netstat |
transaction-logs | udp}

Displays statistics

show tcp

show tcp

Displays TCP configuration information

show tech-support

show tech-support [page]

Displays system information for Cisco technical support

show tftp-server

show tftp-server

Displays TFTP server configuration

show transaction-logging

show transaction-logging [entries number]

Displays transaction logging information

show trusted-hosts

show trusted-hosts

Displays system hardware and software status

show user

show user {uid number | username name}

Displays information for a particular user

show users

show users

Displays all users

show version

show version

Displays system version

show wccp

show wccp {router | status}

Displays WCCP information


hometocprevnextglossaryfeedbacksearchhelp
Posted: Sat Sep 28 19:37:38 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.