summaryrefslogtreecommitdiff
path: root/README
blob: 364890db7f5e7b9b2921395d8023d1a8b280de87 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
Hello!

Thanks for downloading Linux-PAM.

NOTES:

How to use it is as follows:

      ./configure --help | less
      ./configure <your-options>
      make

To make sure everything was compiled correct, run:

      make check

If a test failes, you should not continue to install this build.

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
on sourceforge.net.

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!

If you do not wish to make the modules dynamically loadable, but
build a static libpam including all PAM modules, you have to call:

      ./configure --enable-static-modules

In this case you cannot use pam_unix in the PAM config files instead you
have to use pam_unix_acct, pam_unix_auth, pam_unix_passwd and
pam_unix_session.

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.