Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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

						      ICAT(LOCAL)

Vote for polarhome