-
Cisco IOS XR IP Addresses and Services Command Reference, Release 3.6
-
Preface
-
Access List Commands on Cisco IOS XR Software
-
ARP Commands on Cisco IOS XR Software
-
Cisco Express Forwarding Commands on Cisco IOS XR Software
-
DHCP Commands on Cisco IOS XR Software
-
Host Services and Applications Commands on Cisco IOS XR Software
-
HSRP Commands on Cisco IOS XR Software
-
LPTS Commands on Cisco IOS XR Software
-
Network Stack IPv4 and IPv6 Commands on Cisco IOS XR Software
-
Prefix List Commands on Cisco IOS XR Software
-
Transport Stack Commands on Cisco IOS XR Software
-
VRRP Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
Host Services and Applications Commands on Cisco IOS XR Software
telnet client source-interface
Host Services and Applications Commands on Cisco IOS XR Software
This chapter describes the commands used to configure and monitor host services and applications, such as Domain Name System (DNS), Telnet, File Transfer Protocol (FTP), Trivial File Transfer Protocol (TFTP), and rcp on Cisco IOS XR software.
For detailed information about host services and applications concepts, configuration tasks, and examples, see Cisco IOS XR IP Addresses and Services Configuration Guide.
cinetd rate-limit
To configure the rate limit at which service requests are accepted by Cisco inetd (Cinetd), use the cinetd rate-limit command in global configuration mode. To restore the default, use the no form of this command.
cinetd rate-limit value
no cinetd rate-limit value
Syntax Description
Defaults
One service request per second is accepted.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Any service request that exceeds the rate limit is rejected. The rate limit is applied to individual applications.
Task ID
Examples
The following example shows the cinetd rate-limit being set to 10:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# cinetd rate-limit 10clear host
To delete temporary entries from the hostname-to-address cache, use the clear host command in EXEC mode.
clear host {host-name | *}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The dynamic host entries in the cache are cleared.
The temporary entries in the cache are cleared; the permanent entries that were entered with the domain ipv4 host or the domain ipv6 host command are not cleared.
By default, no static mapping is configured.
Task ID
Examples
The following example shows how to clear all temporary entries from the hostname-and-address cache:
RP/0/RP0/CPU0:router# clear host *Related Commands
domain ipv4 host
To define a static hostname-to-address mapping in the host cache using IPv4, use the domain ipv4 host command in global configuration mode. To remove the domain ipv4 host command from the configuration file and restore the system to its default condition, use the no form of this command.
domain ipv4 host host-name v4address1 [v4address2...v4address8]
no domain ipv4 host host-name v4address1
Syntax Description
Defaults
No static mapping is configured.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The first character can be either a letter or a number. If you use a number, the operations you can perform (such as ping) are limited.
Task ID
Examples
The following example shows how to define two IPv4 static mappings:
RP/0/RP0/CPU0:router(config)# domain ipv4 host host1 192.168.7.18RP/0/RP0/CPU0:router(config)# domain ipv4 host bost2 10.2.0.2 192.168.7.33domain ipv6 host
To define a static hostname-to-address mapping in the host cache using IPv6, use the domain ipv6 host command in global configuration mode. To remove the domain ipv6 host command from the configuration file and restore the system to its default condition, use the no form of this command.
domain ipv6 host host-name v6address1 [v6address2...v6address4]
no domain ipv6 host host-name v6address1
Syntax Description
Defaults
No static mapping is configured. IPv6 address prefixes are not enabled.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The first character can be either a letter or a number. If you use a number, the operations you can perform (such as ping) are limited.
Task ID
Examples
The following example shows how to define two IPv6 static mappings:
RP/0/RP0/CPU0:router(config)# domain ipv6 host host1 ff02::2RP/0/RP0/CPU0:router(config)# domain ipv6 host host2 ff02::1domain list
To define a list of default domain names to complete unqualified hostnames, use the domain list command in global configuration mode. To delete a name from a list, use the no form of this command.
domain list domain-name
no domain list domain-name
Syntax Description
domain-name
Domain name. Do not include the initial period that separates an unqualified name from the domain name.
Defaults
No domain names are defined.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
If there is no domain list, the domain name that you specified with the domain name (global) command is used to complete unqualified hostnames. If there is a domain list, the default domain name is not used. The domain list command is similar to the domain name (global) command, except that you can use the domain list command to define a list of domains, each to be tried in turn.
Task ID
Examples
The following example shows how to add several domain names to a list:
RP/0/RP0/CPU0:router(config)# domain list domain1.comRP/0/RP0/CPU0:router(config)# domain list domain2.eduThe following example shows how to add a name to and then delete a name from the list:
RP/0/RP0/CPU0:router(config)# domain list domain3.eduRP/0/RP0/CPU0:router(config)# no domain list domain2.eduRelated Commands
domain lookup disable
To disable the IP Domain Name System (DNS)-based hostname-to-address translation, use the domain lookup disable command in global configuration mode. To remove the specified command from the configuration file and restore the system to its default condition, use the no form of this command.
domain lookup disable
no domain lookup disable
Syntax Description
This command has no arguments or keywords.
Defaults
The IP DNS-based host-to-address translation is enabled.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Using the no command removes the specified command from the configuration file and restores the system to its default condition. The no form of this command is not stored in the configuration file.
Task ID
Examples
The following example shows how to enable the IP DNS-based hostname-to-address translation:
RP/0/RP0/CPU0:router(config)# domain lookup disableRelated Commands
domain name (global)
To define a default domain name that the software uses to complete unqualified hostnames, use the domain name command in global configuration mode. To remove the name, use the no form of this command.
domain name domain-name
no domain name domain-name
Syntax Description
domain-name
Default domain name used to complete unqualified hostnames. Do not include the initial period that separates an unqualified name from the domain name.
Defaults
There is no default domain name.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
If a hostname does not contain a domain name, then a dot and the domain name configured by the domain name command are appended to the hostname before it is added to the host table.
If no domain name is configured by the domain name command and the user provides only the hostname, then the request is not looked up.
Task ID
Examples
The following example shows how to define cisco.com as the default domain name:
RP/0/RP0/CPU0:router(config)# domain name cisco.comRelated Commands
domain name-server
To specify the address of one or more name servers to use for name and address resolution, use the domain name-server command in global configuration mode. To remove the address specified, use the no form of this command.
domain name-server server-address
no domain name-server server-address
Syntax Description
Defaults
If no name server address is specified, the default name server is 255.255.255.255. IPv4 and IPv6 address prefixes are not enabled.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
You can enter up to six addresses, but only one for each command.
If no name server address is specified, the default name server is 255.255.255.255 so that the DNS lookup can be broadcast to the local network segment. If a DNS server is in the local network, it replies. If not, there might be a server that knows how to forward the DNS request to the correct DNS server.
Task ID
Examples
The following example shows how to specify host 192.168.1.111 as the primary name server and host 192.168.1.2 as the secondary server:
RP/0/RP0/CPU0:router(config)# domain name-server 192.168.1.111RP/0/RP0/CPU0:router(config)# domain name-server 192.168.1.2Related Commands
Disables the domain lookup.
Defines a default domain name to complete unqualified hostnames (names without a dotted-decimal domain name).
ftp client anonymous-password
To assign a password for anonymous users, use the ftp client anonymous-password command in global configuration mode. To remove the ftp client anonymous-password command from the configuration file and restore the system to its default condition, use the no form of this command.
ftp client anonymous-password password
no ftp client anonymous-password
Syntax Description
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The ftp client anonymous-password command is File Transfer Protocol (FTP) server dependent.
Task ID
Examples
The following example shows how to set the anonymous password to xxxx:
RP/0/RP0/CPU0:router(config)# ftp client anonymous-password xxxxRelated Commands
ftp client passive
To configure the software to use only passive File Transfer Protocol (FTP) connections, use the ftp client passive command in global configuration mode. To remove the ftp client passive command from the configuration file and restore the system to its default condition, use the no form of this command.
ftp client passive
no ftp client passive
Syntax Description
This command has no arguments or keywords.
Defaults
FTP data connections are active.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Using the ftp client passive command allows you to make only passive-mode FTP connections. To specify the source IP address for FTP connections, use the ftp client source-interface command.
Task ID
Examples
The following example shows how to configure the networking device to use only passive FTP connections:
RP/0/RP0/CPU0:router(config)# ftp client passive1d:3h:54:47: ftp_fs[16437]: FTP: verifying tuple passive (SET).1d:3h:54:47: ftp_fs[16437]: FTP: applying tuple passive (SET).1d:3h:54:47: ftp_fs[16437]: FTP: passive mode has been enabled.Related Commands
ftp client password
To specify the password for the File Transfer Protocol (FTP) connections, use the ftp client password command in global configuration mode. To disable this feature, use the no form of this command.
ftp client password {clear-text-password | clear clear-text password | encrypted encrypted-text password}
no ftp client password {clear-text-password | clear clear-text password | encrypted encrypted-text password}
Syntax Description
Command Modes
Global configuration
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to specify the password for the File Transfer Protocol (FTP) connections:
RP/0/RP0/CPU0:router(config)# ftp client password labRelated Commands
ftp client source-interface
To specify the source IP address for File Transfer Protocol (FTP) connections, use the ftp client source-interface command in global configuration mode. To remove the ftp client source-interface command from the configuration file and restore the system to its default condition, use the no form of this command.
ftp client source-interface type instance
no ftp client source-interface type instance
Syntax Description
Defaults
The FTP source address is the IP address of the interface used by the FTP packets to leave the networking device.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use this command to set the same source address for all FTP connections. To configure the software to use only passive FTP connections, use the ftp client passive command.
Task ID
Examples
The following example shows how to configure the IP address associated with Packet-over-SONET (POS) interface 0/1/2/1 as the source address on all FTP packets, regardless of which interface is actually used to send the packet:
RP/0/RP0/CPU0:router(config)# ftp client source-interface POS 0/1/2/1Related Commands
ftp client username
To specify the username for File Transfer Protocol (FTP) connections, use the ftp client username command in global configuration mode. To disable this feature, use the no form of this command.
ftp client username username
no ftp client username username
Syntax Description
Command Modes
Global configuration
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to specify the username for FTP connections:
RP/0/RP0/CPU0:router(config)# ftp client username brownfoxRelated Commands
ping (network)
To check host reachability and network connectivity on IP networks, use the ping command in EXEC mode.
ping [ipv4 | ipv6 | vrf vrf-name] [host-name | ip-address] [count number] [size number] [source {ip-address | type number}] [timeout seconds] [pattern number] [type number] [priority number] [verbose] [donnotfrag] [validate] [sweep]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The default value for the ping command refers only to the target IP address. No default value is available for the target IP address.
The ping program sends an echo request packet to an address and then waits for a reply. Ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
Note
The ping (EXEC) command is supported only on IP networks.
If you enter the command without specifying either a hostname or an IP address, the system prompts you to specify the target IP address and several other command parameters. After specifying the target IP address, you can specify alternate values for the remaining parameters or accept the displayed default for each parameter.
If the system cannot map an address for a hostname, it returns an "%Unrecognized host or address, or protocol not running" error message.
To abnormally terminate a ping session, enter the escape sequence, which is, by default, Ctrl-C. Simultaneously press and release the Ctrl and C keys.
Table 35 describes the test characters sent by the ping facility.
Task ID
Examples
Although the precise dialog varies somewhat between IPv4 and IPv6, all are similar to the ping session, using default values shown in the following output:
RP/0/RP0/CPU0:router# pingProtocol [ipv4]:Target IP address: 10.0.0.1Repeat count [5]:Datagram size [100]:Timeout in seconds [2]:Extended commands? [no]: yesSource address or interface: 10.0.0.2Type of service [0]:Set DF bit in IP header? [no]:Validate reply data? [no]: yesData pattern [0xABCD]:Loose, Strict, Record, Timestamp, Verbose[none]:Sweep range of sizes? [no]:Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 10.25.58.21, timeout is 2 seconds:!!!!!Success rate is 100 percent (5/5), round-trip min/avg/max = 2/11/49 msIf you enter a hostname or an address on the same line as the ping command, the command performs the default actions appropriate for the protocol type of that hostname or address, as shown in the following output:
RP/0/RP0/CPU0:router# ping server01Type&#
