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

Table of Contents

Command-Line Interface

Command-Line Interface

This chapter provides a summary of the commands included in Cisco Content Router software, Release 1.0. The command summary tables are grouped alphabetically in six categories: user level (EXEC) commands, privileged level (EXEC) commands, interface configuration commands, global configuration commands, boomerang configuration commands, and show (EXEC) commands.


Note   For more detailed information about each command, refer to "Cisco Content Router Software, Release 1.0 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 B-4.

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)#

Boomerang Configuration Mode

To enter boomerang 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-boomerang)#

The boomerang configuration commands are listed and described in the "Boomerang Configuration Commands" section.

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

Console(config-boomerang)# 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 1997

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 Router Software, Release 1.0 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 Router Software, Release 1.0 Privileged Level EXEC Commands
Privileged EXEC Commands Syntax Description

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 Router software global configuration commands are entered in global configuration mode. The global configuration commands are listed in Table B-3.


Table B-3: Content Router Software, Release 1.0 Global Configuration Commands
Global Configuration Command Syntax Description

boomerang

boomerang dns enable {direct-mode | wccp-mode} [decay decayvalue][sample-freq samp-freqvalue]

boomerang dns {domain domain-name}

Enables boomerang on the
Content Router

Enters boomerang configuration mode

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 Router 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 Router Software, Release 1.0 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

Boomerang Configuration Commands

The Content Router software boomerang configuration commands are entered in boomerang configuration mode. The boomerang configuration commands are listed in Table B-5.


Table B-5: Content Router Software, Release 1.0 Boomerang Configuration Commands
Boomerang 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

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

Specifies the content routing agents

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 to the content routing agents

no

no command

Negates a boomerang 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

show Commands

The Content Router software show commands are entered in EXEC mode. The show commands are listed in Table B-6.


Table B-6: show Commands, Content Router Software, Release 1.0
EXEC show Command Syntax Description

show arp

show arp

Displays ARP entries

show boomerang

show boomerang [domain-name]

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

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: Fri Dec 29 10:12:27 PST 2000
Copyright 1989-2000©Cisco Systems Inc.