Differences between version 4 and predecessor to the previous major change of ftp(1).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 4 | Last edited on Monday, September 1, 2003 7:16:03 pm | by CraigBox | Revert |
| Older page: | version 3 | Last edited on Monday, September 1, 2003 12:15:28 pm | by GerwinVanDeSteeg | Revert |
@@ -1,62 +1,28 @@
-----
-__
NAME__
-
-
-ftp - Internet file transfer
-
-__SYNOPSIS__
-
-
-ftp [[-pinegvd] [[host]
+!!
NAME
+ftp - Internet file transfer program
+!!SYNOPSIS
+ftp [[-pinegvd] [[host] %%%
pftp [[-inegvd] [[host]
-__DESCRIPTION__
-
-
-Ftp is the user interface to the Internet
-standard File Transfer Protocol. The program allows a user
-to transfer files to and from a remote network
-site.
-
-
-Options may be specified at the command line, or to the com- mand interpreter.
- -p
-
-
-Use passive mode for data transfers. Allows use of ftpin environments where a firewall prevents connectionsfrom the outside world back to the client machine.Requires that the ftp server support the PASV command.This is the default if invoked as pftp.-iTurns off interactive prompting during multiple filetransfers.-nRestrains ftp from attempting ``auto-login'' upon ini-tial connection. If auto-login is enabled, ftp willcheck the .netrc (see netrc(5)) file in the user's home directory for an entry describing an account on the remote machine. If no entry exists, ftp will prompt for the remote machine login name (default is the user identity on the local machine), and, if necessary, prompt for a password and an account with which to login.
-
-
--e
-Disables command editing and history support, if it was
-compiled into the ftp executable. Otherwise, does noth-
-ing.
-
-
--g
-Disables file name globbing.
-
--v
-Verbose option forces ftp to show all responses from the
-remote server, as well as report on data transfer
-statistics.
+!!DESCRIPTION
+Ftp is the user interface to the Internet standard File Transfer Protocol. The program allows a user to transfer files to and from a remote network site.
--d
-Enables debugging
.
+Options may be specified at the command line, or to the command interpreter
.
+; __-p__ : Use passive mode for data transfers. Allows use of ftpin environments where a firewall prevents connectionsfrom the outside world back to the client machine.Requires that the ftp server support the PASV command.This is the default if invoked as pftp.-iTurns off interactive prompting during multiple filetransfers.-nRestrains ftp from attempting ``auto-login'' upon ini-tial connection. If auto-login is enabled, ftp willcheck the .netrc (see netrc(5)) file in the user's home directory for an entry describing an account on the remote machine. If no entry exists, ftp will prompt for the remote machine login name (default is the user identity on the local machine), and, if necessary, prompt for a password and an account with which to login.
+; __-e__ : Disables command editing and history support, if it was compiled into the ftp executable. Otherwise, does nothing.
+; __-g__ : Disables file name globbing.
+; __-v__ : Verbose option forces ftp to show all responses from the remote server, as well as report on data transfer statistics.
+; __-d__ : Enables debugging.
-The client host with which ftp is to communicate may be
-specified on the command line. If this is done, ftp will
-immediately attempt to establish a connection to an
-FTP server on that host; otherwise, ftp will
-enter its command interpreter and await instructions from
-the user. When ftp is awaiting commands from the user the
-prompt ftp is pro- vided to the user. The
-following commands are recognized by ftp:
+The client host with which ftp is to communicate may be specified on the command line. If this is done, ftp will immediately attempt to establish a connection to an
+FTP server on that host; otherwise, ftp will enter its command interpreter and await instructions from the user. When ftp is awaiting commands from the user the
+prompt ftp is pro- vided to the user. The following commands are recognized by ftp:
! [[command [[args]]
Invoke an interactive shell on the local machine. If there
are arguments, the first is taken to be a command to execute
@@ -367,10 +333,9 @@
other characters are treated literally, and are used to
determine the nmap [[inpattern] variable values. For example,
given inpattern $1.$2 and the remote file name
-
-
nmap $1.$2.$3 [[$1,$2].[[$2,file]
+ nmap $1.$2.$3 [[$1,$2].[[$2,file]
would yield the output filename
ntrans [[inchars [[outchars]]
@@ -557,113 +522,53 @@
? [[command]
A synonym for help.
-Command arguments which have embedded spaces may be quoted
-
-
+Command arguments which have embedded spaces may be quoted with quote `.
__ABORTING A FILE TRANSFER__
-To abort a file transfer, use the terminal interrupt key
-
-
-protocol ABOR command to the remote server, and
-
-
-
-
-
-server has completed sending the requested
-
+To abort a file transfer, use the terminal interrupt key (usually Ctrl-C). Sending transfers will be immediately halted. Receiving transfers will be halted by sending a ftp
+protocol ABOR command to the remote server, and discarding any further data received. The speed at which this is accomplished depends upon the remote server's support for ABOR processing. If the remote server does not support the ABOR command, an ftp prompt will not appear until the remote
+server has completed sending the requested file.
+The terminal interrupt key sequence will be ignored when ftp has completed any local processing and is awaiting a reply from the remote server. A long delay in this mode may result from the ABOR processing described above, or from unexpected behavior by the remote server, including viola- tions of the ftp protocol. If the delay results from unex- pected remote server behavior, the local ftp program must be killed by hand.
-The terminal interrupt key sequence will be ignored when ftp
-has completed any local processing and is awaiting a reply
-from the remote server. A long delay in this mode may result
-from the ABOR processing described above, or from unexpected
-behavior by the remote server, including viola- tions of the
-ftp protocol. If the delay results from unex- pected remote
-server behavior, the local ftp program must be killed by
-hand.
__FILE NAMING CONVENTIONS__
+Files specified as arguments to ftp commands are processed according to the following rules.
-Files specified as arguments to ftp commands are processed
-according to the following rules.
- 1.
If the file name - is specified, the stdin (for reading)or stdout (for writing) is used.
-
-
-2.
If the first character of the file name is |, theremainder of the argument is interpreted as a shell com-mand
. Ftp then forks a shell, using popen(3) with the argument supplied, and reads (writes) from the stdout (stdin). If the shell command includes spaces, the argument must be quoted; e.g. ``
-
-
-3.
Failing the above checks, if ``globbing'' is enabled,
-
-ftp
-command
expects a single local file (.e.g. put), only the
-
-
-
-4.
For mget commands and get commands with unspecified local
-
-The
-resulting filename may then be altered if runique is
-
-
-
-5.
For mput commands and put commands with unspecified remote
-
-set- ting
. The resulting
-
-
-
+#
If the file name - is specified, the stdin (for reading)or stdout (for writing) is used.
+#
If the first character of the file name is |, theremainder of the argument is interpreted as a shell command
. Ftp then forks a shell, using popen(3) with the argument supplied, and reads (writes) from the stdout (stdin). If the shell command includes spaces, the argument must be quoted; e.g. ``
+#
Failing the above checks, if ``globbing'' is enabled, local file names are expanded according to the rules used in the csh(1); c.f. the glob command. If the ftpcommand
expects a single local file (.e.g. put), only the first filename generated by the
+#
For mget commands and get commands with unspecified local file names, the local filename is the remote file- name, which may be altered by a case, ntrans, or nmap setting. he
+resulting filename may then be altered if runique is on.
+#
For mput commands and put commands with unspecified remote file names, the remote filename is the local filename, which may be altered by a ntrans or nmap setting
. The resulting filename may then be altered by the remote server if sunique is on.
__FILE TRANSFER PARAMETERS__
+The FTP specification specifies many parameters which may affect a file transfer. The type may be one of ``ascii'',``image'' (binary), ``ebcdic'', and ``local byte size'' (for
+PDP -10's and PDP -20's mostly). Ftp supports the ascii and image types of file transfer, plus local byte size 8 for tenex mode transfers.
-The FTP specification specifies many parameters which may
-affect a file transfer. The type may be one of ``ascii'',
-``image'' (binary), ``ebcdic'', and ``local byte size'' (for
-PDP -10's and PDP -20's
-mostly).
Ftp supports the ascii and image types of
file
-plus local byte size 8 for tenex mode
-transfers
.
+
Ftp supports only
the default values for the remaining
file transfer parameters: mode
, form, and struct
.
-
-Ftp supports only the default values for the remaining file
-transfer parameters: mode, form, and struct.
__ENVIRONMENT__
+Ftp utilizes the following environment variables.
+; __HOME__ : For default location of a .netrc file, if one exists.
+; __SHELL__ : For default shell.
-Ftp utilizes the following environment
-variables.
- HOME
-For default location of a .netrc file, if one
-exists.
+!!SEE ALSO
+ftpd(8), RFC:959
-SHELL
-For default shell.
+!!HISTORY
+The ftp command appeared in 4.2 BSD.
-__SEE ALSO__
+!!BUGS
-ftpd(8), RFC 959
-__HISTORY__
-
-
-The ftp command appeared in 4.2 BSD
-.
-__BUGS__
-
-
-
-
-
+Correct execution of many commands depends upon proper behavior by the remote server.
An error in the treatment of carriage returns in the 4.2 BSD ascii-mode transfer code has been corrected. This correc- tion may result in incorrect transfers of binary files to and from 4.2 BSD servers using the ascii type. Avoid this problem by using the binary image type.
-
-
-Linux !NetKit (0.17) August 15, 1999 1
-----
