2003-12-03 libEtPan! Viet Hoa DINH 2003 DINH Viet Hoa Introduction Description The purpose of this mail library is to provide a portable, efficient middleware for different kinds of mail access (IMAPrev4, POP3, NNTP, mbox, MH, Maildir). You have two kinds of mailbox access, either using low-level functions with a different interface for each kind of access or using higher-level functions, using a driver to wrap the higher-level API. The API will be the same for each kind of mail access using the higher-level API. Author Main author DINH Viet Hoa hoa@users.sourceforge.net Contributors Wim Delvaux Melvin Hadasht David Woodhouse Juergen Graf Zsolt VARGA Gael Roualland Toni Willberg Rajko Albrecht Nikita V. Youshchenko Frederic Devernay Michael Leupold Colin Leroy Installation Dependencies Dependencies for users OpenSSL (optional but recommended) Berkeley DB (optional but recommended) POSIX Thread (required) Dependencies for developers autoconf 2.13 automake 1.4 libtool 1.4.3 jade and some SGML tools will be required Existing packages Before you try to compile it, you have to know that packages exist for some systems. FreeBSD you can find it in ports/mail/libetpan. Debian This is in the package collection. Mandrake Linux This is in the package collection. Compilation Generic installation instructions are in the INSTALL file You can pass the following extra options to configure : FreeBSD make sure libiconv is installed from the ports collection (see pkg_info). issue configure with the following parameter: $ ./configure --with-libiconv-prefix=/usr/local Mac OS X in tests/option-parser.c, change the inclusion of getopt.h to gnugetopt/getopt.h in tests/Makefile, add -I/sw/include for the CFLAGS and -L/sw/lib -lgnugetopt for the LDFLAGS. Linux Since libEtPan! is making high usage of mmap() even for writing, when your mailboxes are on NFS filesystem with a Linux server, it is advised to use option no_subtree_check in /etc/exports. This should avoid corruption of data. The problem exist in Linux 2.4.22 and earlier versions. On RedHat systems, you have to configure using the following command line : ./configure --with-openssl=/usr/kerberos On Debian systems, if the ./autogen script fails on missing AM_ICONV, you have to install gettext package. configure You can use the following options : --enable-debug Compiles with debugging turned on --enable-optim Turns on some optimizations flags for gcc --without-openssl Disables OpenSSL (do not look for it) Compile and install Download the package and do the following : $ tar xzvf libetpan-XX.XX.tar.gz # to decompress the package $ cd libetpan-XX.XX $ ./configure --help # to get options of configure $ ./configure # you can specify your own options $ make # to compile the package $ su # make install # logout Use of libEtPan! How to open an Hotmail mailbox If you wish to access hotmail using libEtPan!, you can, by using hotwayd. Then, create a POP3 storage with the given parameters : command as clear text for connection type (CONNECTION_TYPE_COMMAND), "/usr/bin/hotwayd" as command, plain text authentication (ePOP3_AUTH_TYPE_PLAIN), full hotmail address as login (foobar@hotmail.com or foobar@hotmail.com/mailbox_name if you want to access a specific mailbox) and give your password.