DMAIL(1)						      General Commands Manual							  DMAIL(1)

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)