1MBOXGREP(1)                 General Commands Manual                MBOXGREP(1)
2
3
4

NAME

6       mboxgrep - displays email messages matching a pattern
7

SYNOPSIS

9       mboxgrep [OPTIONS] PATTERN [MAILBOX]
10

DESCRIPTION

12       This manual page refers to mboxgrep version 0.7.9.
13
14       mboxgrep scans a MAILBOX and displays messages matching PATTERN.
15
16       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
20       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
24       ·      mbox folder (either plain or compressed)
25
26       ·      MH folder
27
28       ·      Gnus nnmh or nnml folder
29
30       ·      qmail-style maildir folder
31

OPTIONS

33       -h, --help
34              Display a help screen and exit.
35
36       -V, --version
37              Display version and copyright information and exit.
38
39       -r, --recursive
40              Descend into directories recursively.
41
42       -E, --extended-regexp
43              PATTERN is an extended regular expression.  This is default.
44
45       -G, --basic-regexp
46              PATTERN is a basic regular expression.
47
48       -P, --perl-regexp
49              PATTERN  is a Perl regular expression.  Works only if enabled at
50              compile time.
51
52       -e, --regexp=PATTERN
53              Use PATTERN as a regular expression.
54
55       -i, --ignore-case
56              Ignore case distinctions.
57
58       -v, --invert-match
59              Select messages which don't match PATTERN.
60
61       -H, --headers
62              Match PATTERN against message headers.
63
64       -B, --body
65              Match PATTERN against message body.
66
67       -l, --file-lock=METHOD
68              Select file locking METHOD.   METHOD  is  `fcntl',  `flock',  or
69              `none'.
70
71       -nl, --no-file-lock
72              Do  not  lock  files.   This option is meaningful only if a mbox
73              folder (see below) is scanned.
74
75       -c, --count
76              Suppress normal output and print a count of matching messages.
77
78       -o, --output=FOLDER
79              Suppress normal output and write messages to destination  folder
80              FOLDER instead.
81
82       -p, --pipe=COMMAND
83              Pipe each found message to COMMAND
84
85       -d, --delete
86              Suppress  normal  output  and  delete selected messages instead.
87              Use with caution.
88
89       -nd, --no-duplicates
90              Ignore duplicate messages.
91
92       -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

EXAMPLES

99       ·      Search $MAIL for messages from Dirty Harry:
100
101       mboxgrep '^From:.*callahan@homicide\.SFPD\.gov' $MAIL
102
103       ·      Display all messages contained in folder ~/Mail/incoming, except
104              those that appear to originate from AOL:
105
106       mboxgrep -v 'Received:.*aol\.com' ~/Mail/incoming
107

BUGS

109       Report them to address below.
110

NOTICE

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

SEE ALSO

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

DEDICATION

119       Mboxgrep  is  dedicated  in  loving memory of Vicky, my cat who died of
120       tumor on Sep 12, 2002.
121
122       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

URL

127       http://www.mboxgrep.org/
128

AUTHOR

130       Daniel Spiljar <dspiljar@world.std.com>
131
132
133
134                                  24 Aug 2003                      MBOXGREP(1)
Impressum