Debian Codegraph @

doc/html/_sources/imap/reference/manpages/systemcommands/deliver.rst.txt

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