Mercurial > dovecot > original-hg > dovecot-1.2
annotate INSTALL @ 1190:c54c61822d27 HEAD
s/ldap/vpopmail/ in vpopmail.so example
| author | Timo Sirainen <tss@iki.fi> |
|---|---|
| date | Tue, 18 Feb 2003 21:09:18 +0200 |
| parents | 8a93dff28e13 |
| children | 2d8af547a8b4 |
| rev | line source |
|---|---|
| 1157 | 1 Build Instructions |
| 428 | 2 ------------------ |
| 3 | |
| 4 For most people, the usual: | |
| 5 | |
| 6 ./configure | |
| 7 make | |
| 8 sudo make install | |
| 9 | |
| 10 is enough. This installs Dovecot under /usr/local. You must also rename the | |
| 11 configuration file to get it to work: | |
| 12 | |
| 13 mv /usr/local/etc/dovecot-example.conf /usr/local/etc/dovecot.conf | |
| 14 | |
| 15 Read through it, make needed modifications and start imap-master. | |
| 429 | 16 doc/configuration.txt tells you more about configuring Dovecot. |
| 17 | |
| 428 | 18 |
| 19 SSL/TLS | |
| 20 ------- | |
| 21 | |
| 623 | 22 Dovecot supports both GNUTLS and OpenSSL. Dovecot prefers GNUTLS if it's |
| 23 found, but fallbacks to OpenSSL. If you wish to force using OpenSSL, give | |
| 24 --with-ssl=openssl to configure. | |
| 25 | |
| 26 For GNUTLS support you need version 0.5.5 or later. You can get GNUTLS from | |
| 27 http://www.gnutls.org/ | |
| 428 | 28 |
| 429 | 29 |
| 1157 | 30 Optional Configure Options |
| 428 | 31 -------------------------- |
| 32 | |
| 33 You can get a full list with: | |
| 34 | |
| 35 ./configure --help | |
| 36 | |
| 37 The options are listed like --with-thing or --enable-thing, usually they're | |
| 38 also enabled by default. You can disable them with --without-thing or | |
| 39 --disable-thing. | |
| 40 | |
| 41 Besides the standard options, Dovecot has added these: | |
| 42 | |
| 43 --enable-ipv6 Enable IPv6 support (default) | |
| 44 | |
| 45 Enable IPv6 support. By default it's enabled if system is detected to | |
| 46 support it. | |
| 47 | |
| 48 --with-file-offset-size=BITS | |
| 49 | |
| 50 Specifies if we use 32bit or 64bit file offsets. 64bit is default if system | |
| 51 supports it (Linux and Solaris does). You most likely won't have mails | |
| 52 larger than 2GB, so you may want to drop this to 32bit for a bit smaller | |
| 53 disk and memory usage. | |
| 54 | |
|
439
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
55 --with-mem-align=BYTES |
|
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
56 |
|
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
57 Specifies memory alignment, needed with many non-x86 systems and should |
|
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
58 speed up x86 systems too. Default is 8 with everyone to make sure 64bit |
|
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
59 memory accessing work. Currently it should also be safe to set to 4 when |
|
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
60 using 32bit file offets. With x86 it could be 1 as well if you want to save |
|
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
61 a bit of disk space (in .imap.index.data file) and memory. |
|
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
62 |
| 1157 | 63 --with-rawlog Build support for logging user traffic |
| 64 | |
| 65 When Dovecot is compiled with this option and user's home directory | |
| 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 | |
|
439
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
70 |
| 1157 | 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. | |
|
439
b66ccecbc8a6
Added --with-mem-align=BYTES option
Timo Sirainen <tss@iki.fi>
parents:
429
diff
changeset
|
83 |
| 428 | 84 --with-passwd Build with /etc/passwd support (default) |
| 85 --with-passwd-file Build with passwd-like file support (default) | |
| 86 --with-shadow Build with shadow password support (default) | |
| 87 --with-pam Build with PAM support (default) | |
| 1157 | 88 --with-ldap Build with LDAP support |
| 428 | 89 --with-vpopmail Build with vpopmail support (default) |
| 1157 | 90 --with-static-userdb Build with static userdb support (default) |
| 428 | 91 |
| 92 Specify which authentication modules to use. Disabling them give you a few | |
| 93 bytes smaller binary, but not much else. | |
| 94 | |
| 1157 | 95 |
| 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: | |
| 428 | 104 |
| 1159 | 105 gcc -shared -fPIC -DUSERDB_LDAP -DPASSDB_LDAP \ |
| 106 -I../.. -I../lib -I../lib-settings \ | |
| 1157 | 107 db-ldap.c userdb-ldap.c passdb-ldap.c -o ldap.so \ |
| 108 ../lib-settings/libsettings.a -lldap | |
| 109 | |
| 1158 | 110 gcc -shared -fPIC -DUSERDB_VPOPMAIL -DPASSDB_VPOPMAIL -I../.. -I../lib \ |
|
1190
c54c61822d27
s/ldap/vpopmail/ in vpopmail.so example
Timo Sirainen <tss@iki.fi>
parents:
1159
diff
changeset
|
111 userdb-vpopmail.c passdb-vpopmail.c -o vpopmail.so -lvpopmail |
| 1157 | 112 |
| 113 Including libsettings.a in ldap.so is kind of annoying, but it's not | |
| 114 currently needed elsewhere in dovecot-auth. |