SCSISH(8) SCSISH(8)
NAME
scsish - SCSI shell
SYNOPSIS
/usr/lib/worm/scsish
DESCRIPTION
Scsish is a command interpreter for SCSI commands executed
through /dev/scsi (see scsi(4)). Many commands are applica-
ble to more or less all SCSI devices; some are specific to
the SONY WDA-3000-10 optical disk jukebox. Any details not
found here are in the manual for the jukebox.
Typically commands are sent to a particular drive (a number
between 0 and 7 inclusive) on a particular device (normally
a number between 0 and 5 inclusive). Most commands take a
drive parameter (a number). The device number is set by the
id command.
Occasionally, commands fail and will print the result of a
sense command which is normally needed to clear the error
status.
All input is in lower case and keywords and numbers are sep-
arated by white space. Commands are separated by a newline
or semicolon.
General SCSI Commands
capacity drive Report the capacity of drive as nblocks x
blocksize.
disk eject drive Eject the disk (or other removable medium)
from drive.
echo number Print number on standard output.
help Print a summary of the available commands.
id n Set the destination SCSI bus device num-
ber. By default, it is 2 which is the
normal device number for the SONY jukebox.
inquiry drive Print various bits of status about drive.
For example,
drive 2,0: WORM device, ' SONY WDA-3000-10 2.D'
disk,write protect,,,ready (0x9)
If drive is omitted, an inquiry is per-
formed for drives 0 through 7.
read drive block Print the contents of the 1024 byte block
at block on drive in hexadecimal.
read id drive Print the string starting at byte 42 in
block 1 on drive. This corresponds to the
initial vol_id for worm(8) disks.
reset Attempt to reset the SCSI interface.
sense drive Print the sense data for drive. Some of
SCSISH(8) SCSISH(8)
the interpretations of the sense bytes are
idiosyncratic to SONY.
ext sense drive Print the extended sense data for drive.
Most of the interpretations of the
extended sense bytes are idiosyncratic to
SONY.
sleep n Sleep for n seconds.
start drive Start drive spinning.
stop drive Stop drive.
test drive Test unit ready for drive.
SONY Commands
alternate drive
Print the replacement block tables from the disk.
media drive blkno nblks
Print a summary of the media quality in drive for the
nblks blocks starting at block number blkno. For exam-
ple, a dirty disk can yield
drive 0: media check for 1000 blocks [0-999], upper drive
849 good, 1 unwritten, 147 <50% burst, 3 >96% burst,
Please report any instances of messages including rare
error to the jukebox guru.
ext media drive blkno nblks
A verbose form of the media command.
Jukebox Commands
config
Print the configuration data for the jukebox.
rel drive shelf side
Release the disk from drive to shelf. The value of side
indicates whether it should be inverted on the way (b)
or not (a). If shelf and side are absent, the disk is
restored to its former shelf.
set shelf side drive
Put the disk from shelf into drive. The value of side
indicates whether it should be inverted on the way (b)
or not (a).
internal n
Execute various internal reports and diagnostics.
internal -1 with no argument will print a list of
available diagnostics.
status drive
Print the status for drive. An absent drive is taken as
0. As the status is for the jukebox as a whole, the
value of drive doesn't matter. A sample status output
shows the jukebox hides the mapping of logical drive
number and actual drive:
SCSISH(8) SCSISH(8)
drive 0: ready,disk in LUN,power on,disk in drive 0, return shelf 2
drive 1: not ready,no disk in LUN,power on,disk in shelf 0
drive 2: not ready,no disk in LUN,power on,disk in shelf 0
drive 3: ready,disk in LUN,power on,disk in drive 1, return shelf 0
drive 4: not ready,no disk in LUN,power on,disk in shelf 0
drive 5: not ready,no disk in LUN,power on,disk in shelf 0
drive 6: not ready,no disk in LUN,power on,disk in shelf 0
drive 7: not ready,no disk in LUN,power on,disk in shelf 0
0: no disk
1: no disk
2: disk,
I/O shelf: no disk
carrier: disk shelf=0
upper drive: disk, LUN=0
lower drive: disk, LUN=3
SEE ALSO
worm(8), scsi(4)