Search the Catalog
Cisco IOS in a Nutshell

Cisco IOS in a Nutshell

By James Boney
December 2001
1-56592-942-X, Order Number: 942X
606 pages, $34.95

Excerpt
Reference Section I

ignore-dcd

interface

ignore-dcd

no ignore-dcd

Configures

Determination of a link's status

Default

A DTE serial interface monitors the DCD signal

Description

This command tells the interface to ignore the DCD signal and use the DSR signal to determine whether the link is up or down. By default, all DTE serial interfaces monitor the DCD signal for the link's status.

interface

global

interface interface.subinterface [{point-to-point | multipoint}]

Configures

Allows configuration of a given interface

Default

None

Description

This command enters the interface configuration mode for the given interface and subinterface. The interface most commonly consists of an interface type followed by the number of the particular interface (for example, ethernet0). A space is allowed (and commonly used) between the interface type and the number. Table I-1 shows the most common interface types. On more complex routers, the interface number can be specified in a number of different ways: as a slot/port combination, as a slot/adapter/port combination, or as a slot/port:channel-group combination. The appropriate form depends on the hardware you're dealing with. The interface specification can include a subinterface number; subinterfaces are most common when using protocols like Frame Relay or ATM, which can package a number of communications channels on a single physical connection. The point-to-point keyword indicates that a subinterface is logically connected to a single remote node; multipoint indicates that it is logically connected to a number of remote nodes. multipoint and point-to-point are most commonly used on Frame Relay and ATM interfaces.

Table I-1: Common interface types

Type

Description

async

An asynchronous interface (a standard terminal or modem line)

atm

ATM

bri

ISDN BRI (2 B channels)

dialer

Dial-on-demand interface (see the interface dialer command)

ethernet

Ethernet

fastethernet

100 Mbps Ethernet

fddi

FDDI

gigabitethernet

Gigabit Ethernet

group-async

A logical grouping of asynchronous interfaces to which all configuration commands apply (See the interface group-async command)

hssi

High-speed serial interface

lex

Lan extender

loopback

The internal software virtual interface

null

Null interface; packets sent to this interface are discarded.

pos

OC-3/SONET

serial

Serial interface (used for leased line, T1, and T3)

tokenring

Token ring

tunnel

A virtual interface for a tunnel configuration

interface bvi

global

interface bvi bridge-group-number

no interface bvi bridge-group-number

Configures

Bridging

Default

None

Description

The Bridge Virtual Interface (BVI) becomes available on routers when the bridge irb command has been given. This interface allows the router to route and bridge the same protocol over the same interface. The bridge group-number must match the bridge group defined for the bridge.

Example

In this configuration, serial0 and serial1 are bridged, and traffic is routed through those interfaces out through ethernet0:

bridge irb
bridge 1 protocol ieee
!
interface serial0
 bridge-group 1
!
interface serial
  bridge-group 1
!
interface ethernet 0
  ip address 10.11.1.1 255.255.255.0
!
! Configure the virtual bvi interface with a bridge group number of 1
interface bvi 1
  ip address 10.10.3.1 255.255.255.0
!
! Now configure the routing for the bridge
bridge 1 route ip

interface dialer

global

interface dialer number

no interface dialer number

Configures

A dialer configuration

Default

None

Description

This command allows you to define a virtual dialer configuration that can be applied to a set of physical interfaces. Once you configure this interface, you can make other interfaces use this configuration by using the dialer rotary-group command. number is the virtual interface number, and can be a value from 0 to 9.

Example

interface dialer 0
  encapsulation ppp
  dialer in-band
  dialer map ip 10.1.1.1 name bob 5551111
!
interface async 1
  dialer rotary-group 0

interface group-async

global

interface group-async number

no interface group-async number

Configures

A group of interfaces that can share configuration parameters

Default

None

Description

This command allows you to create a group of async interfaces to which you can apply commands. Actual interfaces that belong to the group inherit the settings you apply to this virtual interface. The group-range command defines which physical async interfaces are included in the group. A physical interface can belong only to one group.

Example

The following commands define a group-async interface that includes async interfaces 1 through 7. The ip unnumbered and async mode commands apply to all the interfaces in the group.

interface group-async 0
  group-range 1 7
  ip unnumbered ethernet0
  async mode interactive

ip access-group

interface

ip access-group access-list [in | out]

no ip access-group access-list [in | out]

Configures

Assigns an access list to an interface

Default

No access lists defined

Description

This command applies the given access list to the interface in the direction specified (in or out). Access-list commands are discussed in Chapter 7. Each interface can support only one access list in either direction.

Example

The following commands apply access list 110 to filter incoming packets on the serial1 interface, and access list 111 to filter outgoing packets:

interface serial1
  ip access-group 110 in
  ip access-group 111 out

To remove an access list from an interface, use the no form of this command:

interface serial1

no ip access-group 111 out

If you use the no access-list command instead of no ip access-group, your access list will be deleted. Be sure to use no ip access-group when removing lists from interfaces.

ip access-list

global

ip access-list {standard | extended} name

Configures

Named access lists

Default

None

Description

This command allows you to create a named access list. A named access list is really no different from a numbered access list as defined by the access-list command, except that it is identified by a logical name. A named access list may be either standard or extended. This command is followed by permit and deny commands that specify the access-list rules. For more about access lists, see Chapter 7 and the discussion of the access-list command.

Example

The following commands defines a named access list that allows HTTP traffic from any host to the server at 10.1.2.3 and permits all other TCP traffic that has the SYN flag set:

ip access-list extended bogus-firewall 
  permit tcp any host 10.1.2.3 eq http
  permit tcp any any established

Remember that all access lists end with an implicit deny, which rejects all traffic not permitted by a statement in the access list.

ip accounting

interface

ip accounting [access-violations]

no ip accounting [access-violations]

Configures

IP accounting for an interface

Default

Disabled

Description

This command enables IP accounting based on the source and destination IP addresses that are passing through this router. Traffic that terminates at the router is not logged. The access-violations option enables logging based on access lists. For an access list to log information, the log keyword must be specified at the end of the access-list command.

Example

The following interface has IP accounting enabled and logs access-list violations:

interface serial 1
  ip address 10.10.2.3 255.255.255.0
  ip access-group 110 in
  ip accounting access-violations
! Deny telnet to the outside and log it when someone tries
access-list 110 deny tcp 10.10.2.0 0.0.0.255 any eq 23 log
access-list 110 permit ip any any

ip accounting-list

global

ip accounting-list address mask

no ip accounting-list address mask

Configures

An accounting filter

Default

None

Description

This command defines an IP address and wildcard mask for use as an accounting filter. Once a filter has been created, traffic is logged only if it matches the filter. If an IP address fails to match this filter, it is considered a transit IP packet and is logged to a separate table. See ip accounting-transits.

Example

The following command logs traffic to and from the 10.10.0.0 network:

ip accounting-list 10.10.0.0 0.0.255.255

ip accounting-threshold

global

ip accounting-threshold log-size

no ip accounting-threshold log-size

Configures

The IP accounting log table

Default

512 entries

Description

This command sets the size of the IP accounting table to log-size bytes. Each entry takes up to 26 bytes. Therefore, an accounting table defined at 100 entries could consume up to 2600 bytes of memory. This calculation should be kept in mind when defining new thresholds, as memory usage has adverse affects on the router.

Example

To double the accounting buffer:

ip accounting-threshold 1024

ip accounting-transits

global

ip accounting-transits number

no ip accounting-transits

Configures

The table used for logging transit IP addresses

Default

None

Description

This command sets the size of the table for transit IP accounting to number entries. A transit IP packet is any packet with a source or destination that does not match the filter defined in the ip accounting-list command. If no accounting filters are defined, there are no transit IP packets.

Example

To set the transit table to 200 entries:

ip accounting-transits 200

ip address

interface

ip address address subnet-mask [secondary]

no ip address address subnet-mask [secondary]

Configures

The IP address for an interface

Default

No IP address

Description

This command sets the IP address for the interface to address; the network mask used on the network is subnet-mask. The secondary keyword is used to apply a second (or third, or fourth...) address to an interface. It is allowed only if the interface allows multiple IP addresses.

Example

This command sets the IP address of the ethernet 0 interface to 10.10.1.1 and the subnet mask to 255.255.255.0:

interface ethernet 0
  ip address 10.10.1.1 255.255.255.0

The following commands use the secondary keyword to add a second IP address to the ethernet 0 interface:

interface ethernet 0

ip address 10.10.1.1 255.255.255.0

ip address 10.10.2.1 255.255.255.0 secondary

This interface will now answer and provide routing for both the 10.10.1.0/24 and 10.10.2.0/24 subnets.

ip address negotiated

interface

ip address negotiated

no ip address negotiated

Configures

PPP/IPCP address negotiation

Default

Disabled

Description

This command configures an interface to obtain its IP address via PPP.

ip address-pool

global

ip address-pool [dhcp-proxy-client | local]

no ip address-pool

Configures

Default address pooling

Default

Disabled

Description

This command provides an IP address pool to be used on dial-in or ISDN interfaces.

dhcp-proxy-client
Optional. The router works as a proxy between the dial-in peers and the DHCP server to provide the address pool.

local
Optional. Tells the router to use the local address pool.

ip alias

global

ip alias ip-address port

no ip alias ip-address

Configures

IP address mapping for reverse telnet

Default

None

Description

This command allows you to provide aliases in the form of IP addresses for various ports on the router. This feature is helpful if you are configuring a communication server with reverse telnet.

ip-address
The IP address of the port for which you want to establish an alias.

port
The port that you want to use as an alias for the IP address.

Example

Say we have a communication server (router) with three ports to which we allow reverse telnet access: 2001, 2002, and 2003. Instead of requiring users to type the router's IP address and the port every time, we assign (alias) an available IP address to each of our ports. The following commands create three IP address aliases (172.30.1.1, 172.30.1.2, and 172.30.1.3):

ip alias 172.30.1.1 2001
ip alias 172.30.1.2 2002
ip alias 172.30.1.3 2003

ip as-path access-list

global

ip as-path access-list access-list {permit|deny} as-regex

no ip as-path access-list access-list {permit|deny} as-regex

Configures

A BGP access list

Default

None

Description

This command allows you to build an access list for BGP autonomous system (AS) paths. These lists can be applied to a neighbor with the filter-list option to the neighbor command. access-list is a number that identifies the list; as-regex is a regular expression that matches AS paths. For more information on valid regular expressions for BGP, see Chapter 10.

Example

The following commands create an AS-path access list that denies (blocks) routes that include AS 111. This access list is then applied to routes that are sent to the BGP neighbor 11.1.1.1.

ip as-path access-list 1 deny _111_
 
router bgp 120
  network 10.1.0.0
  neighbor 11.1.1.1 remote-as 200
  neighbor 11.1.1.1 filter-list 1 out

ip authentication

interface

ip authentication key-chain eigrp as-number key-chain
no ip authentication key-chain eigrp as-number key-chain

ip authentication mode eigrp as-number md5
no ip authentication mode eigrp as-number md5

Configures

Authentication of EIGRP packets

Default

None

Description

The ip authentication key-chain command defines the key chain to be used for authenticating EIGRP packets. It is used with the ip authentication mode eigrp command, which applies the key chain to the correct EIGRP process. Key chains are defined with the global key chain command.

as-number
The EIGRP process to which this key applies.

key-chain
The name of an EIGRP key chain.

Example

interface ethernet 0
  ip authentication key-chain eigrp 100 key1
  ip authentication mode eigrp 100 md5

ip bandwidth-percent eigrp

interface, EIGRP

ip bandwidth-percent eigrp as-number percent-value

Configures

The bandwidth that EIGRP is allowed to use

Default

50 percent

Description

This command sets the bandwidth percentage that EIGRP is allowed to consume on a link. It is particularly useful if the link's bandwidth has been set to a fake value for some reason (such as metrics).

as-number
The EIGRP process whose bandwidth is being limited.

percent-value
The percentage of the interface's total bandwidth that can be used by EIGRP. The interface's bandwidth is defined by the bandwidth command and may not be the same as the actual bandwidth available on the link. Note that percent-value may be greater than 100; this is useful if the bandwidth has been set to an artificially low value and doesn't reflect the actual capacity of the link.

ip bgp-community new-format

global

ip bgp-community new-format

no ip bgp-community new-format

Configures

Display of the BGP communities

Default

Disabled

Description

This command changes the display of BGP communities from NN:AA to AA:NN.

ip bootp server

global

ip bootp server

no ip bootp server

Configures

Use of a BOOTP server from the network

Default

Enabled

Description

This command enables or disables the router's BOOTP server. Disabling this feature prevents hosts from accessing the BOOTP service on the router; that is, the router won't act as a BOOTP server.

ip broadcast-address

interface

ip broadcast-address address

no ip broadcast-address address

Configures

A broadcast address for an interface

Default

Depends on the settings in the config-register

Description

This command specifies the interface's broadcast address. All hosts on the network to which the interface is connected must use the same broadcast address. Broadcast addresses are usually formed by setting the "host address" portion of the IP address to 1, which is the default for the router and virtually all modern computer systems. Some very old systems may form the broadcast address by setting the host portion to 0, and may be incapable of using the "1" form. In this case, you must explicitly set the broadcast address of the router interface (and all other hosts on the network) to use the older form.

Example

The following code changes the broadcast IP address for serial 0 to 10.10.10.255:

interface serial 0
    ip broadcast-address 10.10.10.255

ip cef

global

ip cef [distributed]

no ip cef

Configures

Cisco Express Forwarding (CEF)

Default

Depends on the hardware: disabled on the 7000 and 7200; enabled on the 7500 and 12000

Description

This command enables CEF on the router. CEF is a Layer 3 switching technology that increases network performance for certain types of network traffic. The optional distributed keyword enables distributed CEF (dCEF), which distributes CEF information to line cards on the router.

ip cef traffic-statistics

global

ip cef traffic-statistics [load-interval seconds] [update-rate seconds]

no ip cef traffic-statistics

Configures

Time intervals that control when NHRP creates or destroys an SVC

Default

load-interval is 30 seconds; update-rate is 10 seconds

Description

This command sets the intervals that NHRP uses when building or tearing down an SVC. The load-interval is used in conjunction with the ip nhrp trigger-svc command; its value can range from 30 to 300 seconds. The update-rate is the frequency, in seconds, at which the port adapter sends statistics to the route processor (RP). When using NHRP in distributed CEF switching mode, the update rate must be set to 5 seconds.

ip classless

global

ip classless

no ip classless

Configures

IP classless routing for the router

Default

Depends on the IOS version

Description

This command enables routing based on "classless" addresses. With classless routing, packets can be routed if the router knows a route for a supernet of the addressee. Without classless addressing, the packet is discarded if it arrives at the router and there is no network route for its destination. Assume that a packet arrives with the destination of 10.10.1.5, but we have routes only for 10.10.2.0/24, 10.10.3.0/24, and 10.10.0.0/16. With IP classless routing enabled, the router forwards the packet to the 10.10.0.0/16 network because 10.10.0.0/16 is the best matching supernet of 10.10.1.5.

ip community-list

global

ip community-list number {permit | deny} community

no ip community-list number

Configures

A community list for BGP

Default

None

Description

This command defines a community list, which is basically an access list for a BGP community. A community list can be used with the match community command in a route-map configuration.

number
A value identifying the community list that this command belongs to. Values can be 1 to 99.

permit | deny
Permits or denies the given community.

community
The community to permit or deny. This parameter may be a community number between 1 and 99, or one of the default community names (internet, no-export, no-advertise).

Example

ip community-list 1 permit internet

ip default-gateway

global

ip default-gateway address

no default-gateway address

Configures

The default gateway for the router

Default

None

Description

This command establishes address as the router's default gateway, which is the gateway to which nonlocal packets are forwarded in the absence of a better route. It is useful if the no ip routing command has been issued or if you are running from boot mode, in which IP routing is disabled. This command allows you to forward traffic to the default gateway when routing is disabled. Use the no form of this command to remove the entry from the router's configuration.

ip default-network

global

ip default-network network

no ip default-network network

Configures

Gateway of last resort

Default

None

Description

This command defines a gateway of last resort. The network argument is a network address; any route to the network becomes the default route. For RIP, this is the 0.0.0.0 route; for OSPF, it is an external route.

ip dhcp-server

global

ip dhcp-server address

no ip dhcp-server address

Configures

The DHCP server for the router to use

Default

None

Description

Specifies the address of the DHCP server for this router. You can provide the hostname of the DHCP server instead of its IP address. This DHCP server is then used for creating address pools with the ip address-pool command.

ip directed-broadcast

interface

ip directed-broadcast [access-list]

no ip directed-broadcast

Configures

Broadcast forwarding

Default

Enabled (disabled for IOS 12.0 and later)

Description

By default, the router automatically translates directed broadcasts to physical broadcasts within your network. In other words, Layer 3 broadcasts to the IP broadcast address (10.10.1.255 for the subnet 10.10.1.0/24) are translated into Layer 2 broadcasts with an address appropriate for the interface (e.g., ff:ff:ff:ff:ff:ff for an Ethernet interface).

While this can be useful, an interface that is configured to the outside world could allow a potential hacker to flood your network by pinging the broadcast address on your interface. It is recommended that directed-broadcast is disabled on your external interfaces to prevent this attack from occurring. Directed broadcast is also the primary mechanism used for the "smurf" attack. It is recommended that you disable directed broadcast on all your interfaces unless you have a very good reason to use it.

Example

To disable directed broadcasts:

interface serial 0
     no ip directed-broadcast

ip domain-list

global

ip domain-list domain

no ip domain-list domain

Configures

The domain names for the router

Default

None

Description

This command allows you to define a series of domain names to be used (in turn) to complete an unqualified domain name. It behaves just like the domain-name command except that it allows you to list a series of domains.

Example

These commands set the domain list to mydomain.com, com.com, and mycom.com:

ip domain-list mydomain.com
ip domain-list com.com
ip domain list mycom.com

Use the no form of the command to delete an entry:

no ip domain-list com.com

ip domain-lookup

global

ip domain-lookup

no ip domain-lookup

Configures

DNS lookups for hostnames

Default

Enabled

Description

This command enables the DNS lookup feature. To disable DNS, use the no form of this command. Disabling this feature is useful because you don't usually want the router trying to perform a DNS lookup on every word that you type at the command prompt. (You can accomplish the same thing by enabling transport preferred none on all lines.) Furthermore, if you are having network problems, you may not be able to reach any DNS servers to perform lookups.

Example

To disable DNS lookups:

no ip domain-lookup

ip domain-name

global

ip domain-name domain

no ip domain-name domain

Configures

The domain name for the router

Default

None

Description

This command sets the domain name that the router will use to complete any unqualified domain names.

Example

Here, all unqualified hostnames are taken to be in the mydomain.com domain:

ip domain-name mydomain.com

ip dvmrp accept-filter

interface

ip dvmrp accept-filter access-list [distance] [neighbor-list access-list]

no dvmrp accept-filter access-list

Configures

Incoming filter for DVMRP reports

Default

All reports are accepted with a distance of 0

Description

This command applies an access list to incoming DVMRP reports. The lower the distance, the higher the precedence of the route when computing the Reverse Path Forwarding value.

access-list
The number of a standard IP access list (0-99). Routes matching the access list are assigned the given administrative distance. If the access list number is 0 (which is not a legal access list number), all reports are accepted with the given administrative distance.

distance
Optional. The administrative distance to be assigned to routes matching the filter. Default is 0.

neighbor-list list
Optional. The number of a standard IP access list (1-99). DVMRP reports are accepted only from neighbors who match this access list.

ip dvmrp auto-summary

interface

ip dvmrp auto-summary

no ip dvmrp auto-summary

Configures

DVMRP auto summarization

Default

Enabled

Description

Auto summarization occurs when a route is summarized into a classful network route. Use the no form of this command to disable it, which you will want to do if you are using the ip dvmrp summary-address command.

ip dvmrp default-information

interface

ip dvmrp default-information {originate | only}

no dvmrp default-information

Configures

Advertises a default route to DVMRP neighbors

Default

Disabled

Description

This command causes the default route (0.0.0.0) to be advertised to DVMRP neighbors.

originate
Routes more specific than 0.0.0.0 can be advertised.

only
Only the default route is advertised.

ip dvmrp metric

interface

ip dvmrp metric metric [list access-list] [[protocol process-id] | [dvmrp]

no ip dvmrp metric

Configures

Metrics for DVMRP

Default

1

Description

This command lets you specify a metric to be used with the DVMRP routing protocol. The specified metric is assigned to multicast destinations that match the access list.

metric
The metric associated with DVMRP reports; it can range from 0 to 32. 0 means the route is not advertised; 32 means that the route's destination is unreachable.

list access-list
Optional. If used, this metric is assigned only to multicast destinations that match the access list.

protocol
Optional. bgp, eigrp, igrp, isis, ospf, rip, static, or dvmrp.

process-id
Optional. The process ID of the routing protocol, if required.

dvmrp
Optional. Allows routes from the DVMRP routing table to be advertised with the configured metric route map.

ip dvmrp metric-offset

interface

ip dvmrp metric-offset [in | out] value

no ip dvmrp metric-offset

Configures

Metrics of advertised DVMRP routes

Default

in; the default value for in is 1; for out is 0

Description

This command allows you to increment the metric for DVMRP routes. The given value is added to either metrics received (in) or metrics sent (out) by the router.

ip dvmrp output-report-delay

interface

ip dvmrp output-report-delay milliseconds [burst-packets]

no ip dvmrp output-report-delay

Configures

Interpacket delay of a DVMRP report

Default

100 milliseconds; 2 burst packets

Description

This command sets the number of milliseconds that elapse between packets of a DVMRP report.

milliseconds
Number of milliseconds between transmission of packets.

burst-packets
Optional. The number of packets in the set being transmitted.

ip dvmrp reject-non-pruners

interface

ip dvmrp reject-non-pruners

no ip dvmrp reject-non-pruners

Configures

Peering with DVMRP non-pruners

Default

Disabled

Description

When enabled, this feature tells the interface not to peer with DVMRP hosts that do not support pruning. By default, the router will peer with all DVMRP neighbors.

ip dvmrp routehog-notification

global

ip dvmrp routehog-notification route-count

no ip dvmrp routehog-notification

Configures

Number of routes accepted before a syslog message is generated

Default

10,000

Description

This command sets the number of DVMRP routes that can be accepted within one minute to route-count. If more than this number of routes is accepted within a minute, the router generates a syslog message. This usually helps capture any router that is misconfigured and injecting too many routes.

ip dvmrp route-limit

global

ip dvmrp route-limit count

no ip dvmrp route-limit count

Configures

Number of advertised DVMRP routes

Default

7000

Description

This command sets the limit on the number of DVMRP routes that can be advertised over an interface to count.

ip dvmrp summary-address

interface

ip dvmrp summary-address address mask [metric value]

no ip dvmrp summary-address address mask

Configures

A summary DVMRP route

Default

None

Description

This command configures a summary DVMRP route to be advertised over an interface.

address
The IP address of the summary route.

mask
The network mask of the summary route.

metric value
Optional. The metric to be assigned to the summary address. Default is 1.

ip dvmrp unicast-routing

interface

ip dvmrp unicast-routing

no dvmrp unicast-routing

Configures

DVMRP unicast routing

Default

Disabled

Description

This command enables DVMRP unicast routing on the interface.

ip forward-protocol

global

ip forward-protocol {udp [port] | any-local-broadcast | spanning-tree | turbo-flood}

no ip forward-protocol

Configures

Forwarding of broadcast packets for certain services

Default

Enabled with the ip helper-address command

Description

When the ip helper-address command is configured for an interface, the router "helps" hosts find certain UDP services by forwarding the packets. These services are BOOTP (DHCP), DNS, TFTP, TACACS, TIME, and NetBIOS name and datagram servers. This command allows you to define additional UDP ports that you want forwarded automatically to the helper IP address.

port
Optional. Without this parameter, all the default UDP ports listed here are forwarded. This keyword allows you to forward a specific port. You can disable a default port with the no version of this command.

any-local-broadcast
Forwards any broadcasts including local subnet broadcasts.

spanning-tree
Forwards IP broadcasts that meet the following criteria: First, it must be a MAC level broadcast; second, it must be an IP level broadcast; and third, it must be TFTP, DNS, NetBIOS, ND, TIME, BOOTP, or any other UDP packet specified by an ip forward-protocol udp command.

turbo-flood
Speeds up the flooding of UDP datagrams when using the spanning-tree algorithm. This command should be used in conjunction with the ip forward-protocol spanning-tree command.

Example

To forward port 21000 for a specific application:

ip forward-protocol udp 21000

ip ftp passive

global

ip ftp passive

no ip ftp passive

Configures

Passive FTP mode

Default

Disabled (normal FTP)

Description

This command configures the router to use passive FTP. Passive FTP is often used when connecting through firewalls or access lists that block normal FTP connections. With passive FTP, the file transfer occurs on the same port as the initial connection. You may need to use passive FTP when copying a file or image to an FTP server.

ip ftp password

global

ip ftp password [encryption-level] password

no ftp password

Configures

The FTP password

Default

username@routername.domain

Description

This command sets the password to be used for FTP connections. The default password is appropriate for anonymous FTP connections. If you do not use anonymous FTP, you must use this command to provide an appropriate secret password. The encryption-level allows you to encrypt the password within the router's configuration, so people who have access to the configuration file won't learn it. The encryption-level may be 0 or 7; 0 does not encrypt the password, while 7 uses a proprietary (but not particularly strong) encryption scheme.

ip ftp source-interface

global

ip ftp source-interface interface

no ip ftp source-interface

Configures

The FTP source address

Default

The IP address of the interface closest to the destination

Description

This command sets the source address for FTP connections to the IP address of the given interface.

ip ftp username

global

ip ftp username username

no ip ftp username

Configures

The FTP username

Default

anonymous

Description

This command sets the username for FTP connections. If no username is supplied, the router attempts an anonymous FTP file transfer.

Example

The following commands configure the router to use passive FTP with the username saul and the password pleaseletmein.

ip ftp passive
ip ftp username saul
ip ftp password pleaseletmein

ip hello-interval eigrp

interface

ip hello-interval eigrp as-number seconds

no ip hello-interval eigrp as-number seconds

Configures

Hello interval for EIGRP

Default

5 seconds

Description

This command sets the interval at which EIGRP hello discovery packets are sent out on a link. The default value for the hello interval is 5 seconds. On links where latency is high, changing this value to a higher number can be advantageous.

as-number
The EIGRP process number (frequently called an AS number).

seconds
The interval between hello discovery packets.

ip helper-address

interface

ip helper-address address

no ip helper-address address

Configures

IP address to which certain broadcast UDP packets are forwarded

Default

Disabled

Description

This command sets the helper address to address. The helper address should be the address of a host that can answer UDP requests from other hosts. The router sees these requests broadcasted on a LAN interface and forwards them to the helper address (generally a unicast address) if one is defined. A helper is particularly useful for DHCP requests; without some kind of forwarding, DHCP requires you to have a separate server on every subnet. By itself, this command forwards packets for the BOOTP (DHCP), DNS, TFTP, TACACS, TIME, and NetBIOS name and datagram services. The ip forward-protocol command can be used to forward additional UDP services.

Example

To configure interface ethernet 0 to have a helper address:

interface ethernet 0
  ip address 10.10.1.2 255.255.255.0
  ip helper address 10.10.2.5

ip hold-time eigrp

interface

ip hold-time eigrp as-number seconds

no ip hold-time eigrp as-number seconds

Configures

Hold time for EIGRP networks

Default

15 seconds

Description

This command defines the number of seconds that a route is held before hearing from a neighbor router. If the router doesn't hear from a neighbor within this time, the routes from that neighbor are considered invalid. The default holdtime is three times the hello interval, which is 15 seconds on most links. Slower links might have a holdtime of 180 seconds and a hello interval of 60 seconds.

as-number
The EIGRP process number (frequently called an AS number)

seconds
The holdtime for this EIGRP process.

ip host

global

ip host name [tcp-port] address [address]

no ip host name address

Configures

A static hostname that maps to one or more IP addresses

Default

None

Description

This command allows you to define an IP address for a hostname. Each hostname can have up to eight IP addresses associated with it. This is similar to a host file on a workstation (for example, the /etc/hosts file on Unix).

name
The name of a host.

tcp-port
Optional. The port to connect to on the host when using the telnet command.

address
The address assigned to the host.

Example

The following commands define two IP hosts; the second one has two IP addresses:

ip host gateway1 10.10.1.1
ip host gateway2 10.10.1.2 10.10.1.3

ip http

global

ip http server
no ip http server

ip http access-class access-list
no ip http access-class access-list

ip http authentication method
no ip http authentication method

ip http port port
no ip http port port

Configures

Web IOS interface

Default

Disabled; when enabled, listens on port 80

Description

This command configures support for the Web IOS interface software. This feature enables an HTTP server on the router and allows you to configure the router by pointing any web browser at this server. The access-class option lets you specify an access list that limits access to the HTTP server. The port option lets you specify the port on which the server listens.

The acceptable authentication methods are enable, local, tacacs, and aaa.

Example

The following commands enable the web browser interface and specify a non-default port:

ip http server
ip http port 8008 

ip identd

global

ip identd

no ip identd

Configures

Identification support

Default

Disabled

Description

This command enables the IDENTD identification protocol. To disable IDENTD, use the no form of the command.

ip igmp access-group

interface

ip igmp access-group access-list version

no ip igmp access-group access-list version

Configures

Controls multicast groups

Default

All groups are enabled; version 2

Description

This command allows you to set an access-list that controls which groups are available on the interface for hosts to join. If a host is in the access list, it will be allowed to join multicast groups. The version parameter changes the IGMP version.

ip igmp helper-address

interface

ip igmp helper-address ip-address

no ip igmp helper-address ip-address

Configures

Forwards IGMP messages to another IP address

Default

Disabled

Description

This command causes all IGMP Host Reports and Leave messages to be sent to the host specified by the ip-address parameter.

ip igmp join-group

interface

ip igmp join-group group-address

no ip igmp join-group group-address

Configures

Has the router join a multicast group

Default

None

Description

This command causes the router to join the multicast group specified by the IP group address on the interface.

ip igmp query-interval

interface

ip igmp query-interval seconds

no ip igmp query-interval seconds

Configures

Query message interval

Default

60 seconds

Description

This command configures the router to send IGMP host-query messages at the specified interval. Changing this value may affect multicast forwarding.

ip igmp query-max-response-time

interface

ip igmp query-max-response-time seconds

no ip igmp query-max-response-time seconds

Configures

Response time advertised in IGMP query packets

Default

10 seconds

Description

This command sets the time in seconds that the responder has to respond to a query before the router deletes the group. This command works only with IGMP Version 2.

ip igmp query-timeout

interface

ip igmp query-timeout seconds

no ip igmp query-timeout seconds

Configures

Query timeout

Default

2 times the query interval

Description

This commmand sets the query timeout period in seconds. This is the time that the router waits after the last querier stops querying, and takes over as the querier.

ip igmp static-group

interface

ip igmp static-group group-address

no ip igmp static-group group-address

Configures

A static igmp group for the router

Default

Disabled

Description

This command enrolls the router in the multicast group specified by the group-address. Unlike the ip igmp join-group command, this command allows packets to the group to be fast-switched out the interface.

ip igmp version

interface

ip igmp version { 1 | 2 }

no ip igmp version

Configures

The IGMP version type

Default

2

Description

This command sets the version number of IGMP supported by the router (1 or 2). Make sure that your hosts support the same version. Version 3 is planned for later releases of the IOS.

ip irdp

interface

ip irdp [multicast | holdtime seconds | maxadvertinterval seconds | minadvertinterval seconds | preference value | address ip-address [preference]]

no ip irdp

Configures

IRDP

Default

Disabled

Description

This command enables ICMP Router Discovery Protocol (IRDP) on an interface. Other hosts on the network can use this protocol to negotiate a default router based on the preference parameter.

This command has many options. Instead of writing a single long command, it's often more convenient to issue a number of shorter commands, each setting one option.

multicast
Optional. Tells the router to use the multicast address instead of the broadcast address for IRDP.

holdtime seconds
Optional. The time in seconds that advertisements are held. By default, this value is three times the maxadvertinterval.

maxadvertinterval seconds
Optional. Sets the maximum interval in seconds between advertisements. The default is 600 seconds.

minadvertinterval seconds
Optional. Sets the minimum interval in seconds between advertisements. The default is the maximum interval.

preference value
Optional. Sets the preference value for this router, which is used by the routers running IRDP to select the default gateway. The default preference is 0. The higher the preference, the more preferred this router is to hosts.

address ip-address [preference]
Optional. Tells the router to generate proxy advertisements for the given ip-address. If you specify a preference, it is associated with the given ip-address. This allows routers that do not run IRDP to participate in router discovery.

Example

interface ethernet0
  ! Enable IRDP on this interface
  ip irdp
  ! make this router preferred 
  ip irdp preference 10

ip load-sharing

interface

ip load-sharing [per-packet] [per-destination]

no ip load-sharing [per-packet] [per-destination]

Configures

CEF

Default

per-destination

Description

This command enables load sharing for Cisco Express Forwarding (CEF). By default, CEF uses per-destination load sharing, in which all traffic for a given destination is sent through the same interface. The per-packet keyword changes the behavior of CEF so that packets for the same destination may be sent through different interfaces. This approach makes load sharing more effective because it increases the effective bandwidth between the router and the destination. However, packets might arrive at the destination out of order, requiring the destination host to reassemble them.

ip local policy route-map

global

ip local policy route-map map

no ip local policy route-map map

Configures

Policy routing

Default

None

Description

This command enables local policy routing. In brief, policy routing means using criteria other than the shortest path to the destination (as computed by a routing protocol) for route selection. The map parameter is the name of a route map that specifies the routing policy. Unlike the ip policy command, which applies a routing policy to a single interface, this command applies the policy to traffic originating on the router.

Example

In this example, a route map named map1 states that any traffic that matching access list 101 will be routed to the 10.1.1.1 router. Access list 101 matches all IP traffic destined for network 10.1.5.0/24. The ip local policy command is used to apply this route map, effectively routing all traffic for 10.1.5.0 through 10.1.1.1 regardless of what the routing protocols might tell the router to do. There are many possible reasons for this policy--for example, the traffic for 10.1.5.0 might be highly confidential, and we want to make sure that it passes only through trusted routers.

access-list 101 permit ip 10.1.5.0 0.0.0.255 any
!
ip local policy route-map map1
!
route-map map1
  match ip address 101
  set ip next-hop 10.1.1.1

ip local pool

global

ip local pool {default | poolname} low-ip-address [high-ip-address]

no ip local pool {default | poolname}

Configures

A pool of IP addresses

Default

None

Description

This command allows you to create a pool of IP addresses that are used when a remote system connects to one of your interfaces. The default pool is the one used if no name is given on the interface.

default
Default pool configuration.

poolname
The name of the pool you are configuring.

low-ip-address
The starting (lowest) IP address in the address pool.

high-ip-address
The ending (highest) IP address in the pool. This is optional. If omitted, the only IP address in the pool is the low-ip-address.

Example

! Assign a pool called dialins1 that goes from 172.30.25.10 to 172.30.25.100

ip local pool dialins1 172.30.25.10 172.30.25.100

ip mask-reply

interface

ip mask-reply

no mask-reply

Configures

Responses to ICMP mask request messages

Default

Disabled

Description

By default, the router does not respond to ICMP mask requests. This command enables responses through the interface.

Example

interface ethernet 1
  ip mask-reply

ip mroute

global

ip mroute source mask [protocol as-number] {rpf-address | interface} [distance]

no ip mroute source mask [protocol as-number] {rpf-address | interface} [distance]

Configures

A multicast static route

Default

None

Description

This command adds a static multicast route.

source
The source IP address.

mask
Network mask for the source address.

protocol as-number
Optional. The unicast routing protocol you are using, followed by the protocol's process number or autonomous system number, if applicable.

rpf-address
The address of the incoming interface for the multicast route. This address can be a host address or a network address.

interface
The incoming interface for the route (e.g., serial 0).

distance
Optional. This value is used to decide if a unicast, DVMRP, or static route should be used for RPF lookup.

ip mroute-cache

interface

ip mroute-cache

no ip mroute-cache

Configures

IP multicast fast switching

Default

Enabled

Description

This command enables fast switching for multicast routing, which is analogous to the route cache for unicast routing. If disabled with the no form of the command, every packet is switched at the process level.

ip mtu

interface

ip mtu bytes

no ip mtu bytes

Configures

Maximum Transmission Unit (MTU) for the interface

Default

Depends on the interface's media type

Description

This command sets the MTU for the interface to bytes. The MTU is the largest packet size that can be sent over the interface. The default MTU depends on the media type; Table I-2 shows default MTU values for some common media. This command allows you to modify the MTU for any interface. Larger MTU values are more efficient with highly reliable networks; lower MTU values can help if an interface is unreliable, or in situations where protocols do not support fragmentation.

Table I-2: Default MTU values

Interface type

Default MTU

Ethernet/Serial

1500

HSSI/ATM/FDDI

4470

Example

interface ethernet 0
  ip mtu 1250

ip multicast boundary

interface

ip multicast boundary access-list

no ip multicast boundary

Configures

A multicast boundary

Default

None

Description

The access-list defines the multicast boundary, which is used to keep multicast packets from being forwarded out the interface.

ip multicast cache-headers

global

ip multicast cache-headers

no ip multicast cache-headers

Configures

Buffers multicast packet headers

Default

Disabled

Description

This command enables the router to cache IP multicast packet headers. These headers can be viewed with the show ip mpacket command.

ip multicast helper-map

interface

ip multicast helper-map group-address broadcast-address access-list
ip multicast helper-map broadcast multicast-address access-list

no ip multicast helper-map group-address broadcast-address access-list
no ip multicast helper-map broadcast multicast-address access-list

Configures

Multicast tunnelling

Default

None

Description

Use this command to send broadcast packets through a multicast network that connects two or more broadcast-capable networks. At one multicast network, you convert the multicast packets to broadcast packets and send them through the broadcast network, which converts them back to multicast packets at the other end.

group-address
Multicast group whose traffic is to be converted to broadcast traffic.

broadcast
Specifies that the traffic is going to be converted from broadcast to multicast.

broadcast-address
When using the group-address parameter, this parameter specifies the IP address to which to send the broadcast traffic.

multicast-address
When using the broadcast option, this variable specifies the multicast address to which converted traffic is sent.

access-list
An extended access list that uses the UDP port number to control which broadcast packets will be converted.

Example

The following configuration converts multicast traffic for the multicast group 224.1.1.2 to broadcast traffic using the broadcast address 10.1.1.255 and UDP port 5000:

interface ethernet 0 
  ip multicast helper-map 224.1.1.2 10.1.1.255 101 
  ip pim dense-mode 
! 
! Convert to UDP port 5000
access-list 101 permit any any udp 5000 
access-list 101 deny any any udp
!
! Forward UDP port 5000
ip forward-protocol udp 5000

The next configuration is the other end of the tunnel. It converts broadcast traffic on UDP port 5000 to multicast traffic:

interface ethernet 0
  ip multicast helper-map broadcast 224.1.1.2 101
  ip pim dense-mode
!
! Use access list to convert traffic to UDP
! port 5000
access-list 101 permit any any udp 5000
access-list 101 deny any any udp
!
! Forward udp port 5000
ip forward-protocol udp 5000

ip multicast rate-limit

interface

ip multicast rate-limit {in | out} [video | whiteboard]
[group-list access-list] [source-list access-list] kbps

no ip multicast rate-limit {in | out} [video | whiteboard]
[group-list access-list] [source-list access-list] kbps

Configures

The rate at which a sender can send to a multicast group

Default

No rate limit

Description

This command controls the rate at which hosts matching a source list can send multicast packets to a multicast group.

in
The limit applies only to incoming packets.

out
The limit applies only to outgoing packets.

video
Optional. Rate limit applies only to video traffic.

whiteboard
Optional. Rate limit applies only to whiteboard traffic.

group-list access-list
Optional. The rate limit applies only to multicast groups that match the access list.

source-list access-list
Optional. The rate limit applies only to hosts sending multicast traffic that match the access list.

kbps
The total bandwidth, in kbps, that is used for multicast traffic that matches the preceding parameters. Traffic in excess of this rate is discarded. If the rate is set to 0, no traffic is permitted.

ip multicast-routing

global

ip multicast-routing

no ip multicast-routing

Configures

IP multicast routing

Default

Disabled

Description

By default, the router does not forward multicast packets. This command enables multicast routing.

ip multicast ttl-threshold

interface

ip multicast ttl-threshold ttl

no ip multicast ttl-threshold

Configures

TTL threshold of forwarded packets

Default

0

Description

This command configures the TTL threshold for packets that are being forwarded out the interface. Only packets with TTL values greater than the threshold are forwarded. The default value is 0, which means all packets are forwarded. The value of ttl can be from 0 to 255.

ip name-server

global

ip name-server address [address]

no ip name-server address

Configures

DNS server name

Default

None

Description

This command sets the name servers that the router uses for DNS queries. You can specify the addresses of up to 6 different DNS servers on one command line. Because you are configuring domain name service, be sure to use an IP address and not a hostname for the server!

Example

The first line configures one name server; the second line configures six name servers:

ip name-server 10.10.2.5
ip name-server 10.10.1.5 10.10.2.5 10.10.3.5 10.10.4.5 10.10.5.5 10.10.6.5

ip nat

interface

ip nat {inside | outside}

no ip nat {inside | outside}

Configures

IP network address translation (NAT)

Default

Disabled

Description

This command configures an interface for NAT. The translation can occur for inside or outside addresses.

Example

In the following configuration, ethernet0 is our internal network with the internal IP address; serial0 is our external interface to the Internet. The NAT translation should be inside on ethernet0 and outside on serial0.

interface ethernet0
  ip address 10.10.1.1 255.255.255.0
  ip nat inside
interface serial0
  ip address 192.168.1.1 255.255.255.0
  ip nat outside

ip nat inside destination

global

ip nat inside destination [list access-list] pool pool-name

no ip nat inside destination [list access-list] pool pool-name

ip nat inside destination [list access-list] static global-ip local-ip

no ip nat inside destination [list access-list] static global-ip local-ip

Configures

Enables NAT for inside destination IP addresses

Default

Disabled

Description

This command enables the mapping of internal (inside) destination addresses to global destination addresses.

list access-list
Optional. Defines an access list for the translation. If an address is not blocked by the access list, it is translated.

pool pool-name
The name of the address pool for allocating global IP addresses.

static global-ip local-ip
A static mapping of a global IP address to a local IP address.

ip nat inside source

global

ip nat inside source [list access-list] pool pool-name [overload]

no ip inside source [list access-list] pool pool-name [overload]

ip nat inside source [list access-list] static local-ip global-ip

no ip nat inside source [list access-list] static local-ip global-ip

Configures

Enables NAT for inside source IP addresses

Default

None

Description

This command enables the mapping of internal (inside) source addresses to global addresses.

list access-list
Optional. Defines an access list for the translation. If an address is not blocked by the access list, it is translated.

pool pool-name
The name of an address pool to be used for selecting global IP addresses.

overload
Optional. Allows many local IP addresses to share a few global IP addresses by multiplexing the ports.

static local-ip global-ip
A static mapping of a local IP address to a global IP address.

ip nat outside source

global

ip nat outside source [list access-list] pool pool-name

no ip nat outside source [list access-list] pool pool-name

ip nat outside source [list access-list] static global-ip local-ip

no ip nat outside source[list access-list] static global-ip local-ip

Configures

Enables NAT for outside source IP addresses

Default

None

Description

This command enables the mapping of external (outside) source addresses to internal addresses.

list access-list
Optional. Defines an access list for the translation. If an address is not blocked by the access list, it is translated.

pool pool-name
The name of the address pool for allocating global IP addresses.

static global-ip local-ip
A static mapping of a global IP address to a local IP address.

ip nat pool

global

ip nat pool name starting-address ending-address [netmask value | prefix-length length] [type rotary]

no ip nat pool name starting-address ending-address [netmask value | prefix-length length] [type rotary]

Configures

The IP address pool to be used in the NAT configuration

Default

None

Description

This command defines a sequential range of IP addresses to use with NAT configurations.

name
Name of the address pool.

starting-address
The beginning of the pool's IP address range.

ending-address
The last IP address in the pool.

netmask value
Specifies the netmask for the pool address range.

prefix-length length
Specifies the number of ones in the bitmask.

type rotary
Optional. Specifies that the range of IP addresses corresponds to real hosts for which load distribution should occur. This means that the pool is defined as a round-robin set of address for load balancing. As new TCP connections are made, a new address is selected from the pool. Non-TCP traffic passes through without translation.

ip nat translation

global

ip nat translation {timeout | udp-timeout | dns-timeout | tcp-timeout | finrst-timeout} seconds

no ip nat translation {timeout | udp-timeout | dns-timeout | tcp-timeout | finrst-timeout} seconds

Configures

None

Default

See description

Description

This command specifies different timeouts for NAT translations. timeout is 86400 seconds; udp-timeout is 300 seconds; dns-timeout is 60 seconds; tcp-timeout is 86400 seconds; finrst-timeout is 60 seconds.

timeout seconds
The timeout on all translations except overloads.

udp-timeout seconds
The timeout on UDP port translations.

dns-timeout seconds
The timeout on DNS (Domain Name Service).

tcp-timeout seconds
The timeout on TCP ports.

finrst-timeout seconds
The timeout on Finish and Reset TCP packets.

ip netmask-format

line

ip netmask-format [bitcount | decimal | hexadecimal]

no ip netmask-format [bitcount | decimal | hexadecimal]

Configures

How subnets are displayed by the show command

Default

Decimal format (255.255.255.0)

Description

This command determines the format that the show commands use for displaying subnet masks. Table I-3 shows the possibilities.

Table I-3: Netmask formats

Format name

Example

decimal

255.255.255.0

bitcount

10.10.1.0/24

hexadecimal

0xffffff00

ip nhrp authentication

interface

ip nhrp authentication string

no ip nhrp authentication

Configures

Authentication for NHRP

Default

Disabled

Description

This command sets an authentication string for Next Hop Resolution Protocol (NHRP). By default, no authentication is performed. The string can be up to eight characters in length. All routers within the NBMA (nonbroadcast multiple access) must use the same authentication string.

ip nhrp holdtime

interface

ip nhrp holdtime seconds

no nhrp holdtime

Configures

NHRP holdtime

Default

7200 seconds

Description

This command sets the number of seconds to advertise to other routers that they should keep NHRP information.

ip nhrp interest

interface

ip nhrp interest access-list

no nhrp interest

Configures

Which packets should trigger NHRP requests

Default

All non-NHRP packets trigger NHRP requests

Description

This command specifies an access list that the router uses to select which packets should generate NHRP traffic.

ip nhrp map

interface

ip nhrp map ip-address nbma-address

no ip nhrp map ip-address nbma-address

Configures

A static NBMA-to-IP address mapping

Default

None

Description

This command allows you to define a static ip-address to nbma-address mapping. The NBMA address can be a MAC address for Ethernet or an NSAP address for ATM. For NHRP, you usually need to configure one static mapping to get to the next-hop server.

ip nhrp map multicast

interface

ip nhrp map multicast

no ip nhrp map multicast

Configures

An NBMA address for broadcast or multicast packets

Default

None

Description

This command defines a nonbroadcast multiple access (NBMA) address to which to send broadcast or multicast traffic. An NBMA address is a MAC address for Ethernet networks or an NSAP address for ATM networks. A configuration may include several of these commands, each defining another NBMA address. This command allows you to send multicast traffic through a tunnel that crosses networks that do not support IP multicasting. It may be used only on tunnel interfaces.

ip nhrp max-send

interface

ip nhrp max-send packet-count every interval

no nhrp max-send

Configures

Frequency of NHRP packets

Default

packet-count is 5; interval is 10 seconds

Description

This command controls the rate at which NHRP packets can be sent. At most, packet-count packets can be sent every interval seconds. packet-count can be from 1 to 65535; interval can be from 10 to 65535. NHRP traffic cannot exceed this rate. Both locally generated and forwarded traffic count toward the total.

ip nhrp network-id

interface

ip nhrp network-id id

no nhrp network-id id

Configures

Enables NHRP

Default

Disabled

Description

This command enables NHRP on an interface by assigning a unique identifier for the network. All hosts participating in NHRP on a logical NBMA network must use the same network ID. id can be from 1 to 4294967295.

ip nhrp nhs

interface

ip nhrp nhs ip-address [network mask]

no ip nhrp nhs ip-address [network mask]

Configures

The NHS address

Default

None

Description

This command configures the ip-address of the next hop server (NHS). Optionally, you can provide a network address and mask that specify the network that the NHS serves. To specify multiple networks for a single NHS, enter this command multiple times with different network and mask parameters.

When NHS servers are configured, they override the normal NHRP forwarding table.

ip nhrp record

interface

ip nhrp record

no ip nhrp record

Configures

The use of forward and reverse record options in NHRP packets

Default

Enabled

Description

The no form of this command disables the forward and reverse record options in NHRP request and reply packets. These options provide loop detection.

ip nhrp responder

interface

ip nhrp responder interface

no ip nhrp responder interface

Configures

The IP address to use as the source of NHRP reply packets

Default

The IP address of the interface that received the NHRP request

Description

This command specifies the interface whose IP address is used as the source for NHRP reply packets. Normally, the IP address of the interface that received the NHRP packet is used. This command is useful on next-hop servers because it allows a form of loop detection: the server can look for its own unique IP address.

ip nhrp server-only

interface

ip nhrp server-only [non-caching]

no ip nhrp server-only

Configures

NHRP on an interface acting in server mode only

Default

Disabled

Description

This command enables NHRP on an interface in server mode only. In server mode, an interface does not originate NHRP requests. The optional non-caching keyword disables the cache of NHRP information.

ip nhrp trigger-svc

interface

ip nhrp trigger-svc trigger-threshold teardown-threshold

no nhrp trigger-svc

Configures

The thresholds for building an SVC based on traffic rates

Default

trigger threshold is 1 kbps; teardown-threshold is 0 kbps

Description

This command sets the thresholds for traffic rates that define when an SVC is built or destroyed. The trigger-threshold is the average traffic rate at (or above) which NHRP will create an SVC for a destination. The teardown-threshold is the traffic rate at (or below) which NHRP will tear down an SVC. Both parameters are in kbps; they are calculated during the load interval. The load interval is the length of time over which the router calculates the interface's throughput for comparison with the trigger and teardown thresholds. It is always a multiple of 30 seconds and is set by the ip cef traffic-statistics command.

ip nhrp use

interface

ip nhrp use count

no ip nhrp use

Configures

A usage count that defers NHRP requests for a certain number of packets

Default

1

Description

By default, when the router has a packet that is eligible for NHRP address resolution, the router sends the NHRP request immediately. This command allows you to defer the NHRP request until count packets have been sent to the destination. The packet count can be from 1 to 65535.

The packet count is destination-based. If the count was set to 3 and the router received five packets, two for destination 1 and three for destination 2, the router would generate an NHRP request only for destination 2.

ip ospf authentication

interface

ip ospf authentication [message-digest | null]

no ip ospf authentication

Configures

OSPF authentication

Default

No authentication

Description

This command enables OSPF authentication for an interface, to be used if the area authentication command is not enabled. If you enable this command with no options, specify the password with the ip ospf authentiation-key command. If you use the message-digest option, specify the password with the ip ospf message-digest-key command.

The null option can be used to disable authentication for this interface if authentication of the entire area has already been configured.

ip ospf authentication-key

interface

ip ospf authentication-key password

no ip ospf authentication-key

Configures

A password to authenticate OSPF neighbors

Default

None

Description

This command assigns a password for communicating with neighboring routers to this interface. All adjacent routers should be configured with the same authentication key. The password can be from 1 to 8 bytes in length.

ip ospf cost

interface

ip ospf cost value

no ip ospf cost value

Configures

A default OSPF cost for packets sent out on this interface

Default

108 / bandwidth

Description

This command sets the cost of sending an OSPF packet on an interface to value. By default, Cisco routers use the bandwidth to determine the link's cost; high- speed links have a lower cost and are therefore more preferred. Other vendors might have an alternative method for cost calculation. This command can be used as needed to set the cost appropriately in a multi-vendor environment, or to change the preference of two links of the same type. By default, OSPF attempts load balancing across links of the same type; this command changes that behavior by modifying the cost associated with each link.

Example

In this example, there are two FDDI links. The second link has a higher cost, causing the router to prefer the first.

interface fddi0
   ip ospf cost 2
interface fddi1
   ip ospf cost 5

ip ospf dead-interval

interface

ip ospf dead-interval seconds

no ip ospf dead-interval

Configures

The interval that can pass between hello packets

Default

Four times the hello interval

Description

This command specifies the length of time in seconds that must pass before receiving a hello packet. If the time passes without a hello packet from a neighbor router, the router is marked down.

ip ospf demand-circuit

interface

ip ospf demand-circuit

no ip ospf demand-circuit

Configures

Dial-on-demand behavior

Default

Disabled

Description

This command tells OSPF that this interface is a demand circuit (i.e., an interface configured for dial-on-demand routing). OSPF will suppress verbose traffic (such as periodic hello packets), thus preventing the circuit from being kept up all the time.

Example

This example configures an ISDN interface as a DDR link for OSPF:

interface bri0
  ip address 10.12.1.5 255.255.255.0
  encapsulation ppp
  ip ospf demand-circuit

ip ospf hello-interval

interface

ip ospf hello-interval seconds

no ip ospf hello-interval

Configures

The interval between hello packets

Default

10 seconds

Description

This command sets the number of seconds between hello packets on a given interface. All nodes on a network must have the same hello interval. If you change the interval on one router, you must change it on all routers within the area.

ip ospf message-digest-key

interface

ip ospf message-digest-key keyid md5 key

no ip ospf message-digest-key keyid md5 key

Configures

MD5 authentication

Default

Disabled

Description

This command enables MD5 password authentication for the interface. The keyid can be from 1 to 255; the key can be up to 16 bytes in length.

ip ospf name-lookup

interface

ip ospf name-lookup

no ip ospf name-lookup

Configures

DNS lookups for OSPF show commands

Default

Disabled

Description

This command enables DNS name lookups for all OSPF show commands. By default, show commands display IP addresses in numeric form.

ip ospf network

interface

ip ospf network {broadcast | non-broadcast | point-to-multipoint}

no ip ospf network

Configures

The type of OSPF network

Default

Depends on the interface type

Description

Given the interface's type, the OSPF process selects a default network type. This command allows the default network type to be changed.

broadcast
The interface is connected to a broadcast network.

non-broadcast
The interface is connected to a nonbroadcast network, i.e., a network with no effective way of dealing with broadcast packets. One example is a point-to-point network.

point-to-multipoint
The interface is connected to a point-to-multipoint network.

Example

By default, a serial interface is point-to-point. The following commands configure a serial subinterface as part of a broadcast network:

interface serial0.1
   ip ospf network broadcast

ip ospf priority

interface

ip ospf priority priority

no ip ospf priority priority

Configures

OSPF priority

Default

1

Description

This command sets the priority for the router within the OSPF area to which the interface is connected. The priority determines which routers are selected as the area's DR and BDR, and can range from 0 to 255. Routers with a priority of 0 are excluded from the selection process; the router with the highest priority is selected.

Example

interface serial0
    ip ospf priority 10

ip ospf retransmit-interval

interface

ip ospf retransmit-interval seconds

no ip ospf retransmit-interval seconds

Configures

The interval between link state announcements (LSAs)

Default

5 seconds

Description

This command sets the interval (in seconds) at which link state announcements are sent to adjacent routers via the interface. The interval can range from 1 to 65535 seconds.

Example

interface serial0
   ip ospf retransmit-interface 3

ip ospf transmit-delay

interface

ip ospf transmit-delay seconds

no ip ospf transmit-delay seconds

Configures

Estimated time to send a link update on the interface

Default

1 second

Description

This command lets you estimate the number of seconds required to transmit a link state announcement through this interface. It's most useful on slow interfaces where it may take a significant amount of time to transmit the announcement. The estimate is used in computing the packet's age; its value can range from 1 to 65535 seconds.

Example

interface serial0
  ip ospf transmit-delay 3

ip pim

interface

ip pim {sparse-mode | dense-mode | sparse-dense-mode}

no ip pim

Configures

IP multicast routing on the interface

Default

Disabled

Description

This command enables PIM (Protocol-Independent Multicast) and IGMP on the interface.

sparse-mode
In this mode, the router forwards multicast packets only if it has received a join message from a downstream router or if it has group members directly connected to this interface.

dense-mode
In this mode, the router forwards multicast packets until it can determine whether there are group members or downstream routers. Unlike sparse-mode, it doesn't wait for a join message to begin sending multicast packets.

sparse-dense-mode
This mode allows the router to operate in both sparse-mode and dense-mode, depending on what the other routers in the multicast group are using.

ip pim accept-rp

global

ip pim accept-rp {address | auto-rp} [access-list]

no ip pim accept-rp {address | auto-rp} [access-list]

Configures

Processing of multicast join and prune messages

Default

Disabled

Description

By default, all join and prune messages are processed. This command lets you tell the router to process join and prune messages destined for a specific Rendezvous Point (RP) or a specific list of groups.

address
The RP allowed to send messages to the multicast groups specified by the group access list.

auto-rp
Accepts only messages from RPs in the auto-rp cache.

access-list
Optional. An access list that defines the multicast groups for which we want to process join and accept messages.

ip pim message-interval

global

ip pim message-interval seconds

no ip pim message-interval seconds

Configures

Interval for join/prune messages

Default

60 seconds

Description

In sparse-mode operation, this command allows you to control the interval in seconds for sending join and prune PIM messages. A router is pruned if it is not heard from in three times this interval. The interval's value can be from 1 to 65535 seconds.

ip pim minimum-vc-rate

interface

ip pim minimum-vc-rate packets-per-second

no ip pim minimum-vc-rate

Configures

Which VCs are eligible for idling

Default

0 (all VCs)

Description

This command sets the packet rate at which ATM virtual circuits (VCs) can be idled. A VC is idled if its traffic rate falls below packets-per-second, which can range from 0 to 4294967295. This command applies only to ATM interfaces in PIM sparse mode.

ip pim multipoint-signalling

interface

ip pim multipoint-signalling

no ip pim multipoint-signalling

Configures

PIM's ability to open ATM SVCs for multicast groups

Default

Disabled

Description

This command enables an ATM interface to open multipoint SVCs for each PIM multicast group that it joins.

ip pim nbma-mode

interface

ip pim nbma-mode

no ip pim nbma-mode

Configures

NBMA mode

Default

Disabled

Description

This command sets the interface for Non-Broadcast Multi-Access (NBMA) mode and is used on non-multicast interfaces such as Frame Relay and ATM. Use this command only with ip pim sparse-mode.

ip pim neighbor-filter

interface

ip pim neighbor-filter access-list

no ip pim neighbor-filter access-list

Configures

A method to filter (deny) PIM packets from other routers

Default

None

Description

This command allows you to specify a standard IP access-list to control which routers receive PIM packets. The standard access list denies PIM packets from the source, preventing the router from joining PIM.

ip pim query-interval

interface

ip pim query-interval seconds

no ip pim query-interval

Configures

The frequency of PIM query messages

Default

30 seconds

Description

This command sets the query interval to seconds. The query message is used to determine which router on the subnet will be the designated router. The designated router sends IGMP messages to the rest of the routers on the LAN; it also sends messages to the rendezvous point when operating in sparse-mode. The query interval defaults to 30 seconds and can be set to a value between 1 and 65535 seconds.

ip pim rp-address

global

ip pim rp-address ip-address [group-access-list] [override]

no ip pim rp-address ip-address

Configures

Defines the RP for a group

Default

None

Description

This command specifies the rendezvous point (RP) for a particular multicast group.

ip-address
IP address of the PIM rendezvous point.

group-access-list
Optional. Defines the multicast groups for which this RP address should be used. If there is no access list, the RP address is used for all groups.

override
Optional. If the rendezvous point address defined by this command conflicts with the rp-cache, the override option causes this command to override the auto-rp cache.

ip pim rp-announce-filter

global

ip pim rp-announce-filter rp-list access-list group-list access-list

no ip pim rp-announce-filter rp-list access-list group-list access-list

Configures

A filter for incoming RP announcements

Default

All announcements are accepted

Description

RP routers periodically send out auto-rp announcement messages. This command controls which of these messages are accepted.

rp-list access-list
A standard access list that defines the list of allowable RP addresses for the group list.

group-list access-list
A standard access list that defines the multicast groups that the RPs serve.

ip pim send-rp-announce

global

ip pim send-rp-announce interface scope ttl group-list access-list

no ip pim send-rp-announce interface scope ttl group-list access-list

Configures

The auto-rp cache

Default

Disabled

Description

This command tells the router to use the auto-rp cache to define the multicast groups for which the router is willing to become the RP. You normally use this command in the router that you wish to become the RP.

interface
The interface that identifies the RP address.

scope ttl
Time-to-live value for announcements. TTL is roughly equivalent to a hop count.

group-list access-list
An access list that defines the groups for which this router should be the RP.

ip pim send-rp-discovery

global

ip pim send-rp-discovery scope ttl

no ip pim send-rp-discovery scope ttl

Configures

The router to be the RP mapping agent

Default

Disabled

Description

This command configures the router to be the RP mapping agent for the PIM domain. The time-to-live value (ttl) should be large enough to cover the entire domain.

ip pim vc-count

interface

ip pim vc-count number

no ip pim vc-count

Configures

The number of VCs that PIM can open

Default

200 VCs per ATM interface or subinterface

Description

This command sets the maximum number of virtual circuits (VCs) that PIM can open. number must be between 1 and 65535.

ip pim version

interface

ip pim version {1 | 2}

no ip pim version

Configures

PIM version to use on an interface

Default

2

Description

This command sets the PIM version to use for an interface. The version can be 1 or 2.

ip policy route-map

interface

ip policy route-map map

no ip policy route-map map

Configures

Policy routing

Default

None

Description

This command enables policy routing for an interface. In brief, policy routing means using criteria other than the shortest path (as computed by a routing protocol) for route selection. The map parameter is the name of a route map that specifies the routing policy. The map applies only to traffic arriving on the interface.

Example

The following configuration applies the route map map1 to packets arriving on the serial1 interface. This route map selects packets that match access list 101 and sends them to the router at 10.1.1.1 for further routing, regardless of other information in the routing table.

access-list 101 permit ip 10.1.5.0 0.0.0.255 any
!
interface serial 1
  ip policy route-map map1
!
route-map map1
  match ip address 101
  set ip next-hop 10.1.1.1

ip proxy-arp

interface

ip proxy-arp

no ip proxy-arp

Configures

The proxy-arp feature for an interface

Default

Enabled

Description

ARP allows machines to find hardware addresses (MAC addresses) using the corresponding IP addresses. The router's proxy-arp feature helps the machines find each other across subnets. When a host sends an ARP packet requesting information about a host that can't receive the ARP broadcast, the router helps out by responding to the ARP packet on behalf of the requested host.

While proxy-arp is often useful, it can be a burden on the router in large networks. Disabling proxy-arp and relying on proper subnetting is a better solution than relying on proxy-arp to solve subnetting problems.

Example

The following commands disable proxy-arp on ethernet0. All hosts on this subnet must have the proper subnet mask because proxy-arp isn't there to help them.

interface ethernet0
  ip address 10.10.1.64 255.255.255.224
  no ip proxy-arp

ip rarp-server

interface

ip rarp-server address

no ip rarp-server address

Configures

RARP

Default

Disabled

Description

This command enables a router's interface to act as a Reverse Address Resolution Protocol (RARP) server. The address parameter is the address to be used in responses to RARP queries.

ip rcmd rcp-enable

global

ip rcmd rcp-enable

no rcmd rcp-enable

Configures

RCP to the router

Default

Disabled

Description

This command allows remote users to use the Remote Copy Protocol (RCP) to transfer files to and from the router, and RSH to access the router. For security reasons, RCP is disabled by default.

ip rcmd remote-host

global

ip rcmd remote-host local-username {ip-address | hostname} remote-username [enable [level]]

no ip rcmd remote-host local-username {ip-address | hostname} remote-username [enable [level]]

Configures

Which users can access the router via RSH and RCP

Default

None

Description

This command defines a local and remote username pair that allows remote users to perform remote shell tasks (RSH and RCP).

local-username
A locally defined username or the router's hostname. The user must provide a local username to perform an operation via RSH or RCP.

ip-address or hostname
The remote host from which the router accepts remote shell commands.

remote-username
The username on the remote host from which the router accepts remote shell commands.

enable level
Optional. Provides the remote user the ability to execute privileged commands via the remote shell. level specifies a privilege level; the user may execute commands up to and including that level. For more information about privilege levels, see Chapter 4 and the privilege level command.

ip rcmd remote-username

global

ip rcmd remote-username username

no ip rcmd remote-username username

Configures

The username to use when performing remote copy commands

Default

The username for the session or the router's hostname

Description

This command sets the username that the router uses when connecting to remote hosts to execute remote copy commands. By default, the router uses the username of the current session. If that username isn't valid, the router uses the router's hostname.

ip rcmd rsh-enable

global

ip rcmd rsh-enable

no ip rcmd rsh-enable

Configures

Remote shell access by remote users

Default

Disabled

Description

This command enables remote shell access to the router via the rsh command. For security reasons, remote shell access is disabled by default.

ip redirects

interface

ip redirects

no ip redirects

Configures

ICMP redirects for interfaces

Default

Enabled

Description

An ICMP redirect packet is generated by a router to inform a host of a better route to some specific destination. The recipient of an ICMP redirect overrides its route table with the information given in the redirect packet. This command configures the sending of ICMP redirects for an interface. The router never processes received ICMP redirects while IP routing is enabled.

Redirects are enabled by default on all interfaces unless Hot Standby Routing Procotol (HSRP) is configured.

Example

To avoid sending ICMP redirect packets out the ethernet0 interface:

interface ethernet 0
  no ip redirects

ip rip authentication

interface

ip rip authentication key-chain name
no ip rip authentication key-chain name

ip rip authentication mode md5 | text}
no ip rip authentication mode {md5 | text}

Configures

RIP route authentication

Default

Default mode is clear-text

Description

This command specifies a key chain to be used for authentication of RIP routing updates. name is the name of the key chain to be used. Once the key chain is applied, the interface expects to authenticate any incoming RIPv2 routes. The key chain must be defined separately with the key command.

The mode version of this command specifies the authentication mode for an interface: either text (clear-text) or md5.

Example

The following commands specify that RIP routes should be authenticated using MD5 encryption with the key chain defined in group1:

interface ethernet 1
  ip rip authentication key-chain group1
  ip rip authentication mode md5
!
key chain group1
   key 1
   key-string authme1
   key 2
   key-string authme2

ip rip receive version

interface

ip rip receive version 1| 2 | 1 2

no ip rip receive version

Configures

Version of RIP to receive on an interface

Default

The version in the router configuration

Description

This command tells an interface which RIP version to listen for. This version can be 1, 2, or both (1 2). By default, the router listens for the version specified by the version command in the router configuration.

Example

This configuration accepts only Version 2 packets on ethernet 0:

interface ethernet 0
 ip rip receive version 2

ip rip send version

interface

ip rip send version 1| 2 | 1 2

no ip rip send version

Configures

The version of RIP to send

Default

The version in the router configuration, or 1if no version is specified

Description

This command tells an interface which RIP version to use when sending RIP packets. This version can be 1, 2, or both (1 2). By default, the router uses the version specified by the version command in the router configuration.

Example

This configuration sends only Version 2 packets on ethernet 0:

interface ethernet 0
  ip rip send version 2

ip route

global

ip route network mask next-hop-address [distance]

no ip route network mask next-hop-address [distance]

Configures

A static route for a network

Default

None

Description

This command defines a static route to the destination network specified by its network address and mask. next-hop-address is the IP address of the router to which traffic for this destination network should be sent. distance is an optional administrative distance that allows you change the way the static route behaves. If the distance is high enough, it can be overwritten by dynamic protocols. See Chapter 8 for more information about administrative distances.

Example

The following commands create two static routes. The first route sends traffic for the 192.168.1.0/24 network to 10.1.1.1; the second route sends traffic for the 192.168.2.0/24 network to 10.2.2.2.

ip route 192.168.1.0 255.255.255.0 10.1.1.1
ip route 192.168.2.0 255.255.255.0 10.2.2.2

ip route-cache

interface

ip route-cache [cbus] [flow] [same-interface] [cef] [distributed]

no ip route-cache

Configures

The route cache for an interface

Default

Enabled for most interfaces

Description

A route cache stores a route in a temporary table for the duration of a network session. When the session is completed or the session times out, the routing entry is removed from the route cache. The no form of this command disables the route cache, which causes the router to look up the route for each packet of the network session. In some applications, this can be the desired behavior; see .

cbus
Optional. Enables fast switching and autonomous switching.

flow
Optional. Enables the RSP to perform flow switching.

same-interface
Optional. Enables fast switching packets back out the interface on which they arrived.

cef
Optional. Enables Cisco Express Forwarding on an interface after it has been disabled globally.

distributed
Optional. Enables VIP distributed switching.

Example

The route cache can be disabled with the no form of this command.

interface serial 0
  no ip route-cache

ip router isis

interface

ip router isis [tag]

no ip router isis [tag]

Configures

An interface for IS-IS routing

Default

Disabled

Description

This command identifies an interface to be used for IS-IS routing. The optional tag allows you to identify the IS-IS routing process if the process has a tag.

Example

interface ethernet 0
ip router isis

ip routing

global

ip routing

no ip routing

Configures

IP routing

Default

Enabled

Description

This command enables or disables routing.

ip source-route

global

ip source-route

no ip source-route

Configures

Routing of source-routed packets

Default

Enabled

Description

This command allows the router to route packets that contain source-routing options. (Source routing is an IP option that allows the packet to specify the route it should take to its destination.) Source routing is a potential security problem, so it is best to disable this feature unless required.

Example

To disable IP source routing:

no ip source-route

ip split-horizon

interface

ip split-horizon

no ip split-horizon

Configures

Split horizon for the interface

Default

Varies with the interface type; usually enabled

Description

When split horizon is enabled, any route learned from an interface is not advertised back out the same interface. This rule is intended to stop routing loops with distance-vector protocols. With most interfaces, split horizon is enabled. However, with multipoint interfaces--such as a multipoint Frame Relay interface--split horizon is disabled. See Chapter 8 for more information on split horizon.

ip subnet-zero

global

ip subnet-zero

no ip subnet-zero

Configures

The zero subnet

Default

Enabled in recent versions of IOS (12.X)

Description

When subnetting a network, the 0 subnet (the subnet whose subnet bits are all 0) is normally not allowed because of potential confusion between the subnet address and the network address. In practice, this confusion is rarely an issue. This command allows the router to use the all-zeros subnet.

Example

The following command enables the zero subnet:

ip subnet-zero

ip summary-address eigrp

interface

ip summary-address eigrp as-number address mask

no ip summary-address eigrp as-number address mask

Configures

A summary aggregate for a specific interface

Default

None

Description

This command lets you specify a summary address for routes advertised through a specific interface by EIGRP. This command must be applied only to interfaces. It is beneficial if auto-summary has been disabled for EIGRP, as this allows you to define a specific summary address. This address receives an administrative distance of 5, which is more preferred than regular EIGRP routes.

as-number
The number of the EIGRP routing process.

address
The IP address for the summarized route.

mask
The net mask for the summarized route.

ip tcp chunk-size

global

ip tcp chunk-size size

no ip tcp chunk-size

Configures

The number of bytes that a telnet or rlogin session can read at once

Default

0 (the largest size possible)

Description

This command sets the maximum number of bytes (size) that a telnet or rlogin session can read at the same time. A value of 0 means the largest size possible for that connection.

ip tcp compression-connections

interface

ip tcp compression-connections number

no ip tcp compress-connections number

Configures

The maximum number of TCP connections that can use header compression

Default

16

Description

This command sets the number of connections through an interface that can use TCP header compression. The number of connections can be from 3 to 256. A buffer is allocated for each connection that can be compressed. Both sides of a serial link must have the same number of buffers defined.

ip tcp header-compression

interface

ip tcp header-compression [passive]

no ip tcp header-compression [passive]

Configures

TCP header compression for an interface

Default

Disabled

Description

This command enables TCP header compression on the interface. The passive keyword tells the interface to compress headers only when the incoming packets are compressed.

Example

interface serial 0
  ip tcp header-compression passive

ip tcp mtu-path-discovery

interface

ip tcp mtu-path-discovery [age-timer minutes] [infinite]

no ip tcp mtu-path discovery

Configures

Path MTU discovery

Default

Disabled for most interfaces; special interfaces use 10 minutes

Description

This command enables or disables path MTU discovery on new TCP connections.

age-timer minutes
Optional. minutes specifies the interval after which the router recalculates the MTU; its value must be between 1 and 30.

infinite
Disables the age-timer.

ip tcp queuemax

global

ip tcp queuemax packets

no ip tcp queuemax packets

Configures

The queue for outgoing TCP packets

Default

5 for TTY (async and console) interfaces; 20 for others

Description

This command sets the size of the outgoing TCP queue to packets. The queue is maintained per-connection; i.e., every connection has its own queue.

Example

interface serial 0
  ip tcp queuemax 15

ip tcp synwait-time

global

ip tcp synwait-time seconds

no ip tcp synwait-time seconds

Configures

The time the router waits for a TCP connection to open

Default

30 seconds

Description

This command sets the number of seconds that the router waits for a TCP connection to open, before it times out. The value must be between 3 to 300. A longer synwait-time can be useful for dial-on-demand connections where you have to wait for the line to be dialed before a connection can open. This setting applies only to traffic originating within the router, not traffic coming through the router.

Example

If you are telnetting from the router to a remote site through a DDR connection, you might want to increase the synwait-time to more reasonable level so that telnet does not time out:

ip tcp synwait-time 100

ip tcp window-size

global

ip tcp window-size bytes

no ip tcp window-size bytes

Configures

The window size of a TCP connection

Default

2144 bytes

Description

This command sets the size of the TCP window to bytes. Changing the size of the TCP window modifies the size and number of packets that can fit within that window. With the default window of 2144 bytes, you could buffer two 1000-byte packets, or 21 100-byte packets. Regardless of the window's size, the number of packets within the window is restricted to the values set by the ip tcp queuemax command; they default to 5 for TTY interfaces (async and console interfaces) and 20 for other interfaces. The maximum size of the window is 65536 bytes.

Example

ip tcp window-size 4000

ip telnet source-interface

global

ip telnet source-interface interface

no ip telnet source-interface

Configures

The source address for telnet connections

Default

None

Description

This command sets the address used as the source address for outgoing telnet connections to the address of the given interface.

ip tftp source-interface

global

ip tftp source-interface interface

no ip tftp source-interface

Configures

The source IP address for TFTP traffic

Default

The IP address of the interface closest to the destination

Description

This command sets the interface from which the router takes the source IP address for all TFTP traffic.

ip unnumbered

interface

ip unnumbered interface

no ip unnumbered interface

Configures

Interface IP address

Default

None

Description

Normally, creating point-to-point links requires dedicating a subnet specifically for the link. This works well if all your equipment supports variable-length subnet masks (VLSM), but can be very wasteful if your equipment doesn't support VLSM. This forces you to assign relatively large subnets to your point-to-point links.

The ip unnumbered command tells the router to use the IP address of the selected interface as the address for this link. In other words, the router "borrows" the IP address of the named interface and uses that as the link's address.

Example

Assume that older equipment in our network forces us to use a subnet mask of 255.255.255.0. This means that assigning a subnet to a point-to-point link would use 254 addresses, of which only two are actually doing something. Instead of wasting 252 addresses, we can use the ip unnumbered command to borrow the address of another interface for use on the serial link:

interface serial0
 ip unnumbered ethernet0
 encapsulation ppp
 clockrate 1300000

Borrowing the address of the loopback interface for an unnumbered interface is often a good idea because the loopback interface is always up. The following configuration uses the loopback interface to provide the IP address for interface async 2:

interface loopback 0
    ip address 10.10.1.4 255.255.255.0
interface async 2
   ip unnumbered loopback0

ip unreachables

interface

ip unreachables

no ip unreachables

Configures

Sending of ICMP unreachable messages for an interface

Default

Enabled

Description

ICMP unreachable messages are generated when something about an incoming packet is unknown to the router. For example, an "ICMP host unreachable" message is generated if the router cannot deliver a package to its final destination. There are many different types of ICMP unreachable messages, and they all mean that the packet can't be delivered for some reason. Disabling these messages can improve security because the messages can be used to discover information about your network.

Example

The following commands prevent the router from sending IP unreachable messages through the serial 0 interface:

interface serial 0
  no ip unreachables

isdn answer1, isdn answer2

interface

isdn answer1 [called-party-number][:sub-address]
no isdn answer1 [called-party-number][:sub-address]

isdn answer2 [called-party-number][:sub-address]
no isdn answer2 [called-party-number][:sub-address]

Configures

Verification of the called party

Default

None

Description

This command configures the interface to verify that the telephone number being called (which is reported by the ISDN switch as part of call setup) matches the telephone number of the router. By default, calls are processed without verification. If this command is configured, the router verifies the incoming called-party-number before allowing the connection. Using this command can reduce the potential for confusion when several ISDN devices share the same ISDN local loop. Use isdn answer2 to verify a second called-party number.

To list a called-party-number or a sub-address, use any number of digits up to 50; an x specifies a wildcard. You must specify either the called-party-number or the sub-address, but you are not required to specify both. If you specify only one, the other is taken as a wildcard.

isdn autodetect

interface

isdn autodetect

no isdn autodetect

Configures

Automatic detection of ISDN SPIDs and switch types

Default

Disabled

Description

This command enables the automatic detection of ISDN SPIDs and switch types on an interface. It works in North America only.

isdn bchan-number-order

interface

isdn bchan-number-order {ascending | descending}

no isdn bchan-number-order

Configures

ISDN PRI

Default

descending

Description

This command sets the order (ascending or descending) of outgoing B channels. It is for PRI configurations only.

isdn busy

interface

isdn busy dsl number b_channel number

no isdn busy dsl number b_channel number

Configures

A false busy signal on an ISDN B channel

Default

Disabled

Description

This command sets a false busy signal on an ISDN B channel; that is, the ISDN interface reports to the switch that the channel is busy even if it isn't.

dsl number
The digital subscriber loop (DSL) number.

b_channel number
The range of B channels to be set to a busy signal. number can range from 0 to 24 on a PRI interface (it isn't clear whether this command applies to BRI interfaces); 0 indicates the entire interface.

isdn caller

interface

isdn caller phone-number [callback]

no isdn caller phone-number [callback]

Configures

ISDN caller ID screening

Default

Disabled

Description

If your ISDN switch supports caller ID, this command lets you specify a phone-number from which incoming connections are allowed. If the inbound call does not originate from this number, it will be rejected. You may use the letter x in the phone number as a wildcard character; for example, 458-xxxx means "any number in the 458 exchange." The callback keyword causes the router to reject the call and initiate a callback to the caller's number; this feature may help you manage phone costs.

isdn call interface

command

isdn call interface interface telephone-number [speed {56 | 64}]

the "configures" and "default" lines for this command and for "isdn disconnect interface" were originally N/A... should they be deleted?

Configures

Initiates an ISDN call

Default

Line speed: 64

Description

This command initiates an ISDN call from the IOS command line in privileged EXEC mode. To make the call, supply the interface to use, the telephone-number to call, and optionally the line speed (56 or 64 kbps). The line speed defaults to 64 kbps.

Example

Router# isdn call interface bri0 4105551212

isdn calling-number

interface

isdn calling-number phone-number

no isdn calling-number phone-number

Configures

The phone number of the device making the outgoing call

Default

None

Description

This command sets the phone-number of the ISDN device making an outgoing call. The router presents this number to the switch when placing a call.

isdn conference-code

interface

isdn conference-code code

no isdn conference-code

Configures

Three-way calling

Default

60

Description

This command configures a conference code. Conference codes can be used if you have ordered three-way calling as part of your service.

isdn disconnect interface

command

isdn disconnect interface interface channel

Configures

Disconnects an ISDN call

Default

None

Description

This command disconnects an ISDN call on the given interface without bringing down the interface. The channel may be b1 for the first B channel, b2 for the second, or all for both B channels.

isdn fast-rollover-delay

interface

isdn fast-rollover-delay seconds

no isdn fast-rollover-delay seconds

Configures

Time delay between consecutive dial attempts

Default

Disabled (0 seconds)

Description

If more than one dialer map is provided for an ISDN interface, this command provides the time to wait (in seconds) after the first map fails before placing a call using the second map.

isdn incoming-voice

interface

isdn incoming-voice {56 | 64}

no isdn incoming-voice {56 | 64}

Configures

Accepts calls on the voice lines

Default

Disabled

Description

By default, incoming voice calls on data lines are not answered. This command allows you to use voice lines to transfer data by configuring the router to answer voice calls, which can result in significant savings in some areas. The call speed can be either 56 or 64; if no speed is specified, the speed is set to the incoming call's speed.

isdn leased-line bri 128

global

isdn leased-line bri number 128

no isdn leased-line bri number 128

Configures

ISDN interface for leased-line service at 128 kbps

Default

Disabled

Description

This command configures ISDN access over a leased line. There are no phone numbers; both of the line's B channels are combined to provide a single line with a capacity of 128 kbps. number is the number of the BRI interface.

isdn not-end-to-end

interface

isdn not-end-to-end {56 | 64}

no isdn not-end-to-end {56 | 64}

Configures

Overrides the speed the network reported it will use

Default

64 kbps

Description

This command forces the speed of an incoming connection. Sometimes, when ISDN ports don't belong to the same network, incorrect speed selection by the router causes the ISDN connection to fail. This command lets you set the speed manually for incoming connections. Valid speeds are 56 and 64 kbps.

isdn nsf-service

interface

isdn nsf-service {megacom | sdn}

no isdn nsf-service

Configures

Network-specific facilities (NSF)

Default

Disabled

Description

This command enables NSF on an ISDN PRI for outgoing voice calls. megacom is for AT&T Megacom NSF, and sdn is for AT&T SDN NSF.

isdn outgoing-voice

interface

isdn outgoing-voice {info-transfer-capability {3.1kHz-audio | speech}}

no isdn outgoing-voice

Configures

Information transfer capability set for outgoing voice calls

Default

None

Description

This command sets the information transfer capability for outgoing voice calls through an interface. It isn't clear what the optional keywords mean; presumably they request different kinds of signal processing adapted for general audio or speech.

isdn overlap-receiving

interface

isdn overlap-receiving

no isdn overlap-receiving

Configures

ISDN overlap receiving

Default

Disabled

Description

This command enables ISDN overlap receiving for an interface. In this mode, the interface waits for additional information from the switch before establishing the call. This command can be useful when carrying voice traffic through the router.

isdn send-alerting

interface

isdn send-alerting

no isdn send-alerting

Configures

Sending an Alerting message

Default

Disabled

Description

This command enables the sending of an Alerting message before a Connect message when making ISDN calls. Some types of switches want to receive an Alerting message before a Connect message.

isdn sending-complete

interface

isdn sending-complete

no isdn sending-complete

Configures

The sending of a Sending Complete element in the Setup mesage

Default

Disabled

Description

This command configures the router to include the Sending Complete element in the Setup message. Some switches require this message, which tells the switch that it has all the information for the call in the Setup message.

isdn service

interface

isdn service dsl number b_channel number state value

no isdn service dsl number b_channel number state value

Configures

A B channel range to a specified state

Default

Disabled

Description

This command sets a range of B channels or an entire PRI interface to "in service," "maintenance," or "out of service."

dsl number
The digital subscriber loop number.

b_channel number
The B channel or range of B channels to which the command applies. number can range from 0 to 24, where 0 means the entire PRI interface. A range of consecutive channels is indicated by n-m, where n and m are in the range 1 to 24.

state value
The state to which you wish to set the channels. The state is indicated by a number between 0 and 2; 0 is for "in service," 1 is for "maintenance," and 2 is for "out of service."

isdn spid1 (spid2)

interface

isdn {spid1 | spid2} spid [local-directory-number]

no isdn {spid1 | spid2} spid [local-directory-number]

Configures

ISDN service profile identifiers (SPIDs)

Default

None

Description

This command provides the SPID for the B1 channel (spid1) or the B2 channel (spid2). You can also use this command to specify the local-directory-number (optional). Your ISDN carrier (i.e., your phone company) provides the SPIDs and the local directory number. Some carriers and switch types do not require SPIDs (for example, if they are not used in Europe).

isdn switch-type

global

isdn switch-type type

no isdn switch-type type

Configures

ISDN switch type

Default

None

Description

There are many different types of ISDN switches in use. The router must be configured with the appropriate switch type in order to interact with the telephone network. While there are exceptions, your geographic location is the best clue to the type of switch in use. Table I-4 lists common switch types.

Table I-4: Common ISDN Switch Types

IOS type

Switch

basic-5ess

AT&T switches (North America)

basic-dms100

Northern Telecom (North America)

basic-ni1

National ISDN-1 (North America)

basic-ts013

Australian

basic-ltr6

German

basic-nwnet3

Net3 switches (Norway)

basic-net3

Net3 switches (Europe/Taiwan)

basic-nznet3

Net3 switches (New Zealand)

vn2

VN2 (French)

vn3

VN3 (French)

ntt

NTT (Japan)

isdn tei

global

isdn tei [first-call | powerup]

no isdn tei

Configures

ISDN endpoint negotiation

Default

powerup

Description

TEI stands for Terminal Endpoint Identifier. This command enables TEI negotiation on the ISDN interface. TEI negotiation occurs at powerup or when it places its first call (first-call).

isdn tei-negotiation

global, interface

isdn tei-negotiation {first-call | powerup}

no isdn tei-negotiation

Configures

When TEI negotiation occurs

Default

powerup

Description

This command sets when TEI negotiation occurs. By default, negotiation takes place when the router is first turned on (powerup). The first-call option states that negotiation should occur when the first ISDN call is placed or received.

isdn transfer-code

interface

isdn transfer-code code

no isdn transfer-code

Configures

Call transferring

Default

61

Description

This command enables call transferring. This feature is available only if your service provider supports it. code is supplied by your service provider.

isdn twait-disable

interface

isdn twait-disable

no isdn twait-disable

Configures

Time to wait on startup

Default

Enabled

Description

After a power failure, ISDN interfaces wait a random period of time (1 to 300 seconds) before starting up. This command prevents the interfaces from coming back online at the same time when power is restored and the ISDN devices are restarting. This feature can be disabled with the no form of this command.

isdn voice-priority

interface

isdn voice-priority ISDN-directory-number {in | out} {always | conditional | off}

no isdn voice-priority ISDN-directory-number

Configures

The priority of data and voice calls

Default

A data call is never bumped

Description

This command allows you to set the priority of a data call relative to a voice call. ISDN-directory-number is the directory number assigned by your telephone company. in and out specify whether the command applies to incoming or outgoing voice calls. always means always bump a data call for a voice call. conditional means bump a data call if there is more than one call to the same destination. off means never bump a data call for a voice call.

isis circuit-type

interface

isis circuit-type {level-1 | level-1-2 | level-2-only}

no isis circuit-type

Configures

Type of IS-IS routing on an interface

Default

level-1-2

Description

This command sets the type of IS-IS routing used on an interface. It is rarely used except for border routers (routers that lie between areas).

isis csnp-interval

interface

isis csnp-interval seconds [{level-1 | level-2}]

no isis csnp-interval

Configures

CSNP interval

Default

10 seconds

Description

This command sets the interval (in seconds) for CSNP packets on border routers. CSNP packets are broadcast at the specified interval to make sure that the routing database is synchronized. This command can be used only in multiaccess interfaces. The level-1 and level-2 keywords are optional; they specify that the interval applies only to the given level.

isis hello-interval

interface

isis hello-interval seconds [{level-1 | level-2}]

no isis hello-interval

Configures

IS-IS hello interval for an interface

Default

10 seconds

Description

This command sets the hello interval for IS-IS routing to seconds. By default, the hello interval is the advertised holdtime multiplied by the hello multiplier, which has a default of 3. The optional level-1 and level-2 keywords allow you to apply this command to an individual level; otherwise the interval is applied to both levels.

isis hello-multiplier

interface

isis hello-multiplier value [{level-1 | level-2}]

no isis hello-multiplier

Configures

The holdtime value multiplier

Default

3

Description

For IS-IS, the holdtime is calculated by taking the hello interval and multiplying it by the hello multiplier. This command sets the hello multiplier to value. By changing the hello multiplier, you effectively change the holdtime. The optional level-1 and level-2 keywords allow you to apply this command to an individual level; otherwise the interval is applied to both levels.

Example

The following commands configure IS-IS routing for the interface ethernet 1. The hello interval is set to 5 seconds (for level 1) and the multiplier is set to 5, yielding a holdtime of 25 seconds.

interface ethernet 1
  ip router isis
  isis hello-interval 5 level-1
  isis hello-multiplier 5 level-1

isis lsp-interval

interface

isis lsp-interval milliseconds

no isis lsp-interval

Configures

Time delay between LSPs for IS-IS routing

Default

33 milliseconds

Description

This command sets the number of milliseconds between IS-IS link state packets (LSPs). If a router has many IS-IS interfaces, it might have trouble sending all the LSPs. This command lets you increase the time between the packets, which should reduce the load on the router's CPU.

isis metric

interface

isis metric value [{level-1 | level-2}]

no isis metric

Configures

The default IS-IS metric for the interface

Default

10

Description

This command sets the default metric for the interface to value. By using the keywords level-1 or level-2, you can specify a metric for a specific routing level. If no level is specified, level-1 is used.

isis password

interface

isis password password [{level-1 | level-2}]

no isis password

Configures

The authentication password for IS-IS routing

Default

None

Description

This command sets the authentication password for IS-IS routing for the interface. All IS-IS communication to other routers through this interface must be authenticated with this password. However, like other password settings for IS-IS, this password is sent out in clear-text, providing little security. The level-1 and level-2 keywords are optional; they allow separate passwords to be applied to each level. If no level is specified, level-1 is used.

isis priority

interface

isis priority priority [{level-1 | level-2}]

no isis priority

Configures

A priority value for the interface for IS-IS routing

Default

64

Description

This command allows you to set the router's priority in an IS-IS network. The priority is used to determine which routers become the designated router (DR) and the backup designated router (BDR). The priority can range from 0 to 127; 127 is the highest. The optional keywords level-1 and level-2 allow you to set a different priority for each level; otherwise the priority value applies to both levels.

isis retransmit-interval

interface

isis retransmit-interval seconds

no isis retransmit-interval

Configures

The time between link state packet (LSP) retransmissions

Default

5 seconds

Description

This command sets the time (in seconds) between LSP retransmisions. It should be used only on point-to-point links.

isis retransmit-throttle-interval

interface

isis retransmit-throttle-interval milliseconds

no isis retransmit-throttle-interval

Configures

Time between retransmissions of LSPs

Default

Calculated from the isis lsp-interval command

Description

This command sets the interval in milliseconds between retransmissions of IS-IS LSPs.

is-type

router

is-type {level-1 | level-1-2 | level-2-only}

no is-type level-1 | level-1-2 | level-2-only}

Configures

The level at which the IS-IS routing protocol will operate

Default

level-1-2

Description

This command sets the level at which the IS-IS routing protocol operates, which also defines the type of IS-IS router it is (station or area). By default, the router operates at both levels, which means it is both a station router and an area router.

level-1
The router performs only as a station router.

level-1-2
The router performs as both a station and an area router.

level-2-only
The router performs only as an area router.

Example

router isis
  is-type level-2-only

Back to: Cisco IOS in a Nutshell


oreilly.com Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies | Privacy Policy

© 2001, O'Reilly & Associates, Inc.
webmaster@oreilly.com