s4-dns: dlz_bind9: Fix ipv6 updates
[samba.git] / source3 / pam_smbpass / INSTALL
1
2 Because pam_smbpass is derived from the Samba smbpasswd utility, recent
3 versions of pam_smbpass require a copy of the Samba source code to be
4 available on the build system.  Version 0.7.5 has been tested against
5 Samba 2.2.0-alpha3, and this is the recommended version of Samba to use
6 for building pam_smbpass.  This only affects /building/ pam_smbpass; you
7 can still run any version of the Samba server that you want, although
8 clearly it saves some disk space to have only one copy of the source
9 code on your system (Samba 2.2.0-alpha3 takes roughly 32MB of disk space
10 to build pam_smbpass).
11
12 Version 0.7.5 features a new build system to make it easier to build
13 pam_smbpass.
14
15
16 Using the new build system
17 ==========================
18
19 If you don't have a copy of the Samba source code on your machine, and you
20 don't have a preferred Samba version (or mirror site), you can build
21 pam_smbpass by just typing 'make'.
22
23 If you want to use a version other than 2.2.0-alpha3, or you want to
24 download the source code from a faster Samba mirror (see
25 <http://us1.samba.org/samba/> for a list of mirror sites), please download
26 the source code and unpack it before running make.  The build scripts will
27 attempt to autodetect your Samba source directory, and if it can't be
28 found automatically, you will be given the opportunity to specify an
29 alternate directory for the Samba sources.
30
31 Feedback is welcome if you try (or succeed!) to build pam_smbpass with
32 other versions of Samba.
33
34
35 Options to 'make'
36 =================
37
38 By default, pam_smbpass will configure the Samba build tree with the
39 options
40
41     --with-fhs --with-privatedir=/etc --with-configdir=/etc
42
43 This will configure pam_smbpass to look for the smbpasswd file as
44 /etc/smbpasswd (or /etc/smbpasswd.tdb), and the smb.conf file as
45 /etc/smb.conf.  You can override these options by setting CONFIGOPTS when
46 calling make.  E.g., if you have your smb.conf file in /usr/etc and your
47 smbpasswd file in /usr/etc/private, you might run
48
49     make CONFIGOPTS="--with-privatedir=/usr/etc/private --with-configdir=/usr/etc"
50
51 For a complete list of available configuration options, see
52 './samba/configure --help'
53
54
55 Installing the module
56 =====================
57
58 If all goes well in the build process, the file pam_smbpass.so will be
59 created in the current directory.  Simply install the module into your
60 system's PAM module directory:
61
62         install -m 755 -s bin/pam_smbpass.so /lib/security
63
64 and you're all set.