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

Table of Contents

Command-Line Interface

Command-Line Interface

This appendix provides a summary of the command-line interface (CLI) commands included in the Cisco 8005 Content Request Gateway User's Guide. The command summary tables are grouped alphabetically in six categories: user level EXEC commands, privileged level EXEC commands, global configuration commands, interface configuration commands, tag domain configuration commands, and show EXEC commands. The CLI can be accessed through the console port or Telnet.

For detailed information about each command, see "Content Request Gateway Software, Release 1.0 Commands."

Using Command-Line Processing

CRG 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 B-1.)


Table B-1: Command-Line Processing Keystroke Combinations
Keystroke Combinations 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-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

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-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.

EXEC Mode

There are two EXEC access 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 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 Enter 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 Enter 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 

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

Tag Domain Configuration Mode

To enter tag domain configuration mode, from the global configuration mode prompt, enter
http tag domain .contentprovider.com, where .contentprovider.com is the name of your domain.

Console# config

Console(config)# http tag domain .contentprovider.com

Console(config-domain)# ?

Configure HTTP domain commands:
  cgp-destination  Add cgp-destination
  exit             Exit from HTTP tag-domain mode
  no               Negate a command or set its defaults
  profile          Add a profile
  source           Source IP Access List
 

To exit the tag domain configuration mode, enter exit to return to the global configuration mode.

Console(config-domain)# exit

Console(config)#
 

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

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
MONTH Month of the year - e.g., january
Console#clock set 13:32:00
. . . 
 

Enter the day and month as prompted and use the question mark for additional instructions:

Console# clock set 13:32:00 25 August ?

  <1993-2035>  Year
 

Now you can complete the command entry by entering the year:

Console# clock set 13:32:00 25 August 01

                                        ^
%Invalid input detected at '^' marker.
Console# 
 

The caret symbol (^) and help response indicate an error with the 01 entry. To display the correct syntax, press Ctrl-P or the Up Arrow to display the previous command and then replace the part where the error was indicated with a question mark. 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 25 August ?

<1993-2035> Year
Console# clock set 13:32:00 25 August

 

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

Console# clock set 13:32:00 25 August 2001

WARNING: Setting the clock may cause a temporary service interruption.
Do you want to proceed? [no] yes

Sat Aug 25 13:32:00 EST 2001 
Console# 

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 "running" and "saved" configuration modes.

EXEC Commands

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


Table B-2: CRG 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

dnslookup

dnslookup {host | domain-name}

Resolves the host name (DNS)

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

show command

See the "show Commands" section

type

type filename

Displays a file

whoami

whoami

Displays current user's name


Table B-3: CRG Software, Release 1.0 Privileged Level EXEC Commands
Privileged EXEC Commands Syntax Description

cd

cd directoryname

Changes directory

check

check superuser passwords

Checks whether superuser accounts are password-protected

clear

clear {cgp {destination | traffic} | dns-cache | http {asx | domain | homepage | intercept | redirect | statistics | tag}} | interface serial number | license | logging | statistics {all | dns-cache | ip | tcp}}

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 {bios imagename |
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

dnslookup

dnslookup {host | domain-name}

Resolves host name (DNS)

dosfs

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

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

ip send-packet

ip send-packet {tcp | udp} {dest_port | source_port}{dest_host | dest_ip} {source_host | source_ip}

Sends a test packet

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 (path name)

rmdir

rmdir directory

Removes directory

show

show command

See the "show Commands" section

terminal

terminal monitor

Current terminal commands

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


Table B-4: CRG Software, Release 1.0 Global Configuration Commands
Global Configuration Command Syntax Description

cgp

cgp keepalive ip-addr [period]

Configures Content Gateway Protocol (CGP) parameters

clock

clock timezone timezone_name utc_offset_hours [utc_offset_min]

clock summer-time sum_time_zone date start_day start_month start_year start_time end_day end_month end_year end_time offset

clock summer-time sum_time_zone recurring {week_num_start | first | last} weekday_start month_start hour_start {week_num_end | first | last} weekday_end month_end hour_end offset

Configures time-of-day clock

cron

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

cron commands

dns-cache

dns-cache size cache-size

Configures DNS cache

end

end

Exits configuration mode

exception

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 CRG network name

http asx access-list

http asx access-list {1-99} {permit | deny}
[{any | host ipaddr | ipaddr [wildcard bits]}]

Defines destination access list

http asx enable

http asx enable

Enables ASX streaming metafile manipulation

http asx insert enable

http asx insert enable

Enables entry insertion into ASX metafiles

http asx insert pool

http asx insert pool {1-5} [dest-access-group {1-99}] url [number] [number] [number] [number] [time {1-60} | request {1-10000}

Specifies pool of URLs for inserting in ASX metafiles

http asx log-metafiles

http asx log-metafiles

Logs decoded streaming metafile information

http asx skip

http asx skip

Renders ASX metafile entries skippable

http asx url

http asx url {1-20} {URL}

Specifies URL for WMT media

http homepage

http homepage {frequency-timeout frequency | idle-timeout time | url homepage-url-number url-string}

Configures HTTP home page redirection

http intercept

http intercept nat

Enables Network Address Translation (NAT)

http redirect dest-domain

http redirect dest-domain {permit | deny}
{any | domain-name}

Configures HTTP redirection destination domain name access list

http redirect source

http redirect source {permit {any | host ip-addr | ip-addr [wildcard-bits]} url redirect-url number {redirect-url-number} [request frequency | time minutes] [homepage homepage-url-number]

Configures HTTP redirection source IP access list and redirection URL

http redirect url

http redirect url redirect-url-number url-string [frameset [delay seconds] [title title-string]]

Configures HTTP redirection URL and frequency for source list entries

http tag domain

http tag domain domain-name

Configures HTTP tag domain

http tag profile

http tag profile variable-name variable-value {any | host ip-addr | ip-addr [wildcard-bits]}

Configures HTTP tag profile

inetd

inetd {enable service}

Configures TCP/IP services

interface

interface ethernet {0 |1)

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 | on | recycle size | trap loglevels}

Configures system logging (syslog)

no

no command

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

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

wccp web-cache

wccp web-cache router-list-num number [l2-redirect] [password key] [weight percentage]

Standard web caching service

Interface Configuration Commands

The CRG 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 0

Console(config-if)#
 

To exit 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-5.


Table B-5: CRG 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 command

Negates a command or sets its defaults

Tag Domain Configuration Commands

The CRG software tag domain configuration commands are entered in tag domain configuration mode. The tag domain configuration commands are listed in Table B-6.


Table B-6: CRG Software, Release 1.0 Tag Domain Configuration Commands
Tag Domain Configuration Command Syntax Description

cgp-destination

cgp-destination ip-addr [key [0 | 7] shared-key] [description string]

Adds CGP destination

exit

exit

Exits from HTTP tag domain mode

no

no command

Negates a tag domain command or sets its defaults

profile

profile include variable-name

Adds a profile

source permit

source permit {any | host ip-addr | ip-addr [wildcard-bits]}

Allows HTTP tagging for a source IP address

source deny

source deny {any | host ip-addr | ip-addr [wildcard-bits]}

Prevents HTTP tagging for a source IP address

show Commands

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


Table B-7: CRG Software, Release 1.0 show Commands
EXEC show Command Syntax Description

show arp

show arp

Displays ARP entries

show cgp

show cgp {destination | traffic}

Displays Content Gateway Protocol (CGP) 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 dns-cache

show dns-cache

Displays DNS cache information

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 http asx

show http asx {client | detail | media-server | metafile-server | url}

Displays ASX information

show http domain

show http domain

Displays HTTP most popular domains

show http homepage

show http homepage [url]

Displays HTTP home page information

show http intercept

show http intercept

Displays HTTP packet interception information

show http redirect

show http redirect {list | url}

Displays HTTP redirect information

show http statistics

show http statistics

Displays HTTP statistics

show http tag

show http tag {detail | dictionary [profile_name] | domain | history | list}

Displays HTTP tagging information

show inetd

show inetd

Displays the inetd daemon activity information

show interface

show interface {ethernet number | scsi number}

Displays hardware interface information

show ip

show ip routes

Displays IP routing table

show license

show license {history [gmt | local] | statistics}

Displays product license information

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 {dns-cache | icmp | ip | mbuf | netstat | tcp | 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 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 [cache-engines | flows{custom-web-cache | reverse-proxy | web-cache} | routers | slowstart {custom-web-cache | reverse-proxy | web-cache | status}]

Displays WCCP information


hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Sep 24 21:05:02 PDT 2001
All contents are Copyright © 1992--2001 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.