home | help
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 mes-
     sage  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)

home | help