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.