LMTPD is a lmtp server compliant with RFC 2033. It is used to deliver
mail from network into user mailboxes. This implementation is able to
filter incomming mails according user preferences and to keep user
logs of mail activity.

* DOWNLOAD

You can get new version from the web site http://pll.sourceforge.net/

* INSTALLATION

The "configure" script try to guess what software are installed on your
server, you can force some options

   --without-libhome  

        disable libhome feature. Libhome is an authentication library
        avaiable from http://pll.sourceforge.net/ If you want multiple
        domain support, you should use it.

   --without-mysqllog 

        Disable MySQL logging of mail delivery and MySQL cache support.
	Download MySQL from http://www.mysql.com/ if you want it.

   --with-db4=DIR
   --with-db3=DIR
   --with-db-libdir=DIR 

        Force the check of DB3 or DB4 includes and libraries. DB is
        used to cache user status and accelerate lookup. Go to
        http://www.sleepycat.com/ for DB informations.

   --without-pcre

        Disable the check of PCRE (Perl Compatible Regular Expressions)
        They may be used to filter mail. See http://www.pcre.org/
        Notice that UTF-8 support in PCRE is supported.

   --without-iconv

        Disable iconv support. Iconv is used to translate headers into UTF-8
        according RFC2047. If iconv is disabled, is bogus or don't recognise
        e-mail charset, the conversion is not done.


   --with-oniguruma[=DIR]
   --with-oniguruma-lib=DIR

        Enable Oniguruma regular expression. 

 	The library containt POSIX emulation, it may have conflict
	with System POSIX regexp, and anything can append.
	So, this is disabled by default. See

        http://www.ruby-lang.org/cgi-bin/cvsweb.cgi/oniguruma/
	ftp://ftp.ruby-lang.org/pub/ruby/contrib/

   --with-regexp-db-cache

	Enable cache of compiled regexp. As this is experimental,
	and some regexp library compile faster than a DB3/4 access,
	and this eat memory, this feature is disabled by default.

Run "configure --help" for more options

Once you configured the package, run "make" then "make install".
If you want stripped executables, run "make install-strip" instead

* CONFIGURATION

The configuration file, "lmtpd.conf" is typically in /usr/local/etc
directory.

If you use system password, you need to set the "domain.local" option
with the domain name who receive the mail. If you use libhome in MySQL
or LDAP mode with multiple domains, an empty file should work. Notice
that shadow password are not used, the server only check use user
exists.

Look at lmtpd(8) manual page to see more options.

The lmtpd server should be used into inetd or any clone. An inetd.conf
line may be

  lmtp  stream  tcp  nowait  root  /usr/local/libexec/lmtpd lmtpd

The "lmtp" port is typicaly set to port 24 (reserved by IANA for
private mail system). You may need to set a name in /etc/services
file for inetd.

For security reasons, you should make it run with tcpwrapper behind
any firewall. Only allow your LMTP client (which are probably a subset
of your SMTP servers) to connect. As the server keeps the connection
opened until the client close it, they is no new connection overhead.

You may also enable SASL client authentification (see manual).

* CONFIGURING SMTP SERVER

 + Postfix 

   Read the file README_FILES/LMTP_README in postfix source
   distribution archive. LMTP may be used as transport, using
   transport(5) maps or options lonke mailbox_transport,
   local_transport, fallback_transport

* FILTER CHECKING

The utility "filtercheck" check if filter file is syntaxicaly correct
and ready to install. This program don't use the lmtpd.conf option
file. If you want check module, use the '-m' option.

* SAMPLE FILES

Some configuration directives need external file, see txt/ directory
for exemples in some languages.

sql/ directory containts SQL tables examples

samples/ comaints misc examples files.

* EXTERNAL TOOLS

 The delivery agent may talk to some external server to parse
the message 

 + Antivirus

   An antivirus may be configured. The antivirus has to run in server
mode on one or more hosts. Supported antivirus servers are :

   - Dr.Web see http://www.drweb.ru/
   - Sophie (Sophos server) see http://www.vanja.com/tools/  
   - ClamAV see http://sourceforge.net/projects/clamav/

   Notice that ClamAV server may crash (version 0.60) and you should
   probably choose another antivirus.

 + Spam Assassin

   Spam Assassin is a spam detection tool. LMTP server may talk to one
or more Spam Assassin servers. See http://spamassassin.org/

 + Iconv

   GNU libiconv should work, at least recent versions.
   HPUX iconv() should not (don't know current charset name, including "UTF-8").

* ARCHITECTURE NOTES

This sofware has compiled with gcc on the following architectures :

  - FreeBSD 4 
  - FreeBSD 5
  - SunOS 5.8
  - Linux (debian, redhat)
  - HPUX 11

This program have been heavly tested on FreeBSD-4 and some tests have
been made on other plateforms.

Internal "syslog" user command is not avaiable on HPUX because the
miss of some POSIX standard library.