| 1 |
.. cyrusman:: deliver(8) |
| 2 |
|
| 3 |
.. author: Nic Bernstein (Onlight) |
| 4 |
|
| 5 |
.. _imap-reference-manpages-systemcommands-deliver: |
| 6 |
|
| 7 |
=========== |
| 8 |
**deliver** |
| 9 |
=========== |
| 10 |
|
| 11 |
intro |
| 12 |
|
| 13 |
Synopsis |
| 14 |
======== |
| 15 |
|
| 16 |
.. parsed-literal:: |
| 17 |
|
| 18 |
**deliver** [ **-C** *config-file* ] [ **-d** ] [ **-r** *address* ] |
| 19 |
[ **-f** *address* ] [ **-m** *mailbox* ] [ **-a** *auth-id* ] |
| 20 |
[ **-q** ] [ *userid* ]... |
| 21 |
**deliver** [ **-C** *config-file* ] **-l** |
| 22 |
|
| 23 |
Description |
| 24 |
=========== |
| 25 |
|
| 26 |
**deliver** reads a message from the standard input and delivers it to |
| 27 |
one or more IMAP mailboxes. |
| 28 |
|
| 29 |
|
| 30 |
**deliver** |default-conf-text| |
| 31 |
|
| 32 |
Options |
| 33 |
======= |
| 34 |
|
| 35 |
.. program:: deliver |
| 36 |
|
| 37 |
.. option:: -C config-file |
| 38 |
|
| 39 |
|cli-dash-c-text| |
| 40 |
|
| 41 |
|
| 42 |
.. option:: -d |
| 43 |
|
| 44 |
Ignored for compatibility with **/bin/mail**. |
| 45 |
|
| 46 |
.. option:: -r address, --return-path=address |
| 47 |
|
| 48 |
Insert a **Return-Path:** header containing *address*. |
| 49 |
|
| 50 |
.. option:: -f address |
| 51 |
|
| 52 |
Insert a **Return-Path:** header containing *address*. |
| 53 |
|
| 54 |
.. option:: -m mailbox, --mailbox=mailbox |
| 55 |
|
| 56 |
Deliver to **mailbox**. If any *userid*\ s are specified, attempts |
| 57 |
to deliver to ``user.``\ *userid*\ ``.mailbox`` for each *userid*\ . |
| 58 |
If the ACL on any such mailbox does not grant the sender the "p" |
| 59 |
right or if **-m** is not specified, then delivers to the INBOX for |
| 60 |
the *userid*, regardless of the ACL on the INBOX. |
| 61 |
|
| 62 |
If no *userid*\ s are specified, attempts to deliver to *mailbox*\ |
| 63 |
. If the ACL on *mailbox* does not grant the sender the "p" right, |
| 64 |
the delivery fails. |
| 65 |
|
| 66 |
.. option:: -a auth-id, --auth-id=auth-id |
| 67 |
|
| 68 |
Specify the authorization id of the sender. Defaults to "anonymous". |
| 69 |
|
| 70 |
.. option:: -q, --ignore-quota |
| 71 |
|
| 72 |
Deliver message even when receiving mailbox is over quota. |
| 73 |
|
| 74 |
.. option:: -l, --lmtp |
| 75 |
|
| 76 |
Accept messages using the LMTP protocol. |
| 77 |
|
| 78 |
NOTES |
| 79 |
===== |
| 80 |
|
| 81 |
Depending on the setting of ``reject8bit`` in :cyrusman:`imapd.conf(5)`, deliver |
| 82 |
either rejects/accepts messages with 8-bit-set characters in the headers. |
| 83 |
If we accept messages with 8-bit-set characters in the headers, then depending |
| 84 |
on the setting of ``munge8bit``, these characters are either left un-touched |
| 85 |
or changed to "X". |
| 86 |
|
| 87 |
This is because such characters can't be interpreted since the |
| 88 |
character set is not known, although some communities not well-served by |
| 89 |
US-ASCII assume that those characters can be used to represent characters not |
| 90 |
present in US-ASCII. |
| 91 |
|
| 92 |
A method for encoding 8-bit-set characters is provided by :rfc:`2047`. |
| 93 |
|
| 94 |
Examples |
| 95 |
======== |
| 96 |
|
| 97 |
[NB: Examples needed] |
| 98 |
|
| 99 |
Files |
| 100 |
===== |
| 101 |
|
| 102 |
/etc/imapd.conf |
| 103 |
|
| 104 |
See Also |
| 105 |
======== |
| 106 |
:cyrusman:`lmtpd(8)` |