----------------------------------------------------------------------------

 Tabu - Quarter inch cartridge (QIC) tape backup utility.
   Copyright 1990 Roy C. Sigsbey - all rights reserved.
   This software may be publicly distributed at no charge.

   usage: tabu [-ddsk] [-sscsi] [-ttap] -b|c|l|r|x [name]
        -b = backup by blocks to tape
        -c = create backup to tape (name required)
        -d = dsk is scsi address for disk (default: 000)
        -l = list tape contents
        -r = restore by blocks from tape
        -s = scsi is scsi device name (default: HardFrame.device)
        -t = tap is scsi address for tape (default: 001)
        -x = extract from tape (name required)
      name = reference name (required for c or x)

   tabu.info ToolTypes may be set as follows:

      OPER=B      backup
      OPER=C      create (NAME required)
      OPER=L      list
      OPER=R      restore
      OPER=X      extract (NAME required)
      NAME=name   reference name (required for C or X)

      LIST=name   list to file or printer
      SCSI=name   scsi device name (default: HardFrame.device)
      DISK=nnn    disk scsi address (default: 000)
      TAPE=nnn    tape scsi address (default: 001)

      Tabu defaults to using HardFrame.device to access a SCSI bus. The SCSI
   address of 000 (as described in devices/scsidisk.h) is the default for
   the disk and the tape is defaulted to the address 001.  Options -d, -s,
   and -t for command line; DISK, SCSI, and TAPE for tooltypes may be used
   to specify other configurations.

      Options b and r (Tooltype OPER = B and R) utilize a block by block
   transfer between devices.  For the b (B) function, the disk is copied
   block by block until the last block on the disk has been read and written
   to tape.  This is a disk image backup.  For the r (R) function, the tape
   is copied block by block to disk until an end of file mark is encountered.
   This is a disk image restore.   Both functions use a block size of 512
   bytes (industry standard size for both devices).

      Options c and x (Tooltype OPER = C and X) utilize AmigaDOS functions
   to access the disk.  The name option (Tooltype NAME) is required for
   these options.  For the c (C) option, the name (NAME) is the directory
   or disk or file to be backed up to tape.  If the name is a disk, the
   subdirectories and files therein will be copied to tape and their names
   will be listed to stdout.  If the name is a directory, it and all its
   contents will be backed up to tape and their names listed to stdout.  If
   the name is a file, then only it will be backed up to tape and listed
   to stdout.  Stdout may be redirected on the command line to any printer
   or file using AmigaDOS redirection.  Stdout may be redirected in Tooltypes
   using the LIST option.  Setting LIST=PRT: for instance will redirect the
   listing to a printer.  For the x (X) option, the name must be a disk or
   directory.  The contents of the tape are written to the disk or directory
   using AmigaDOS commands.  The date/time, protect bits, and comments are
   also restored for the files and directories on the tape.

      The c (C) and x (X) options can be used to backup and restore any
   AmigaDOS file system (yes, including floppies).  Although this seems a
   little like information that isn't real useful, it does give insight as
   to how these options access the disk.

      The two tape formats are not interchangeable.  Attempting to restore
   with option r (R) from a tape created with option c (C) will result in
   a tabu error message indicating improper tape format.  Attempting to
   restore with option x (X) from tape created with option b (B) will also
   result in a tabu error message.

      The last option l (Tooltype OPER = L) is used to list the contents of
   a tape created with option c (C) or to give the backup date for a tape
   created with option b (B).  It lists the protect bits, date and time,
   size in bytes, and the heirarchical structure and names of the files
   and directories for option c (C) tapes.

      Note that a copy of tabu must exist on some floppy or other media than
   the disk being backed up.  If for some reason that disk gets damaged
   (which is why we back them up) the tabu software won't be available to
   restore the disk data.  A copy of tabu on the hard disk being backed up
   is OK and makes doing the backup easier.  There is no copy protection of
   this software except by the user's trustworthiness.

      You may convey your opinions and recommendations to me.

      Address:  Roy C. Sigsbey
                13370 Peregrine Way
                Black Forest, CO 80908

      I hope you find this useful.

--- End of Text ------------------------------------------------------------
