%general-entities; ]> $LastChangedBy$ $Date$ Linux-PAM-&linux-pam-version; Linux-PAM Introduction to Linux-PAM The Linux-PAM package contains Pluggable Authentication Modules. This is useful to enable the local system administrator to choose how applications authenticate users. Package Information Download (HTTP): Download (FTP): Download MD5 sum: &linux-pam-md5sum; Download size: &linux-pam-size; Estimated disk space required: &linux-pam-buildsize; Estimated build time: &linux-pam-time; Additional Downloads Optional documentation: Linux-PAM Dependencies Optional and Prelude Optional (To {,Re}build the Documentation) , , , , and User Notes: Installation of Linux-PAM If you downloaded the documentation, unpack the tarball from the same top-level directory you unpacked the source tarball from. The files will unpack into the correct directories of the source tree. Install Linux-PAM by running the following commands: ./configure --libdir=/lib \ --sbindir=/lib/security \ --enable-securedir=/lib/security \ --docdir=/usr/share/doc/Linux-PAM-&linux-pam-version; \ --enable-read-both-confs && make The test suite will not provide meaningful results until the package has been installed and minimally configured. If, after installing the package and creating a minimum configuration as shown below in the 'other' example, you wish to run the tests, issue make check. Now, as the root user: make install && chmod -v 4755 /lib/security/unix_chkpwd && mv -v /lib/security/pam_tally /sbin && mv -v /lib/libpam{,c,_misc}.la /usr/lib && sed -i 's| /lib| /usr/lib|' /usr/lib/libpam_misc.la && for LINK in libpam{,c,_misc}.so; do ln -v -sf ../../lib/$(readlink /lib/${LINK}) /usr/lib/${LINK} && rm -v /lib/${LINK} done Command Explanations --libdir=/lib: This parameter results in the libraries being installed in /lib as they may be required in single-user mode. --sbindir=/lib/security: This parameter results in two executables, one of which is not intended to be run from the command line, being installed in the same directory as the PAM modules. The other executable is later moved to the /sbin directory. --enable-securedir=/lib/security: This parameter results in the PAM modules being installed in /lib/security. --docdir=...: This parameter results in the documentation being installed in a versioned directory name. --enable-read-both-confs: This parameter allows the local administrator to choose which configuration file setup to use. chmod -v 4755 /lib/security/unix_chkpwd: The unix_chkpwd password-helper program must be setuid so that non-root processes can access the shadow-password file. mv -v /lib/security/pam_tally /sbin: The pam_tally program is designed to be run by the system administrator, possibly in single-user mode, so it is moved to the appropriate directory. mv -v /lib/libpam{,c,_misc}.la /usr/lib: This command moves the Libtool library files to /usr/lib as they are expected to reside there. sed -i 's| /lib| /usr/lib|' /usr/lib/libpam_misc.la: This command corrects an installation reference due to the file being moved in the previous step. for ...; do ...; done: These commands are used to relocate the .so symbolic links into the /usr/lib directory by cloning and then removing the existing symlinks. Using readlink ensures the new symlinks point at the correct library filenames. Configuring Linux-PAM Config Files /etc/security/* and /etc/pam.d/* or /etc/pam.conf /etc/security/* /etc/pam.d/* /etc/pam.conf Configuration Information Configuration information is placed in /etc/pam.d/ or /etc/pam.conf depending on system administrator preference. Below are example files of each type: # Begin /etc/pam.d/other auth required pam_unix.so nullok account required pam_unix.so session required pam_unix.so password required pam_unix.so nullok # End /etc/pam.d/other # Begin /etc/pam.conf other auth required pam_unix.so nullok other account required pam_unix.so other session required pam_unix.so other password required pam_unix.so nullok # End /etc/pam.conf The PAM man page (man pam) provides a good starting point for descriptions of fields and allowable entries. The Linux-PAM System Administrators' Guide is recommended for additional information. Refer to for a list of various modules available. You should now reinstall the package. Contents Installed Program Installed Libraries Installed Directories pam_tally libpam.{so,a}, libpamc.{so,a}, and libpam_misc.{so,a} /etc/pam.d, /etc/security, /lib/security and /usr/include/security Short Descriptions pam_tally is used to view or manipulate the faillog file. pam_tally libpam.{so,a} provides the interfaces between applications and the PAM modules. libpam.{so,a}