@@ -1,4 +1,4 @@
This is mboxgrep.info, produced by makeinfo version 4.6 from
This is mboxgrep.info, produced by makeinfo version 6.4 from
mboxgrep.texi.
mboxgrep.texi.
INFO-DIR-SECTION Mail
INFO-DIR-SECTION Mail
@@ -9,7 +9,7 @@ END-INFO-DIR-ENTRY
File: mboxgrep.info, Node: Top, Up: (dir)
File: mboxgrep.info, Node: Top, Up: (dir)
This file documents ` mboxgrep' (version 0.7.9), a mailbox scanning
This file documents ' mboxgrep' (version 0.7.9), a mailbox scanning
utility.
utility.
Copyright (C) 2000, 2001, 2002, 2003 Daniel Spiljar
Copyright (C) 2000, 2001, 2002, 2003 Daniel Spiljar
@@ -26,15 +26,15 @@ utility.
File: mboxgrep.info, Node: Introduction, Next: Invoking, Up: Top
File: mboxgrep.info, Node: Introduction, Next: Invoking, Up: Top
Introduction
1 Introduction
************
**************
` mboxgrep' is a small, non-interactive utility that scans mail folders
' mboxgrep' is a small, non-interactive utility that scans mail folders
for messages matching regular expressions.
for messages matching regular expressions.
It supports basic and extended POSIX regular expressions.
It supports basic and extended POSIX regular expressions.
` Perl'-style regular expressions are supported as well, if ` mboxgrep'
' Perl'-style regular expressions are supported as well, if ' mboxgrep' is
is linked with PCRE library.
linked with PCRE library.
Found messages can be either displayed on standard output, counted,
Found messages can be either displayed on standard output, counted,
deleted, piped to a specified command, or copied to another mailbox.
deleted, piped to a specified command, or copied to another mailbox.
@@ -42,24 +42,21 @@ deleted, piped to a specified command, or copied to another mailbox.
It can read and write a variety of folder formats:
It can read and write a variety of folder formats:
* mbox folders, either plain or compressed
* mbox folders, either plain or compressed
* MH folders
* MH folders
* nnml and nnmh folders used by Gnus
* nnml and nnmh folders used by Gnus
* 'qmail'-style maildirs
* `qmail'-style maildirs
Additionally, it can read mbox folders or output from another
Additionally, it can read mbox folders or output from another
` mboxgrep' process from standard input. It does so if a single dash
' mboxgrep' process from standard input. It does so if a single dash (-)
(-) is given as a file name.
is given as a file name.
File: mboxgrep.info, Node: Invoking, Next: Examples, Prev: Introduction, Up: Top
File: mboxgrep.info, Node: Invoking, Next: Examples, Prev: Introduction, Up: Top
Command-Line Arguments
2 Command-Line Arguments
**********************
************************
The syntax of ` mboxgrep' invocation is:
The syntax of ' mboxgrep' invocation is:
mboxgrep [OPTIONS] PATTERN [MAILBOX]
mboxgrep [OPTIONS] PATTERN [MAILBOX]
@@ -75,136 +72,130 @@ The syntax of `mboxgrep' invocation is:
File: mboxgrep.info, Node: Miscellaneous, Next: File locking, Up: Invoking
File: mboxgrep.info, Node: Miscellaneous, Next: File locking, Up: Invoking
` --help'
' --help'
` -h'
' -h'
Display a brief help screen and exit.
Display a brief help screen and exit.
` --version'
' --version'
` -V'
' -V'
Display program version and copyright information and exit.
Display program version and copyright information and exit.
` --recursive'
' --recursive'
` -r'
' -r'
Descend into directories recursively.
Descend into directories recursively.
File: mboxgrep.info, Node: File locking, Next: Regexp selection, Prev: Miscellaneous, Up: Invoking
File: mboxgrep.info, Node: File locking, Next: Regexp selection, Prev: Miscellaneous, Up: Invoking
When accessing mbox folders, ` mboxgrep' puts a shared lock on files
When accessing mbox folders, ' mboxgrep' puts a shared lock on files by
by default. Note that mbox folders normally should not be accessed
default. Note that mbox folders normally should not be accessed without
without locking.
locking.
` --file-lock=METHOD'
' --file-lock=METHOD'
` -l METHOD'
' -l METHOD'
Specify file locking METHOD. ` mboxgrep' supports ` flock' and
Specify file locking METHOD. ' mboxgrep' supports ' flock' and
` fcntl' file locking. However, one of these methods may be
' fcntl' file locking. However, one of these methods may be
unimplemented on your operating system and thus not available in
unimplemented on your operating system and thus not available in
` mboxgrep' at run time. To disable file locking, specify ` none'.
' mboxgrep' at run time. To disable file locking, specify ' none'.
` --no-file-lock'
' --no-file-lock'
` -nl'
' -nl'
Do not attempt to lock mbox folder files.
Do not attempt to lock mbox folder files.
File: mboxgrep.info, Node: Regexp selection, Next: Output control, Prev: File locking, Up: Invoking
File: mboxgrep.info, Node: Regexp selection, Next: Output control, Prev: File locking, Up: Invoking
` --extended-regexp'
' --extended-regexp'
` -E'
' -E'
PATTERN is an extended regular expression.
PATTERN is an extended regular expression.
` --basic-regexp'
' --basic-regexp'
` -G'
' -G'
PATTERN is a basic regular expression.
PATTERN is a basic regular expression.
` --perl-regexp'
' --perl-regexp'
` -P'
' -P'
PATTERN is a Perl regular expression.
PATTERN is a Perl regular expression.
` --regexp=PATTERN'
' --regexp=PATTERN'
` -e PATTERN'
' -e PATTERN'
Use PATTERN as a regular expression.
Use PATTERN as a regular expression.
` --ignore-case'
' --ignore-case'
` -i'
' -i'
Perform case-insensitive search.
Perform case-insensitive search.
` --invert-match'
' --invert-match'
` -v'
' -v'
Invert the sense of matching, i.e. select only non-matching
Invert the sense of matching, i.e. select only non-matching
messages.
messages.
File: mboxgrep.info, Node: Output control, Next: Search scope selection, Prev: Regexp selection, Up: Invoking
File: mboxgrep.info, Node: Output control, Next: Search scope selection, Prev: Regexp selection, Up: Invoking
By default, ` mboxgrep' writes found messages to standard output.
By default, ' mboxgrep' writes found messages to standard output. The
The options below change such behavior.
options below change such behavior.
` --count'
' --count'
` -c'
' -c'
Suppress normal output and print the count of matching (or
Suppress normal output and print the count of matching (or
non-matching, if used with the ` -v' option) messages.
non-matching, if used with the ' -v' option) messages.
` --delete'
' --delete'
` -d'
' -d'
Suppress normal output and delete selected messages.
Suppress normal output and delete selected messages.
Use with extreme caution.
Use with extreme caution.
` --no-duplicates'
' --no-duplicates'
` -nd'
' -nd'
Ignore duplicate messages.
Ignore duplicate messages.
` --output=FOLDER'
' --output=FOLDER'
` -o FOLDER'
' -o FOLDER'
Suppress normal output and write messages to destination folder
Suppress normal output and write messages to destination folder
FOLDER instead.
FOLDER instead.
Note that ` mboxgrep' assumes the output folder is of the same
Note that ' mboxgrep' assumes the output folder is of the same
format as the input folder. Currently there is no possibility to
format as the input folder. Currently there is no possibility to
convert folders.
convert folders.
` --pipe=COMMAND'
' --pipe=COMMAND'
` -p COMMAND'
' -p COMMAND'
Suppress normal output and pipe each selected message to a separate
Suppress normal output and pipe each selected message to a separate
instance of COMMAND.
instance of COMMAND.
` --no-messages'
' --no-messages'
` -s'
' -s'
Suppress error messages.
Suppress error messages.
File: mboxgrep.info, Node: Search scope selection, Next: Mailbox type selection, Prev: Output control, Up: Invoking
File: mboxgrep.info, Node: Search scope selection, Next: Mailbox type selection, Prev: Output control, Up: Invoking
` --headers'
' --headers'
` -H'
' -H'
Match PATTERN against message headers.
Match PATTERN against message headers.
` --body'
' --body'
` -B'
' -B'
Match PATTERN against message body.
Match PATTERN against message body.
File: mboxgrep.info, Node: Mailbox type selection, Prev: Search scope selection, Up: Invoking
File: mboxgrep.info, Node: Mailbox type selection, Prev: Search scope selection, Up: Invoking
` --mailbox-format=FORMAT'
' --mailbox-format=FORMAT'
` -m FORMAT'
' -m FORMAT'
Specify mailbox FORMAT. Supported formats are ` mbox' (default),
Specify mailbox FORMAT. Supported formats are ' mbox' (default),
` zmbox' (gzip compressed mbox), ` bz2mbox' (bzip2 compressed mbox)
' zmbox' (gzip compressed mbox), ' bz2mbox' (bzip2 compressed mbox)
` mh', ` nnml', ` nnmh', and ` maildir'.
' mh', ' nnml', ' nnmh', and ' maildir'.
File: mboxgrep.info, Node: Examples, Next: Bugs, Prev: Invoking, Up: Top
File: mboxgrep.info, Node: Examples, Next: Bugs, Prev: Invoking, Up: Top
Examples
3 Examples
********
**********
Scan ` $MAIL' for messages from Dirty Harry:
Scan ' $MAIL' for messages from Dirty Harry:
mboxgrep -H '^From:.*callahan@homicide\.SFPD\.gov' $MAIL
mboxgrep -H '^From:.*callahan@homicide\.SFPD\.gov' $MAIL
@@ -212,40 +203,40 @@ Scan `$MAIL' for messages from Dirty Harry:
mboxgrep --pipe="/usr/lib/sendmail george" --ignore-case george ~/Mail/*
mboxgrep --pipe="/usr/lib/sendmail george" --ignore-case george ~/Mail/*
Display all messages in folder ` ~/Mail/incoming', except those that
Display all messages in folder ' ~/Mail/incoming', except those that
appear to originate from AOL:
appear to originate from AOL:
mboxgrep -v -H '^Received:.*aol\.com' ~/Mail/incoming
mboxgrep -v -H '^Received:.*aol\.com' ~/Mail/incoming
Do a case-insensitive scan of ` ~/Mail/incoming' for messages with
Do a case-insensitive scan of ' ~/Mail/incoming' for messages with
subject "Weekly News" and write them to folder ` ~/Mail/archive':
subject "Weekly News" and write them to folder ' ~/Mail/archive':
mboxgrep -o ~/Mail/archive -H -i '^Subject: Weekly News' ~/Mail/incoming
mboxgrep -o ~/Mail/archive -H -i '^Subject: Weekly News' ~/Mail/incoming
Count _all_ messages stored in folder ` spam', ignoring duplicates:
Count _all_ messages stored in folder ' spam', ignoring duplicates:
mboxgrep -nd -c . spam
mboxgrep -nd -c . spam
File: mboxgrep.info, Node: Bugs, Next: To Vicky, Prev: Examples, Up: Top
File: mboxgrep.info, Node: Bugs, Next: To Vicky, Prev: Examples, Up: Top
Detecting Vermin
4 Detecting Vermin
****************
******************
Shortly, if ` mboxgrep' crashes and/or works differently than described
Shortly, if ' mboxgrep' crashes and/or works differently than described
in this manual, you've found a bug.
in this manual, you've found a bug.
Please report bugs to <dspiljar@panix.com >. Instructions how to
Please report bugs to <dspiljar@datatipp.se >. Instructions how to
reproduce the bug or output from a debugger would be highly
reproduce the bug or output from a debugger would be highly appreciated.
appreciated. Don't, however, send any coredumps.
Don't, however, send any coredumps.
File: mboxgrep.info, Node: To Vicky, Prev: Bugs, Up: Top
File: mboxgrep.info, Node: To Vicky, Prev: Bugs, Up: Top
Author's Dedication
5 Author's Dedication
*******************
*********************
` Mboxgrep' is dedicated in loving memory of Vicky, my cat who died of
' Mboxgrep' is dedicated in loving memory of Vicky, my cat who died of
tumor on Sep 12, 2002.
tumor on Sep 12, 2002.
You haven't been long with us, but you gave us a lot of joy and all
You haven't been long with us, but you gave us a lot of joy and all
@@ -256,16 +247,16 @@ Sleep well, little friend.
Tag Table:
Tag Table:
Node: Top 197
Node: Top 197
Node: Introduction 598
Node: Introduction 595
Node: Invoking 1466
Node: Invoking 1464
Node: Miscellaneous 1824
Node: Miscellaneous 1826
Node: File locking 2110
Node: File locking 2111
Node: Regexp selection 2752
Node: Regexp selection 2748
Node: Output control 3304
Node: Output control 3300
Node: Search scope selection 4298
Node: Search scope selection 4291
Node: Mailbox type selection 4540
Node: Mailbox type selection 4532
Node: Examples 486 3
Node: Examples 485 3
Node: Bugs 5679
Node: Bugs 5673
Node: To Vicky 6080
Node: To Vicky 6080
End Tag Table
End Tag Table