Current File : //usr/share/doc/pam-1.1.8/html/sag-pam_rhosts.html
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>6.26. pam_rhosts - grant access using .rhosts file</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="Linux-PAM_SAG.html" title="The Linux-PAM System Administrators' Guide"><link rel="up" href="sag-module-reference.html" title="Chapter 6. A reference guide for available modules"><link rel="prev" href="sag-pam_pwhistory.html" title="6.25. pam_pwhistory - grant access using .pwhistory file"><link rel="next" href="sag-pam_rootok.html" title="6.27. pam_rootok - gain only root access"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.26. pam_rhosts - grant access using .rhosts file</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sag-pam_pwhistory.html">Prev</a> </td><th width="60%" align="center">Chapter 6. A reference guide for available modules</th><td width="20%" align="right"> <a accesskey="n" href="sag-pam_rootok.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sag-pam_rhosts"></a>6.26. pam_rhosts - grant access using .rhosts file</h2></div></div></div><div class="cmdsynopsis"><p><code class="command">pam_rhosts.so</code> </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="sag-pam_rhosts-description"></a>6.26.1. DESCRIPTION</h3></div></div></div><p>
This module performs the standard network authentication for services,
as used by traditional implementations of <span class="command"><strong>rlogin</strong></span>
and <span class="command"><strong>rsh</strong></span> etc.
</p><p>
The authentication mechanism of this module is based on the contents
of two files; <code class="filename">/etc/hosts.equiv</code> (or
and <code class="filename">~/.rhosts</code>. 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
"<span class="emphasis"><em>remote-host remote-user</em></span>" pairs to that user's
account on the current host. Access is granted to the user if their
host is present in <code class="filename">/etc/hosts.equiv</code> and their
remote account is identical to their local one, or if their remote
account has an entry in their personal configuration file.
</p><p>
The module authenticates a remote user (internally specified by the
item <em class="parameter"><code>PAM_RUSER</code></em> connecting from the remote
host (internally specified by the item <span class="command"><strong>PAM_RHOST</strong></span>).
Accordingly, for applications to be compatible this authentication
module they must set these items prior to calling
<code class="function">pam_authenticate()</code>. The module is not capable
of independently probing the network connection for such information.
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="sag-pam_rhosts-options"></a>6.26.2. OPTIONS</h3></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="option">debug</code>
</span></dt><dd><p>
Print debug information.
</p></dd><dt><span class="term">
<code class="option">silent</code>
</span></dt><dd><p>
Don't print informative messages.
</p></dd><dt><span class="term">
<code class="option">superuser=<em class="replaceable"><code>account</code></em></code>
</span></dt><dd><p>
Handle <em class="replaceable"><code>account</code></em> as root.
</p></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="sag-pam_rhosts-types"></a>6.26.3. MODULE TYPES PROVIDED</h3></div></div></div><p>
Only the <code class="option">auth</code> module type is provided.
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="sag-pam_rhosts-return_values"></a>6.26.4. RETURN VALUES</h3></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">PAM_AUTH_ERR</span></dt><dd><p>
The remote host, remote user name or the local user name
couldn't be determined or access was denied by
<code class="filename">.rhosts</code> file.
</p></dd><dt><span class="term">PAM_USER_UNKNOWN</span></dt><dd><p>
User is not known to system.
</p></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="sag-pam_rhosts-examples"></a>6.26.5. EXAMPLES</h3></div></div></div><p>
To grant a remote user access by <code class="filename">/etc/hosts.equiv</code>
or <code class="filename">.rhosts</code> for <span class="command"><strong>rsh</strong></span> add the
following lines to <code class="filename">/etc/pam.d/rsh</code>:
</p><pre class="programlisting">
#%PAM-1.0
#
auth required pam_rhosts.so
auth required pam_nologin.so
auth required pam_env.so
auth required pam_unix.so
</pre><p>
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="sag-pam_rhosts-author"></a>6.26.6. AUTHOR</h3></div></div></div><p>
pam_rhosts was written by Thorsten Kukuk <kukuk@thkukuk.de>
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sag-pam_pwhistory.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sag-module-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sag-pam_rootok.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.25. pam_pwhistory - grant access using .pwhistory file </td><td width="20%" align="center"><a accesskey="h" href="Linux-PAM_SAG.html">Home</a></td><td width="40%" align="right" valign="top"> 6.27. pam_rootok - gain only root access</td></tr></table></div></body></html>
Mini Shell