MBOXGREP(1)						      General Commands Manual						       MBOXGREP(1)

NAME

       mboxgrep - displays email messages matching a pattern

SYNOPSIS

       mboxgrep [OPTIONS] PATTERN [MAILBOX]

DESCRIPTION

       This manual page refers to mboxgrep version 0.7.9.

       mboxgrep scans a MAILBOX and displays messages matching PATTERN.

       If a mailbox name is ommited, or a single dash (-) is given instead, it reads from standard input.  It can read mbox folders or output from
       another mboxgrep process from standard input.

       mboxgrep understands POSIX regular expressions, as well as Perl compatible regular expressions (if enabled at compile time).   MAILBOX  can
       be either a:

       o      mbox folder (either plain or compressed)

       o      MH folder

       o      Gnus nnmh or nnml folder

       o      qmail-style maildir folder

OPTIONS

       -h, --help
	      Display a help screen and exit.

       -V, --version
	      Display version and copyright information and exit.

       -r, --recursive
	      Descend into directories recursively.

       -E, --extended-regexp
	      PATTERN is an extended regular expression.  This is default.

       -G, --basic-regexp
	      PATTERN is a basic regular expression.

       -P, --perl-regexp
	      PATTERN is a Perl regular expression.  Works only if enabled at compile time.

       -e, --regexp=PATTERN
	      Use PATTERN as a regular expression.

       -i, --ignore-case
	      Ignore case distinctions.

       -v, --invert-match
	      Select messages which don't match PATTERN.

       -H, --headers
	      Match PATTERN against message headers.

       -B, --body
	      Match PATTERN against message body.

       -l, --file-lock=METHOD
	      Select file locking METHOD.  METHOD is `fcntl', `flock', or `none'.

       -nl, --no-file-lock
	      Do not lock files.  This option is meaningful only if a mbox folder (see below) is scanned.

       -c, --count
	      Suppress normal output and print a count of matching messages.

       -o, --output=FOLDER
	      Suppress normal output and write messages to destination folder FOLDER instead.

       -p, --pipe=COMMAND
	      Pipe each found message to COMMAND

       -d, --delete
	      Suppress normal output and delete selected messages instead.  Use with caution.

       -nd, --no-duplicates
	      Ignore duplicate messages.

       -m, --mailbox-format=TYPE
	      Select  input  and  output  mailbox  TYPE.  TYPE can be either `mbox' (default), `zmbox' (meaning `gzip compressed mbox'), `bz2mbox'
	      (meaning `bzip2 compressed mbox'), `mh', `nnml', `nnmh' or `maildir'.

EXAMPLES

       o      Search $MAIL for messages from Dirty Harry:

       mboxgrep '^From:.*callahan@homicide.SFPD.gov' $MAIL

       o      Display all messages contained in folder ~/Mail/incoming, except those that appear to originate from AOL:

       mboxgrep -v 'Received:.*aol.com' ~/Mail/incoming

BUGS

       Report them to address below.

NOTICE

       Mboxgrep was alomost completely rewritten since version 0.5.3.  Additionally, there was no stable 0.6.x branch between 0.5.3 and 0.7.0.

SEE ALSO

       grep(1), regex(7), perlre(1), mbox(5), RFC 2822

DEDICATION

       Mboxgrep is dedicated in loving memory of Vicky, my cat who died of tumor on Sep 12, 2002.

       You haven't been long with us, but you gave us a lot of joy and all your big heart that stopped ticking too early.   I  will  never  forget
       you.  Sleep well, little friend.

URL

       http://www.mboxgrep.org/

AUTHOR

       Daniel Spiljar <dspiljar@world.std.com>

								    24 Aug 2003 						       MBOXGREP(1)