DELIVERQUOTA(8) DELIVERQUOTA(8)
NAME
deliverquota - deliver to a maildir(1,5) with a quota(1,8)
SYNOPSIS
deliverquota [ -c ] [ -w percent ] maildir(1,5) quota(1,8)
DESCRIPTION
deliverquota delivers mail(1,8) to a maildir(1,5) taking into account any soft-
ware-imposed quota(1,8) on the maildir. This manually-enforced quota(1,8) mecha-
nism is described in(1,8) the maildirquota(7) and maildirmake(1) manual
pages. Instead of setting up your mail(1,8) server to deliver the message
directly to a maildir(1,5), configure the mail(1,8) server to run the deliv-
erquota program in(1,8) order to deliver the message, and specify the loca-
tion of the maildir(1,5) as the argument to deliverquota.
The second argument to deliverquota is optional. If present, quota(1,8)
specifies a new quota(1,8) setting for this maildir. Specifying quota(1,8) is
equivalent to running maildirmake(1) with the -q option. The second
argument to deliverquota is considered obsolete, and may be removed in(1,8)
the future.
deliverquota reads the message from standard input and delivers it to
maildir(1,5). maildir(1,5) may specify a path directly to a maildir(1,5) folder, not
the main maildir(1,5) (as long as the folder was created by the
maildirmake(1) command.
The -c option automatically creates the maildir(1,5), and all missing parent
subdirectories (as 'mkdir(1,2) -p'). This option should be used with cau-
tion.
The -w N option places a warning message into the maildir(1,5) if(3,n) the
maildir(1,5) has a quota(1,8) setting, and after the message was successfully
delivered the maildir(1,5) was at least N percent full. The warning message
is copied verbatim from /etc/courier-imap/quotawarnmsg with the addi-
tion of the "Date:" and "Message-Id:" headers. The warning is repeated
every 24 hours (at least), until the maildir(1,5) drops below N percent
full.
RETURN CODE
deliverquota delivers the message to the maildir(1,5) and terminates with
exit(3,n,1 builtins) code 0 if(3,n) the message can be delivered without going over quota.
If the maildir(1,5) is over its specified quota(1,8), deliverquota terminates
with exit(3,n,1 builtins) code 77 (EX_NOPERM).
SEE ALSO
maildirquota(7), maildirmake(1),
http://www.qmail.org/man(1,5,7)/man5/maildir.html.
Double Precision, Inc. 07 February 2004 DELIVERQUOTA(8)