version 1.21, 1998/09/19 20:47:16 |
version 1.22, 1998/09/26 19:54:48 |
|
|
file transfer program |
file transfer program |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm |
.Nm |
.Op Fl A |
.Op Fl AVadegimnptu |
.Op Fl a |
|
.Op Fl d |
|
.Op Fl e |
|
.Op Fl g |
|
.Op Fl i |
|
.Op Fl m |
|
.Op Fl n |
|
.Op Fl o Ar output |
.Op Fl o Ar output |
.Op Fl p |
|
.Op Fl P Ar port |
.Op Fl P Ar port |
.Op Fl r Ar seconds |
.Op Fl r Ar seconds |
.Op Fl t |
|
.Op Fl v |
|
.Op Fl V |
|
.Op Ar host Op Ar port |
.Op Ar host Op Ar port |
.Nm ftp |
.Nm ftp |
ftp://[\fIuser\fR:\fIpassword\fR@]\fIhost\fR[:\fIport\fR]/\fIfile\fR[/] |
ftp://[\fIuser\fR:\fIpassword\fR@]\fIhost\fR[:\fIport\fR]/\fIfile\fR[/] |
|
|
.Nm ftp |
.Nm ftp |
\fIhost\fR:[/\fIpath\fR/]\fIfile\fR[/] |
\fIhost\fR:[/\fIpath\fR/]\fIfile\fR[/] |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm Ftp |
.Nm ftp |
is the user interface to the |
is the user interface to the |
.Tn ARPANET |
.Tn ARPANET |
standard File Transfer Protocol. |
standard File Transfer Protocol. |
|
|
.It Fl a |
.It Fl a |
Causes |
Causes |
.Nm |
.Nm |
to bypass normal login procedure, and use an anonymous login instead. |
to bypass the normal login procedure and use an anonymous login instead. |
.It Fl d |
.It Fl d |
Enables debugging. |
Enables debugging. |
.It Fl e |
.It Fl e |
|
|
.It Fl o Ar output |
.It Fl o Ar output |
When fetching a single file or url, save the contents in |
When fetching a single file or url, save the contents in |
.Ar output . |
.Ar output . |
To make the contents go to |
To make the contents go to stdout, |
.Ar stdout , |
|
use |
use |
.Qq - |
.Dq - |
for |
for |
.Ar output . |
.Ar output . |
.It Fl p |
.It Fl p |
|
|
from the user. |
from the user. |
When |
When |
.Nm |
.Nm |
is awaiting commands from the user the prompt |
is awaiting commands the prompt |
.Ql ftp> |
.Ql ftp> |
is provided to the user. |
is provided to the user. |
The following commands are recognized |
The following commands are recognized |
by |
by |
.Nm ftp : |
.Nm ftp : |
.Bl -tag -width Fl |
.Bl -tag -width Fl |
.It Ic \&! Op Ar command Op Ar args |
.It Ic \&! Op Ar command Op Ar args |
Invoke an interactive shell on the local machine. |
Invoke an interactive shell on the local machine. |
|
|
session with the remote server |
session with the remote server |
and exit |
and exit |
.Nm ftp . |
.Nm ftp . |
An end of file will also terminate the session and exit. |
An end-of-file will also terminate the session and exit. |
.It Ic case |
.It Ic case |
Toggle remote computer file name case mapping during |
Toggle remote computer file name case mapping during |
.Ic mget |
.Ic mget |
|
|
.It Ic close |
.It Ic close |
Terminate the |
Terminate the |
.Tn FTP |
.Tn FTP |
session with the remote server, and |
session with the remote server and |
return to the command interpreter. |
return to the command interpreter. |
Any defined macros are erased. |
Any defined macros are erased. |
.It Ic \&cr |
.It Ic \&cr |
Toggle carriage return stripping during |
Toggle carriage return stripping during |
ascii type file retrieval. |
ASCII type file retrieval. |
Records are denoted by a carriage return/linefeed sequence |
Records are denoted by a carriage return/linefeed sequence |
during ascii type file transfer. |
during ASCII type file transfer. |
When |
When |
.Ic \&cr |
.Ic \&cr |
is on (the default), carriage returns are stripped from this |
is on (the default), carriage returns are stripped from this |
|
|
Records on |
Records on |
.Pf non\- Ns Ux |
.Pf non\- Ns Ux |
remote systems may contain single linefeeds; |
remote systems may contain single linefeeds; |
when an ascii type transfer is made, these linefeeds may be |
when an ASCII type transfer is made, these linefeeds may be |
distinguished from a record delimiter only when |
distinguished from a record delimiter only when |
.Ic \&cr |
.Ic \&cr |
is off. |
is off. |
|
|
different from expansion of the name of an ordinary file: |
different from expansion of the name of an ordinary file: |
the exact result depends on the foreign operating system and ftp server, |
the exact result depends on the foreign operating system and ftp server, |
and can be previewed by doing |
and can be previewed by doing |
.Ql mls remote-files \- |
.Dq mls remote-files \- . |
Note: |
Note: |
.Ic mget |
.Ic mget |
and |
and |
|
|
The macro processor interprets `$' and `\e' as special characters. |
The macro processor interprets `$' and `\e' as special characters. |
A `$' followed by a number (or numbers) is replaced by the |
A `$' followed by a number (or numbers) is replaced by the |
corresponding argument on the macro invocation command line. |
corresponding argument on the macro invocation command line. |
A `$' followed by an `i' signals that macro processor that the |
A `$' followed by an `i' tells the macro processor that the |
executing macro is to be looped. |
executing macro is to be looped. |
On the first pass `$i' is |
On the first pass `$i' is |
replaced by the first argument on the macro invocation command line, |
replaced by the first argument on the macro invocation command line, |
|
|
.Ic mput . |
.Ic mput . |
.It Ic newer Ar file-name |
.It Ic newer Ar file-name |
Get the file only if the modification time of the remote file is more |
Get the file only if the modification time of the remote file is more |
recent that the file on the current system. |
recent than the file on the current system. |
If the file does not |
If the file does not |
exist on the current system, the remote file is considered |
exist on the current system, the remote file is considered |
.Ic newer . |
.Ic newer . |
|
|
.Ar inpattern |
.Ar inpattern |
and |
and |
.Ar outpattern . |
.Ar outpattern . |
.Op Ar Inpattern |
.Ar inpattern |
is a template for incoming filenames (which may have already been |
is a template for incoming filenames (which may have already been |
processed according to the |
processed according to the |
.Ic ntrans |
.Ic ntrans |
|
|
Use `\\' to prevent this special treatment of the `$' character. |
Use `\\' to prevent this special treatment of the `$' character. |
All other characters are treated literally, and are used to determine the |
All other characters are treated literally, and are used to determine the |
.Ic nmap |
.Ic nmap |
.Op Ar inpattern |
.Ar inpattern |
variable values. |
variable values. |
For example, given |
For example, given |
.Ar inpattern |
.Ar inpattern |
|
|
from the |
from the |
.Ar inpattern |
.Ar inpattern |
template. |
template. |
The sequence `$0' is replace by the original filename. |
The sequence `$0' is replaced by the original filename. |
Additionally, the sequence |
Additionally, the sequence |
.Ql Op Ar seq1 , Ar seq2 |
.Ql Op Ar seq1 , Ar seq2 |
is replaced by |
is replaced by |
|
|
.Ar host |
.Ar host |
.Tn FTP |
.Tn FTP |
server. |
server. |
An optional port number may be supplied, |
An optional port number may be supplied |
in which case, |
in which case |
.Nm |
.Nm |
will attempt to contact an |
will attempt to contact an |
.Tn FTP |
.Tn FTP |
|
|
Do not transfer the file. |
Do not transfer the file. |
.It Ic a |
.It Ic a |
Answer |
Answer |
.Sq yes |
.Dq yes |
to the current file, and automatically answer |
to the current file and automatically answer |
.Sq yes |
.Dq yes |
to any remaining files for the current command. |
to any remaining files for the current command. |
.It Ic p |
.It Ic p |
Answer |
Answer |
.Sq yes |
.Dq yes |
to the current file, and turn off prompt mode |
to the current file and turn off prompt mode |
(as is |
(as if |
.Dq prompt off |
.Dq prompt off |
had been given). |
had been given). |
.El |
.El |
.Pp |
.Pp |
Any other reponse will answer |
Any other reponse will answer |
.Sq yes |
.Dq yes |
to the current file. |
to the current file. |
.It Ic proxy Ar ftp-command |
.It Ic proxy Ar ftp-command |
Execute an ftp command on a secondary control connection. |
Execute an ftp command on a secondary control connection. |
|
|
.It Ic rename Op Ar from Op Ar to |
.It Ic rename Op Ar from Op Ar to |
Rename the file |
Rename the file |
.Ar from |
.Ar from |
on the remote machine, to the file |
on the remote machine to the file |
.Ar to . |
.Ar to . |
.It Ic reset |
.It Ic reset |
Clear reply queue. |
Clear reply queue. |
|
|
.Ar marker . |
.Ar marker . |
On |
On |
.Ux |
.Ux |
systems, marker is usually a byte |
systems, |
|
.Ar marker |
|
is usually a byte |
offset into the file. |
offset into the file. |
.It Ic rmdir Ar directory-name |
.It Ic rmdir Ar directory-name |
Delete a directory on the remote machine. |
Delete a directory on the remote machine. |
|
|
To abort a file transfer, use the terminal interrupt key |
To abort a file transfer, use the terminal interrupt key |
(usually Ctrl-C). |
(usually Ctrl-C). |
Sending transfers will be immediately halted. |
Sending transfers will be immediately halted. |
Receiving transfers will be halted by sending a ftp protocol |
Receiving transfers will be halted by sending an ftp protocol |
.Dv ABOR |
.Dv ABOR |
command to the remote server, and discarding any further data received. |
command to the remote server, and discarding any further data received. |
The speed at which this is accomplished depends upon the remote |
The speed at which this is accomplished depends upon the remote |
|
|
.It |
.It |
If the file name |
If the file name |
.Sq Fl |
.Sq Fl |
is specified, the |
is specified, the stdin |
.Ar stdin |
(for reading) or stdout |
(for reading) or |
|
.Ar stdout |
|
(for writing) is used. |
(for writing) is used. |
.It |
.It |
If the first character of the file name is |
If the first character of the file name is |
|
|
By default, this is bound to the TAB key. |
By default, this is bound to the TAB key. |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Nm |
.Nm |
utilizes the following environment variables. |
utilizes the following environment variables: |
.Bl -tag -width "FTPSERVERPORT" |
.Bl -tag -width "FTPSERVERPORT" |
.It Ev FTPMODE |
.It Ev FTPMODE |
Overrides the default operation mode. Recognized values are: |
Overrides the default operation mode. Recognized values are: |
|
|
An error in the treatment of carriage returns |
An error in the treatment of carriage returns |
in the |
in the |
.Bx 4.2 |
.Bx 4.2 |
ascii-mode transfer code |
ASCII-mode transfer code |
has been corrected. |
has been corrected. |
This correction may result in incorrect transfers of binary files |
This correction may result in incorrect transfers of binary files |
to and from |
to and from |
.Bx 4.2 |
.Bx 4.2 |
servers using the ascii type. |
servers using the ASCII type. |
Avoid this problem by using the binary image type. |
Avoid this problem by using the binary image type. |