DELIVERQUOTA(8)

💖 NAME 💖

okay so listen — this is deliverquota from section 8 of the manual (the admin-commands girlies), and her whole job is: deliver to a maildir with a quota. that's it, that's the vibe. 👑

---

✨ SYNOPSIS ✨

deliverquota [-c] [-w percent] [-W filename] {maildir} {quota}

---

🦋 DESCRIPTION 🦋

bestie, here's the tea 🍓: deliverquota delivers mail to a maildir, and it takes into account any software-imposed quota on that maildir. like, it's not out here ignoring the limits. this manually-enforced quota mechanism is the whole thing described in the maildirquota(7)[1] and maildirmake(1)[2] manual pages. iykyk.

so instead of setting up your mail server to deliver the message directly to a maildir, you configure the mail server to run the deliverquota program to deliver the message, and you hand it the location of the maildir as the argument. that's the move. ✨

the second argument to deliverquota is optional. if it's there, quota specifies a new quota setting for this maildir. specifying quota is equivalent to running maildirmake(1)[2] with the -q option. but — and i'm saying this with love — the second argument to deliverquota is considered obsolete, and it may be removed in the future. so don't get too attached. 💀

deliverquota reads the message from standard input and delivers it to maildir. and get this: maildir may specify a path directly to a maildir folder, not the main maildir — as long as the folder was created by the maildirmake(1)[2] command. flexible queen 💅

here's the options breakdown, one by one, no skipping:

• -c — automatically creates the maildir, plus all the missing parent subdirectories (as in mkdir -p). ⚠️ this option should be used with caution. like, for real, be careful with her.
• -w N — drops 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 N percent full. the warning message is copied from the file specified by the -W option, or from /etc/quotawarnmsg if -W was not specified. the "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. 🔔

---

🌸 RETURN CODE 🌸

deliverquota delivers the message to the maildir and terminates with exit code 0 if the message can be delivered without going over quota. clean, simple, slay. ✅

but if the maildir is over its specified quota? different story, bestie:

• 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).

two different exit codes depending on which version you got. know your version. 🫶

---

🌈 SEE ALSO 🌈

maildirquota(7)[1], maildirmake(1)[2].

---

👑 AUTHOR 👑

Sam Varshavchik — Author. iconic. periodt. 💜

---

🎀 NOTES 🎀

1. maildirquota(7) — http://www.courier-mta.org/maildirquota.html
2. maildirmake(1) — http://www.courier-mta.org/maildirmake.html

---

okay that's the whole page, no cap. now go forth and deliver responsibly. 💖✨

this was brought to you by the Courier Mail Server, dated 11/12/2022 — mwah, take care of your maildirs bestie 🦋💅