dmail - procmail Mail Delivery Module
dmail [-D] [-f from_name] [-s] [-k keyword_list] [user][+folder]
delivers mail to a user's INBOX or a designated folder.
may be configured as a drop-in replacement for binmail
(1) for use with a mail delivery filter such as
Because of security considerations (see below) dmail
is not intended to
be used for direct delivery by the mailer daemon; tmail
(1) is the
preferred tool for this purpose. If dmail
is used for mailer daemon
delivery, the mailer daemon must invoke dmail
with the dmail
process' user id set to the recipient's user id.
exits, it returns exit status values to enable
(1) to determine whether a message was delivered successfully
or had a temporary (requeue for later delivery) or permanent (return to
If the user
name is present, it must be the same as the logged-in user
If the +folder
extension is included in the user argument (or appears by
itself if there is no user argument), dmail
will attempt to deliver to
the designated folder. If the folder does not exist or the extension is not
included, the message is delivered to the user's INBOX. If delivery is to
INBOX and no INBOX currently exists, dmail
will create a new INBOX.
recognizes the format of an existing INBOX or folder, and appends
the new message in that format.
flag specifies debugging; this enables additional message
flag is used to specify a Return-Path. The header
Return-Path: < from_name
is prepended to the message before delivery.
flag specifies that the message will be flagged as being
flag is used to specify delivery keywords, which are set on the
message at delivery time if and only
if the keywords are already
defined in the mailbox. Multiple keywords can be specified by using a quoted
dmail -k "$Junk Discard" +junkbox
Absolute pathnames and ~user
specifications are not permitted in
you can use dmail
to deliver to IMAP4 namespace names
extensions. This means that it is possible to deliver to
(1) format mailboxes.
However, this can also include such namespaces as #shared, #public, and #ftp. In
most cases, it is undesirable to allow anybody sending mail to the user to
deliver to these namespaces. Consequently, there needs to be a rule in place
in the configuration of either sendmail
(8) or procmail
prevent such abuse.
Mark Crispin, MRC@CAC.Washington.EDU