Mercurial > dovecot > original-hg > dovecot-1.2

comparison INSTALL @ 1157:d8d8ec83c2f7 HEAD

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated
author Timo Sirainen <tss@iki.fi>
date Tue, 11 Feb 2003 22:38:34 +0200
parents 3fa9e363cd3d
children d346da6de29d
comparison
equal deleted inserted replaced
1156:cd46f47d559f 1157:d8d8ec83c2f7
1 Build instructions 1 Build Instructions
2 ------------------ 2 ------------------
3 3
4 For most people, the usual: 4 For most people, the usual:
5 5
6 ./configure 6 ./configure
25 25
26 For GNUTLS support you need version 0.5.5 or later. You can get GNUTLS from 26 For GNUTLS support you need version 0.5.5 or later. You can get GNUTLS from
27 http://www.gnutls.org/ 27 http://www.gnutls.org/
28 28
29 29
30 Optional configure options 30 Optional Configure Options
31 -------------------------- 31 --------------------------
32 32
33 You can get a full list with: 33 You can get a full list with:
34 34
35 ./configure --help 35 ./configure --help
58 speed up x86 systems too. Default is 8 with everyone to make sure 64bit 58 speed up x86 systems too. Default is 8 with everyone to make sure 64bit
59 memory accessing work. Currently it should also be safe to set to 4 when 59 memory accessing work. Currently it should also be safe to set to 4 when
60 using 32bit file offets. With x86 it could be 1 as well if you want to save 60 using 32bit file offets. With x86 it could be 1 as well if you want to save
61 a bit of disk space (in .imap.index.data file) and memory. 61 a bit of disk space (in .imap.index.data file) and memory.
62 62
63 Specifies memory alignment to use. Many non-x86 systems require this 63 --with-rawlog Build support for logging user traffic
64 64
65 With many non-x86 systems this is 65 When Dovecot is compiled with this option and user's home directory
66 required to be 64bit (8 bytes) since all 64bit memo 66 contains rawlog directory, all IMAP connections are logged into
67 timstamp-pid.in and .out files. This is mostly useful for debugging.
68
69 --enable-debug Enable some extra checks for debugging
70
71 This is mostly useful for developers. It does quite a lot of unnecessary
72 work but should catch some programming mistakes more quickly.
73
74 --with-ssl=gnutls|openssl Build with GNUTLS (default) or OpenSSL
75 --with-ssldir=DIR SSL base directory for certificates (/etc/ssl)
76
77 SSL options.
78
79 --with-pop3d Build POP3 server (default)
80
81 Build pop3d binary. It still has to be separately enabled from configuration
82 file.
67 83
68 --with-passwd Build with /etc/passwd support (default) 84 --with-passwd Build with /etc/passwd support (default)
69 --with-passwd-file Build with passwd-like file support (default) 85 --with-passwd-file Build with passwd-like file support (default)
70 --with-shadow Build with shadow password support (default) 86 --with-shadow Build with shadow password support (default)
71 --with-pam Build with PAM support (default) 87 --with-pam Build with PAM support (default)
88 --with-ldap Build with LDAP support
72 --with-vpopmail Build with vpopmail support (default) 89 --with-vpopmail Build with vpopmail support (default)
90 --with-static-userdb Build with static userdb support (default)
73 91
74 Specify which authentication modules to use. Disabling them give you a few 92 Specify which authentication modules to use. Disabling them give you a few
75 bytes smaller binary, but not much else. 93 bytes smaller binary, but not much else.
76 94
77 --with-ssl=gnutls|openssl Build with GNUTLS (default) or OpenSSL
78 95
79 Specify wanted SSL library. 96 Dynamic Authentication Modules
97 ------------------------------
98
99 Dovecot can also dynamically load authentication modules from
100 $prefix/lib/dovecot/auth/ directory. Binary packages builders should use
101 them for auth modules which require external libraries (eg. LDAP and
102 vpopmail). There's no standard way to build them as modules currently, but
103 something like this should work:
104
105 gcc -shared -DUSERDB_LDAP -DPASSDB_LDAP -I../.. -I../lib -I../lib-settings \
106 db-ldap.c userdb-ldap.c passdb-ldap.c -o ldap.so \
107 ../lib-settings/libsettings.a -lldap
108
109 gcc -shared -DUSERDB_VPOPMAIL -DPASSDB_VPOPMAIL -I../.. -I../lib \
110 userdb-vpopmail.c passdb-ldap.c -o vpopmail.so -lvpopmail
111
112 Including libsettings.a in ldap.so is kind of annoying, but it's not
113 currently needed elsewhere in dovecot-auth.