Mercurial > dovecot > core-2.2
view INSTALL @ 4343:407e6c620d70 HEAD
dovecot-config now contains module_dir
author | Timo Sirainen <tss@iki.fi> |
---|---|
date | Fri, 16 Jun 2006 12:25:19 +0300 |
parents | ed7d77a89b17 |
children | 5fe316cdd8a6 |
line wrap: on
line source
Build Instructions ------------------ For most people, the usual: ./configure make sudo make install is enough. This installs Dovecot under /usr/local. If you have installed some libraries into locations which require special include or library paths, you can give them in CPPFLAGS and LDFLAGS environment variables. For example: CPPFLAGS=-I/opt/openssl/include LDFLAGS=-L/opt/openssl/lib ./configure Running ------- Rename configuration file: mv /usr/local/etc/dovecot-example.conf /usr/local/etc/dovecot.conf Read through, and make needed modifications. doc/configuration.txt tells you more about configuring Dovecot. Once everything is configured, there's two ways to start Dovecot: 1) Run "dovecot" binary which does everything. 2) Start it via inetd or similiar by executing "imap-login" or "pop3-login" binaries. If you're listening in SSL port, add --ssl parameter. SSL/TLS ------- Dovecot used to support both GNUTLS and OpenSSL libraries, but nowadays only the OpenSSL code is working. Optional Configure Options -------------------------- You can get a full list with: ./configure --help The options are listed like --with-thing or --enable-thing, usually they're also enabled by default. You can disable them with --without-thing or --disable-thing. Besides the standard options, Dovecot has added these: --enable-ipv6 Enable IPv6 support (default) Enable IPv6 support. By default it's enabled if system is detected to support it. --with-file-offset-size=BITS Specifies if we use 32bit or 64bit file offsets. 64bit is default if system supports it (Linux and Solaris does). You most likely won't have mails larger than 2GB, so you may want to drop this to 32bit for a bit smaller disk and memory usage. --with-mem-align=BYTES Specifies memory alignment, needed with many non-x86 systems and should speed up x86 systems too. Default is 8 with everyone to make sure 64bit memory accessing work. Currently it should also be safe to set to 4 when using 32bit file offets. With x86 it could be 1 as well if you want to save a bit of disk space (in .imap.index.data file) and memory. --enable-debug Enable some extra checks for debugging 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 file. --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) --with-pgsql Build with PostgreSQL support Specify which authentication modules to use. Disabling them give you a few bytes smaller binary, but not much else. 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: cd src/auth gcc -shared -fPIC -DHAVE_CONFIG_H -DUSERDB_LDAP -DPASSDB_LDAP \ -I../.. -I../lib -I../lib-settings \ db-ldap.c userdb-ldap.c passdb-ldap.c -o ldap.so -lldap gcc -shared -fPIC -DHAVE_CONFIG_H -DUSERDB_VPOPMAIL -DPASSDB_VPOPMAIL \ -I../.. -I../lib userdb-vpopmail.c passdb-vpopmail.c -o vpopmail.so \ -lvpopmail Dynamic IMAP and POP3 Modules ----------------------------- If imap_use_modules or pop3_use_modules is set to yes, Dovecot will load all *.so modules from directory pointed by imap_modules or pop3_modules. These modules can do anything, they're only expected to contain <module name>_init and <module name>_deinit functions which are called. Dynamic SQL drivers ------------------- Currently SQL drivers are only used by dovecot-auth, so you could place them into same directory with auth plugins. cd src/lib-sql gcc -shared -fPIC -DHAVE_CONFIG_H -DBUILD_PGSQL \ -I../.. -I../lib -I../lib-settings -I/usr/include/postgresql \ driver-pgsql.c -o driver_pgsql.so -L/usr/lib/postgresql -lpq gcc -shared -fPIC -DHAVE_CONFIG_H -DBUILD_MYSQL \ -I../.. -I../lib -I../lib-settings -I/usr/include/mysql \ driver-mysql.c -o driver_mysql.so -lmysqlclient