Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MAGREP(1)		    General Commands Manual		     MAGREP(1)

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
       magrep prints the names of files	from the specified msgs	if  the	 value
       of  header  matches  the	POSIX Extended Regular Expression regex.  (See
       mmsg(7) for the message argument	syntax.)

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

       If header is `*', magrep	searches for the pattern in any	header.

       If header is `/', magrep	searches any plain  text  parts	 of  the  msgs
       body.

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

       The options are as follows:

       -a      Search for regex	in RFC 2822 address header parts only.

       -c      Only print a count of matching headers.	If  -v	is  specified,
	       count non-matching headers instead.

       -d      Decode the header according to RFC 2047 prior to	searching.

       -h      Like -p but do not print	the file name.

       -i      Match regex case	insensitively.

       -l      Only search a message until a match has been found.

       -m max  Do not show more	than max matches.

       -o      Print each match	only, not the entire line.  This option	is ig-
	       nored 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.

       -v      Invert the match; print (or count) all files where  regex  does
	       not match.

EXIT STATUS
       The  magrep  utility exits 0 on success,	1 if no	match was found	and >1
       if an error occurs.

SEE ALSO
       grep(1),	mmsg(7), regex(7) / re_format(7)

AUTHORS
       Leah Neukirchen <leah@vuxu.org>

TRIVIA
       magrep is not called mgrep because many tools with  this	 name  already
       exist.

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/

FreeBSD	Ports 14.quarterly    September	10, 2018		     MAGREP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=magrep&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help