/ [pam-modules] / trunk / README
To checkout: svn checkout http://svn.gnu.org.ua/sources/pam-modules/trunk/README
Puszcza

Contents of /trunk/README

Parent Directory Parent Directory | Revision Log Revision Log


Revision 117 - (show annotations)
Thu Sep 29 00:31:48 2011 UTC (10 years, 2 months ago) by gray
File size: 3324 byte(s)
Allow installers to link modules with alternative crypt(3) implementations.

* configure.ac: New option --with-crypt-lib.
* README: Document new configuration option.


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

Properties

Name Value
svn:eol-style native
svn:keywords Author Date Id Revision

Send suggestions and bug reports to Sergey Poznyakoff
ViewVC Help
Powered by ViewVC 1.1.20