unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



netrc(4)							     netrc(4)



NAME

  netrc, .netrc	- Specifies automatic login information	for ftp

SYNOPSIS

  $HOME/.netrc

DESCRIPTION

  The .netrc file contains the information used	by the automatic login (auto-
  login) feature of the	ftp command.  It is a hidden file in your home direc-
  tory and must	be owned by the	user logging in, or by the root	user.	If
  the .netrc file contains a login password, the file's	permissions must be
  set to 600 (read and write by	owner only).

  The .netrc file can contain the following entries (separated by spaces,
  tabs,	or newlines):

  machine host
      Where host is the	name of	a remote host.	This entry begins the defini-
      tion of the autologin process for	the specified host.  All following
      entries up to the	next machine entry or the end of the file apply	to
      that host.

  default
      This is the same as machine, except that default matches any name.
      There can	be only	one default token, and it must appear after all
      machine tokens.  This is normally	used as	follows:
	   default login anonymous password user@site
      The preceding command line gives the user	automatic anonymous ftp	login
      to machines not specified	in .netrc.  This can be	overriden by using
      the -n flag to disable autologin.

  login	user
      Where user is the	username to use	at the remote host.  If	this entry is
      found, the autologin process initiates a login using the specified
      name.  If	this entry is missing, the autologin process fails.

  password password
      Where password is	the login password to be used.	The autologin process
      supplies this password to	the remote server.  A login password must be
      established at the remote	host and that password must be entered in
      this file, or the	autologin process fails	and you	are prompted for the
      login password.

  account password
      Where password is	the account password to	be used.  If this entry	is
      found and	an account password is required	at the remote host, the	auto-
      login process supplies the password to the remote	server.	 If the
      remote host requires an account password but this	entry is missing, the
      autologin	process	prompts	for the	account	password.

  macdef macro
      Where macro is the name of an ftp	subcommand macro.  The macro defini-
      tion starts on the following line	and is defined to contain all of the
      following	ftp subcommands	up to the next blank line.  If the macro is
      named init, ftp executes the macro upon successful completion of the
      autologin	process.

FILES

  $HOME/.netrc
	 Contains automatic login information.

RELATED	INFORMATION

  Commands:  ftp(1).