User Commands                                         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 PAT-
     TERN.

     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  stan-
     dard 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  destina-
          tion 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>