AKPOP3D(8) BSD System Manager's Manual AKPOP3D(8)NAMEakpop3d — small and secure POP3 daemon
SYNOPSISakpop3d [-s] [-p port] [-d] [-f pidfile] [-c certfile] [-k keyfile]
[-l address] [-a authfile] [-m spooldir] [-D] [-L mboxfile]
[-t timeout] [-x tmpdir] [-v] [-h]
DESCRIPTIONakpop3d is a small and secure implementation of a server for as described
in RFC1939. Furthermore, POP3-over-SSL for secure retrieval of email is
also supported.
akpop3d must be started as root. It then listens for connections on port
110. When the commandline switch -s is used, POP3-over-SSL is enabled,
and akpop3d listens on port 995.
akpop3d is usually started via some kind of startup script, which depends
on your Unix system. Init scripts for Debian and Red Hat systems are pro‐
vided with the source package.
OPTIONSakpop3d accepts the following commandline switches:
-d Run as a daemon (in the background). The process ID of the
daemon is written to a PID file, which by default is
/var/run/akpop3d.pid but which can be changed using the -f
option.
-f pidfile Store the process ID of the daemon in pidfile which must be
specified as a full path (i.e. /path/to/something instead of
something on its own).
-s SSL mode: instead of listening on port 110, akpop3d will lis‐
ten on port 995 and will use SSL to encrypt communications.
The certificate and key will be taken from
/etc/akpop3d/cert.pem and /etc/akpop3d/key.pem respectively
unless set with the -c and -k options.
-c certfile
Use certfile for the SSL certificate. (Point this to your SSL
certificate.)
-k keyfile Use keyfile for the SSL key. (Point this to your RSA key.)
-p port Listen on the given port instead of port 995 (SSL) or 110
(non-SSL).
-l address Listen on the given address instead of not binding to a spe‐
cific IP address.
-a authfile
Instead of using /etc/passwd for authentication, read infor‐
mation from the authfile text file. The format of this file
is username:password:unixname:maildrop (one record per line),
where username is the POP3 username, password is the POP3
password, unixname is the Unix username to run as when read‐
ing the mailbox, and maildrop is the full path to the mail‐
drop file to use for that user. Note that as with the -f
option, authfile must be specified as a full path.
The password may be given either as an MD5 hash or in the
clear (not recommended). If MD5 us used, the value should be
"MD5-" followed by 32 hexadecimal digits (lower case) repre‐
senting the MD5 output of the following string: The password,
a line feed (ASCII 10), the user name, a line feed, and the
magic string "akpop3d". No trailing line feed after the
magic string. As an example, the password "foo" for user
"bar" would be "MD5-a199706d2b8302a086a20fe9fb4e8403".
If the programs printf and md5sum are available, which they
typically are on GNU-based systems, the hash may be calcu‐
lated using the following command:
printf "foo\nbar\nakpop3d" | md5sum
-m spooldir
specifies an alternative mail spool directory. The default is
/var/mail/.
-D enables using the files /etc/pop3.allow and /etc/pop3.deny
for specifying users that are allowed to receive email via
POP3.
-L mboxfile
uses the file mboxfile in the user's home directory as mail‐
spool.
-t timeout sets a timeout of timeout seconds for read and write opera‐
tions. The default is 30 seconds.
-x tmpdir set the default temporary directory to tmpdir.
-v Show the program version and exit.
-h Show a summary of program options and exit.
SEE ALSOpopa3d(8)
RFC 1939 - Post Office Protocol - Version 3.
HISTORY
The current POP3 protocol standard was published in May 1996. It was pre‐
ceded by POP2 (February 1985) and POP (October 1984).
AUTHORS
Andreas Krennmair <ak@synflood.at>
Andrew Wood <andrew.wood@ivarch.com>
akpop3d April 4, 2003 akpop3d