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

FreeBSD Manual Pages

  
 
  

home | help
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.13.

     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:

     *	    mbox folder (either plain or compressed)

     *	    MH folder

     *	    Gnus nnmh or nnml folder

     *	    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 com-
	    pile 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=MAILBOX
	    Suppress normal output and write messages to destination MAILBOX in-
	    stead.

     -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' (gzip compressed  mbox),  `bz2mbox'  (bzip2  com-
	    pressed mbox), `mh', `nnml', `nnmh' or `maildir'.

     -s, --no-messages
	    Suppress most error messages.

     --debugPrint messages useful for debugging.

EXAMPLES
     *	    Search $MAIL for messages from Dirty Harry:

     mboxgrep '^From:.*callahan@sanfranciscopolice\.org' $MAIL

     *	    Re-mail to George messages that mention his name:

     mboxgrep --pipe="/usr/lib/sendmail george" --ignore-case george ~/Mail/*

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

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

     *	    Do a case-insensitive scan of ~/Mail/incoming for messages with sub-
	    ject ``Weekly News'' and write them to folder ~/Mail/archive:

     mboxgrep -o ~/Mail/archive -H -i '^Subject: Weekly News' ~/Mail/incoming

     *	    Count all messages stored in folder spam, ignoring duplicates:

     mboxgrep -nd -c . spam

BUGS
     Report them to address below.

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

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.

HOMEPAGE
     https://www.mboxgrep.org/

GIT
     https://git.datatipp.se/dspiljar/mboxgrep

     https://github.com/dspiljar/mboxgrep

AUTHOR
     Daniel Spiljar <dspiljar@datatipp.se>

				23 September 2024		     MBOXGREP(1)

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

home | help