From 4463902ff272d0ee5be8757768a6491e681c332e Mon Sep 17 00:00:00 2001 From: Thorsten Kukuk Date: Tue, 18 Dec 2007 12:55:38 +0000 Subject: Relevant BUGIDs: 1822779, 1822764 Purpose of commit: docufix Commit summary: --------------- 2007-12-18 Thorsten Kukuk * README: Document how to run make check with static modules (SF#1822779). 2007-12-18 Peter Breitenlohner * README: Document that "make check" requires a file /etc/pam.d/other (SF#1822764). --- ChangeLog | 9 +++++++++ README | 16 +++++++++++++++- 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index af4bf132..a5cc2818 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,12 @@ +2007-12-18 Thorsten Kukuk + + * README: Document how to run make check with static modules + (SF#1822779). + +2007-12-18 Peter Breitenlohner + * README: Document that "make check" requires a file + /etc/pam.d/other (SF#1822764). + 2007-12-12 Eamon Walsh * doc/man/pam_item_types_ext.inc.xml: More appropriate wording diff --git a/README b/README index 364890db..86cf1838 100644 --- 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. -- cgit v1.2.3