#----------------------------------------------------------------------------\
				safari_icon_osx v1.0

			http://jafat.sourceforge.net
			Copyright 2007 - Jake Cunningham

#----------------------------------------------------------------------------\

Background:
===========

The Safari v2.x web browser on OSX stores a cache of the "favicon.ico" files 
and related metadata from each web site visited to the files:

~/Library/Safari/Icons/XX/XX/xxxxxxxxxx-xxxxxxxx.cache
(x is a random numeric value)


This program parses the individual .cache files and displays the URL of the
icon and the creation time of the cache file (as reported by the filesystem).
This program also extracts the binary icon image (in TIFF format) to a file 
named icon_data.ico in the current directory.


Installing:
============

This program has been tested (and works) on OSX 10.4. 

It will compile on Linux with GNUStep, HOWEVER, it is unable to parse the 
.cache files under Linux because OSX has a proprientary Archive format that 
is incompatable with GNUStep.
If you attempt to read an OSX archive file under Linux you will receive
the following error:  "Uncaught exception NSInternalInconsistencyException, reason: Archive has wrong prefix"


Usage:
======

To output the icon cache metadata (URL of icon, file create time [as reported 
by the filesystem]) to STDOUT in TAB delimited format, and extract the icon 
image data to icon_output.ico in the current directory:

$ safari_icon_osx 1234567890-1234567890.cache

The icon file icon_output.ico can then be viewed with any TIFF
file viewer.

Changes:
========
v1.0 - Initial public release (included with SFT 1.1)


LICENSE:
========

safari_icon_osx (Copyright 2007 Jake Cunningham) is distributed under 
the GNU GPL v2.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

#----------------------------------------------------------------------------\