mirror of
https://github.com/leahneukirchen/mblaze
synced 2024-11-07 15:20:37 +00:00
7eed9240a7
- Try not to use 'messages msgs' - 'matches' instead of 'instead match' - 'specified' instead of 'passed' - Clarify default use of current sequence - Simplify some language used - List '-p' output in the order it is printed - Remove superfluous 'the' - Bring EXIT STATUS in line with '.Ex -std' Closes: #42 [via git-merge-pr]
127 lines
2.0 KiB
Groff
127 lines
2.0 KiB
Groff
.Dd February 15, 2017
|
|
.Dt MAGREP 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm magrep
|
|
.Nd print mails matching a pattern
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl c | Fl q | Fl m Ar max
|
|
.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 names of files from the specified
|
|
.Ar msgs
|
|
if the value of
|
|
.Ar header
|
|
matches the POSIX Extended Regular Expression
|
|
.Ar regex .
|
|
.Pp
|
|
If
|
|
.Ar header
|
|
is empty,
|
|
.Nm
|
|
matches against the Maildir flags of
|
|
.Ar msgs .
|
|
.Pp
|
|
If
|
|
.Ar header
|
|
is
|
|
.Sq Cm \&/ ,
|
|
.Nm
|
|
searches any plain text parts of the
|
|
.Ar msgs
|
|
body.
|
|
.Pp
|
|
See
|
|
.Xr mmsg 7
|
|
for the message argument syntax.
|
|
If no
|
|
.Ar msgs
|
|
are specified, and
|
|
.Nm
|
|
is used interactively,
|
|
the current sequence will be searched.
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width Ds
|
|
.It Fl a
|
|
Search for
|
|
.Ar regex
|
|
in RFC 2822 address
|
|
.Ar header
|
|
parts only.
|
|
.It Fl c
|
|
Only print a count of matching messages.
|
|
.It Fl d
|
|
Decode the
|
|
.Ar header
|
|
according to RFC 2047 prior to searching.
|
|
.It Fl i
|
|
Match
|
|
.Ar regex
|
|
case insensitively.
|
|
.It Fl m Ar max
|
|
Do not show more than
|
|
.Ar max
|
|
matches.
|
|
.It Fl o
|
|
Print each match only,
|
|
not the entire line.
|
|
This option is ignored if
|
|
.Fl c ,
|
|
.Fl q
|
|
or
|
|
.Fl v
|
|
is specified.
|
|
.It Fl p
|
|
Print the file name,
|
|
the header and the matching line
|
|
for each of the matched
|
|
.Ar msgs .
|
|
If
|
|
.Fl o
|
|
is specified each match is printed,
|
|
instead of the matching line.
|
|
This option is ignored if
|
|
.Fl c ,
|
|
.Fl q
|
|
or
|
|
.Fl v
|
|
is specified.
|
|
.It Fl q
|
|
Quiet mode: do not print anything,
|
|
quit as soon as possible.
|
|
.It Fl v
|
|
Invert the match; print (or count) all files where
|
|
.Ar regex
|
|
does not match.
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Nm
|
|
exits 0 on success, 1 if no match was found
|
|
and >1 if an error occurs.
|
|
.Sh SEE ALSO
|
|
.Xr grep 1 ,
|
|
.Xr mmsg 7 ,
|
|
.Xr regex 7
|
|
.Sh AUTHORS
|
|
.An Leah Neukirchen Aq Mt leah@vuxu.org
|
|
.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/
|