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

								   ICAT(LOCAL)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome