1DMAIL(1) General Commands Manual DMAIL(1)
2
3
4
6 dmail - procmail Mail Delivery Module
7
9 dmail [-D] [-f from_name] [-s] [-k keyword_list] [user][+folder]
10
12 dmail delivers mail to a user's INBOX or a designated folder. dmail
13 may be configured as a drop-in replacement for binmail(1),
14 mail.local(1) for use with a mail delivery filter such as procmail(1).
15
16 Because of security considerations (see below) dmail is not intended to
17 be used for direct delivery by the mailer daemon; tmail(1) is the
18 preferred tool for this purpose. If dmail is used for mailer daemon
19 delivery, the mailer daemon must invoke dmail with the dmail process'
20 user id set to the recipient's user id.
21
22 When dmail exits, it returns exit status values to enable procmail(1)
23 to determine whether a message was delivered successfully or had a
24 temporary (requeue for later delivery) or permanent (return to sender)
25 failure.
26
27 If the user name is present, it must be the same as the logged-in user
28 name.
29
30 If the +folder extension is included in the user argument (or appears
31 by itself if there is no user argument), dmail will attempt to deliver
32 to the designated folder. If the folder does not exist or the
33 extension is not included, the message is delivered to the user's
34 INBOX. If delivery is to INBOX and no INBOX currently exists, dmail
35 will create a new INBOX. dmail recognizes the format of an existing
36 INBOX or folder, and appends the new message in that format.
37
38 The -D flag specifies debugging; this enables additional message
39 telemetry.
40
41 The -f or -r flag is used to specify a Return-Path. The header
42 Return-Path: <from_name>
43 is prepended to the message before delivery.
44
45 The -s flag specifies that the message will be flagged as being "seen".
46
47 The -k flag is used to specify delivery keywords, which are set on the
48 message at delivery time if and only if the keywords are already
49 defined in the mailbox. Multiple keywords can be specified by using a
50 quoted string, e.g.,
51 dmail -k "$Junk Discard" +junkbox
52
54 Absolute pathnames and ~user specifications are not permitted in
55 +folder extensions.
56
58 Unlike tmail you can use dmail to deliver to IMAP4 namespace names via
59 +folder extensions. This means that it is possible to deliver to mh(1)
60 format mailboxes.
61
62 However, this can also include such namespaces as #shared, #public, and
63 #ftp. In most cases, it is undesirable to allow anybody sending mail
64 to the user to deliver to these namespaces. Consequently, there needs
65 to be a rule in place in the configuration of either sendmail(8) or
66 procmail(1) to prevent such abuse.
67
69 Mark Crispin, MRC@CAC.Washington.EDU
70
72 binmail(1)
73 procmail(1)
74
75
76
77 June 18, 2007 DMAIL(1)