netrc(4)                  FILE FORMATS                   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 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, stop-
          ping  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 addi-
          tional 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 speci-
          fied 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.





                                                                1

netrc(4)                  FILE FORMATS                   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).










































                                                                2