ICAT(LOCAL)ICAT(LOCAL)NAME
icat - "cat" a mailbox from an IMAP source
SYNOPSIS
icat [ -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 scripting or interactive Unix sessions to pro‐
vide 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 match‐
ing 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 Subject: 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 mes‐
sage.
-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)