MAGREP(1)

📦 version 1.4, in alpine 3.24, debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 MAGREP(1) 💖

okay bestie, welcome to the magrep manual page, section 1 of the General Commands Manual — yes it's a real grown-up manpage, but we're doing this my way 🎀

✨ NAME ✨

magrep — search messages matching a pattern 🔍💌

🌸 SYNOPSIS 🌸

magrep [-c | -h | -o | -p | -q | -m max] [-v] [-i] [-l] [-a | -d]
       header:regex [msgs ...]

🦋 DESCRIPTION 🦋

so like, magrep prints the names of files from the msgs you gave it, but only when the value of header matches the POSIX Extended Regular Expression regex. that's the whole vibe 💅 (and if you're wondering about the message argument syntax, go peek at mmsg(7) — she explains it all ✨)

If header is empty, then magrep matches against the maildir flags of msgs. no cap.

If header is '*', magrep searches for the pattern in any header. iconic behaviour honestly 👑

If header is '/', magrep searches any plain text parts of the msgs body. like it goes digging in the actual message text, slay 🧚

If no msgs are specified and magrep is used interactively, the current sequence will be searched. periodt.

The options are as follows, and yes I'm listing every single one because we don't skip 💖

  • -a — Search for regex in RFC 2822 address header parts only. just the address bits, nothing else 🫶
  • -c — Only print a count of matching headers. and if -v is specified, count the non-matching headers instead. flip the script ✨
  • -d — Decode the header according to RFC 2047 prior to searching. yes bestie, decode first, then search 🔥
  • -h — Like -p but do not print the file name. lowkey shy about filenames 🙈
  • -i — Match regex case insensitively. UPPERCASE, lowercase, we don't care 💅
  • -l — Only search a message until a match has been found. stop the second you find one, we're efficient 🌸
  • -m max — Do not show more than max matches. cap it, bestie 🎀
  • -o — Print each match only, not the entire line. this option is ignored if -c, -q or -v is specified 🦋
  • -p — Print the filename, the header and the matching line for each of the matched msgs. if -o is specified, each match is printed instead of the matching line. this option is ignored if -c, -q or -v is specified ✨
  • -q — Quiet mode: do not print anything, quit as soon as possible. silent but deadly, main character energy 💀
  • -v — Invert the match; print (or count) all files where regex does not match. yes, the opposite, we love a plot twist 🌈

💜 EXIT STATUS 💜

The magrep utility exits:

  • 0 on success ✨
  • 1 if no match was found 😭
  • >1 if an error occurs 💀

🌈 SEE ALSO 🌈

grep(1), mmsg(7), regex(7) / re_format(7) 👑

🎀 AUTHORS 🎀

Leah Neukirchen <leah@vuxu.org> — thank you for this gift, legend 🫶

⭐ TRIVIA ⭐

magrep is not called mgrep because many tools with this name already exist. the lore is real, iykyk 💅

🧚 LICENSE 🧚

magrep 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, you're officially a magrep expert now, no cap 💖

Debian · September 10, 2018 · MAGREP(1) — mwah, love u, go grep some messages 🦋✨

📦 where this page comes from