Blame README

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