granicus.if.org Git - linux-pam/blob - README

   1
   2 Hello!
   3
   4 Thanks for downloading Linux-PAM.
   5
   6 NOTES:
   7
   8 How to use it is as follows:
   9
  10 If you check out the sources from git, install Autotools and generate
  11 configuration scripts:
  12
  13       ./autogen.sh
  14
  15 Then compile:
  16
  17       ./configure --help | less
  18       ./configure <your-options>
  19       make
  20
  21 To make sure everything was compiled correct, run:
  22
  23       make check
  24
  25 If a test fails, you should not continue to install this build.
  26 These tests require a suitable file /etc/pam.d/other; if necessary,
  27 create such a file containing, e.g., these five lines (not indented)
  28
  29         #%PAM-1.0
  30         auth     required       pam_deny.so
  31         account  required       pam_deny.so
  32         password required       pam_deny.so
  33         session  required       pam_deny.so
  34
  35
  36 Note, if you are worried - don't even think about doing the next line
  37 (most Linux distributions already support PAM out of the box, so if
  38 something goes wrong with installing the code from this version your
  39 box may stop working..)
  40
  41       make install
  42
  43 That said, please report problems to the bug reporting database
  44 on sourceforge.net.
  45
  46 You can run additional checks after installing by executing
  47
  48       make xtests
  49
  50 as root.
  51
  52 WARNING: Running "make xtests" can overwrite configuration data
  53 or make the system insecure/unfunctional for a short time!
  54 Backup all important data before!
  55
  56
  57 If you do not wish to make the modules dynamically loadable, but
  58 build a static libpam including all PAM modules, you have to call:
  59
  60       ./configure --enable-static-modules --disable-pie
  61
  62 To run the build checks with static modules, you need to run the
  63 following command: make -C test check && make check
  64
  65
  66 To regenerate manual pages from the XML source files you need the
  67 docbook-xsl stylesheets in version 1.69.1 or newer, older versions had
  68 a bug which generates a broken layout.