From c99944cbc52cdd0770d3e1851e7a2ddbd0fe06c1 Mon Sep 17 00:00:00 2001 From: Christian Neukirchen Date: Tue, 2 Aug 2016 16:02:29 +0200 Subject: add magrep.1 --- man/magrep.1 | 88 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 man/magrep.1 (limited to 'man/magrep.1') diff --git a/man/magrep.1 b/man/magrep.1 new file mode 100644 index 0000000..b28d37c --- /dev/null +++ b/man/magrep.1 @@ -0,0 +1,88 @@ +.Dd August 2, 2016 +.Dt MAGREP 1 +.Os +.Sh NAME +.Nm magrep +.Nd print mails matching a pattern +.Sh SYNOPSIS +.Nm +.Op Fl c | Fl q +.Op Fl v +.Op Fl i +.Op Fl a | Fl d +.Ar header Ns Cm ":" Ns Ar regex +.Op Ar msgs\ ... +.Sh DESCRIPTION +.Nm +prints the messages +.Ar msgs +where the value of +.Ar header +matches the POSIX Extended Regular Expression +.Ar regex . +If +.Ar header +is empty, +.Nm +will instead match against the Maildir flags of the messages. +.Pp +See +.Xr mmsg 7 +for the message argument syntax. +If no +.Ar msgs +are passed, and +.Nm +is used interactively, +.Nm +will default to the current sequence. +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl a +Search for +.Ar regex +only in all RFC 2822 address parts in +.Ar header . +.It Fl c +Don't print matching messages, +just display the number of matched messages. +.It Fl d +Decode the +.Ar header +according to RFC 2047 first. +.It Fl i +Match +.Ar regex +case insensitively. +.It Fl q +Quiet mode: do not print anything, +quit as soon as possible. +.It Fl v +Invert the match, print (or count) all messages where +.Ar regex +does not match. +.Sh EXIT STATUS +.Nm +returns with exit status 0 if a match was found, +with exit status 1 if no match was found, +and with exit status higher than 1 if an error occurred. +.Sh SEE ALSO +.Xr grep 1 , +.Xr mmsg 7 , +.Xr regex 7 +.Sh AUTHORS +.An Christian Neukirchen Aq Mt chneukirchen@gmail.com +.Sh TRIVIA +.Nm +is not called mgrep because many tools with this name already exist. +.Sh LICENSE +.Nm +is in the public domain. +.Pp +To the extent possible under law, +the creator of this work +has waived all copyright and related or +neighboring rights to this work. +.Pp +.Lk http://creativecommons.org/publicdomain/zero/1.0/ -- cgit 1.4.1