netrc man page
netrc, .netrc — user configuration for ftp
This file contains configuration and autologin information for the File Transfer Protocol client ftp(1).
.netrc file contains login and initialization information used by the auto-login process. It resides in the user's home directory. The following tokens are recognized; they may be separated by spaces, tabs, or new-lines:
- Identify a remote machine
name. The auto-login process searches the
.netrcfile for a
machinetoken that matches the remote machine specified on the ftp command line or as an
opencommand argument. Once a match is made, the subsequent
.netrctokens are processed, stopping when the end of file is reached or another
defaulttoken is encountered.
- This is the same as
defaultmatches any name. There can be only one
defaulttoken, and it must be after all
machinetokens. This is normally used as:
default login anonymous password user@site
thereby giving the user
automaticanonymous ftp login to machines not specified in
.netrc. This can be overridden by using the -n flag to disable auto-login.
- Identify a user on the remote machine. If this token is present, the auto-login process will initiate a login using the specified
- 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
.netrcfile for any user other than
anonymous, ftp will abort the auto-login process if the
.netrcis readable by anyone besides the user.
- 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.
- Define a macro. This token functions like the ftp
macdefcommand functions. A macro is defined with the specified name; its contents begin with the next
.netrcline and continue until a null line (consecutive new-line characters) is encountered. If a macro named
initis defined, it is automatically executed as the last step in the auto-login process.
curl(1), fetchmail(1), ftp(1), mc(1), mpop(1), msmtp(1), transmission-remote(1).