source: trunk-3.0/source/pam_smbpass/INSTALL@ 101

Last change on this file since 101 was 1, checked in by Paul Smedley, 19 years ago

Initial code import

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