PAM_RHOSTS

Section: Linux\-PAM Manual (8)
Updated: 03/02/2009
Index Return to Main Contents
pam_rhosts - The rhosts PAM module  

Synopsis

pam_rhosts.so
 

DESCRIPTION

This module performs the standard network authentication for services, as used by traditional implementations of rlogin and rsh etc.

The authentication mechanism of this module is based on the contents of two files; FC/etc/hosts.equivF[] (or and FC~/.rhostsF[]. Firstly, hosts listed in the former file are treated as equivalent to the localhost. Secondly, entries in the user's own copy of the latter file is used to map "remote-host remote-user" pairs to that user's account on the current host. Access is granted to the user if their host is present in FC/etc/hosts.equivF[] and their remote account is identical to their local one, or if their remote account has an entry in their personal configuration file.

The module authenticates a remote user (internally specified by the item PAM_RUSER connecting from the remote host (internally specified by the item PAM_RHOST). Accordingly, for applications to be compatible this authentication module they must set these items prior to calling pam_authenticate(). The module is not capable of independently probing the network connection for such information.  

OPTIONS

debug

Print debug information.

silent

Don't print informative messages.

superuser=account

Handle account as root.
 

MODULE TYPES PROVIDED

Only the auth module type is provided.  

RETURN VALUES

PAM_AUTH_ERR

The remote host, remote user name or the local user name couldn't be determined or access was denied by FC.rhostsF[] file.

PAM_USER_UNKNOWN

User is not known to system.
 

EXAMPLES

To grant a remote user access by FC/etc/hosts.equivF[] or FC.rhostsF[] for rsh add the following lines to FC/etc/pam.d/rshF[]:



#%PAM-1.0
#
auth     required       pam_rhosts.so
auth     required       pam_nologin.so
auth     required       pam_env.so
auth     required       pam_unix.so
      

 

SEE ALSO

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

AUTHOR

pam_rhosts was written by Thorsten Kukuk <kukuk@thkukuk.de>


 

Index

Synopsis
DESCRIPTION
OPTIONS
MODULE TYPES PROVIDED
RETURN VALUES
EXAMPLES
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 05:34:28 GMT, December 24, 2015