netrc, .netrc - Specifies automatic login information for ftp
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):
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
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.
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.
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
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.
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
Contains automatic login information.