################################################################################
# FILENAME: readme                                                             #
################################################################################

################################################################################
# SECTION 1.0:                                                                 #
################################################################################
In order to use Iomega (R) devices, either module support for these devices must
be built into the Linux kernel or the drivers themselves must be included in
the kernel. 
Before Iomegaware (R) for Linux can be used, appropriate drivers, Iomega (R)
drives and support hardware must be installed.

################################################################################
# SECTION 2.0:                                                                 #
################################################################################
The following files should be found in this directory once you've untared the
download file/s.

    readme ----> This file

    iw --------> Iomegaware (R) executable

################################################################################
# SECTION 3.0:                                                                 #
#   Man page-like help on Iomegaware for Linux. Please read this section       #
#   for information on how to use Iomegaware for Linux.                        #
################################################################################

NAME
  iomegaware - Tools package for Iomega (R) devices under Linux

SYNOPSIS
  iomegaware -m device [ -mp mountpoint ] [ -pw password ]
  iomegaware -u device
  iomegaware -i device
  iomegaware -f device [ -l ] [ -ext2 ] [ -v label ]
  iomegaware -p device [ -w ] [ -rw ] [ -ue ] [ -pw password ]

DESCRIPTION
  Iomegaware (R) for Linux provides the capabilities to mount, unmount, format,
  protect and view properties of Iomega (R) devices in Linux.

COMMANDS
  
  iomegaware -m
    This command enables Iomega (R) disks to be mounted. An Iomega (R) disk
    must be inserted into the Iomega (R) device before this command can be
    used.
    If the disk is password protected, use the -pw option to temporarily
    remove password protection (Except for read/write protected disks. In this
    case you must remove protection from the disk before mounting can occur).
    An error message will be generated if attempting to mount a Non-Iomega
    device.

    -mp mountpoint
          Mountpoint to which deivce will be mounted. If mountpoint is not
          provided, Iomegaware (R) for Linux will default according to the
          following (in the /mnt directory):
              ZIP100 disks --> zip100.0, zip100.1, zip100.2, etc.
              ZIP250 disks --> zip250.0, zip250.1, zip250.2, etc.
              JAZ1G  disks --> jaz1g.0,  jaz1g.1,  jaz1g.2,  etc.
              JAZ2G  disks --> jaz2g.0,  jaz2g.1,  jaz2g.2,  etc.
          Of course, these mount points must have already been created before
          Iomegaware (R) for Linux can mount the disks.

    -pw password
          Password if disk is password protected.
          NOTE: If no password is provided and the disk is password protected,
                Iomegaware (R) will prompt for a password.

  iomegawre -u
    This command enables Iomega (R) disks to be unmounted from the specified
    Iomega (R) drive. When the disk is unmounted, it is ejected from the drive.
    A disk cannot be ejected until it is unmounted.

  iomegaware -i
    This command provides Iomega (R) Disk and Drive information.

  iomegaware -f
    This command enables both long and short formatting of Iomega (R) disks.
    Iomega (R) disks can be formatted with either FAT16 or ext2 file systems.
    By default, this command without any parameters (iw -f device) performs
    a short format with a FAT16 file system.

    -l     This option instructs iomegaware -f to perform a long format. By
           default iomegaware -f performs a short format. A short format
           erases just the header information on a disk.
           A long format erases the entire disk and verifies the integrity of
           the disk surface. Long formats should be performed either when a
           disk has developed errors and needs to be repaired, or if the
           password to a password-protected disk has been forgotten.

    -ext2  This option formats the disk with the ext2 file system. If this
           option is not provided, the disk will be formatted with the FAT16
           file system.
           NOTE: The -v option cannot be used with the -ext2 option.

    -v label
           This option assigns a volume label to an Iomega (R) disk that is
           formatted with the FAT16 file system.
           This option is ignored if the -ext2 option is specified. To
           remove a volume label from a disk, re-format the disk without
           specifying the -v option.
           The label can be up to 11 characters in length. Also the
           label cannot contain any of the following characters:
                             *?/.,;:+=[]()&^<>

  iomegaware -p
    This command allows Iomega (R) disks to be protected, unprotected and the
    protection level to be modified. Iomega (R) disks can be either read/write
    protected or write protected. To access a password protected disk, it
    must be unprotected either temporarily or permanently. If a disk is
    permanently unprotected the password protection is completely removed
    from the disk. If the disk is temporarily unprocted, the password
    protection is removed until the disk is ejected (the next time the
    disk is mounted, the password will have to be supplied).

    -w    This parameter write protects Iomega (R) disks. Write protection
          prevents accidentally overwritting critical data. The -pw
          parameter is an optional parameter when the -w parameter is
          supplied. If the password is forgotten, data can be recovered by
          copying it to another disk and then long-formatting the original
          disk for re-use.

    -rw  This parameter read/write protects Iomega (R) disks. Read/write
         protection prevents reading or writing of a disk without a
         password. The -pw parameter is required when the -rw parameter
         is supplied.
         If the password is forgotten for a read/write protected disk, data
         cannot be recovered. The disk must be long-formatted before it can
         be used.
         NOTE: Read/Write protected disks cannot be mounted. If mounting a
               read/write protected disk is desired, remove the protection
               from the disk and then mount the disk.

    -u   This parameter unprotects Iomega (R) disks. If the disk is write
         protected, the -pw parameter must be supplied.
  
    -ue  This parameter allows Iomega (R) disks to be temporarily unprotected
         until the disk is ejected. If the disk is password protected, the
         -pw parameter must be supplied.

    -pw password
          This parameter assigns passwords to Iomega (R) disks.
          Passwords can be up to 32 characters in length. A password must
          follow the -pw parameter. This is a required parameter if the
          -rw parameter is specified. In order to change passwords, use
          the -u parameter to unprotect the disk and then reassign
          password protection to the disk.