deliver - Man Page

Name

deliver — Cyrus IMAP documentation

intro

Synopsis

deliver [ -C config-file ] [ -d ] [ -r address ]
       [ -f address ] [ -m mailbox ] [ -a auth-id ]
       [ -q ] [ userid ]...
deliver [ -C config-file ] -l

Description

deliver reads a message from the standard input and delivers it to one or more IMAP mailboxes.

deliver reads its configuration options out of the imapd.conf(5) file unless specified otherwise by -C​.

Options

-C config-file

Use the specified configuration file config-file rather than the default imapd.conf(5)​.

-d

Ignored for compatibility with /bin/mail​.

-r address, --return-path=address

Insert a Return-Path: header containing address​.

-f address

Insert a Return-Path: header containing address​.

-m mailbox, --mailbox=mailbox

Deliver to mailbox​.  If any userids are specified, attempts to deliver to user.userid​.mailbox for each userid​. If the ACL on any such mailbox does not grant the sender the "p" right or if -m is not specified, then delivers to the INBOX for the userid, regardless of the ACL on the INBOX.

If no userids are specified, attempts to deliver to mailbox​. If the ACL on mailbox does not grant the sender the "p" right, the delivery fails.

-a auth-id, --auth-id=auth-id

Specify the authorization id of the sender.  Defaults to "anonymous".

-q,  --ignore-quota

Deliver message even when receiving mailbox is over quota.

-l,  --lmtp

Accept messages using the LMTP protocol.

Notes

Depending on the setting of reject8bit in imapd.conf(5), deliver either rejects/accepts messages with 8-bit-set characters in the headers. If we accept messages with 8-bit-set characters in the headers, then depending on the setting of munge8bit, these characters are either left un-touched or changed to "X".

This is because such characters can't be interpreted since the character set is not known, although some communities not well-served by US-ASCII assume that those characters can be used to represent characters not present in US-ASCII.

A method for encoding 8-bit-set characters is provided by RFC 2047​.

Examples

[NB: Examples needed]

Files

/etc/imapd.conf

See Also

lmtpd(8)

Author

The Cyrus Team, Nic Bernstein (Onlight)

Info

Sep 09, 2026 3.12.4 Cyrus IMAP