WPOP3D(1)

NAME
wpop3d - Wintellect's POP3 Daemon

SYNOPSIS
wpop3d [-V] [-c<limit>] [-d] [-h] [-l<logfile>] [-m<maildir>] [-p<port>] [-r] [-s] [-t<seconds>] [-v<level>]

DESCRIPTION
wpop3d is a highly configurable pop3 mail server that allows remote clients to access mail. It aims to be 100% RFC1939 compliant. wpop3d offers the facility to specifically deny root maildrop access via the -r switch and real system user maildrop access via the -s switch. wpop3d will attempt to use the system maildrop directory as defined at compile time unless the -m switch is used; exiting if no suitable maildir is found or specified. Virtual maildrops are supported via the users text file. If the file is not found, or an error is encountered in its format, virtual users will be disabled with an appropriate message being logged. A virtual user is searched for FIRST before wpop3d reverts to the system users. Virtual users must have sufficient permissions to create new files in their maildrop directory. A SIGHUP may be issued to wpop3d which will force it to reread the list of virtual users, if an error is encountered in the users file, the currently loaded virtual users are kept.

OPTIONS

-V  Show version.

-c<limit>
    Set a limit for the number of concurrent connections to the server. Default is no limit.

-d  Do not enter daemon mode, causing the application to run in the current shell.

-h  Syntax help.

-m<maildir>
    Specify an alternate <maildir> for the maildrops, the default is /var/mail. This only applies to system users.

-p<port>
    Specify an alternate <port> to the default RFC1939 specification of 110.

-r  Deny root maildrop access.

-s  Deny system user maildrop access, resulting in a totally virtual user maildrop setup.

-t<seconds>
    Specify an alternate number of <seconds> before an inactivity connection timeout occurs. The RFC1939 specification is 600 seconds (10 minutes) and is the default.

-v<level>
    Specify a <level> of verbosity for the logfile; where
    1 = log errors only
    2 = log errors and accepted connections (default)
    3 = log errors, accepted connections and failed logins
    4 = log errors, accepted & lost connections and failed logins

FILES
/usr/local/etc/wpop3d/users
    The location of the virtual users config file. It supports the following format:
        uname:passwd:uid:gid:/fullpath/to/maildrop
    If the admin wishes to use a real system user's password for a virtual maildrop then a "*" may be placed in the passwd field, wpop3d will then use the system passwd for the system username that matches the uname field. This will fail if the -s switch is set. First match use principle is employed with virtual users.
/var/run/wpop3d.pid
    File containing the Process ID number of wpop3d when successfully entered into daemon mode.

EXAMPLES
To start a RFC1939 compliant server:
    wpop3d
To start a wpop3d server listening on port 5000 and with an inactivity timeout of 60 seconds:
    wpop3d -p5000 -t60
To start a wpop3d server that denies root maildrop access:
    wpop3d -r

AUTHOR
Phil Pereira <phil at bsdnexus dot com>

SEE ALSO
inetd(8), syslogd(8), RFC1939, RFC1321

STANDARDS
wpop3d server conforms to RFC1939.

BUGS
To date there are no known bugs.

SECURITY
root privilidges are dropped after valid user/pass authentication.