/usr/share/doc/courier-doc/htmldoc/deliverquota.html is in courier-doc 0.66.1-1ubuntu4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 | <?xml version="1.0"?>
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>deliverquota</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"/><link rel="home" href="#id336226" title="deliverquota"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
Copyright 1998 - 2009 Double Precision, Inc. See COPYING for distribution
information.
--></head><body><div class="refentry" title="deliverquota"><a id="id336226" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>deliverquota — deliver to a maildir with a quota</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">deliverquota</code> [-c] [-w <em class="replaceable"><code>percent</code></em>] [-W <em class="replaceable"><code>filename</code></em>] {<em class="replaceable"><code>maildir</code></em>} {<em class="replaceable"><code>quota</code></em>}</p></div></div><div class="refsect1" title="DESCRIPTION"><a id="id336001" shape="rect"> </a><h2>DESCRIPTION</h2><p>
<span class="command"><strong>deliverquota</strong></span> delivers mail to a
<em class="replaceable"><code>maildir</code></em> taking into account any
software-imposed quota on the maildir.
This manually-enforced quota mechanism is described in the
<a class="ulink" href="maildirquota.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildirquota</span>(7)</span></a>
and
<a class="ulink" href="maildirmake.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildirmake</span>(1)</span></a>
manual pages.
Instead of setting up your mail
server to deliver the message directly
to a maildir, configure the mail server to
run the <span class="command"><strong>deliverquota</strong></span> program in order to deliver the
message,
and specify the
location of the maildir as the argument to
<span class="command"><strong>deliverquota</strong></span>.</p><p>
The second argument to <span class="command"><strong>deliverquota</strong></span> is optional.
If present, <em class="replaceable"><code>quota</code></em> specifies a new quota setting
for this maildir.
Specifying <em class="replaceable"><code>quota</code></em> is equivalent to running
<a class="ulink" href="maildirmake.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildirmake</span>(1)</span></a>
with the <code class="option">-q</code> option.
The second argument to <span class="command"><strong>deliverquota</strong></span> is considered obsolete,
and may be removed in the future.</p><p>
<span class="command"><strong>deliverquota</strong></span> reads the message from standard input
and delivers it
to <em class="replaceable"><code>maildir</code></em>.
<em class="replaceable"><code>maildir</code></em>
may specify a path directly to a maildir folder,
not the main <em class="replaceable"><code>maildir</code></em>
(as long as the folder was created by the
<a class="ulink" href="maildirmake.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildirmake</span>(1)</span></a> command.</p><p>
The <code class="option">-c</code> option automatically creates the maildir,
and all missing parent subdirectories (as '<span class="command"><strong>mkdir -p</strong></span>').
This option should be used with caution.</p><p>
The <code class="option">-w N</code> option places a warning message
into the maildir if the maildir has a quota setting, and after
the message was successfully delivered the maildir was at least
<em class="replaceable"><code>N</code></em> percent full.
The warning message is copied
from the file specified by the <code class="option">-W</code> option, or from
<code class="filename">/etc/courier/quotawarnmsg</code> if <code class="option">-W</code> was not
specified.
The
"<code class="literal">Date:</code>" and
"<code class="literal">Message-Id:</code>" headers are added to the message.
The warning is repeated every 24 hours (at least), until the maildir drops
below
<em class="replaceable"><code>N</code></em> percent full.</p></div><div class="refsect1" title="RETURN CODE"><a id="id370609" shape="rect"> </a><h2>RETURN CODE</h2><p>
<span class="command"><strong>deliverquota</strong></span> delivers the message to the maildir
and terminates with
exit code 0 if the message can be delivered without going over quota.</p><p>
If the maildir is over its specified quota, <span class="command"><strong>deliverquota</strong></span>
terminates with exit code 77 (EX_NOPERM).</p></div><div class="refsect1" title="SEE ALSO"><a id="id335131" shape="rect"> </a><h2>SEE ALSO</h2><p>
<a class="ulink" href="maildirquota.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildirquota</span>(7)</span></a>,
<a class="ulink" href="maildirmake.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildirmake</span>(1)</span></a>,
<a class="ulink" href="http://www.qmail.org/man/man5/maildir.html" target="_top" shape="rect">http://www.qmail.org/man/man5/maildir.html</a>.
</p></div></div></body></html>
|