ICAT(LOCAL)ICAT(LOCAL)NAMEicat - "cat" a mailbox from an IMAP source
SYNOPSISicat [ -a ] [ -d[bos] date ] [ -f[adfno] ] [ -m[tscfbx]
string ] [ -d
] [ -h ] mailbox
DESCRIPTION
The icat program reads a remote mailbox using the IMAP
protocol and prints it in standard Unix mailbox format on
the standard output. Icat is intended for use in script
ing or interactive Unix sessions to provide a bridge
between a remote mail store and traditional Unix tools.
The mailbox argument is required and can be any valid c-
client IMAP mailbox specification (see the examples
below).
OPTIONS
The options are used to filter the output to only those
message matching specified criteria.
-a Prints all messages. This is the default.
The various -d options filter based on date. In all cases
the date
must be in DD-MMM-YYYY (e.g. 24-JAN-1988) format.
-db Print messages dated before the date specified.
-do Print messages dated on the date specified.
-ds Print messages dated since the date specified.
The various -f options filter based on message flags.
-fa Print messages marked as answered.
-fd Print messages marked as deleted.
-ff Print messages marked as flagged.
-fn Print messages marked as new.
-fo Print messages not marked as new (old).
The various -m options will perform a case-insensitive
substring match
on the indicated region. The string cannot be a regular
expression.
-mt Print messages with the specified string in the To:
header line.
-ms Print messages with the specified string in the Sub
ject: header line.
-mc Print messages with the specified string in the Cc:
header line.
-mf Print messages with the specified string in the From:
header line.
-mb Print messages with the specified string in the body
of the message.
-mx Print messages with the specified string in the full
text (header and body) of the message.
EXAMPLES
Print all messages from your inbox on
yourms.imap.org that are new and to root:
icat-fn -mt root '{yourms.imap.org}inbox'
Print all messages from Robert Morris dated November 2,
1988:
icat-do 2-nov-1988 -mf "Robert Morris"
'{yourms.imap.org}inbox'
Note that in both cases the quotes are required to protect
the braces from the shell.
BUGS
The "From " separator lines of the Unix mailbox format
output do not reflect the "From:" line of the forthcoming
message.
Most likely there are others.
AUTHOR
Eric Horst, erich@cac.washington.edu
SEE ALSOcat(1), pine(1)ICAT(LOCAL)