1PAM_RHOSTS(8)                  Linux-PAM Manual                  PAM_RHOSTS(8)
2
3
4

NAME

6       pam_rhosts - The rhosts PAM module
7

SYNOPSIS

9       pam_rhosts.so
10

DESCRIPTION

12       This module performs the standard network authentication for services,
13       as used by traditional implementations of rlogin and rsh etc.
14
15       The authentication mechanism of this module is based on the contents of
16       two files; /etc/hosts.equiv (or and ~/.rhosts. Firstly, hosts listed in
17       the former file are treated as equivalent to the localhost. Secondly,
18       entries in the user´s own copy of the latter file is used to map
19       "remote-host remote-user" pairs to that user´s account on the current
20       host. Access is granted to the user if their host is present in
21       /etc/hosts.equiv and their remote account is identical to their local
22       one, or if their remote account has an entry in their personal
23       configuration file.
24
25       The module authenticates a remote user (internally specified by the
26       item PAM_RUSER connecting from the remote host (internally specified by
27       the item PAM_RHOST). Accordingly, for applications to be compatible
28       this authentication module they must set these items prior to calling
29       pam_authenticate(). The module is not capable of independently probing
30       the network connection for such information.
31

OPTIONS

33       debug
34           Print debug information.
35
36       silent
37           Don´t print informative messages.
38
39       superuser=account
40           Handle account as root.
41

MODULE TYPES PROVIDED

43       Only the auth module type is provided.
44

RETURN VALUES

46       PAM_AUTH_ERR
47           The remote host, remote user name or the local user name couldn´t
48           be determined or access was denied by .rhosts file.
49
50       PAM_USER_UNKNOWN
51           User is not known to system.
52

EXAMPLES

54       To grant a remote user access by /etc/hosts.equiv or .rhosts for rsh
55       add the following lines to /etc/pam.d/rsh:
56
57           #%PAM-1.0
58           #
59           auth     required       pam_rhosts.so
60           auth     required       pam_nologin.so
61           auth     required       pam_env.so
62           auth     required       pam_unix.so
63
64
65

SEE ALSO

67       rootok(3), hosts.equiv(5), rhosts(5), pam.conf(5), pam.d(5), pam(8)
68

AUTHOR

70       pam_rhosts was written by Thorsten Kukuk <kukuk@thkukuk.de>
71
72
73
74Linux-PAM Manual                  03/02/2009                     PAM_RHOSTS(8)
Impressum