Linux-PAM  1.5.1
About: Linux-PAM is the Pluggable Authentication Modules for Linux.
  Fossies Dox: Linux-PAM-1.5.1.tar.xz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

Linux-PAM Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies Linux-PAM-1.5.1.tar.xz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README
Hello!

Thanks for downloading Linux-PAM.

NOTES:

How to use it is as follows:

Please look at the ci/install_dependencies.sh for the necessary
prerequisite packages to be able to build the Linux-PAM. The script
is targeted at Debian based Linux distributions so the package
names and availability might differ on other distributions.

If you check out the sources from git, install Autotools and generate
configuration scripts, ensuring you have the minimum packages installed,
the ci scripts may help here:

      ./autogen.sh

Then compile:

      ./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
at https://github.com/linux-pam/linux-pam/issues .

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!

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.