1MBOXGREP(1) General Commands Manual MBOXGREP(1)
2
6 mboxgrep - displays email messages matching a pattern
7
9 mboxgrep [OPTIONS] PATTERN [MAILBOX]
10
12 This manual page refers to mboxgrep version 0.7.9.
13 mboxgrep scans a MAILBOX and displays messages matching PATTERN.
15 If a mailbox name is ommited, or a single dash (-) is given instead, it
17 reads from standard input. It can read mbox folders or output from
18 another mboxgrep process from standard input.
19 mboxgrep understands POSIX regular expressions, as well as Perl compat‐
21 ible regular expressions (if enabled at compile time). MAILBOX can be
22 either a:
23 · mbox folder (either plain or compressed)
25 · MH folder
27 · Gnus nnmh or nnml folder
29 · qmail-style maildir folder
31
33 -h, --help
34 Display a help screen and exit.
35 -V, --version
37 Display version and copyright information and exit.
38 -r, --recursive
40 Descend into directories recursively.
41 -E, --extended-regexp
43 PATTERN is an extended regular expression. This is default.
44 -G, --basic-regexp
46 PATTERN is a basic regular expression.
47 -P, --perl-regexp
49 PATTERN is a Perl regular expression. Works only if enabled at
50 compile time.
51 -e, --regexp=PATTERN
53 Use PATTERN as a regular expression.
54 -i, --ignore-case
56 Ignore case distinctions.
57 -v, --invert-match
59 Select messages which don't match PATTERN.
60 -H, --headers
62 Match PATTERN against message headers.
63 -B, --body
65 Match PATTERN against message body.
66 -l, --file-lock=METHOD
68 Select file locking METHOD. METHOD is `fcntl', `flock', or
69 `none'.
70 -nl, --no-file-lock
72 Do not lock files. This option is meaningful only if a mbox
73 folder (see below) is scanned.
74 -c, --count
76 Suppress normal output and print a count of matching messages.
77 -o, --output=FOLDER
79 Suppress normal output and write messages to destination folder
80 FOLDER instead.
81 -p, --pipe=COMMAND
83 Pipe each found message to COMMAND
84 -d, --delete
86 Suppress normal output and delete selected messages instead.
87 Use with caution.
88 -nd, --no-duplicates
90 Ignore duplicate messages.
91 -m, --mailbox-format=TYPE
93 Select input and output mailbox TYPE. TYPE can be either `mbox'
94 (default), `zmbox' (meaning `gzip compressed mbox'), `bz2mbox'
95 (meaning `bzip2 compressed mbox'), `mh', `nnml', `nnmh' or
96 `maildir'.
97
99 · Search $MAIL for messages from Dirty Harry:
100 mboxgrep '^From:.*callahan@homicide\.SFPD\.gov' $MAIL
102 · Display all messages contained in folder ~/Mail/incoming, except
104 those that appear to originate from AOL:
105 mboxgrep -v 'Received:.*aol\.com' ~/Mail/incoming
107
109 Report them to address below.
110
112 Mboxgrep was alomost completely rewritten since version 0.5.3. Addi‐
113 tionally, there was no stable 0.6.x branch between 0.5.3 and 0.7.0.
114
116 grep(1), regex(7), perlre(1), mbox(5), RFC 2822
117
119 Mboxgrep is dedicated in loving memory of Vicky, my cat who died of
120 tumor on Sep 12, 2002.
121 You haven't been long with us, but you gave us a lot of joy and all
123 your big heart that stopped ticking too early. I will never forget
124 you. Sleep well, little friend.
125
127 http://www.mboxgrep.org/
128
130 Daniel Spiljar <dspiljar@world.std.com>
131 24 Aug 2003 MBOXGREP(1)