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)

NAME | SYNOPSIS | DESCRIPTION | RESTRICTIONS | SECURITY CONSIDERATIONS | AUTHOR | SEE ALSO

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

home | help