diff options
author | Eduardo Chappa <echappa@gmx.com> | 2013-02-03 00:59:38 -0700 |
---|---|---|
committer | Eduardo Chappa <echappa@gmx.com> | 2013-02-03 00:59:38 -0700 |
commit | 094ca96844842928810f14844413109fc6cdd890 (patch) | |
tree | e60efbb980f38ba9308ccb4fb2b77b87bbc115f3 /imap/src/dmail/dmail.1 | |
download | alpine-094ca96844842928810f14844413109fc6cdd890.tar.xz |
Initial Alpine Version
Diffstat (limited to 'imap/src/dmail/dmail.1')
-rw-r--r-- | imap/src/dmail/dmail.1 | 121 |
1 files changed, 121 insertions, 0 deletions
diff --git a/imap/src/dmail/dmail.1 b/imap/src/dmail/dmail.1 new file mode 100644 index 00000000..92cd894f --- /dev/null +++ b/imap/src/dmail/dmail.1 @@ -0,0 +1,121 @@ +.ig + * ======================================================================== + * Copyright 1988-2007 University of Washington + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * + * ======================================================================== +.. +.TH DMAIL 1 "June 18, 2007" +.SH NAME +dmail \- procmail Mail Delivery Module +.nh +.SH SYNOPSIS +.B dmail +.I [\-D] [\-f from_name] [-s] [-k keyword_list] [user][+folder] +.SH DESCRIPTION +.I dmail +delivers mail to a user's INBOX or a designated folder. +.I dmail +may be configured as a drop-in replacement for +.IR binmail (1), +.IR mail.local (1) +for use with a mail delivery filter such as +.IR procmail (1) . +.PP +Because of security considerations (see below) +.I dmail +is not intended to be used for direct delivery by the mailer daemon; +.IR tmail (1) +is the preferred tool for this purpose. If +.I dmail +is used for mailer daemon delivery, the mailer daemon must invoke +.I dmail +with the +.I dmail +process' user id set to the recipient's user id. +.PP +When +.I dmail +exits, it returns exit status values to enable +.IR procmail (1) +to determine whether a message was delivered successfully or had a +temporary (requeue for later delivery) or permanent (return to sender) +failure. +.PP +If the +.I user +name is present, it must be the same as the logged-in user name. +.PP +If the +.I +folder +extension is included in the user argument (or appears by itself if there +is no user argument), +.I 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, +.I dmail +will create a new INBOX. +.I dmail +recognizes the format of an existing INBOX or folder, and appends the new +message in that format. +.PP +The \fB-D\fR flag specifies debugging; this enables additional message +telemetry. +.PP +The \fB-f\fR or \fB-r\fR flag is used to specify a Return-Path. The header +.br + Return-Path: <\fIfrom_name\fR> +.br +is prepended to the message before delivery. +.PP +The +.B -s +flag specifies that the message will be flagged as being "seen". +.PP +The \fB-k\fR flag is used to specify delivery keywords, which are set on +the message at delivery time if and +.B only +if the keywords are already defined in the mailbox. Multiple keywords can be +specified by using a quoted string, e.g., +.br + dmail -k "$Junk Discard" +junkbox +.br +.SH RESTRICTIONS +Absolute pathnames and +.I ~user +specifications are not permitted in +.I +folder +extensions. +.SH SECURITY CONSIDERATIONS +Unlike +.I tmail +you can use +.I dmail +to deliver to IMAP4 namespace names via +.I +folder +extensions. This means that it is possible to deliver to +.IR mh (1) +format mailboxes. +.PP +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 +.IR sendmail (8) +or +.IR procmail (1) +to prevent such abuse. +.SH AUTHOR +Mark Crispin, MRC@CAC.Washington.EDU +.SH "SEE ALSO" +binmail(1) +.br +procmail(1) |