.\" Copyright (c) 1995 Peter Tobias <tobias@et-inf.fho-emden.de>
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" This file may be distributed under the GNU General Public License.
+.\" %%%LICENSE_END
.TH HOSTS.EQUIV 5 2003-08-24 "Linux" "Linux Programmer's Manual"
.SH NAME
/etc/hosts.equiv \- list of hosts and users that are granted "trusted"
-\fBr\fP command access to your system
+.B r
+command access to your system
.SH DESCRIPTION
-The \fBhosts.equiv\fP file allows or denies hosts and users to use
-the \fBr\fP-commands (e.g., \fBrlogin\fP, \fBrsh\fP or \fBrcp\fP) without
+The
+.B hosts.equiv
+file allows or denies hosts and users to use
+the \fBr\fP-commands (e.g.,
+.BR rlogin ,
+.BR rsh ,
+or
+.BR rcp )
+without
supplying a password.
.PP
The file uses the following format:
.TP
\fI[ + | \- ]\fP \fI[hostname]\fP \fI[username]\fP
.PP
-The \fIhostname\fP is the name of a host which is logically equivalent
+The
+.I hostname
+is the name of a host which is logically equivalent
to the local host.
Users logged into that host are allowed to access
like-named user accounts on the local host without supplying a password.
-The \fIhostname\fP may be (optionally) preceded by a plus (+) sign.
-If the plus sign is used alone it allows any host to access your system.
-You can explicitly deny access to a host by preceding the \fIhostname\fP
+The
+.I hostname
+may be (optionally) preceded by a plus (+) sign.
+If the plus sign is used alone, it allows any host to access your system.
+You can explicitly deny access to a host by preceding the
+.I hostname
by a minus (\-) sign.
Users from that host must always supply a password.
For security reasons you should always use the FQDN of the hostname and
not the short hostname.
.PP
-The \fIusername\fP entry grants a specific user access to all user
+The
+.I username
+entry grants a specific user access to all user
accounts (except root) without supplying a password.
That means the
user is NOT restricted to like-named accounts.
-The \fIusername\fP may
+The
+.I username
+may
be (optionally) preceded by a plus (+) sign.
You can also explicitly
-deny access to a specific user by preceding the \fIusername\fP with
+deny access to a specific user by preceding the
+.I username
+with
a minus (\-) sign.
This says that the user is not trusted no matter
what other entries for that host exist.
.SH FILES
.I /etc/hosts.equiv
.SH NOTES
-Some systems will only honor the contents of this file when it has owner
+Some systems will honor the contents of this file only when it has owner
root and no write permission for anybody else.
Some exceptionally
paranoid systems even require that there be no other hard links to the file.
.PP
Modern systems use the Pluggable Authentication Modules library (PAM).
-With PAM a standalone plus sign is only considered a wildcard
-character which means "any host" when the word
+With PAM a standalone plus sign is considered a wildcard
+character which means "any host" only when the word
.I promiscuous
is added to the auth component line in your PAM file for
the particular service
.RB "(e.g., " rlogin ).
-.SH "SEE ALSO"
+.SH SEE ALSO
.BR rhosts (5),
.BR rlogind (8),
.BR rshd (8)
+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.