jaZip for Linux (c) 1996 Jarrod A. Smith
Send bug reports, questions and comments to jsmith@scripps.edu

INTRODUCTION:

The user interface for this program was done using the XForms Library 0.81.
You will need to get this library in order to compile this program.
It is available at http://bragg.phys.uwm.edu/~zhao/ftp/ftp.html
or http://www.scripps.edu/~jsmith/jazip/dist.html

I got the idea for the precursor to this program from Grant Guenther's command
line program, "ziptool."  ziptool is available at:

http://www.torque.net/ziptool.html

I liked the features of ziptool and wanted to add features for
easily mounting/umounting disks, as well as to provide a user interface that
approximates the Mac and Windows software that Iomega bundles with the drive.
This precursor program was called ZipIt and supported only the Zip drive.  This
program now supports both the Zip and Jaz drive, all from one configuration
file.  Thanks to Florent Staley (staley@phnx7.saclay.cea.fr) for giving me the
modification to tools.c that enabled the jaz detection.

I mainly did this as a project to learn something about making a user
interface with the XForms Library, and because I like my Zip and Jaz drives.
I hope you will find it useful.

I have no affiliation with Iomega whatsoever.  Again, I did this because I
like their products and wanted to gain experience as well as hopefully provide
something useful to part of the Linux community.


INSTALLATION:
1.	Get the XForms library tarfile from one of the above locations.
	untar the xforms tar file.
	cd xforms/
	become root
	type 'make install'
	now you are ready to make and install jaZip

2.	There are a couple of things at the top of jazip.h that you can change
	to suit your needs.  Most notably, the default raw scsi device of your
	Iomega drive, DEF_DEV.  This will save you having to put the device
	name as the first command line argument each time you start the program
	(see below).

3.	Do as root (if you want non-root users to be able to use the program):

	make; make install

	The first 'make' does a "chmod +s" to the executable once it is
	made so that ordinary users can have control over the drive without
	needing root privledges on the system.  Things should remain secure,
	although I can't guarantee it.  If you don't want ordinary users to be
	able to do these things, then you've got at least two options to fix the
	situation:
	  remove the "chmod +s jazip" line from the makefile before running
	   "make"
	-or-
	  unset the suid bit after installation with
	   "chmod -s /usr/X11R6/bin/jazip"

4.	Modify the /etc/jaziptab file to suit your needs.


USING THE PROGRAM:

jazip [scsi_dev] [-display host:dpy] [-visual visual] [-depth depth] [-private]

The optional scsi_dev command line parameter is the raw scsi device of
your Iomega drive (default is /dev/sda).

The XForms Library itself allows you to specify the following display variables:

   -display host:dpy
   -visual visual (TrueColor, PseudoColor etc)
   -depth depth (24, 8, 1 etc.)
   -private Force a private colormap

Once the program is running, see the online help (under the help menu) for
further information and instructions.


MODIFYING YOUR RC FILES:

I have included a simple shell script that you may want to use in your sysinit
procedure which will try to autodetect and mount a Zip disk that may be in the
drive upon boot.  It gets installed to /etc/rc.d/rc.zip.  Read the comments at
the top of the file for more info.  The script should work with Jaz drives as
well with little or no modification.
