<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><link rel='stylesheet' type='text/css' href='manpage.css'> <!-- $Id: deliverquota.sgml,v 1.3 2002/06/10 03:51:44 mrsam Exp $ --> <!-- Copyright 1998 - 2001 Double Precision, Inc. See COPYING for --> <!-- distribution information. --> <meta name="MSSmartTagsPreventParsing" content="TRUE"> <link rel="icon" href="icon.gif" type="image/gif" /> <TITLE >deliverquota</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><H1 ><A NAME="DELIVERQUOTA" ></A >deliverquota</H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN10" ></A ><H2 >Name</H2 >deliverquota -- deliver to a maildir with a quota</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN13" ></A ><H2 >Synopsis</H2 ><P ><B CLASS="COMMAND" >deliverquota</B > [-c] [-w <VAR CLASS="REPLACEABLE" >percent</VAR >] {<VAR CLASS="REPLACEABLE" >maildir</VAR >} {<VAR CLASS="REPLACEABLE" >quota</VAR >}</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN23" ></A ><H2 >DESCRIPTION</H2 ><P ><B CLASS="COMMAND" >deliverquota</B > delivers mail to a <VAR CLASS="REPLACEABLE" >maildir</VAR > taking into account any software-imposed quota on the maildir. This manually-enforced quota mechanism is described in the <A HREF="maildirquota.html" TARGET="_top" ><SPAN CLASS="CITEREFENTRY" ><SPAN CLASS="REFENTRYTITLE" >maildirquota</SPAN >(7)</SPAN ></A > and <A HREF="maildirmake.html" TARGET="_top" ><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 <B CLASS="COMMAND" >deliverquota</B > program in order to deliver the message, and specify the location of the maildir as the argument to <B CLASS="COMMAND" >deliverquota</B >.</P ><P >The second argument to <B CLASS="COMMAND" >deliverquota</B > is optional. If present, <VAR CLASS="REPLACEABLE" >quota</VAR > specifies a new quota setting for this maildir. Specifying <VAR CLASS="REPLACEABLE" >quota</VAR > is equivalent to running <A HREF="maildirmake.html" TARGET="_top" ><SPAN CLASS="CITEREFENTRY" ><SPAN CLASS="REFENTRYTITLE" >maildirmake</SPAN >(1)</SPAN ></A > with the <VAR CLASS="OPTION" >-q</VAR > option. The second argument to <B CLASS="COMMAND" >deliverquota</B > is considered obsolete, and may be removed in the future.</P ><P ><B CLASS="COMMAND" >deliverquota</B > reads the message from standard input and delivers it to <VAR CLASS="REPLACEABLE" >maildir</VAR >. <VAR CLASS="REPLACEABLE" >maildir</VAR > may specify a path directly to a maildir folder, not the main <VAR CLASS="REPLACEABLE" >maildir</VAR > (as long as the folder was created by the <A HREF="maildirmake.html" TARGET="_top" ><SPAN CLASS="CITEREFENTRY" ><SPAN CLASS="REFENTRYTITLE" >maildirmake</SPAN >(1)</SPAN ></A > command.</P ><P >The <VAR CLASS="OPTION" >-c</VAR > option automatically creates the maildir, and all missing parent subdirectories (as '<B CLASS="COMMAND" >mkdir -p</B >'). This option should be used with caution.</P ><P >The <VAR CLASS="OPTION" >-w N</VAR > 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 <VAR CLASS="REPLACEABLE" >N</VAR > percent full. The warning message is copied verbatim from <TT CLASS="FILENAME" >/etc/quotawarnmsg</TT > with the addition of the "<TT CLASS="LITERAL" >Date:</TT >" and "<TT CLASS="LITERAL" >Message-Id:</TT >" headers. The warning is repeated every 24 hours (at least), until the maildir drops below <VAR CLASS="REPLACEABLE" >N</VAR > percent full.</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN67" ></A ><H2 >RETURN CODE</H2 ><P ><B CLASS="COMMAND" >deliverquota</B > 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, <B CLASS="COMMAND" >deliverquota</B > terminates with exit code 77 (EX_NOPERM).</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN73" ></A ><H2 >SEE ALSO</H2 ><P ><A HREF="maildirquota.html" TARGET="_top" ><SPAN CLASS="CITEREFENTRY" ><SPAN CLASS="REFENTRYTITLE" >maildirquota</SPAN >(7)</SPAN ></A >, <A HREF="maildirmake.html" TARGET="_top" ><SPAN CLASS="CITEREFENTRY" ><SPAN CLASS="REFENTRYTITLE" >maildirmake</SPAN >(1)</SPAN ></A >, <A HREF="http://www.qmail.org/man/man5/maildir.html" TARGET="_top" >http://www.qmail.org/man/man5/maildir.html</A >.</P ></DIV ></BODY ></HTML >