Additional File Transfer Function Commands

This chapter explains the function and syntax of the additional file transfer function commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Configuration Fundamentals Command Reference, Release 12.1.

Note Commands in this chapter that have been replaced by new commands continue to perform their normal functions in the current release, but are no longer documented. Support for these commands will cease in a future release. Table 11 maps the old command to its replacement.

Table 11: Mapping Old Commands to New Commands

Old Command New Command

tftp-server system

tftp-server

Old Command	New Command
tftp-server system	tftp-server

For configuration information and examples, refer to the chapter "Configuring Additional File Transfer Functions" in the Cisco IOS Configuration Fundamentals Configuration Guide.

async-bootp

To configure extended BOOTP requests for asynchronous interfaces as defined in RFC 1084, use the async-bootp global configuration command. Use the no form of this command to restore the default.

async-bootp tag [:hostname] data

no async-bootp

Syntax Description

tag

Item being requested; expressed as filename, integer, or IP dotted-decimal address. See Table 12 for possible keywords.

:hostname

(Optional) This entry applies only to the host specified. The argument :hostname accepts both an IP address and a logical host name.

data

List of IP addresses entered in dotted-decimal notation or as logical host names, a number, or a quoted string.

tag	Item being requested; expressed as filename, integer, or IP dotted-decimal address. See Table 12 for possible keywords.
:hostname	(Optional) This entry applies only to the host specified. The argument :hostname accepts both an IP address and a logical host name.
data	List of IP addresses entered in dotted-decimal notation or as logical host names, a number, or a quoted string.

Table 12 list possible tag keywords for the async-bootp command.

Table 12: async-bootp Tag Keywords

Keyword Description

bootfile

Specifies use of a server boot file from which to download the boot program. Use the optional :hostname and data arguments to specify the filename.

subnet-mask mask

Dotted-decimal address specifying the network and local subnetwork mask (as defined by RFC 950).

time-offset offset

Signed 32-bit integer specifying the time offset of the local subnetwork in seconds from Universal Coordinated Time (UTC).

gateway address

Dotted-decimal address specifying the IP addresses of gateways for this subnetwork. A preferred gateway should be listed first.

time-server address

Dotted-decimal address specifying the IP address of time servers (as defined by RFC 868).

IEN116-server address

Dotted-decimal address specifying the IP address of name servers (as defined by IEN 116).

nbns-server address

Dotted decimal address specifying the IP address of Windows NT servers.

DNS-server address

Dotted-decimal address specifying the IP address of domain name servers (as defined by RFC 1034).

log-server address

Dotted-decimal address specifying the IP address of an MIT-LCS UDP log server.

quote-server address

Dotted-decimal address specifying the IP address of Quote of the Day servers (as defined in RFC 865).

lpr-server address

Dotted-decimal address specifying the IP address of Berkeley UNIX Version 4 BSD servers.

impress-server address

Dotted-decimal address specifying the IP address of Impress network image servers.

rlp-server address

Dotted-decimal address specifying the IP address of Resource Location Protocol (RLP) servers (as defined in RFC 887).

hostname name

The name of the client, which may or may not be domain qualified, depending upon the site.

bootfile-size value

A two-octet value specifying the number of 512-octet (byte) blocks in the default boot file.

Keyword	Description
bootfile	Specifies use of a server boot file from which to download the boot program. Use the optional :hostname and data arguments to specify the filename.
subnet-mask mask	Dotted-decimal address specifying the network and local subnetwork mask (as defined by RFC 950).
time-offset offset	Signed 32-bit integer specifying the time offset of the local subnetwork in seconds from Universal Coordinated Time (UTC).
gateway address	Dotted-decimal address specifying the IP addresses of gateways for this subnetwork. A preferred gateway should be listed first.
time-server address	Dotted-decimal address specifying the IP address of time servers (as defined by RFC 868).
IEN116-server address	Dotted-decimal address specifying the IP address of name servers (as defined by IEN 116).
nbns-server address	Dotted decimal address specifying the IP address of Windows NT servers.
DNS-server address	Dotted-decimal address specifying the IP address of domain name servers (as defined by RFC 1034).
log-server address	Dotted-decimal address specifying the IP address of an MIT-LCS UDP log server.
quote-server address	Dotted-decimal address specifying the IP address of Quote of the Day servers (as defined in RFC 865).
lpr-server address	Dotted-decimal address specifying the IP address of Berkeley UNIX Version 4 BSD servers.
impress-server address	Dotted-decimal address specifying the IP address of Impress network image servers.
rlp-server address	Dotted-decimal address specifying the IP address of Resource Location Protocol (RLP) servers (as defined in RFC 887).
hostname name	The name of the client, which may or may not be domain qualified, depending upon the site.
bootfile-size value	A two-octet value specifying the number of 512-octet (byte) blocks in the default boot file.

ip ftp passive

To configure the router to use only passive File Transfer Protocol connections, use the ip ftp passive global configuration command. To allow all types of FTP connections, use the no form of this command.

ip ftp passive

no ip ftp passive

Syntax Description

This command has no arguments or keywords.

ip ftp password

To specify the password to be used for File Transfer Protocol connections, use the ip ftp password global configuration command. Use the no form of this command to return the password to its default.

ip ftp password [type] password

no ip ftp password

Syntax Description

type

(Optional) Type of encryption to use on the password. A value of 0 disables encryption. A value of 7 indicates proprietary encryption.

password

Password to use for FTP connections.

type	(Optional) Type of encryption to use on the password. A value of 0 disables encryption. A value of 7 indicates proprietary encryption.
password	Password to use for FTP connections.

ip ftp source-interface

To specify the source IP address for File Transfer Protocol connections, use the ip ftp source-interface global configuration command. Use the no form of this command to use the address of the interface where the connection is made.

ip ftp source-interface interface

no ip ftp source-interface

Syntax Description

interface

The interface type and number to use to obtain the source address for FTP connections.

interface	The interface type and number to use to obtain the source address for FTP connections.

ip ftp username

To configure the username for File Transfer Protocol connections, use the ip ftp username global configuration command. To configure the router to attempt anonymous FTP, use the no form of this command.

ip ftp username username

no ip ftp username

Syntax Description

username

Username for FTP connections.

username	Username for FTP connections.

ip rarp-server

To enable the router to act as a Reverse Address Resolution Protocol (RARP) server, use the ip rarp-server interface configuration command. Use the no form of this command to restore the interface to the default of no RARP server support.

ip rarp-server ip-address

no ip rarp-server ip-address

Syntax Description

ip-address

IP address that is to be provided in the source protocol address field of the RARP response packet. Normally, this is set to whatever address you configure as the primary address for the interface.

ip-address	IP address that is to be provided in the source protocol address field of the RARP response packet. Normally, this is set to whatever address you configure as the primary address for the interface.

ip rcmd domain-lookup

To enable Domain Name System (DNS) security for rcp and rsh, use the ip rcmd domain-lookup global configuration command. T o bypass DNS security for rcp and rsh, use the no form of this command.

ip rcmd domain-lookup

no ip rcmd domain-lookup

Syntax Description

This command has no arguments or keywords.

ip rcmd rcp-enable

To configure the Cisco IOS software to allow remote users to copy files to and from the router, use the ip rcmd rcp-enable global configuration command. Use the no form of this command to disable a router that is enabled for rcp.

ip rcmd rcp-enable

no ip rcmd rcp-enable

Syntax Description

This command has no arguments or keywords.

ip rcmd remote-host

To create an entry for the remote user in a local authentication database so that remote users can execute commands on the router using rsh or rcp, use the ip rcmd remote-host global configuration command. Use the no form of this command to remove an entry for a remote user from the local authentication database.

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

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

Syntax Description

local-username

Name of the user on the local router. You can specify the router host name as the username. This name needs to be communicated to the network administrator or the user on the remote system. To be allowed to remotely execute commands on the router, the remote user must specify this value correctly.

ip-address

IP address of the remote host from which the local router will accept remotely executed commands. Either the IP address or the host name is required.

host

Name of the remote host from which the local router will accept remotely executed commands. Either the host name or the IP address is required.

remote-username

Name of the user on the remote host from which the router will accept remotely executed commands.

enable level

(Optional) Enables the remote user to execute privileged EXEC commands using rsh or to copy files to the router using rcp. The range is 1 to 15. The default is 15. For information on the enable level, refer to the privilege level global configuration command in the Cisco IOS Security Command Reference.

local-username	Name of the user on the local router. You can specify the router host name as the username. This name needs to be communicated to the network administrator or the user on the remote system. To be allowed to remotely execute commands on the router, the remote user must specify this value correctly.
ip-address	IP address of the remote host from which the local router will accept remotely executed commands. Either the IP address or the host name is required.
host	Name of the remote host from which the local router will accept remotely executed commands. Either the host name or the IP address is required.
remote-username	Name of the user on the remote host from which the router will accept remotely executed commands.
enable level	(Optional) Enables the remote user to execute privileged EXEC commands using rsh or to copy files to the router using rcp. The range is 1 to 15. The default is 15. For information on the enable level, refer to the privilege level global configuration command in the Cisco IOS Security Command Reference.

ip rcmd remote-username

To configure the remote username to be used when requesting a remote copy using rcp, use the ip rcmd remote-username global configuration command. To remove from the configuration the remote username, use the no form of this command.

ip rcmd remote-username username

no ip rcmd remote-username username

Caution The remote username must be associated with an account on the destination server.

Syntax Description

username

Name of the remote user on the server. This name is used for rcp copy requests. All files and images to be copied are searched for or written relative to the directory of the remote user's account, if the server has a directory structure, for example, as do UNIX systems.

username	Name of the remote user on the server. This name is used for rcp copy requests. All files and images to be copied are searched for or written relative to the directory of the remote user's account, if the server has a directory structure, for example, as do UNIX systems.

ip rcmd rsh-enable

To configure the router to allow remote users to execute commands on it using rsh, use the ip rcmd rsh-enable global configuration command. Use the no form of this command to disable a router that is enabled for rsh.

ip rcmd rsh-enable

no ip rcmd rsh-enable

Syntax Description

This command has no arguments or keywords.

mop device-code

To identify the type of device sending Maintenance Operation Protocol sysid messages and request program messages, use the mop device-code global configuration command. Use the no form of this command to set the identity to the default value.

mop device-code {cisco | ds200}

no mop device-code {cisco | ds200}

Syntax Description

cisco

Denotes a Cisco device code.

ds200

Denotes a DECserver 200 device code.

cisco	Denotes a Cisco device code.
ds200	Denotes a DECserver 200 device code.

mop retransmit-timer

To configure the length of time that the Cisco IOS software waits before resending boot requests to a Maintenance Operation Protocol server, use the mop retransmit-timer global configuration command. Use the no form of this command to reinstate the default value.

mop retransmit-timer seconds

no mop retransmit-timer

Syntax Description

seconds

Sets the length of time, in seconds, that the software waits before retransmitting a message. The value is a number from 1 to 20.

seconds	Sets the length of time, in seconds, that the software waits before retransmitting a message. The value is a number from 1 to 20.

mop retries

To configure the number of times the Cisco IOS software will resend boot requests to a Maintenance Operation Protocol server, use the mop retries global configuration command. Use the no form of this command to reinstate the default value.

mop retries count

no mop retries

Syntax Description

count

Indicates the number of times the software will retransmit a MOP boot request. The value is a number from 3 to 24.

count	Indicates the number of times the software will retransmit a MOP boot request. The value is a number from 3 to 24.

rsh

To execute a command remotely on a remote rsh host, use the rsh privileged EXEC command.

rsh {ip-address | host} [/user username] remote-command

Syntax Description

ip-address

IP address of the remote host on which to execute the rsh command. Either the IP address or the host name is required.

host

Name of the remote host on which to execute the command. Either the host name or the IP address is required.

/user username

(Optional) Remote username.

remote-command

Command to be executed remotely. This is a required parameter.

ip-address	IP address of the remote host on which to execute the rsh command. Either the IP address or the host name is required.
host	Name of the remote host on which to execute the command. Either the host name or the IP address is required.
/user username	(Optional) Remote username.
remote-command	Command to be executed remotely. This is a required parameter.

show async-bootp

To display the extended BOOTP request parameters that have been configured for asynchronous interfaces, use the show async-bootp privileged EXEC command.

show async-bootp

Syntax Description

This command has no arguments or keywords.

tftp-server

To configure a router or a Flash memory device on the router as a TFTP server, use one of the following tftp-server global configuration commands. This command replaces the tftp-server system command. To remove a previously defined filename, use the no tftp-server command with the appropriate filename.

tftp-server flash [partition-number:]filename1 [alias filename2] [access-list-number]

tftp-server rom alias filename1 [access-list-number]

no tftp-server {flash [partition-number:]filename1 | rom alias filename2}

Cisco 1600 series and Cisco 3600 series

tftp-server flash [device:][partition-number:]filename

no tftp-server flash [device:][partition-number:]filename

Cisco 7000 family

tftp-server flash device:filename

no tftp-server flash device:filename

Syntax Description

flash

Specifies TFTP service of a file in Flash memory.

rom

Specifies TFTP service of a file in ROM.

filename1

Name of a file in Flash or in ROM that the TFTP server uses in answering TFTP Read Requests.

alias

Specifies an alternate name for the file that the TFTP server uses in answering TFTP Read Requests.

filename2

Alternate name of the file that the TFTP server uses in answering TFTP Read Requests. A client of the TFTP server can use this alternate name in its Read Requests.

access-list-number

(Optional) Basic IP access-list number. Valid values are 0 to 99.

partition-number:

(Optional) Specifies TFTP service of a file in the specified partition of Flash memory. If the partition number is not specified, the file in the first partition is used.

For the Cisco 1600 series and Cisco 3600 series, you must enter a colon (:) after the partition number if a filename follows it.

device:

(Optional) Specifies TFTP service of a file on a Flash memory device in the Cisco 1600 series, Cisco 3600 series and Cisco 7000 family. The colon (:) is required. Valid devices are as follows:

flash---Internal Flash memory on the Cisco 1600 series and Cisco 3600 series. This is the only valid device for the Cisco 1600.

bootflash---Internal Flash memory in the Cisco 7000 family.

slot0---First PCMCIA slot on the Cisco 3600 series and Cisco 7000 family.

slot1---Second PCMCIA slot on the Cisco 3600 series and Cisco 7000 family.

slavebootflash---Internal Flash memory on the slave RSP card of a Cisco 7507 or Cisco 7513 configured for HSA.

slaveslot0---First PCMCIA slot of the slave RSP card on a Cisco 7507 or Cisco 7513 configured for HSA.

slaveslot1---Second PCMCIA slot of the slave RSP card on a Cisco 7507 or Cisco 7513 configured for HSA.

filename

Name of the file on a Flash memory device that the TFTP server uses in answering a TFTP Read Request. Use this argument only with the Cisco 1600 series, Cisco 3600 series, Cisco 7000 series or Cisco 7500 series.

flash	Specifies TFTP service of a file in Flash memory.
rom	Specifies TFTP service of a file in ROM.
filename1	Name of a file in Flash or in ROM that the TFTP server uses in answering TFTP Read Requests.
alias	Specifies an alternate name for the file that the TFTP server uses in answering TFTP Read Requests.
filename2	Alternate name of the file that the TFTP server uses in answering TFTP Read Requests. A client of the TFTP server can use this alternate name in its Read Requests.
access-list-number	(Optional) Basic IP access-list number. Valid values are 0 to 99.
partition-number:	(Optional) Specifies TFTP service of a file in the specified partition of Flash memory. If the partition number is not specified, the file in the first partition is used. For the Cisco 1600 series and Cisco 3600 series, you must enter a colon (:) after the partition number if a filename follows it.
device:	(Optional) Specifies TFTP service of a file on a Flash memory device in the Cisco 1600 series, Cisco 3600 series and Cisco 7000 family. The colon (:) is required. Valid devices are as follows: flash---Internal Flash memory on the Cisco 1600 series and Cisco 3600 series. This is the only valid device for the Cisco 1600. bootflash---Internal Flash memory in the Cisco 7000 family. slot0---First PCMCIA slot on the Cisco 3600 series and Cisco 7000 family. slot1---Second PCMCIA slot on the Cisco 3600 series and Cisco 7000 family. slavebootflash---Internal Flash memory on the slave RSP card of a Cisco 7507 or Cisco 7513 configured for HSA. slaveslot0---First PCMCIA slot of the slave RSP card on a Cisco 7507 or Cisco 7513 configured for HSA. slaveslot1---Second PCMCIA slot of the slave RSP card on a Cisco 7507 or Cisco 7513 configured for HSA.
filename	Name of the file on a Flash memory device that the TFTP server uses in answering a TFTP Read Request. Use this argument only with the Cisco 1600 series, Cisco 3600 series, Cisco 7000 series or Cisco 7500 series.

tftp-server system

The tftp-server command replaces the tftp-server system command. See the tftp-server command for more information.

Table of Contents

Additional File Transfer Function Commands