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).

          Files
             ~/.netrc

       USAGE
             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 that, 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.


                           Copyright 1994 Novell, Inc.               Page 1

      netrc(4)                                                    netrc(4)


            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.

         Examples
            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.

      REFERENCES
            chmod(1), ftp(1), ftpd(1M)






























                          Copyright 1994 Novell, Inc.               Page 2