Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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
       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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dmail&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help