** oginst
**
** Unix GPK file installer.
** Needs ogftp 1.1 or higher.
**
** Written by and Copyright 1996 Asher Hoskins.
**
** The author retains copyright on this implementation. Permission for
** educational and non-profit use is granted to all. If you're planning to
** make money with this or any code derived from it, check with the author
** first.

** VERSION 0.11 beta.


oginst is a utility to list the contents of GPK files or install them
onto an Omnigo. It works by extracting the files into a temporary directory
along with a script file for ogftp and then calling ogftp. ogftp version 1.1
or higher is needed (oginst needs a put command which can cope with different
local and remote file names). After a GPK has been installed onto the Omnigo
the temporary files will be deleted.

ogftp is available from http://domestic1.sjc.ox.ac.uk/~ahoskins/omnigo/.

USAGE:
	"oginst <filename>" will list the contents of a GPK file,
	"oginst -u <filename>" will upload a GPK file to an Omnigo.

LIMITATIONS:
	This is a very early version of oginst. At the moment it expects
	ogftp to be in the path and for it to default to the correct port
	and speed (you'll have to edit the source if you want to add arguments
	to the ogftp call (look for the 'system("ogftp...' line)).

	The file upload buffer size is set to 512k, this will need to be
	changed if files bigger than this are to be uploaded (edit the line
	that defines the buf variable near the top of the source). This will
	only be an issue if you have a RAM card.

	oginst will fall over in a heap if the GPK file is truncated for
	any reason.

CREDITS:
	oginst is adapted from code written by a colleague, Tim Everett,
	who reverse engineered the file format.

SUPPORTED SYSTEMS:
	oginst has been tested on the following systems:
	  * A Sun386i running SunOS 4.0.2.

BUGS:
	Other than those listed in the LIMITATIONS section, I don't know
	of any.

HISTORY:
	0.1 beta: original release.
	0.11 beta: minor bugfixed version of above.

DISCLAIMER:
	I hold no responsibility for this program doing nasty things to either
	your Omnigo or the computer it's connected to.


Asher Hoskins,
asher@prl.research.philips.com
7/7/96

