netrc(4)                                                           netrc(4)

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 per-
     missions 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 pro-
          cess 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 con-
          tents 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.








Page 1                       Reliant UNIX 5.44                Printed 11/98

netrc(4)                                                           netrc(4)

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                       Reliant UNIX 5.44                Printed 11/98