diff options
author | Lorry <lorry@roadtrain.codethink.co.uk> | 2012-07-23 11:07:21 +0100 |
---|---|---|
committer | Lorry <lorry@roadtrain.codethink.co.uk> | 2012-07-23 11:07:21 +0100 |
commit | 7e99712021a572e6ca85ff8454d3b322bfbeaa6e (patch) | |
tree | 6577e57ca2aab59b4b6ed8f21dfdbe349c028e49 /README | |
download | linux-pam-7e99712021a572e6ca85ff8454d3b322bfbeaa6e.tar.gz |
Tarball conversion
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. |