PMAILQ(8)

💌 PMAILQ(8) — bestie's guide to pmailq 💌

okay so. pmailq?? the Postfix Mail Queue manager?? yeah. she's that girl. let's get into it 🫶

---

✨ NAME ✨

pmailq — the Postfix Mail Queue manager. she manages the mail queue. that's the whole vibe. 👑

---

🌸 SYNOPSIS 🌸

pmailq [OPTION]... [COMMAND]

pmailq --help

---

🦋 DESCRIPTION 🦋

so basically pmailq takes the output of the Postfix mailq command and does stuff with it. iconic behavior honestly. she can:

• list the queued messages,
• parse them (machine-readably, no cap),
• or delete them in batches. 💅

and how do you pick which ones? you can select by size, by queue status, and by pattern matching (with wildcards, yes queen) on recipient addresses and server error messages. the way she just... filters. 😭

---

🎀 COMMANDS 🎀

this is the action to perform on the selected entries, bestie. pick your fighter:

• list (this is the default command) — shows a detailed listing of the selected entries (via postqueue -p).
• parse — shows a listing of the selected entries in a machine readable format. nerdy. we love her. 🤓
• del — deletes the selected entries (via postsuper -d). bye bitch 💀

---

💅 OPTIONS 💅

• -e PATTERN, --email=PATTERN — select entries in queue with email matching PATTERN. (PATTERN accepts wildcards, go wild ✨)
• -m PATTERN, --msg=PATTERN — select entries in queue with error message matching PATTERN. (PATTERN accepts wildcards too, periodt)
• -l SIZE, --size-lower=SIZE — select entries in queue with size lower than SIZE bytes.
• -u SIZE, --size-upper=SIZE — select entries in queue with size upper than SIZE bytes.
• -a — select 'active' entries in queue. she's up and she's doing things 💅
• -o — select 'on hold' entries in queue. she's on pause, respect it 🙈
• --version — show program's version number and exit.
• -h, --help — show this help message and exit.

---

🌈 EXAMPLES 🌈

Example 1 🌸

display all the entries in queue sent to an email address matching "*@example.com*" with a size between 3000 and 3200 bytes in a machine readable format:

# pmailq -u 3000 -l 3200 -e "*@example.com" parse

 7E75214643A4|Fri Aug 31|3154|1|0|edgar@example.com
 B0BDE146B640|Thu Aug 30|3199|1|0|paul@example.com
 B587E146B675|Wed Aug 29|3065|0|0|paul@example.com
 CF3C514656E4|Wed Aug 29|3161|0|0|abuse@example.com
      /\         /\       /\  \  \
   queue id     date     size  \  \ on hold (or not)
                                \ active (or not)

look at that little diagram bestie, she's literally annotating herself 😭 the way the \'s just point at the fields... iykyk.

Example 2 🔥

remove all mails in queue not sent because of a connection time out:

# pmailq -m "*connection*timed*out" del

deleting 00CF514616D3 [OK]
deleting 12D911461924 [OK]
deleting 269EF1461CA9 [OK]
deleting 288DF1461CA0 [OK]
deleting 3B3901460F62 [OK]
deleting 3AE58147019F [OK]

six for six. she ate and left no crumbs. 🍓

---

💜 SEE ALSO 💜

• postsuper(1) — privileged queue operations 👑
• postqueue(1) — mail queue control 🎀

---

🌟 AUTHOR 🌟

Emmanuel Bouthenot <kolter@openics.org> — the icon, the legend, the moment. 🫶

---

⭐ COPYRIGHT AND LICENSE ⭐

Copyright 2007-2011 by Emmanuel Bouthenot <kolter@openics.org>

This program is released under the "do What The Fuck you want to Public Licence" Version 2, as published by Sam Hocevar. yes that's the real name, i am not joking, it is giving unhinged and we respect it deeply. 💀✨

See http://sam.zoy.org/wtfpl/COPYING for more details.

---

ngl this is one of the most unbothered licenses in existence and honestly? main character energy. no cap. 🎀

anyway bestie, that's the whole page, pmailq(8), from the PMAILQ(8) manual. go clear that queue. slay 💖🦋🌸