NAME

       dmail - procmail Mail Delivery Module

SYNOPSIS

       dmail [-D] [-f from_name] [-s] [-k keyword_list] [user][+folder]

DESCRIPTION

       dmail  delivers mail to a user's INBOX or a designated folder.  dmail may be configured as
       a drop-in replacement for binmail(1), mail.local(1) for use with a  mail  delivery  filter
       such as procmail(1).

       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.

       When dmail exits, it returns exit status values to enable procmail(1) to determine whether
       a  message  was  delivered successfully or had a temporary (requeue for later delivery) or
       permanent (return to sender) failure.

       If the user name is present, it must be the same as the logged-in user name.

       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.  dmail recognizes the format of an existing INBOX or folder,  and  appends  the
       new message in that format.

       The -D flag specifies debugging; this enables additional message telemetry.

       The -f or -r flag is used to specify a Return-Path.  The header
          Return-Path: <from_name>
       is prepended to the message before delivery.

       The -s flag specifies that the message will be flagged as being "seen".

       The -k 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 string, e.g.,
          dmail -k "$Junk Discard" +junkbox

RESTRICTIONS

       Absolute pathnames and ~user specifications are not permitted in +folder extensions.

SECURITY CONSIDERATIONS

       Unlike tmail you can use dmail to deliver to IMAP4 namespace names via +folder extensions.
       This means that it is possible to deliver to mh(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(1) to prevent such abuse.

AUTHOR

       Mark Crispin, MRC@CAC.Washington.EDU

SEE ALSO

       binmail(1)
       procmail(1)

                                          June 18, 2007                                  DMAIL(1)