aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/lukemftp/src/ftp.1
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/lukemftp/src/ftp.1')
-rw-r--r--contrib/lukemftp/src/ftp.1108
1 files changed, 75 insertions, 33 deletions
diff --git a/contrib/lukemftp/src/ftp.1 b/contrib/lukemftp/src/ftp.1
index 83bff622f4d1..f162ca66153b 100644
--- a/contrib/lukemftp/src/ftp.1
+++ b/contrib/lukemftp/src/ftp.1
@@ -1,6 +1,6 @@
-.\" $NetBSD: ftp.1,v 1.73 2000/09/28 12:26:19 lukem Exp $
+.\" $NetBSD: ftp.1,v 1.83 2002/06/05 10:20:48 lukem Exp $
.\"
-.\" Copyright (c) 1996-2000 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1996-2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
@@ -68,7 +68,7 @@
.\"
.\" @(#)ftp.1 8.3 (Berkeley) 10/9/94
.\"
-.Dd September 28, 2000
+.Dd May 18, 2002
.Dt FTP 1
.Os
.Sh NAME
@@ -79,6 +79,9 @@ Internet file transfer program
.Nm ""
.Op Fl 46AadefginpRtvV
.Bk -words
+.Op Fl N Ar netrc
+.Ek
+.Bk -words
.Op Fl o Ar output
.Ek
.Bk -words
@@ -202,6 +205,14 @@ If no entry exists,
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.
+.It Fl N Ar netrc
+Use
+.Ar netrc
+instead of
+.Pa ~/.netrc .
+Refer to
+.Sx THE .netrc FILE
+for more information.
.It Fl o Ar output
When auto-fetching files, save the contents in
.Ar output .
@@ -299,7 +310,7 @@ from the user.
When
.Nm
is awaiting commands from the user the prompt
-.Ql ftp>
+.Ql ftp\*[Gt]
is provided to the user.
The following commands are recognized
by
@@ -359,7 +370,10 @@ and exit
An end of file will also terminate the session and exit.
.It Ic case
Toggle remote computer file name case mapping during
+.Ic get ,
.Ic mget
+and
+.Ic mput
commands.
When
.Ic case
@@ -413,7 +427,7 @@ When debugging is on,
.Nm
prints each command sent to the remote machine, preceded
by the string
-.Ql \-\->
+.Ql \-\-\*[Gt]
.It Ic delete Ar remote-file
Delete the file
.Ar remote-file
@@ -481,8 +495,9 @@ Set the file transfer
.Ic form
to
.Ar format .
-The default format is
-.Dq file .
+The default (and only supported)
+format is
+.Dq non-print .
.It Ic ftp Ar host Op Ar port
A synonym for
.Ic open .
@@ -525,9 +540,10 @@ are used while transferring the file.
.It Ic glob
Toggle filename expansion for
.Ic mdelete ,
-.Ic mget
+.Ic mget ,
+.Ic mput ,
and
-.Ic mput .
+.Ic mreget .
If globbing is turned off with
.Ic glob ,
the file name arguments
@@ -537,9 +553,10 @@ Globbing for
is done as in
.Xr csh 1 .
For
-.Ic mdelete
+.Ic mdelete ,
+.Ic mget ,
and
-.Ic mget ,
+.Ic mreget ,
each remote file name is expanded
separately on the remote machine and the lists are not merged.
Expansion of a directory name is likely to be
@@ -548,9 +565,10 @@ the exact result depends on the foreign operating system and ftp server,
and can be previewed by doing
.Ql mls remote-files \-
Note:
-.Ic mget
-and
+.Ic mget ,
.Ic mput
+and
+.Ic mreget
are not meant to transfer
entire directory subtrees of files.
That can be done by
@@ -697,9 +715,9 @@ Set the file transfer
.Ic mode
to
.Ar mode-name .
-The default mode is
-.Dq stream
-mode.
+The default (and only supported)
+mode is
+.Dq stream .
.It Ic modtime Ar remote-file
Show the last modification time of the file on the remote machine.
.It Ic more Ar file
@@ -718,6 +736,13 @@ Resulting file names will then be processed according to
and
.Ic nmap
settings.
+.It Ic mreget Ar remote-files
+As per
+.Ic mget ,
+but performs a
+.Ic reget
+instead of
+.Ic get .
.It Ic msend Ar local-files
A synonym for
.Ic mput .
@@ -800,7 +825,7 @@ the output filename "myfile.data" for input filenames "myfile.data" and
"myfile.myfile" for the input filename ".myfile".
Spaces may be included in
.Ar outpattern ,
-as in the example: `nmap $1 sed "s/ *$//" > $1' .
+as in the example: `nmap $1 sed "s/ *$//" \*[Gt] $1' .
Use the `\e' character to prevent special treatment
of the `$','[',']', and `,' characters.
.It Ic ntrans Op Ar inchars Op Ar outchars
@@ -1121,7 +1146,7 @@ commands known to support options include:
.Sq MLST
(used for
.Dv MLSD
-and
+and
.Dv MLST ) .
.It Ic rename Op Ar from Op Ar to
Rename the file
@@ -1249,6 +1274,12 @@ Defaults to
Defaults to
.Ev $FTPRPROMPT .
.El
+.It Ic site Ar arg1 arg2 ...
+The arguments specified are sent, verbatim, to the remote
+.Tn FTP
+server as a
+.Dv SITE
+command.
.It Ic size Ar remote-file
Return size of
.Ar remote-file
@@ -1256,12 +1287,6 @@ on remote machine.
.It Ic sndbuf Ar size
Set the size of the socket send buffer to
.Ar size .
-.It Ic site Ar arg1 arg2 ...
-The arguments specified are sent, verbatim, to the remote
-.Tn FTP
-server as a
-.Dv SITE
-command.
.It Ic status
Show the current status of
.Nm ftp .
@@ -1270,9 +1295,9 @@ Set the file transfer
.Ar structure
to
.Ar struct-name .
-By default
-.Dq stream
-structure is used.
+The default (and only supported)
+structure is
+.Dq file .
.It Ic sunique
Toggle storing of files on remote machine under unique file names.
The remote
@@ -1720,7 +1745,12 @@ The
.Pa .netrc
file contains login and initialization information
used by the auto-login process.
-It resides in the user's home directory.
+It resides in the user's home directory,
+unless overridden with the
+.Fl N Ar netrc
+option, or specified in the
+.Ev NETRC
+environment variable.
The following tokens are recognized; they may be separated by spaces,
tabs, or new-lines:
.Bl -tag -width password
@@ -1844,7 +1874,7 @@ By default, this is bound to the TAB key.
By default,
.Nm
displays a command line prompt of
-.Dq "ftp> "
+.Dq "ftp\*[Gt] "
to the user.
This can be changed with the
.Ic "set prompt"
@@ -1872,7 +1902,7 @@ begins with
.Sq 0 ,
the number of skipped components precede the trailing component(s) in
the format
-.Dq /\fI<skipped>\fRtrailing
+.Dq /\fI\*[Lt]skipped\*[Gt]\fRtrailing
(for
.Sq %c )
or
@@ -1920,7 +1950,7 @@ only
.It Ev FTPPROMPT
Command-line prompt to use.
Defaults to
-.Dq "ftp> " .
+.Dq "ftp\*[Gt] " .
Refer to
.Sx COMMAND LINE PROMPT
for more information.
@@ -1947,6 +1977,10 @@ lookup of
For default location of a
.Pa .netrc
file, if one exists.
+.It Ev NETRC
+An alternate location of the
+.Pa .netrc
+file.
.It Ev PAGER
Used by various commands to display files.
Defaults to
@@ -1963,6 +1997,10 @@ URL requests
(if not defined, use the standard
.Tn FTP
protocol).
+.Pp
+.Em NOTE :
+this is not used for interactive sessions, only for command-line
+fetches.
.It Ev http_proxy
URL of
.Tn HTTP
@@ -1979,7 +2017,11 @@ and
.Ev http_proxy
may be incompatible with other programs that use it
(such as
-.Xr lynx 1 ).
+.Xr lynx 1 ) .
+.Pp
+.Em NOTE :
+this is not used for interactive sessions, only for command-line
+fetches.
.It Ev no_proxy
A space or comma separated list of hosts (or domains) for which
proxying is not to be used.
@@ -2019,7 +2061,7 @@ and other enhancements over the standard
were implemented in
.Nx 1.3
and later releases
-by Luke Mewburn <lukem@netbsd.org>.
+by Luke Mewburn \*[Lt]lukem@netbsd.org\*[Gt].
.Pp
IPv6 support was added by the WIDE/KAME project
(but may not be present in all non-NetBSD versions of this program, depending