changeset 1157:d8d8ec83c2f7 HEAD

author Timo Sirainen <>
date Tue, 11 Feb 2003 22:38:34 +0200
parents cd46f47d559f
children d346da6de29d
diffstat 1 files changed, 41 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/INSTALL	Tue Feb 11 22:25:35 2003 +0200
+++ b/INSTALL	Tue Feb 11 22:38:34 2003 +0200
@@ -1,4 +1,4 @@
-Build instructions
+Build Instructions
 For most people, the usual:
@@ -27,7 +27,7 @@
-Optional configure options
+Optional Configure Options
 You can get a full list with:
@@ -60,20 +60,54 @@
 using 32bit file offets. With x86 it could be 1 as well if you want to save
 a bit of disk space (in file) and memory.
-Specifies memory alignment to use. Many non-x86 systems require this 
+  --with-rawlog           Build support for logging user traffic
+When Dovecot is compiled with this option and user's home directory
+contains rawlog directory, all IMAP connections are logged into and .out files. This is mostly useful for debugging.
+  --enable-debug          Enable some extra checks for debugging
-With many non-x86 systems this is
-required to be 64bit (8 bytes) since all 64bit memo
+This is mostly useful for developers. It does quite a lot of unnecessary
+work but should catch some programming mistakes more quickly.
+  --with-ssl=gnutls|openssl Build with GNUTLS (default) or OpenSSL
+  --with-ssldir=DIR       SSL base directory for certificates (/etc/ssl)
+SSL options.
+  --with-pop3d            Build POP3 server (default)
+Build pop3d binary. It still has to be separately enabled from configuration
   --with-passwd           Build with /etc/passwd support (default)
   --with-passwd-file      Build with passwd-like file support (default)
   --with-shadow           Build with shadow password support (default)
   --with-pam              Build with PAM support (default)
+  --with-ldap             Build with LDAP support
   --with-vpopmail         Build with vpopmail support (default)
+  --with-static-userdb    Build with static userdb support (default)
 Specify which authentication modules to use. Disabling them give you a few
 bytes smaller binary, but not much else.
-  --with-ssl=gnutls|openssl Build with GNUTLS (default) or OpenSSL
+Dynamic Authentication Modules
+Dovecot can also dynamically load authentication modules from
+$prefix/lib/dovecot/auth/ directory. Binary packages builders should use
+them for auth modules which require external libraries (eg. LDAP and
+vpopmail). There's no standard way to build them as modules currently, but
+something like this should work:
-Specify wanted SSL library.
+gcc -shared -DUSERDB_LDAP -DPASSDB_LDAP -I../.. -I../lib -I../lib-settings \
+db-ldap.c userdb-ldap.c passdb-ldap.c -o \
+../lib-settings/libsettings.a -lldap
+gcc -shared -DUSERDB_VPOPMAIL -DPASSDB_VPOPMAIL -I../.. -I../lib \
+userdb-vpopmail.c passdb-ldap.c -o -lvpopmail
+Including libsettings.a in is kind of annoying, but it's not
+currently needed elsewhere in dovecot-auth.