From bb065ca6b62de590f87a214c688970e7a80788d9 Mon Sep 17 00:00:00 2001 From: Sam Varshavchik Date: Sat, 4 Jun 2022 16:36:56 -0400 Subject: Update deliverquota man page. --- maildir/deliverquota.sgml | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/maildir/deliverquota.sgml b/maildir/deliverquota.sgml index 9c59183..74e6a80 100644 --- a/maildir/deliverquota.sgml +++ b/maildir/deliverquota.sgml @@ -17,7 +17,7 @@ - deliverquota + deliverquota -c -w percent -W filename @@ -30,7 +30,7 @@ DESCRIPTION -deliverquota delivers mail to a +deliverquota delivers mail to a maildir taking into account any software-imposed quota on the maildir. This manually-enforced quota mechanism is described in the @@ -41,24 +41,24 @@ manual pages. Instead of setting up your mail server to deliver the message directly to a maildir, configure the mail server to -run the deliverquota program in order to deliver the +run the deliverquota program in order to deliver the message, and specify the location of the maildir as the argument to -deliverquota. +deliverquota. -The second argument to deliverquota is optional. +The second argument to deliverquota is optional. If present, quota specifies a new quota setting for this maildir. Specifying quota is equivalent to running maildirmake1 with the option. -The second argument to deliverquota is considered obsolete, +The second argument to deliverquota is considered obsolete, and may be removed in the future. -deliverquota reads the message from standard input +deliverquota reads the message from standard input and delivers it to maildir. maildir @@ -69,7 +69,7 @@ not the main maildir The option automatically creates the maildir, -and all missing parent subdirectories (as 'mkdir -p'). +and all missing parent subdirectories (as 'mkdir -p'). This option should be used with caution. @@ -79,11 +79,11 @@ the message was successfully delivered the maildir was at least N percent full. The warning message is copied from the file specified by the option, or from -@sysconfdir@/quotawarnmsg if was not +@sysconfdir@/quotawarnmsg if was not specified. The -"Date:" and -"Message-Id:" headers are added to the message. +"Date:" and +"Message-Id:" headers are added to the message. The warning is repeated every 24 hours (at least), until the maildir drops below N percent full. @@ -94,13 +94,16 @@ below RETURN CODE -deliverquota delivers the message to the maildir +deliverquota delivers the message to the maildir and terminates with exit code 0 if the message can be delivered without going over quota. -If the maildir is over its specified quota, deliverquota -terminates with exit code 77 (EX_NOPERM). + If the maildir is over its specified quota: the maildrop version of + deliverquota + terminates with an exit code 77 (EX_NOPERM); the Courier version of + deliverquota + terminates with an exit code 75 (EX_TEMPFAIL). -- cgit v1.2.3