#----------------------------------------------------------------------------\
				safari_cookies v1.0

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

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

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

The Safari web browser on MacOSX stores its browser cookies in the file:
<~user>/Library/Cookies/Cookies.plist

This Cookies.plist file is a XML property list file made up of an NSArray
of NSDictionaries. The NSDictionaries contain key/value pairs of the cookie
data. 

More info on property list files files can be found here: 
http://en.wikipedia.org/wiki/Plist

This program parses the XML Cookies.plist file and outputs the results to 
STDOUT. The created date of each cookie entry is converted to a readable 
time format and printed (with the original value in parenthases).

It has been tested on Linux with GNUstep and OSX 10.4.


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

safari_cookies is being distributed in both binary and source code formats.

The binary version:
The binary version is a statically linked binary built on Linux and should 
run on any x86 Linux distribution. To install the binary version, 
simply unpack the tarball and copy the safari_cookies binary to your 
desired location.

Compile the source code version (Linux):
----------------------------------------

- Install GNUstep (See: http://www.gnustep.org)
- Initialize the GNUstep environment using the following command: 
(Assuming GNUstep is installed in /usr/lib/GNUstep)

". /usr/lib/GNUstep/System/Library/Makefiles/GNUstep.sh"


- Compile:
  cd safari_cookies
  make 

After compilation, the dynamically linked binary will be in the 
obj/shared_obj directory. Copy this binary to your desired location.

To statically compile the binary substitute "make" command with: 
 make shared=no 

The resulting statically linked binary will be in the obj/static_obj/ 
directory.

Compile the source code (OSX):
--------------------------------------

- Compile:
  make -f Makefile.OSX

The resuling binary, safari_cookie can be copied to your desired location.


Usage:
======

$ safari_cookies <plist file>


LICENSE:
========

safari_cookies (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.


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