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  pro-
           cess searches the .netrc file for a machine token that
           matches the remote machine specified on the  ftp  com-
           mand  line  or  as  an  open command argument.  Once a
           match is made, the subsequent .netrc tokens  are  pro-
           cessed,  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 the same as   ftp
           macdef.  A  macro  is defined with the specified name;
           its contents begin with the next .netrc line and  con-
           tinue  until  a null line (consecutive NEWLINE charac-
           ters)  is  encountered.  If  a  macro  named  init  is
           defined, it is automatically executed as the last step
           in the auto-login process.

SunOS 5.8            Last change: 3 Jul 1990                    1

File Formats                                             netrc(4)

EXAMPLES
     Example 1: A Sample .netrc File

     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), in.ftpd(1M)

SunOS 5.8            Last change: 3 Jul 1990                    2