Relevant BUGIDs: 1822779, 1822764

Purpose of commit: docufix

Commit summary:
---------------

2007-12-18  Thorsten Kukuk <kukuk@thkukuk.de>

        * README: Document how to run make check with static modules
        (SF#1822779).

2007-12-18  Peter Breitenlohner <peb@mppmu.mpg.de>
        * README: Document that "make check" requires a file
        /etc/pam.d/other (SF#1822764).

diff --git a/ChangeLog b/ChangeLog
index af4bf132f65906224cdb6189e54c2247acd9bbf9..a5cc28181771bfd5e8fdfb91f8e280c449ccd859 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2007-12-18  Thorsten Kukuk <kukuk@thkukuk.de>
+
+       * README: Document how to run make check with static modules
+       (SF#1822779).
+
+2007-12-18  Peter Breitenlohner <peb@mppmu.mpg.de>
+       * README: Document that "make check" requires a file
+       /etc/pam.d/other (SF#1822764).
+
 2007-12-12  Eamon Walsh <ewalsh@tycho.nsa.gov>
 
        * doc/man/pam_item_types_ext.inc.xml: More appropriate wording

diff --git a/README b/README
index 364890db7f5e7b9b2921395d8023d1a8b280de87..86cf1838a68d67e73e8a560517cfa703b8a95f3e 100644 (file)
--- a/README
+++ b/README
@@ -15,7 +15,16 @@ To make sure everything was compiled correct, run:
 
       make check
 
-If a test failes, you should not continue to install this build.
+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
@@ -37,6 +46,7 @@ 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:
 
@@ -46,6 +56,10 @@ 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.