3.0;ftp (file_transfer_program), revision 3.0, 86/11/18
FTP (FILE_TRANSFER_PROGRAM) -- Transfer files between DOMAIN net and remote host
usage: FTP [-TRACE ] [-DEBUG ] [host]
FORMAT
FTP [options] [host]
After invoking the File Transfer Program (ftp), you are placed in a command
interpreter (much like TELNET's command mode) so that you can transfer files
back and forth across your TCP/IP connection.
In a typical ftp session, you identify yourself using ftp access control
commands. Then you describe the data you're transferring with the data
transfer specification commands, and then transfer the data with the service
commands. The ftp commands are listed below.
ARGUMENTS
host
(optional) Internet name of the host with which you want to
communicate. This must be a valid, configured TCP/IP host.
Default if omitted: ftp prompts you for a host.
OPTIONS
-TRACE Generate packet tracing on the control connection.
-DEBUG Enable FTP debug mode. In debug mode, each command sent
over the control connection is displayed.
FTP COMMANDS
After connecting to the host, you'll get the ftp greater than (>) prompt so
that you can begin entering the following commands. They are listed in the
order in which you'll use them.
Access Control Commands
Use the access control commands to gain access to the remote host after you
invoked the ftp command at the Shell prompt.
log Log in to a remote host. It sends your user ID, password, and
account number to the remote host.
user Send your user ID to the remote host. After entering this
command, enter the password and account commands to identify
yourself completely to the remote.
password Send your password to the remote host. Use this command if
you log in to a remote computer using the user command and the
remote prompts you for a password.
account|acct Send your account number to the remote host. Use this command
if the remote computer prompts you for your account number.
Data Transfer Commands
Use the following data transfer commands to describe the format of the data
being transferred.
structure Specify the structure of the file being transferred. You can
specify that the file has either a file (unstructured) or
record structure.
type Specify the format of the data. Specify ascii for ASCII
files; it allows you to transfer text with different
conventions for storing ASCII text. Specify binary for binary
object, byte-stream, or record-structured files. Specify
image for transferring ASCII or binary files only to a system
that runs UNIX. This is faster than transferring files as
ascii or binary. Specify local to store and retrieve object
files.
Service Commands
Use the following commands to transfer files and request the remote host to
perform various actions. Note that commands sharing the same description are
synonyms.
get|retrieve|recv
Transfer a remote file to a local machine; ftp stores the file
according to the name you specify.
send|store|put Send a local file to a remote host; ftp stores the file
according to the name you specify.
mget|mrecv|mretrieve
Copy remote files to the local host. Specify the -q option to
query for the pathname of the destination; specify -s to use
the same pathname for the destination as the source; specify
-w to copy the source file to the current working directory.
mput|msend|mstore
Copy local files to the remote host. Specify the -q option to
query for the pathname of the destination; specify -s to use
the same pathname for the destination as the source; specify
-w to copy the source file to the current working directory.
append Add data from a local file to the end of the remote file.
rename Change the name of a file on the remote host from old to new
name.
delete Delete the specified file on the remote host.
mdelete Delete multiple files on the remote host. Specify the -q
option to query for the pathname of the destination; specify
-s to use the same pathname for the destination as the source;
specify -w to copy the source file to the current working
directory.
status Get status information about the current ftp parameter
settings, or about the pathname specified on the command line.
The pathname can be a file or directory.
rate Display the average data transfer rate. Specify the option
reset to start computing a new average, based only on file
transfers that occur after invoking the command.
list Store status information about the remote object specified by
a pathname in a specified file. The pathname must be on the
remote host; it can either be a file or directory.
nlst Store a list of remote filenames in a local file. This is
similar to the list command, except that nlst returns only
names, list returns names and status information.
cwd Change the working directory on the remote host.
chdir|wd|cd Change the working directory on the local system.
cup Change the working directory on the remote host to its parent
directory.
ld Display the working directory on the local host.
pwd Display the name of the current working directory on the
remote host.
mkdir Make a directory on the remote host.
rmdir Delete a directory on the remote host.
quote Send an arbitrary command to the remote ftp server program.
This allows you to send a command that the remote host
recognizes, but the DOMAIN ftp program does not.
bye|quit Close the connection to the remote host and return to the
Shell.
Miscellaneous Commands
!|<SHELL> Create a Shell process to run Shell commands. Connections to
the remote host remain open while running the Shell process.
command|cmd Create a Shell process on the remote host to run Shell
commands. Connections to the remote host remain open while
running the Shell process.
debug Toggle debugging mode; when debugging is on, ftp prints each
command that it transmits to the remote ftp server, preceded
by the prompt -->. By default, debug mode is off.
help Display available ftp commands and their descriptions.
remotehelp Display available ftp comands and their descriptions on the
remote host.
interrupt Send a Network Interrupt (a DM DQ -i command) to the remote
host to abort any ongoing data transfer. The remote computer
should reply, indicating whether the transfer was aborted.
port Set the ftp port number for the remote host, disable or
re-enable automatic port selection. Automatic port selection
allows ftp to select a new port and use it for additional
stream-mode data transfers before the TCP/IP close protocol
has completed the connection that used the previous port. You
must disable port selection when exchanging files to hosts
that don't support the port command.
quit|<CTRL/Q> Break any local ftp connections and return to the Shell. Use
quit only when the connections appear to be confused (for
example, if the remote host crashes), or if ftp appears to be
hanging.
trace Toggle trace mode; when you run in trace mode, ftp generates
packet traces for all file transfers.
verbose Toggle verbose mode; when you run in verbose mode, the remote
ftp server displays all its responses on the local host. It
also displays statistics regarding the efficiency of data
transfer. By default, verbose mode is on.