MLIST(1)

💌 MLIST(1) — bestie's guide to listing & filtering messages 💌

okay so real talk, this is the mlist page from the General Commands Manual, and it's genuinely one of my faves. she lists messages, she filters messages, she's a whole vibe. let's get into it 🫶

✨ NAME ✨

mlist — list and filter messages 💅

🌸 SYNOPSIS 🌸

mlist [-DFPRST] [-X str]
      [-dfprst] [-x str]
      [-N | -n | -C | -c]
      [-i] [dirs ...]

look at her. so structured. so iconic. 👑

🦋 DESCRIPTION 🦋

mlist lists messages in the specified maildir folders dirs, separated by newlines. periodt. 💖

and here's the lil plot twist bestie: if you use it non-interactively and you don't specify any folders, mlist reads the directory names from the standard input. no cap. it's just slurping those folder names right off stdin. 😭

The options are as follows:

• -D — Only list messages marked as draft. ✍️
• -F — Only list messages marked as flagged. 🚩
• -P — Only list messages marked as passed (resent/forwarded/bounced). 📤
• -R — Only list messages marked as replied-to. 💬
• -S — Only list messages marked as seen. 👀
• -T — Only list messages marked as trashed. 🗑️
• -X str — Only list messages marked with the characters in str.
• -d — Don't list messages marked as draft.
• -f — Don't list messages marked as flagged.
• -p — Don't list messages marked as passed (resent/forwarded/bounced).
• -r — Don't list messages marked as replied-to.
• -s — Don't list messages marked as seen.
• -t — Don't list messages marked as trashed.
• -x str — Don't list messages marked with the characters in str. (Remember to use uppercase characters.) ⚠️
• -C — Only list messages in cur.
• -N — Only list messages in new.
• -c — Don't list messages in cur.
• -n — Don't list messages in new.
• -i — Don't print filenames. Instead, print a one-line summary for each folder, showing the number of unseen, flagged and total messages, along with the folder name. If any of the message selection flags are used, the number of matching messages is printed as well. If two or more folders are specified, a total for all folders will also be printed at the end. 📊

💀 heads up bestie: Multiple options are regarded as a conjunction. so they're all getting AND-ed together, not OR-ed. they're a package deal, fr fr.

🎀 EXIT STATUS 🎀

The mlist utility exits 0 on success, and >0 if an error occurs. clean exit = slay, anything else = something went sideways. 😌

🌈 SEE ALSO 🌈

• find(1)
• Using maildir format: https://cr.yp.to/proto/maildir.html

👑 AUTHORS 👑

Leah Neukirchen <leah@vuxu.org> — an absolute legend, no notes. 💜

🧚 LICENSE 🧚

mlist is in the public domain. 🕊️

To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.

http://creativecommons.org/publicdomain/zero/1.0/

and that's the whole page bestie, tysm for reading 💖 this one shipped with Debian, dated April 30, 2020 — so like, vintage but still eating. 🍓✨