Daniel Spiljar
0649ac9320
2003 and 2006 and haven't been tracked by any SCM. The changes are the following, in reverse order: * src/mboxgrep.h, src/main.c, src/mbox.c, src/mbox.h, src/scan.c: Temporary mbox file (used for deleting messages) is now created by tmpmbox_create(); tmpp global pointer is killed; portions of code in scan.c are replaced by single call of mbox_write_message(); scan.c no longer includes zlib.h and bzlib.h. * src/mboxgrep.h, src/main.c, src/maildir.c, src/scan.c: Got rid off tmpp and maildir_count global variables (code cleanup). * src/mboxgrep.h, src/main.c, src/scan.c: Introduction of the global runtime_t structure; mailbox counter, MD5 hash and other global variables are now part of it (code cleanup). * src/mboxgrep.h, src/re.c, src/re.h, src/scan.c: Portions of scan_mailbox() have been moved to new functions, pcre_match() and regex_match() (code cleanup). * src/main.c, src/mboxgrep.h, src/re.c, src/re.h, src/scan.c: main() has been partially uncluttered by moving portions of the code to functions pcre_init() and regex_init(). * src/main.c, src/mboxgrep.h, src/misc.c, src/misc.h: Variables regex_s and haveregex are now part of the option_t structure (code cleanup). * src/main.c, src/misc.c, src/misc.h: Parts of main() have been moved to set_default_options() and get_runtime_options() (code cleanup). * src/mbox.c, src/mbox.h: File mode and ownership-altering code has been moved to a separate function, tmpfile_mod_own (code cleanup). * src/mbox.c, src/mbox.h: Portions of the code from tmpfile_open moved to a new function, tmpfile_name (code cleanup). * src/maildir.c, src/mh.c: Removed some unused variables (have_return_path). * src/mboxgrep.h, src/maildir.c, src/mh.c, src/mbox.c, src/scan.c, src/main.c: boxname, outboxname, pipecmd and tmpfilename are now a part of the config_t structure and no longer global variables. * src/scan.c, src/misc.c, src/misc.h: Created postmark_print() to unclutter scan_mailbox(). * src/misc.c, src/misc.h, src/mbox.c, src/maildir.c, src/mh.c: Some repetitive code moved to malloc_message(). * src/mbox.c: Cleanup of mbox_write_message(); use of gzwrite_loop() and bzwrite_loop(). * src/scan.c, src/wrap.h, src/wrap.c: Wrote gzwrite_loop() and bzwrite_loop() to remove some repetitive code from scan.c. * src/scan.c: md5_check_message(): array b and cast in strncmp are no longer unsigned. * src/info.c, src/mboxgrep.h: Updated copyright information, changed author's email address to the one at Panix. * src/mbox.h, src/mbox.c, src/scan.c, src/main.c: mbox_write_message(); further fixes of message deletion code. * src/scan.c: Fixed deleting messages from mbox folders compressed with bzip2. * src/main.c, src/mbox.c: Moved James P. Dugal's ownership-preserving code from main() to tmpfile_open(). * src/info.c: If bzip2 support is compiled in, `--help' command should list `bz2mbox' as a valid option to `--mailbox-format='.
123 lines
3.3 KiB
Groff
123 lines
3.3 KiB
Groff
.Id $Id: mboxgrep.1,v 1.16 2006-01-18 00:09:58 dspiljar Exp $
|
|
.TH MBOXGREP 1 "24 Aug 2003"
|
|
.SH NAME
|
|
mboxgrep \- displays email messages matching a pattern
|
|
.SH SYNOPSIS
|
|
.B mboxgrep
|
|
.RI [ OPTIONS ]
|
|
.RI PATTERN
|
|
.RI [ MAILBOX ]
|
|
.SH DESCRIPTION
|
|
This manual page refers to
|
|
.B mboxgrep
|
|
version
|
|
.BR 0.7.9 .
|
|
.PP
|
|
.B mboxgrep
|
|
scans a
|
|
.I MAILBOX
|
|
and displays messages matching
|
|
.I PATTERN.
|
|
.PP
|
|
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
|
|
.B mboxgrep
|
|
process from standard input.
|
|
.PP
|
|
.B mboxgrep
|
|
understands POSIX regular expressions, as well as Perl compatible regular
|
|
expressions (if enabled at compile time).
|
|
.I MAILBOX
|
|
can be either a:
|
|
.TP
|
|
\(bu
|
|
mbox folder (either plain or compressed)
|
|
.TP
|
|
\(bu
|
|
MH folder
|
|
.TP
|
|
\(bu
|
|
Gnus nnmh or nnml folder
|
|
.TP
|
|
\(bu
|
|
qmail-style maildir folder
|
|
.SH OPTIONS
|
|
.PP
|
|
.IP "-h, --help"
|
|
Display a help screen and exit.
|
|
.IP "-V, --version"
|
|
Display version and copyright information and exit.
|
|
.IP "-r, --recursive"
|
|
Descend into directories recursively.
|
|
.IP "-E, --extended-regexp"
|
|
PATTERN is an extended regular expression. This is default.
|
|
.IP "-G, --basic-regexp "
|
|
PATTERN is a basic regular expression.
|
|
.IP "-P, --perl-regexp"
|
|
PATTERN is a Perl regular expression. Works only if enabled at compile time.
|
|
.IP "-e, --regexp=PATTERN"
|
|
Use PATTERN as a regular expression.
|
|
.IP "-i, --ignore-case"
|
|
Ignore case distinctions.
|
|
.IP "-v, --invert-match"
|
|
Select messages which don't match PATTERN.
|
|
.IP "-H, --headers"
|
|
Match PATTERN against message headers.
|
|
.IP "-B, --body"
|
|
Match PATTERN against message body.
|
|
.IP "-l, --file-lock=METHOD"
|
|
Select file locking METHOD. METHOD is `fcntl', `flock', or `none'.
|
|
.IP "-nl, --no-file-lock"
|
|
Do not lock files. This option is meaningful only if a mbox folder (see below)
|
|
is scanned.
|
|
.IP "-c, --count"
|
|
Suppress normal output and print a count of matching messages.
|
|
.IP "-o, --output=FOLDER"
|
|
Suppress normal output and write messages to destination folder FOLDER instead.
|
|
.IP "-p, --pipe=COMMAND"
|
|
Pipe each found message to COMMAND
|
|
.IP "-d, --delete"
|
|
Suppress normal output and delete selected messages instead. Use with
|
|
caution.
|
|
.IP "-nd, --no-duplicates"
|
|
Ignore duplicate messages.
|
|
.IP "-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'.
|
|
.SH EXAMPLES
|
|
.TP
|
|
\(bu
|
|
Search $MAIL for messages from Dirty Harry:
|
|
.PP
|
|
mboxgrep '^From:.*callahan@homicide\\.SFPD\\.gov' $MAIL
|
|
.TP
|
|
\(bu
|
|
Display all messages contained in folder ~/Mail/incoming, except those
|
|
that appear to originate from AOL:
|
|
.PP
|
|
mboxgrep -v 'Received:.*aol\\.com' ~/Mail/incoming
|
|
.SH BUGS
|
|
Report them to address below.
|
|
.SH 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.
|
|
.SH SEE ALSO
|
|
grep(1),
|
|
regex(7),
|
|
perlre(1),
|
|
mbox(5),
|
|
RFC 2822
|
|
.SH DEDICATION
|
|
Mboxgrep is dedicated in loving memory of Vicky, my cat who died of
|
|
tumor on Sep 12, 2002.
|
|
.PP
|
|
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.
|
|
.SH URL
|
|
http://www.mboxgrep.org/
|
|
.SH AUTHOR
|
|
Daniel Spiljar <dspiljar@panix.com>
|