diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 65 |
1 files changed, 65 insertions, 0 deletions
@@ -0,0 +1,65 @@ + +Hello! + +Thanks for downloading Linux-PAM. + +NOTES: + +How to use it is as follows: + + ./configure --help | less + ./configure <your-options> + make + +To make sure everything was compiled correct, run: + + make check + +If a test fails, you should not continue to install this build. +These tests require a suitable file /etc/pam.d/other; if necessary, +create such a file containing, e.g., these five lines (not indented) + + #%PAM-1.0 + auth required pam_deny.so + account required pam_deny.so + password required pam_deny.so + session required pam_deny.so + + +Note, if you are worried - don't even think about doing the next line +(most Linux distributions already support PAM out of the box, so if +something goes wrong with installing the code from this version your +box may stop working..) + + make install + +That said, please report problems to the bug reporting database +on sourceforge.net. + +You can run additional checks after installing by executing + + make xtests + +as root. + +WARNING: Running "make xtests" can overwrite configuration data +or make the system insecure/unfunctional for a short time! +Backup all important data before! + + +If you do not wish to make the modules dynamically loadable, but +build a static libpam including all PAM modules, you have to call: + + ./configure --enable-static-modules --disable-pie + +In this case you cannot use pam_unix in the PAM config files instead you +have to use pam_unix_acct, pam_unix_auth, pam_unix_passwd and +pam_unix_session. + +To run the build checks with static modules, you need to run the +following command: make -C test check && make check + + +To regenerate manual pages from the XML source files you need the +docbook-xsl stylesheets in version 1.69.1 or newer, older versions had +a bug which generates a broken layout. |