Manual Page: deliver.8


deliver - deliver mail into Archiveopteryx.


/usr/local/archiveopteryx/bin/deliver [-f sender] [-t mailbox] [-v] destination [filename]


The deliver program injects a single mail message in RFC-822 format into Archiveopteryx. It connects to Archiveopteryx's backend ddatabase injects the message into the correct mailbox.

deliver is meant as a compatibility shim for use with e.g. formail(1) and with MTAs that want to deliver to a program. Note that you will generally get better performance by using LMTP.

deliver bypasses Sieve and always stores mail directly into the target mailbox.


-f sender

specifies the fully qualified address of the message sender. This is the same as the SMTP envelope sender.

Starting with version 2.01, the -f argument is ignored. It is still accepted to keep old scripts working.

-t mailbox

directs deliver to store the message into the named mailbox. The "p" right on the mailbox must be granted to "anyone". ("p" controls who is permitted to send mail to the mailbox, see RFC 4314 for more details.)


requests more verbosity during delivery. May be specified twice.


To deliver an entire berkeley mbox into the inbox of user

formail -s deliver < mbox

To deliver each message in the MH folder +blah into the inbox of user

folder +blah
seq all | xargs -n1 deliver

To deliver each message in the MH folder +ramble into folder stumble of user

folder +blah
seq all | xargs -n1 deliver -t stumble

If raj has not granted "anyone" the "p" right ("p"ost mail to mailbox), this example fails.


The normal exit status of deliver is 0. In case of errors, deliver returns an error code from sysexits.h, such as EX_TEMPFAIL, EX_NOUSER, etc.


Delivering multiple messages would also be good, for those big mailbox migrations. In that case, deliver should report which messages could be delivered and which could not.

There is no command-line option to set the configuration file.


The Archiveopteryx Developers,


This man page covers Archiveopteryx version 3.1.3, released 2010-03-10,


archiveopteryx(8), archiveopteryx.conf(5), logd(8),