netrc(4N)                        (TCP/IP)                         netrc(4N)


   NAME
         netrc - file for ftp remote login data

   DESCRIPTION
         The .netrc file contains data for logging in to a remote host over
         the network for file transfers by ftp(1).  This file resides in the
         user's home directory on the machine initiating the file transfer.
         Its permissions should be set to disallow read access by group and
         others [see chmod(1)].

         The following tokens are recognized; they may be separated by SPACE,
         TAB, or NEWLINE characters:

         machine name
               Identify a remote machine name.  The auto-login process
               searches the .netrc file for a machine token that matches the
               remote machine specified on the ftp command line or as an open
               command argument.  Once a match is made, the subsequent .netrc
               tokens are processed, stopping when the EOF is reached or
               another machine token is encountered.

         login name
               Identify a user on the remote machine.  If this token is
               present, the auto-login process will initiate a login using the
               specified name.

         password string
               Supply a password.  If this token is present, the auto-login
               process will supply the specified string if the remote server
               requires a password as part of the login process.  Note: if
               this token is present in the .netrc file, ftp will abort the
               auto-login process if the .netrc is readable by anyone besides
               the user.

         account string
               Supply an additional account password.  If this token is
               present, the auto-login process will supply the specified
               string if the remote server requires an additional account
               password, or the auto-login process will initiate an ACCT
               command if it does not.

         macdef name
               Define a macro.  This token functions as the ftp macdef command
               functions.  A macro is defined with the specified name; its
               contents begin with the next .netrc line and continue until a
               NULL line (consecutive NEWLINE characters) is encountered.  If
               a macro named init is defined, it is automatically executed as
               the last step in the auto-login process.





   7/91                                                                 Page 1

   netrc(4N)                        (TCP/IP)                         netrc(4N)


   EXAMPLE
         A .netrc file containing the following line:

               machine ray login demo password mypassword

         allows an autologin to the machine ray using the login name demo with
         password mypassword.

   FILES
         ~/.netrc

   SEE ALSO
         chmod(1), ftp(1), ftpd(1M).








































   Page 2                                                                 7/91