NAME

pcheckd - Checks for mail in maildir mailboxes

SYNOPSIS

pcheckd [-l FILE, --logfile FILE] [-m DIR, --mailboxdir DIR] [-p PORT, --port PORT] [-e LOAD, --emptyload LOAD] [-f NUM, --fork NUM] [-r DIR, --rundir DIR] [-h HOST, --host HOST] [--nodeamon] [--debug] [--help] [--version]

DESCRIPTION

This program will open the named UDP port (default: 50110) and listen for requests. It will send an answer to the requests back to the client.

There are two types of requests: The mailbox request ('M') will ask the server about the state of the named mailbox ('0 no mail', '1 mail', '2 new mail', or '3 load too high'). The load request ('L') will ask the server for the load avarage for the last minute.

The load is returned as an integer which is determined by reading /proc/loadavg and cutting of everything after the decimal point.

This server is single threaded.

OPTIONS

--help: Print short command line help.
--version: Print version information.
-l FILE, --logfile FILE: Name of logfile (default: /var/log/popular/pcheckd)
-m DIR --mailboxdir DIR: Directory where all the mailboxes reside. There can be an arbitrary depth of subdirectories beneath this. All mailbox names sent by the client are relative to this directory.
-p PORT, --port PORT: UDP port to listen to.
-e LOAD, --emptyload LOAD: If the system load average over the last minute is LOAD or higher, a 'M' request will be answered with '3 load too high'. In this case pproxy will fake an empty mailbox.
-f NUM, --fork NUM: Fork NUM processes at start of pcheckd. The parent and all the children will answer requests. The parent doesn't count towards NUM, so there will be NUM+1 pcheckd processes.
-r DIR, --rundir DIR: Name of run directory. The pid file is saved into this directory. (default: /var/run/popular)
-h HOST, --host HOST: Host name or IP number to bind to. This might be needed if you have several IP numbers on one host. Default is to bind to INADDR_ANY (0.0.0.0), i.e. to listen to all interfaces.
--nodeamon: Don't run as daemon in the background.
--debug: Enable debug logging. This will log all packets as they are received and sent.

AUTHOR

Jochen Topf jochen@remote.org

http://www.remote.org/jochen/mail/popular/ <URL:http://www.remote.org/jochen/mail/popular/>

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.