Manual page for NETRC(5)
netrc - file for ftp remote login data
DESCRIPTION
The
.netrc
file contains data for logging in to a
remote host over the network for file transfers by
ftp.1c
This file resides in the user's home directory
on the machine initiating the file transfer.
Its permissions should be set to
disallow read access by group and others (see
chmod.1v
The following tokens
are recognized; they may be separated by
SPACE,
TAB,
or
NEWLINE
characters:
- machinename
-
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
EOF
is reached or another
machine
token is encountered.
- 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: if this token is present in the
.netrc
file,
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
command if it does not.
- macdef name
-
Define a macro.
This token functions as the
ftp
macdef
command functions. A macro is defined with the
specified name; 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.
EXAMPLE
The command:
machine ray login demo password mypassword
allows an autologin to the machine
ray
using the login name
demo
with password
mypassword.
FILES
- ~/.netrc
-
SEE ALSO
chmod.1v
ftp.1c
ftpd.8c
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97