pdeliver

Name

pdeliver --  Deliver mail into a maildir mailbox

Synopsis

pdeliver [--help] [--version] [ -q QUOTA, --quota QUOTA ] [ -Q NUM, --maxnum NUM ] [ -m DIR, --mailboxdir DIR ] [ -f FORMAT, --format FORMAT ] [ -l FILE, --logfile FILE ] [ -i ID, --id ID ] [mailbox]

Description

This command awaits a mail on STDIN formatted according to the format specified with the -f option. It will write the mail to the mailbox specified on the command line in maildir format.

Options

--help

Get help on parameters.

--version

Print version information.

-q QUOTA, --quota QUOTA

This is the quota for the total size of the mailbox in MBytes (1024*1024 bytes) or 0, if the total size of the mailbox should not be checked. Default is 0.

-Q NUM, --maxnum NUM

This is the quota for the number of mails in the mailbox or 0, if the check should not be performed. Default is 0.

-m DIR, --mailboxdir DIR

This is the directory where all mailbox directories are. Default is /pop.

-f FORMAT, --format FORMAT

Format of the mail an STDIN. There are three mail formats understood by pdeliver:

LF

Each line in the mail ends in a line feed (LF) character. This is the common format for UNIX text files.

CRLF

Each line in the mail ends in a carriage return (CR), line feed (LF) combination.

NET

Each line in the mail ends in a carriage return (CR, line feed (LF) combination. Lines beginning with a dot (.), have this dot doubled. A line consisting of a single dot and a carriage return (CR), line feed (LF) combination denotes the end of the mail. pdeliver will stop reading at this point.

Irrespective of the format an EOF will always end the mail.

-l FILE, --logfile FILE

Logfile used for all messages. Default is /var/log/popular/pdeliver. if you don't want any logging, you have to use '-l /dev/null'.

-i ID, --id ID

This ID is logged with every line in the log file to find corresponding entries. If you don't specify an ID "-" will be logged. You probabely want to put the internal ID of the MTA here to easily find corresponding entries in the MTA log file.

Quota

The quota will be checked before delivering the mail. The size of the mail currently being delivered is not counted towards the mailbox size. If the mailbox size is smaller then the quota and the number of mails smaller then the maximal allowed number of mails, the mail is delivered, otherwise pdeliver exits with return code 1.

Because there is no locking done, two processes delivering into the same mailbox at the same time might lead to overfull mailboxes.

Return codes

0

Mail was successfully delivered.

1

Quota for this mailbox exceeded. Mail is not delivered.

2

Error while delivering. Permission problems or something like that.

3

Command line error.

See Also

pcheck(1), pcheckd(8), pclean(8), pcontrol(1), pproxy(8), pserv(8), pstatus(1), ptestpdm(1), The POPular Manual