netrc Man Page


This is the man page for the FTP-style $HOME/.netrc file.

Note: The use of a .netrc file is currently only supported for the combo or local authmethods.  It will only be used if the HPSS_USE_NETRC_FILE environment variable is set, otherwise the user will be prompted for a password and possibly for a principal name.  

The man page below is for the BSD FTP implementation of the NETRC file.


Note:   HSI and HTAR currently make use of "login" and "password" entries in the file; other entries such as "macdef" and "account" are currently ignored.


      NETRC Man Page for FTP




  Transfer Protocol client ftp(1).


  The .netrc file contains login and initialization information used by the

  auto-login process.  It resides in the user's home directory.  The fol-

  lowing tokens are recognized; they may be separated by spaces, tabs, or



  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 end of file is reached

  or another "machine" or a "default" token is encountered.


  default   This is the same as machine name except that default matches

  any name.  There can be only one "default" token, and it must be

  after all "machine" tokens.  This is normally used as:


  default login anonymous password user@site


  thereby giving the user automatic anonymous ftp login to

  machines not specified in .netrc.  This can be overridden 

  by using the -n flag to disable auto-login.


  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 for any user other

  than anonymous, 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 com-

  mand if it does not.


  macdef name

  Define a macro.  This token functions like the ftp macdef com-

  mand functions.  A macro is defined with the specified name;

  its contents begin with the next .netrc line and continue until

  a null line (consecutive new-line characters) is encountered.

  If a macro named init is defined, it is automatically executed

  as the last step in the auto-login process.