glenda.party
term% ls -F
term% cat index.txt
SCUZZ(8)                    System Manager's Manual                   SCUZZ(8)



NAME
       scuzz - SCSI target control

SYNOPSIS
       scuzz [ -q ] [ target-id ]

DESCRIPTION
       Scuzz  is  an  interactive program for exercising raw SCSI devices.  It
       reads commands from standard input and applies them to a  SCSI  target.
       If target-id is given on the command line, an open (see below) is imme‐
       diately applied to the target.  On successful completion of a  command,
       ok n is printed, where n is the number of bytes transferred to/from the
       target; the -q command line option suppresses the ok message.

   Commands
       help command
              Help is rudimentary and prints a one line synopsis for the named
              command, or for all commands if no argument is given.

       probe  Probe  attempts  an  inquiry command on all SCSI target ids, and
              prints the result preceded by the id of those targets which  re‐
              spond.

       The help and probe commands may be given at any time.

       open target-id
              Open  must be given before any of the remaining commands will be
              accepted.  Internally, open issues ready then inquiry,  followed
              by  a  device  class-specific  command  to determine the logical
              block size of the target.

       close  Close need only be given if another target is to  be  opened  in
              the current session.

       The  remaining  commands  are in two groups, generic SCSI commands, and
       those specific to the Philips CDD521 Compact Disc Recorder  (flushcache
       onwards).   With  the  exception  of the read, write, space, and wtrack
       commands, all arguments are in the style of ANSI-C integer constants.

       ready  Test Unit Ready checks if the unit is powered up and ready to do
              read and write commands.

       rezero Rezero  Unit  requests  that a disc be brought to a known state,
              usually by seeking to track zero.

       rewind Rewind positions a tape at the beginning  of  current  partition
              (there is usually only one partition, the beginning of tape).

       reqsense
              Request  Sense retrieves Sense Data concerning an error or other
              condition and is usually issued following the  completion  of  a
              command  that  had  check-condition status.  Scuzz automatically
              issues a reqsense in response to a  check-condition  status  and
              prints the result.

       format Format Unit performs a ``low level'' format of a disc.

       rblimits
              Read  Block  Limits  reports  the possible block lengths for the
              logical unit. Tapes only.

       read file nbytes
              Read transfers data from the target  to  the  host.   A  missing
              nbytes causes the entire device to be read.

       write file nbytes
              Write  transfers  data  from  the host to the target.  A missing
              nbytes causes the entire input file to be transferred.

              The first argument to the read, write, and wtrack  (q.v.)   com‐
              mands  specifies  a  source  (write  and  wtrack) or destination
              (read) for the I/O.  The argument is either a plain file name or
              |  followed  by a command to be executed by rc(1).  The argument
              may be quoted in the style of rc(1).

       seek offset whence
              Seek requests the target to seek to a position on a disc,  argu‐
              ments being in the style of seek(2); whence is 0 by default.

              Scuzz  maintains  an internal notion of where the current target
              is positioned.  The  seek,  read,  write,  rewind,  rezero,  and
              wtrack commands all manipulate the internal offset.

       filemark howmany
              Write  Filemarks  writes  one  (default)  or more filemarks on a
              tape.

       space [-b] [-f] [[--]howmany]
              Space positions a tape forwards  or  backwards.   The  arguments
              specify  logical block (-b) or filemark (-f) spacing; default is
              -b.  If howmany is negative it specifies spacing backwards,  and
              should be preceded by -- to turn off any further option process‐
              ing.  Default is 1.

       inquiry
              Inquiry is issued to determine the device type of  a  particular
              target, and to determine some basic information about the imple‐
              mented options and the product name.

       modeselect bytes...
              Mode Select is issued to set variable parameters in the  target.
              Bytes  given  as arguments comprise all the data for the target;
              see an appropriate manual for the format.

       modesense [page [nbytes]]
              Mode Sense reports variable and fixed parameters from  the  tar‐
              get.  If no page is given, all pages are returned.  Nbytes spec‐
              ifies how many bytes should be returned.

       start code

       stop code

       eject code
              Start, stop, and eject are synonyms  for  Start/Stop  Unit  with
              different  default values of code.  Start/Stop Unit is typically
              used to spin up and spin down a rotating disk drive.  Code is  0
              to stop, 1 to start and 3 to eject (if the device supports ejec‐
              tion of the medium).

       capacity
              Read Capacity reports the number of blocks and the block size of
              a disc.

       The  remaining  commands  are  specific  to  the  CDD521  Compact  Disc
       Recorder.  A brief description of each is given; see the manual for de‐
       tails of arguments.

       flushcache
              The  Flush  Cache command forces data in the cache memory of the
              CDD521 to be written to the physical medium.

       rdiscinfo [track/session-number[ses]]
              The Read TOC/PMA command transfers data from one of  the  tables
              of contents (TOC or PMA) on the CD medium.

       fwaddr [track[mode[npa]]]
              The  First  Writable  Address  command  reports the next logical
              writable address for the next write command.

       treserve nbytes
              The Reserve Track  command  reserves  one  track  on  the  disc.
              Tracks can only be reserved in successive order.

       trackinfo track
              Read  Track  Info  reports the starting address, the length of a
              given track on the disc and the number of free  blocks  in  that
              track.

       wtrack file [nbytes [track [mode]]]
              Write  Track sets up for track-writing if nbytes is 0 (default),
              or writes a complete track.  See write above.

       load

       unload Load and Unload open or close the tray.

       fixation [toc-type]
              Fixation writes table of contents (TOC) and LEADOUT  information
              to the disc to complete a session.

FILES
       #S/scsi-target-id/cmd
              raw SCSI interface for command and status.

       #S/scsi-target-id/data
              raw SCSI interface for I/O.

SOURCE
       /sys/src/cmd/scuzz

SEE ALSO
       scsi(3)
       Small Computer System Interface - 2 (X3T9.2/86-109), Global Engineering
       Documents
       SCSI Command Set CDD521/10, Philips IMS
       SCSI Bench Reference, ENDL Publications

BUGS
       Only a limited  subset  of  SCSI  commands  has  been  implemented  (as
       needed).

       Only one target can be open at a time.

       LUNs other than 0 are not supported.

       No way to force 6- or 10- byte commands.



                                                                      SCUZZ(8)