<html>
<head>
<title>mod_auth_pam: Installation</title>
</head>
<body bgcolor="white" text="black">
<h1 align=center>mod_auth_pam Installation Instructions</h1>
<h2>Requirements</h2>
<dl>
<dt>Apache, v1.3.x<dd>Apache is the worlds most widely used
web-server and included with all Linux distributions I know
of. The current source code, in case you want to compile it
yourself, can be retrieved from: <a
href="http://www.apache.org/dist/">http://www.apache.org/dist/</a>
<dt>Linux-PAM 0.64+ (0.68 or higher is recommended)<dd> If
your system does not include Linux-PAM by default, this module
is probably not what you want!
<dd><a href="http://www.de.kernel.org/pub/linux/libs/pam/">more information on Linux-PAM</a>
</dl>
<h2>Compiling the source code</h2>
If this is your first Apache module, skip the following
paragraph and go directly to <a href="#dso">dynamic shared
object module</a>.
<p>
mod_auth_pam is as standard as it gets with respect to module
installation, so if you are familiar with installing and using
3rd party modules, you should have no trouble at all and can
use any of the supported installation methods. I
<em>strongly</em> recommend using the DSO method, as it is by
far the easiest way and will give you a working system in no
time. If you are looking for more information, the Apache
Group has written <a
href="http://www.apache.org/docs/dso.html">a very detailed
explanation of DSO modules</a>.
<p>
Now, here's what you have to do:
<ul>
<li><a name="dso">dynamic shared object</a> (DSO) module
<p align="justify">
<ol>
<li><tt>cd</tt> to the directory where you unpacked the sources
<li>Type "<tt>make</tt>" and then "<tt>make install</tt>"
<li>Restart Apache
</ol>
</p>
<li>static module
<p>
<ol>
<li>Put <tt>mod_auth_pam.c</tt> into the <tt>src/modules/extra</tt> directory of your Apache source-tree
<li>configure with <tt>LIBS="-lpam -ldl" ./configure --activate-module=src/modules/extra/mod_auth_pam.o</tt> (all on one line and in addition ot any other options you usually require)
<li>Proceed with compilation and installation as usual
</ol>
</ul>
</p>
<p>
If everything went smoothly, proceed with <a
href="configure.html">Configuring mod_auth_pam</a>. If you ran
into an error, please check out the <a
href="http://www.apache.org/docs/dso.html">Apache Guide to
DSO's</a>.
</p>G
<hr noshade>
<p>
<address>Copyright © 2000 by <a href="mailto:ingo@blank.pages.de">Ingo Lütkebohle</a></address>
</body>
</html>
