1PAM-modules README 2Copyright (C) 2001, 2004-2005, 2007, 2009-2012, 2014-2015, 2018 Sergey 3Poznyakoff 4See the end of file for copying conditions. 5 6* Introduction 7 8PAM-modules is a collection of some (hopefully) useful PAM 9modules. This file contains brief information about configuring and 10using them. It is *not* intended as a replacement for the 11documentation, it is provided as a brief reference only. The complete 12documentation for PAM-modules is available in doc/ subdirectory. To 13read it without installing the package run `info -f 14doc/pam-modules'. After installation, the documentation can be accessed 15running `info pam-modules'. 16 17The online copy of the documentation in various formats is available 18at http://puszcza.gnu.org.ua/software/pam-modules/manual. 19 20* Installation 21 22To install the package, do 23 24** ./configure [options] 25 26For the list of available options consult file INSTALL. 27The applications-specific options are: 28 29 --enable-debug 30 Enable additional debugging code. See description of the 31 `waitdebug' option in node `Introduction to PAM-modules' of 32 the documentation. 33 34 --with-pamdir=DIR 35 Set installation directory for PAM loadable files. 36 Default is PREFIX/lib/security. 37 38 --with-crypt-lib=NAME 39 Use libNAME instead of libcrypt. Use this if you wish to use 40 an external implementation of crypt(3). For example, a common 41 approach is to use libxcrypt, which provides a wider range of 42 encryption algorithms than the native crypt. To use it, one 43 would do the following: 44 45 ./configure --with-crypt-lib=xcrypt 46 47--without-crypt-lib 48 Do not link libcrypt. This option is provided for the sake of 49 really hard cases, when the user wants to supply an 50 alternative implementation of crypt, yet finds that 51 --with-crypt-lib is not enough for this. It is supposed that 52 the necessary libraries will be given in LDFLAGS variable, 53 e.g.: 54 55 ./configure --without-crypt-lib LDFLAGS=... 56 57Building of each particular MODULE can be disabled using the 58--disable-MODULE command line option. See the documentation for 59the list of available modules. 60 61** Run make 62 63** Run make install 64 65* Usage 66 67See the accompanying documentation for the detailed description. 68 69* Bug reporting 70 71Send bug reports to <bug-pam-modules@gnu.org.ua>. Read the chapter 72"Reporting Bugs" in the accompanying documentation for more information. 73 74 75* Copyright information: 76 77Copyright (C) 2001, 2004-2005, 2007, 2009-2014 Sergey Poznyakoff 78 79 Permission is granted to anyone to make or distribute verbatim copies 80 of this document as received, in any medium, provided that the 81 copyright notice and this permission notice are preserved, 82 thus giving the recipient permission to redistribute in turn. 83 84 Permission is granted to distribute modified versions 85 of this document, or of portions of it, 86 under the above conditions, provided also that they 87 carry prominent notices stating who last changed them. 88 89Local variables: 90mode: outline 91paragraph-separate: "[ ]*$" 92end: 93