Installing OpenPAM
                         ==================

1. REQUIREMENTS

 See the release notes for a list of platforms OpenPAM has been
 tested on.

 You will need the GNU autotools, GNU make and the GNU compiler suite
 to build OpenPAM.  On some platforms, you may have to install these
 separately.

2. CONFIGURATION

 Use the "configure" shell script to configure OpenPAM for your
 system.  Options include:

   --enable-debug
       Turn debugging on by default.

   --with-modules-dir=DIR
       Indicates the directory where PAM modules will be installed.
       This option should not be used if you intend to install PAM
       modules in the system library directory.

   --with-localbase=DIR
       Search for additional policies and modules in DIR/etc and
       DIR/lib respectively.  Defaults to the installation prefix if
       one was set, otherwise to the default installation prefix
       (usually /usr/local).

   --without-localbase
       Do not search for policies and modules anywhere else than /etc
       and /usr/lib.

   --without-doc
       Skips the documentation.

   --with-pam-unix
       Builds the sample PAM module.

   --with-su
       Builds the sample su(1) implementation.

 For more information about configuration options, use the --help
 option.

 A typical invocation might look like this:

 # ./configure --with-pam-unix --with-su

3. COMPILATION

 To compile OpenPAM, simply run "make" (or "gmake" on platforms where
 "make" is not GNU make) in the top-level OpenPAM directory:

 # make

4. INSTALLATION

 To install OpenPAM, simply run "make install" (or "gmake install" on
 platforms where "make" is not GNU make) in the top-level OpenPAM
 directory:

 # make install