.netrc(4)                           CLIX                           .netrc(4)



  NAME

    .netrc - Login and initialization information used by auto-login process
    associated with ftp

  DESCRIPTION

    The .netrc file resides in the user's local home directory.  The following
    parameters are recognized and are separated by spaces, tabs, or newlines:

    machine name
           Identifies a remote machine name.  The auto-login process searches
           the .netrc file for a machine parameter followed by a name that
           matches the host given on the ftp command line or as an argument to
           the open command.  Once a match is found, subsequent .netrc
           parameters are processed until the end of the file is reached or
           another machine parameter is encountered.

    login name
           Identifies a username on the remote machine.  If this parameter is
           present, the auto-login process initiates a login using name.

    password string
           Supplies a password.  If this parameter is present, the auto-login
           process supplies string if the remote server requires a password as
           part of the login process.  Note that including a password in the
           .netrc file is a serious security risk.  Ensure that the file
           permissions prevent anyone other than the user from reading the
           .netrc file.  If the password parameter is present in the .netrc
           file and the file permissions are set so the file is readable by
           anyone other than the user, ftp aborts the auto-login process.  For
           more security, do not include passwords in the .netrc file.

    account string
           Supplies an additional account password.  If this parameter is
           present, the auto-login process supplies string if the remote
           server requires an additional account password.  If the remote
           server requires an additional account password and the account
           parameter is not defined, the auto-login process initiates an ftp
           ACCT (account) command.

    macdef name
           Defines a macro.  This parameter functions as the macdef command of
           the ftp program does.  A macro called name is defined; 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




  2/94 - Intergraph Corporation                                              1

  .netrc(4)                           CLIX                           .netrc(4)



    When an ftp command is run, the following sample .netrc file logs in to
    the machine toad as user me with the password me2.  After a successful
    login the ls and pwd commands are executed as part of the auto-login
    process.

    machine toad
    login me
    password me2
    macdef init
    ls
    pwd

    The ftp> prompt is then displayed to continue the interactive ftp session.

    A blank line must be included at the end of the file as it is used as a
    null line terminator for the macro defined.

  NOTES

    Be sure to include the blank line at the end of the .netrc file.

    If the password parameter is included in the file, the file permissions
    must be set so that the file is readable only by the user or ftp will
    abort the auto-login process.

  CAUTIONS

    Including your password in a .netrc file is a serious security risk.

  RELATED INFORMATION

    Commands:  ftp(1)






















  2                                              Intergraph Corporation - 2/94