[BACK]Return to ftp.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / ftp

Diff for /src/usr.bin/ftp/ftp.1 between version 1.21 and 1.22

version 1.21, 1998/09/19 20:47:16 version 1.22, 1998/09/26 19:54:48
Line 44 
Line 44 
 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[/]
Line 67 
Line 56 
 .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.
Line 94 
Line 83 
 .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
Line 129 
Line 118 
 .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
Line 175 
Line 163 
 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.
Line 233 
Line 221 
 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
Line 259 
Line 247 
 .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
Line 277 
Line 265 
 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.
Line 399 
Line 387 
 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
Line 473 
Line 461 
 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,
Line 559 
Line 547 
 .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 .
Line 589 
Line 577 
 .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
Line 602 
Line 590 
 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
Line 615 
Line 603 
 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
Line 673 
Line 661 
 .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
Line 747 
Line 735 
 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.
Line 857 
Line 845 
 .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.
Line 875 
Line 863 
 .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.
Line 1119 
Line 1109 
 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
Line 1151 
Line 1141 
 .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
Line 1365 
Line 1353 
 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:
Line 1426 
Line 1414 
 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.
Legend:
Removed from v.1.21  
changed lines
  Added in v.1.22