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 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 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 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 ALSO
cat(1), pine(1)