cc/td/doc/product/dsl_prod/c600s/cbos
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Using the Command Line Interface

Using the Command Line Interface

2.1 Commonly Used Commands

This section documents the Cisco Broadband Operating System (CBOS) commands and command arguments that manage the Cisco 67x. CBOS runs in two modes: exec and enable. The table below lists the commands for each mode.


Table 2-1: Cisco Broadband Operating System Commands

Exec Mode Enable Mode

help/?

help/?

ping

quit/exit

quit/exit

ping

reboot

reboot

show

set

traceroute

show

enable

traceroute

stats

write

exec

stats

2.1.1 help

To get help information on a particular command.

help command-name

You can also do:

? command-name

Syntax Description

command-name

Specifies the command.

Command Modes

Exec and Enable

Examples
help stats

or

? stats

2.1.2 ping

To send one or more echo ICMP (Internet Control Message Protocol) request message(s) to another host for a reply.

ping ip-address [-t | -n number] [-w seconds] [-i ]

Syntax Description

ip-address

Specifies the destination IP address to be pinged.

-t

Specifies to ping host IP continuously until the user interrupts. On a PC, press the Enter key to stop the ping command.

-n number

Specifies the number of pings to send to host.

-w number

Specifies the amount of time (in seconds) to wait for response.

-i number

Specifies the Time to Live.

Command Modes

Exec and Enable

Example

The following example pings IP address 208.203.234.26 three times.

ping 208.203.234.26 -n 3

The following example pings IP address 208.203.234.26 indefinitely allowing for a 3 second wait response until the command string times itself out.

ping 208.203.234.26 -t -w 3

2.1.3 quit/exit

To quit or exit CBOS.

quit | exit

Syntax Description

This command has no keywords or arguments.

Command Modes

Exec and Enable

Example

The following examples quit CBOS.

quit exit

2.1.4 reboot

To reboot CBOS.

reboot

Syntax Description

This command has no keywords or arguments.

Command Modes

Exec and Enable

Example

The following example reboots CBOS.

reboot

2.1.5 set bridging

To enable and disable bridging options.

set bridging {enabled | disabled | users interface number-of-users | rfc1483 | management | ppp}

Syntax Description

enabled

Enables bridging.

disabled

Disables bridging .

users interface number-of-users

Specifies the maximum number of users for a specific port. The port is defined by the variable interface. The number of users is defined by the variable number-of-users.

rfc1483

Specifies the protocol to be used for bridging is for RFC1483 MAC.

management

Specifies that bridging is for the management VC.

ppp

Specifies that bridging is in PPP-BCP mode.

Command Mode

Enable

Usage Guidelines

The rules that govern the set bridging command are:


Note You must reboot to enable bridging options.
Examples

The following examples contain a sequence of commands for setting up bridging.

set bridging rfc1483 enabled set bridging ppp enabled

2.1.6 set broadcast forwarding

To set forwarding of broadcast packets.

set broadcast forwarding {enabled | disabled}

Syntax Description

enabled

Activates broadcast packet forwarding.

disabled

Deactivates broadcast packet forwarding.

Command Mode

Enable

Example

The following example enables broadcast packet forwarding:

set broadcast forwarding enabled

2.1.7 set dhcp

To activate, deactivate, or configure Dynamic Host Configuration Protocol (DHCP) functionality.

set dhcp

{client {enabled | disabled | interface interface-name} |

{server {enabled | disabled | pool pool-number {dns | sdns | gateway | ip | irc | nntp | pop3 | smtp | web | wins | swims} ip-address}} | {lease seconds | netmask mask | size pool-size | enabled | disabled} |

{relay {enabled | disabled}}

Syntax Description

enabled

Activates a specific DHCP functionality, either client, server, or relay.

disabled

Deactivates a specifies DHCP functionality, either client, server, or relay.

client

Specifies to configure client settings.

interface interface-name

Specifies to configure physical and logical interface settings.

server

Specifies to configure server settings.

pool pool-number

Manually modifies a DHCP server pool entry and specifies the number of the pool to modify. Pool-number is a number between 0 and 19.

dns ip-address

Sets the DNS address for all requests sent out of this pool. If ip-address is set to 0.0.0.0, no DNS information is sent out. If you add a pool after setting DNS, you must reset DNS for the new pool.

sdns ip-address

Sets the secondary DNS address. If ip-address is set to 0.0.0.0, no SDNS information is sent out. If you add a pool after setting SDNS, you must reset SDNS for the new pool.

gateway

Sets the gateway address for all requests sent out of this pool. If gw-address is set to 0.0.0.0, no gateway information is sent out. If you add a pool after setting the gateway, you must reset the gateway for the new pool.

ip ip-address

Sets the initial IP address for the pool specified.

irc ip-address

Sets the IP address of the IRC Server.

nntp ip-address

Sets the IP address of the News Server.

pop3 ip-address

Sets the IP address of the POP Mail Server.

smtp ip-address

Sets the IP address of the Mail Server.

web ip-address

Sets the IP address of the Web Server.

wins ip-address

Sets the primary wins server address.

swims ip-address

Sets the secondary wins server address.

lease seconds

Sets the lease time of clients in seconds.

netmask ip-address

Sets the subnet mask for all requests sent out of this pool.

size pool-size

Sets the size of the allocation pool. Note: Your pool size can never be set to higher then your local subnet mask that you are handing out for the pool.

relay

Sets the DHCP host server up as a relay agent to pass DHCP IP address assignments to the client system.

Command Mode

Enable

Example

The following example enables the DHCP client:

set dhcp client enabled

The following example sends all DHCP client requests out through the logical wan0-1 port.

set dhcp client interface wan0-1

You must do the following before you can use a logical wan port:

set interface wan0-0 close set interface maxvcs 4 write

Reboot your system after you enter the commands shown above.

The following example enables the DHCP server functionality:

set dhcp server enabled

The following command adds pool 0 with a specific IP address.

set dhcp server pool 0 ip 192.168.0.100 enabled

The following example enables the DHCP relay agent:

set dhcp relay enabled

2.1.8 set download

To download a new router image or new router configuration image.

set download {code | data}

Syntax Description

code

Begins an XMODEM download of a new router image file.

data

Begins an XMODEM download of a new router configuration image file.

Command Mode

Enable

Example

The following example begins an XMODEM download of a new router configuration image file.

set download data

2.1.9 set errors

To enable IP packet dumping.

set errors [client {enabled | disabled} | combo {enabled | disabled} | module {rfc1483 | none} | debug {enabled | disabled}] | clear

Syntax Description

client {enabled | disabled}

Enables IP packet dumping for the client from which the command was invoked.

enabled - Enables packet dumping.
disabled - Disables packet dumping.

combo {enabled | disabled}

Enables both the debug and the client modes simultaneously.

enabled - Enables packet dumping.
disabled - Disables packet dumping.

module {rfc1483 | none}

Enables IP packet dumping only for the RFC1483 module.

rfc1483 - Defines the RFC1483 module.
none - Disables packet dumping for the RFC1483 module

debug {enabled | disabled}

Sets IP packet dumping utility to display errors to the system display.

enabled - Enables debug error display.
disabled -Disables debug error display.

clear

Clears any errors from NVRAM.

Command Mode

Enable

Example

The following example enables IP packet dumping for the RFC1483 module.

set error module rfc1483

The following example clears errors.

set errors clear

2.1.10 set filter

To specify and modify IP filtering conventions for the Cisco 67x.

set filter {code on | off} [deny | allow {interface | all src-ip src-mask dest-ip dest-mask} port number]

Syntax Description

code

Enter the numbered filter number to be modified. Valid filter code values are 0 through 9.

on | off

Enables or disables the filter.

deny | allow

Specifies whether the filter is to allow or deny packets that match the filter's address and mask.

interface | all

Displays the Interface on which to apply the filter. This can be a particular interface such as eth0 or wan0-x or all interfaces.

src-ip

Enter the source IP address for packets.

src-mask

Enter the mask to be applied to source IP address. This allows the filter to match a group of incoming IP addresses.

dest-ip

Enter the destination IP address of outgoing packets.

dest-mask

Enter the mask to be applied to destination IP address. This allows the filter to match a group of outgoing IP addresses.

port number

Displays the TCP/UDP port number to block.

Command Mode

Enable

Usage Guidelines

The set filter command is used to specify IP filtering conventions. The Cisco 67x has 10 filters that can be applied to TCP and UDP packets passing through the router's interfaces. Enabled filters are applied to packets in sequential order according to filter number.

The rules that govern the filter command are:

Examples

The following example blocks all web access.

set filter 0 on deny all 0.0.0.0. 0.0.0.0 0.0.0.0. port 80

The following example blocks all telnet access from the 192.168.0.25 network.

set filter 1 on deny all 192.168.0.0 255.255.255.0 0.0.0.0. 0.0.0.0 port 23

The following example accepts telnet access from the host 192.168.0.25.

set filter 2 on allow all 192.168.0.25 255.255.255.255 0.0.0.0. 0.0.0.0 port 23

The following example blocks all FTP access on a wan port.

set filter 3 on deny wan0-1 0.0.0.0. 0.0.0.0 0.0.0.0. 0.0.0.0 port 21

The following example turns off the first filter.

set filter 0 off

The following example activates all enabled filters.

set filter on
Note Press enter only after entering all command parameters. A command may appear on two lines here for readability.

2.1.11 set interface

To configure settings for physical and virtual interfaces.

set interface

{eth0 {address ip-address | mask netmask | down | up | speed {10 | 100} |

vip {1 | 2 | 3 | 4} {ip ip-address | mask netmask} |

wan0 {baud rate | count {1 | 2 | 4 | 8 |} | doh {enabled | disabled} |
maxvcs {1 | 2 | 3 | 4} | rate {up | down | down:baud}
rate-number | auto} | [remote] | retrain | scramble {enabled | disabled} | stay} |

wan0-x {close | destination ip-address | disabled | enabled | mask netmask | open | rate rate-value | VCI vci-number | VPI vpi-number}

Syntax Description

enabled

Enables a command or functionality.

disabled

Disables a command or functionality.

eth0

Specifies to set or check values for the Ethernet interface.

address ip-address

Specifies the destination IP address for the Ethernet interface.

mask netmask

Specifies the netmask address for the Ethernet interface.

down

Disables the interface.

up

Enables the interface.

speed

Specifies the link speed given as [10 | 100 | auto].

vipx

Specifies to set or check values for a virtual Ethernet interface.

ip ip address

Specifies the destination IP address for the virtual interface.

mask netmask

Specifies the netmask address for the virtual interface.

wan0

Specifies to set or check values for the wan0 interface.

baud rate

Sets the ADSL baud rate.

count

Sets the VPI count.

doh

Specifies to turn the Digital Off-Hook functionality off or on.

maxvcs

Sets the maximum number of virtual connections (VCs).

rate

Sets line rates.

up rate-number

Sets upstream ADSL line rate.

down rate-number

Sets downstream ADSL line rate.

down:baud rate-number

Sets downstream line rate and baud rate.

auto

Sets auto-negotiation mode for this device.

retrain

Retrains the ADSL line.

scramble

Enables or disables ATM cell scrambling.

stay

Sets stay-trained mode; ADSL line will not retrain.

wan0-x

Specifies to set or check values for the wan0-x interface.

close

Closes the virtual connection.

destination ip-address

Sets the IP address.

mask netmask

Sets the netmask.

open

Opens the virtual connection.

rate rate-value

Sets the scalarate - the transmitted data rate in 64Kbps increments up to a maximum of the current line rate.

VCI vci-number

Sets the number of the virtual channel identifier.

VPI vpi-number

Sets the number of the virtual path identifier.

wan0

Command Mode

Enable

Usage Guidelines

Since the Cisco 67x only has one physical port for the Ethernet port, the default value is always 0 as in eth0.

Use this command only when you have a serial connection with Cisco 67x. If you use this command when you are communicating over an Ethernet LAN, you will lose the connection to Cisco 67x. If you forget and issue this command over the LAN, you can reset Cisco 67x by switching the Cisco 67x OFF and then turning the power back ON.

Example

The following example assigns the Ethernet interface an IP address.

set interface eth0 address 198.162.55.5

The following example sets the maximum number of VCs to two.

set interface wan0 maxvcs 2

The following examples open or close the wan0-0 port.

set interface wan0-0 open set interface wan0-0 close

The following example sets the ScalaRate of the wan0-0 port.

set interface wan0-0 rate 1088

The following example sets a VPI address for the wan0-0 port to equal 1, which is in the valid range for VPI addresses.

set interface wan0-0 vpi 1

The following example sets the VCI address for the wan0-0 port to equal 1, which is in the valid range for VCI addresses.

set interface wan0-0 vci 1
Note The ScalaRate only affects the transmitted data rate. On the Cisco 67x only the upstream rate is affected.
Usage Guidelines

The Cisco 67x has a total number of four VCs (wan0-1 through wan 0-3). Configure only the total number of actual VCs terminated to optimize the performance of the Cisco 67x. Close the wanx-x port before making any changes to the port.

The Cisco 67x supports user configuration of VPI/VCI address mapping. The Cisco 67x ships with one VC enabled. Its VPI/VCI address is 1/1. When changing the VPI/VCI address space mapping, it is important to understand that adding VPI space decreases VCI space. For example, if the VPI count is one, 255 possible VCI values are available for the single VPI. If the VPI count is eight, the number of possible VCI values is reduced to 31 VCIs for each of the eight VPIs.

When changing the VPI count values, you must ensure that VPI and VCI port assignments are consistent with the VPI count mode selected. For instance, when changing the VPI count from four to one, you must change the VPI port assignment to zero (0) on all wan0-x ports previously assigned to values other than 0, since 0 is the only valid VPI when the VPI count is 1.

The valid ranges for VPI and VCI addresses are shown in the following table:


Table 2-2: Valid VPI and VCI Address Ranges

VPI <count> VPI Range VCI Range

1

0

0..255

2

0..1

0..127

4

0..3

0..63

8

0..7

0..31

2.1.12 set multicast

To enable multicast proxy support.

set multicast {forwarding enabled | disabled}

Syntax Description

enabled

Enables multicast proxy support.

disabled

Disables multicast proxy support.

Command Mode

Enable

Example

The following example enables multicast proxy support.

set multicast forwarding enabled

2.1.13 set nat

To enable or disable Network Address Translation (NAT) functionality.

set nat {enabled | disabled | timeout {icmp | upd | tcp idle | tcp negotiation | other} value | outside ip ip-address |

entry add {inside-ip inside-port outside-ip outside-port protocol} |

entry delete { all | [inside-ip] [outside-ip] [protocol]}}

Syntax Description

enabled

Activates NAT functionality.

disabled

Deactivates NAT functionality. The default setting for this command is disabled.

timeout

Sets the timeout value for the protocols listed below.

icmp

Specifies the ICMP protocol. Default = 60 seconds

udp

Specifies the UDP protocol. Default = 120 seconds

tcp

Specifies the TCP protocol.

idle

Specifies the timeout value to set for the data transfer portion after connection setup. Used for the TCP protocol only. Default = 24 hours

negotiation

Specifies the timeout value to set during TCP setup and tear down. Used for the TCP protocol only. Default = 60 seconds

fragmentation

Specifies how long to maintain `out-of-order' fragments before the set nat timeout command terminates. Default = 60 seconds

value

Specifies the timeout value. Expressed in seconds less than or equal to 65000.

outside ip ip-address

To set the global outside network address to be used for translation.

entry add

To add a static entry to a NAT table.

· Follow the sequence exactly as shown in the example below when entering your command string.

inside inside-ip

Specifies the IP address of the inside, private or SOHO network.

inside inside-port

Specifies the port number of the inside network port.

outside outside-ip

Specifies the IP address of the outside, public or Service Provider's network.

outside outside-port

Specifies the port number of the inside network port.

protocol

Specifies the protocols to use. Select between: udp, tcp, icmp.

entry delete

To delete NAT table entries.

all

Deletes all entries from the NAT table.

inside ip-inside

Deletes all matching entries with the specified inside IP address (shown as ip) from the NAT table.

outside outside-ip

Deletes all matching entries with the specified outside IP address (shown as ip) from the NAT table.

port

Defines the port associated with the IP address to delete from NAT.

protocol

Specifies the protocols to use. Select between: udp, tcp, icmp.

Command Mode

Enable

Usage Guidelines

To ensure that PPP assigns an address for translation, you must issue the following commands:

set ppp wan0-0 ipcp 0.0.0.0 write NVRAM
Examples

The following example disables NAT.

set nat disabled

The following examples show various timeout values that you can set:

set nat timeout icmp 60 set nat timeout tcp idle 84 set nat timeout tcp negotiation 60 set nat timeout udp 60 set nat timeout fragmentation 60

The following example adds an entry to the NAT table that routes external requests destined for IP address 192.168.0.100 on port 322 to the internal station at IP address 10.10.10.100 on port 211.

set nat entry add 10.10.10.100 211 192.168.0.100 322 tcp
Note You must use the precise sequence, as defined in the Syntax Description listing below, when you enter your command string.

The following command deletes all of the NAT table entries.

set nat entry delete all

The following command deletes a specific NAT entry. You must enter the port number when deleting a specific NAT entry. Refer to the syntax example at the top of this page.

set nat entry delete 10.10.10.100 111 outside 192.168.0.100 10000 udp

The following command deletes all entries that match a specific inside address.

set nat entry delete inside 1.1.1.1

The following command deletes all entries that match a specific outside address.

set nat entry delete outside 2.2.2.2
Note Do not use the following command for normal setup. In normal setup, either DHCP or IPCP acquires the global outside network address for the 67x.

The following example sets the outside IP address to 192.168.0.100.

set nat outside ip 192.168.0.100

2.1.14 set nvram

To configure NVRAM settings.

set nvram {erase | add parameter | del parameter}

Syntax Description

erase

Erases current configuration.

add parameter

Adds parameter manually to NVRAM.

del parameter

Removes parameter manually from NVRAM.

Command Mode

Enable

Example

The following example erases NVRAM.

set nvram erase

2.1.15 set ppp

To configure PPP parameters and statistics.

set ppp {restart {on|enabled|off|disabled}} | wan0-x {llc {enabled | disabled} | radius {enabled | disabled} | pap {enabled | disabled} | mru units | retry number | magicnum hexnumber | ipcp {ip-adr | clear} | dms ip-address | login pap-login | password pap-password | debug {enabled | disabled | syslog} | subnet ip-address | wins ip-address}

Syntax Description

restart

Reinitiates the PPP session

on | enabled

Allows auto restart of ADSL link after idle

off | disabled

Disallows auto restart of ADSL link after idle

wan0-x

Specifies the wan0-x port. Wan ports are numbered consecutively 0-3.

pap {enabled | disabled}

Enables or disables PPP PAP passwords.

llc {enabled | disabled}

Enables or disables LLC encapsulation.

mru mru-units

Enter the Maximum Receive Units.

radius

Sets RADIUS for authentication.

enabled | disabled

Enables or disables RADIUS.

retry retry-number

Enter a maximum retry count on authentication.

magicnum hex-magic

Enter a valid hexadecimal number.

ipcp ip-address

Enter the IP address of the destination router.

dns ip-address

Enables automatic negotiation of the primary or secondary DNS IP address

login pap-login

Enter PAP authentication login name.

password pap-pass

Enter PAP authentication password.

debug

Sets PPP trace output debug facility.

on | off | syslog

Enables or disables the PPP debug facility or enables the syslog daemon.

Command Mode

Enable

Examples

The following example sets the Maximum Receive Units.:

set ppp wan0-0 mru 10

The following example sets the Maximum Retry Counts on PPP authentication.

set ppp wan0-0 retry 5

The following example sets the PPP Magic Number.

set ppp wan0-0 magicnum 16

The following example sets the PAP authentication name.

set ppp wan0-0 login bjones

The following example sets the PAP authentication password.

set ppp wan0-0 password 78A55Q

2.1.16 set prompt

To set a different prompt for the CBOS command line.

set prompt new-prompt-name

Syntax Description

new-prompt-name

Specifies the new name of the CBOS prompt.

Command Mode

Enable

Example

The following example resets the CBOS prompt.

set prompt cisco67x

2.1.17 set radius

To configure RADIUS security and accounting settings.

set radius {enabled | disabled | remote ip-address | port port-number | acctport udp-port-number | secret password | test [acct] login password}

Syntax Description

enabled | disabled

Activates or deactivates the application.

remote ip-address

Enter IP address for the remote RADIUS server.

port port-number

View the Cisco default port setting as defined by the variable port-number.

acctport udp-port-number

View the Cisco accounting port setting as defined by the variable udp port number.

secret password

Enter Shared Secret password as defined by the variable password.

test

Enables you to send a test the RADIUS serve security and account settings. See Examples.

login

Specifies the login name to use when logging into the RADIUS server.

password

Specifies the password to use when logging into the RADIUS server.

acct

Tests RADIUS accounting.

Command Mode

Enable

Examples

The following example enables RADIUS.:

set radius enabled

The following example sets the IP address of the remote RADIUS server.

set radius remote ip-address

The following example tests for login user id on the RADIUS server; where username is the name of the user who has login permissions and password is the user's password to the RADIUS server.

set radius test acct username password

The following example tests security on the RADIUS server; where username is the name of the user who has login permissions and password is the user's password to the RADIUS server.

set radius test username password

2.1.18 set rip

The set rip command automatically adds routes to your stream. It can also provide MD5 authentication when the v2 argument is selected. The v1 argument provides non-authenticated transmissions.

The usage example below has been separated into three parts for ease of readability. The keywords eth0 and wanx-x use identical keywords and argument variables.

To configure RIP settings.

set rip {enabled | disabled | aging aging-value | deltimedout {enabled | disabled} | garbage garbage-value | update update-value} | {eth0 | wanx-x} {announce {default | host | self | static} | delexpired | holdown | splithorizon | poisonreverse | summarize | learn {default | host | sender} {enabled | disabled}} | {authentication {disabled | text | md5} | keyid keyid-name | receive {disabled | v1compatible | v1 | v2} | rollover value | send {requests {disabled | v1 | both | v2} | responses {enabled | disabled}}}

Syntax Description

enabled

Enables the set rip command.

disabled

Disables the set rip command.

deltimedout timeout-value

enabled

disabled

Delete RIP2 time-outed entries. Expressed in seconds.

Enables the deltimedout keyword.

Disables the deltimedout keyword.

aging

Route aging timeout value (default is 180 seconds).

garbage

Route garbage collection timeout value (default is 120 seconds).

update

Update time interval (default is 30 seconds).

eth0 ip-address

Enter IP address for a LAN interface. The address is defined by the variable eth-address.

wanx-x ip-address

Enter IP address for a WAN interface. The address is defined by the variable wan-address.

The Remainder of This List Consists of Keywords and Keyword Arguments
in Common to Both eth0 and wan
x-x Commands

announce

default {enabled | disabled}

host {enabled | disabled}

self {enabled | disabled}

static {enabled | disabled}

Announces routes.

Announces default route.

Announces host routes.

Announces self as default router.

Announces static routes.

authentication

disabled | test | md5

Sets RIP authentication.

disabled - Disables the set rip command.
text - Tests the authentication mode.
md5 - Enables encrypted authentication.

delexpired {enabled | disabled}

Auto deletes expired key.

keyid keyname

Authentication active key id.

holddown {enabled | disabled}

Sets Route holddown.

splithorizon

{enabled | disabled}

Sets split horizon.

Turns the split horizon mode on or off.

learn

default {enabled | disabled}

host {enabled | disabled}

Learns routes.

Sets default route.

Sets host routes.

password password

Sets a plain text password. The maximum number is 16 characters.

poisonreverse

enabled | disabled

Reverse RIP poison.

Turns poisonreverse command on or off.

receive

disabled | v1compatible | v1 | v2

Sets the receive command.

disabled - Disables the receive keyword.
v1 compatible - Specifies v1 compatibility (non-authentication mode) with other systems.
v1 - Specifies non-authentication mode.
v2 - Specifies encrypted authentication mode.

rollover time-period

Period in advance to start rollover.

send

requests

disabled | v1 | both | v2

Sets the send command.

Sets RIP requests.

disabled - Disables the receive keyword.
v1 - Specifies non-authentication mode.
both - Specifies both v1and v2 modes.
v2 - Specifies authentication mode.

responses

enabled | disabled

Sets RIP responses.

Turns RIP responses on or off.

summarize

enabled | disabled

Sets RIP summary.

Enables or disables the summary keyword.

Command Mode

Enable

Example

The following example disables all requests.

set rip eth0 send requests disabled

The following example disables all responses from rip.

set rip eth0 send responses disabled

The following examples sets rip to receive only V1-compatible messages.

set rip eth0 receive v1compatible

The following example enables rip to learn the default IP address path.

set rip eth0 learn default enabled

2.1.19 set route

To build a routing table by manually adding or deleting entries in a routing table.

set route {default target | add {ip address gw address [mask netmask] [metric hops]} | delete address}

Syntax Description

default target

Sets a default route to an IP address or a WAN interface.

delete ip-address

Deletes an existing route.

add

Adds a new route.

ip address

Specifies the IP address of the host you are trying to reach. The IP host address is specified by the keyword argument variable, address.

gw address

Specifies the IP address of an external gateway. Data is sent through the external gateway to the destination address. Therefore, this address must be the address of a gateway physically linked to your network. The gateway address is specified by the keyword argument variable, address.

mask netmask

Specifies the netmask of the host you are trying to reach.

metric hops

Specifies the distance in hops between the destination address and the gateway. The default value is 1.This value is required when you add a route.

Command Mode

Enable

Examples

The following example shows how to add a route without specifying a netmask or metric.

set route add ip 192.9.9.1 gateway 192.168.10.250

The following example shows how to delete a route.

set route delete 192.168.10.1

The following example shows how to add a route specifying a netmask and a gateway.

set route add ip 192.10.10.0 mask 255.255.255.0
gateway 208.203.245.228

The following example shows how to add a default route.

set route default 208.203.245.228

The following example shows how to add a route add a route specifying a netmask, gateway and a metric.

set route add ip 192.10.10.0 mask 255.255.255.0
gateway 208.203.245.228 metric 1

Note Press Enter only after entering all command parameters. Command examples appear on two lines for readability.

2.1.20 set serial

To configure serial port settings.

set serial timeout {timeout-value more lines-number}

Syntax Description

timeout timeout-value

Sets the value in seconds to disconnect the serial connection. The value must be less than or equal to 65334.

more lines-number

Sets the number of lines for the more output. Enter a numeric value of `0' to disable this command.

Command Mode

Enable

Example

The following example set the timeout value for the serial port.

set serial timeout 50000

2.1.21 set snmp

To configure SNMP settings.

set snmp enabled | disabled | remote remote-address | traps host-address

Syntax Description

disabled

Disabled SNMP settings

enabled

Enables SNMP settings.

remote remote-address

Specifies the IP address for the remote location running SNMP.

traps host-address

Sets the IP address of the host on which to trap SNMP messages.

Command Mode

Enable

Example

The following command uses hypothetical IP addresses to demonstrate the use of set snmp.

set snmp remote 198.162.2.57 set snmp traps 198.162.2.50

2.1.22 set syslog

To invoke the Syslog application and its options.

set syslog {disabled | enabled | port port-number | remote remote-address | test test-string}

Syntax Description

disabled

Disables the Syslog application.

enabled

Enables the Syslog application.

port port-number

Specifies the Syslog port number.

remote remote-address

Specifies the remote IP address of the Syslog server.

test test-string

Sends a test message to the Syslog server

Syntax Description

This command has no arguments or keywords.

Command Mode

Enable

Example

The following command disables the Syslog application.

set syslog disabled

The following example sets the IP address for the remote Syslog server.

set syslog port 232

The following example sets the IP address for the remote Syslog server.

set syslog remote 198.162.5.3

The following example sends the message "Testing syslog" to the Syslog server.

set syslog test Testing syslog

2.1.23 set telnet

To configure the telnet daemon settings.

set telnet {enabled | disabled | remote ip-address | timeout # | port udp-port-number}

Syntax Description

enabled

Enables Telnet functionality.

disabled

Disables Telnet functionality.

remote ip-address

Specifies the IP address for the remote location running the Telnet server.

timeout #

Specifies the timeout value, in seconds, for a Telnet connection.

port udp-port-number

Specifies the Telnet port number.

Command Mode

Enable

Example

The following example sets the remote address for the Telnet application.

set telnet remote 1.1.1.1

The following example sets the number of seconds for the Telnet connection to timeout.

set telnet timeout 300

2.1.24 set tftp

To configure the TFTP settings.

set tftp {enabled | disabled | remote ip-address | port udp-port-number}

Syntax Description

enabled

Enables TFTP functionality

disabled

Disables TFTP functionality.

remote ip-address

Specifies the IP address for the remote location running the TFTP server.

port udp-port-number

Specifies the TFTP port number.

Command Mode

Enable

Example

The following example sets the remote address for the TFTP application.

set tftp remote 198.162.58.23

2.1.25 set timeout

To configure timeout settings.

set timeout {idle seconds | session seconds | reset seconds}

Syntax Description

idle seconds

Enter number of seconds to disconnect after idle.

session seconds

Enter number of seconds to disconnect after session uptime.

reset seconds

Enter number of seconds to wait to reopen connection.

Command Mode

Enable

Example

The following example sets the timeout values for the idle timeout.

set timeout idle 60

2.1.26 set web

To configure web server settings.

set web remote ip-address port tcp-port-number enabled | disabled

Syntax Description

remote ip-address

Specifies the IP address of the web server.

port tcp-port-number

Specifies the web server port number.

enabled

Turns on the web server.

disabled

Turns off the web server.

Command Mode

Enable

Example

The following example sets the web server IP address to 192.168.0.100.

set web 192.168.0.100

2.1.27 show

To display statistics on a particular application or interface.

show {arp | broadcast | dhcp {client | relay | server {pool {number | all} | leased} | errors | filter | interface [interface-name] | multicast | nat [timeout [all | icmp | ipd | tcp | fragmentation]] | nvram | nvram# | ppp | radius | rarp | rates | rfc1483 | rip {status | eth0 | wan0-x} | rout | running | running# | serial | snmp | syslog | telnet | tftp | timeout | uptime | version | web}

Syntax Description

arp

Displays ARP Table.

dhcp {client | server [pool 0 | allocated] }

Displays whether the dhcp client, server, or server pool 0 is enabled. The allocated argument shows which addresses are currently leased.

errors

Displays list of errors that have occurred.

filter

Displays IP Filters.

interface wan0

Displays transmit power and remote transmit power statistics.

nat

Displays whether NAT is enabled and NAT entries (if any).

nat timeout {all | icmp | udp | tcp | fragmentation}

Displays timeout values for specified protocols or all protocols in NAT. The keyword fragmentation specifies the duration of time to maintain `out-of-order' fragments.

nvram

Displays the configuration file located in NVRAM.

nvram#

Displays written configuration file in NVRAM without any comments you may have entered in the configuration file.

ppp

Displays PPP Parameters and Statistics.

radius

Displays RADIUS security and accounting settings.

rarp

Displays RARP Table.

rates

Displays list of possible scalar ATM line rate settings.

rfc1483

Displays RFC1483 Bridging Parameters and Statistics.

rip {status | eth0 | wan0-x}

Displays RIP settings and status on specified interfaces.

running

Displays configuration settings that are currently running, but not saved to NVRAM through the write command.

running#

Displays configuration settings that are currently running without comments, but not saved to NVRAM through the write command.

serial

Displays serial port setting.

snmp

Displays SNMP configuration settings.

syslog

Displays syslog settings.

telnet

Displays telnet daemon settings.

tftp

Displays tftp settings.

timeout

Displays Idle and Session timeout settings.

uptime

Displays uptime.

web

Displays Web Server settings.

Command Mode

Exec and Enable

Examples

The following example displays an application's configuration settings.

show tftp show syslog show radius

The following example displays the status of IP filters.

show filter

The following example displays web browser status.

show web

The following example displays possible ATM line rates at prescribed baud rates.

show rates

The following example displays error reports.

show errors

2.1.28 stats

To show operating statistics.

stats {bridging {eth0 | wan0-x} | dhcp | eth0 | ip {eth0 | general | rip | vipx | wan0-x} | nat | ppp | radius | serial | snmp | syslog | telnet | tftp | wan0 |
wan0-
x | web}

Syntax Description

ip

Displays IP statistics.

general

Displays general statistics on the WAN interface.

rip

Displays RIP statistics on the WAN interface.

eth0

Displays eth0 statistics on the WAN interface.

wan0-x

Displays wan0-x statistics on a VC.

vip x

Displays virtual interface statistics.

bridging

Displays statistics on bridging.

eth0

Displays statistics on the Ethernet interface.

wan0

Displays statistics on the Wan interface.

wan0-x

Displays statistics on a VC.

telnet

Displays statistics on telnet.

syslog

Displays statistics on syslog.

tftp

Displays statistics on tftp.

web

Displays statistics on web.

ppp

Displays ppp statistics.

serial

Displays statistics on the serial port.

radius

Displays statistics on RADIUS.

snmp

Displays statistics on SNMP.

nat

Displays NAT statistics.

dhcp

Displays DHCP statistics.

wan0

Displays wan0 statistics.

wan0-x

Displays wan0-x statistics.

Command Mode

Exec and Enable

Example

The following command displays the statistics for the Ethernet interface:

stats ip eth0

The following command enables MAC address dumping in bridging mode:

stats bridging eth0

The following command enables MAC address dumping on the wan0-o port:

stats bridging wan0-0

2.1.29 traceroute

To trace the routes that a data packet takes until it reaches its destination IP address. The traceroute command traces routes along the network, listing all hops and gateways, until it reaches the specified IP address.

traceroute ip-address [-m number-of-hops] [ -w wait-time
[-p udp-port-number]

Syntax Description

ip-address

Specifies the final destination IP address.

-m number-of-hops

Sets the Max Time to Live by specifying the number of hops to the trace.Most systems use a default of 64 TTL. Please refer to the appropriate system documentation for your system's default.

-w wait-time

Specifies the amount of time, in seconds, to wait for response.

-p udp-port-number

Specifies the UDP port number on which to use the trace facility.

Command Mode

Exec and Enable

Example

The following command traces the route for IP address 208.192.56.1. The example uses all arguments and assigns a server from which to originate the command string.

traceroute 208.192.56.1 -m 64 -w 5 -p 198.162.2.1

2.1.30 write

To write configuration changes to NVRAM.

write

Syntax Description

This command has no arguments or keywords.

Command Mode

Enable

Example

The following command writes all configuration changes you make to NVRAM.

write

hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Dec 4 15:32:10 PST 2000
Copyright 1989-2000©Cisco Systems Inc.