
   [[1]Index] [[2]Installation] [[3]Configuration] [[4]Frequently Asked
   Questions]

                   mod_auth_pam Installation Instructions

Requirements

   Apache, v1.3.x
          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: [5]http://www.apache.org/dist/

   Linux-PAM 0.64+ (0.68 or higher is recommended)
          If  your  system  does  not  include Linux-PAM by default, this
          module is probably not what you want!
          [6]more information on Linux-PAM

Compiling the source code

   If  this is your first Apache module, skip the following paragraph and
   go directly to [7]dynamic shared object module.

   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 strongly 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 [8]a very detailed explanation of DSO modules.

   Now, here's what you have to do:
     * dynamic shared object (DSO) module
         1. cd to the directory where you unpacked the sources
         2. Type "make" and then "make install"
         3. Restart Apache
     * static module
         1. Put  mod_auth_pam.c  into  the src/modules/extra directory of
            your Apache source-tree
         2. configure      with     LIBS="-lpam     -ldl"     ./configure
            --activate-module=src/modules/extra/mod_auth_pam.o   (all  on
            one  line  and  in  addition ot any other options you usually
            require)
         3. Proceed with compilation and installation as usual

   If everything went smoothly, proceed with [9]Configuring mod_auth_pam.
   If  you  ran  into  an error, please check out the [10]Apache Guide to
   DSO's.

References

   1. http://pam.sourceforge.net/mod_auth_pam/
   2. http://pam.sourceforge.net/mod_auth_pam/install.html
   3. http://pam.sourceforge.net/mod_auth_pam/configure.html
   4. http://pam.sourceforge.net/mod_auth_pam/faq.html
   5. http://www.apache.org/dist/
   6. http://www.de.kernel.org/pub/linux/libs/pam/
   7. http://pam.sourceforge.net/mod_auth_pam/install.html#dso
   8. http://www.apache.org/docs/dso.html
   9. http://pam.sourceforge.net/mod_auth_pam/configure.html
  10. http://www.apache.org/docs/dso.html
