Return to scsish.8 CVS log

Up to [Research Unix] / researchv10dc / man / man8

Annotation of researchv10dc/man/man8/scsish.8, revision 1.1

1.1     ! root        1: .TH SCSISH 8
        !             2: .CT 1 sa_nonmortals
        !             3: .SH NAME
        !             4: scsish \- SCSI shell
        !             5: .SH SYNOPSIS
        !             6: .B /usr/lib/worm/scsish
        !             7: .SH DESCRIPTION
        !             8: .I Scsish
        !             9: is a command interpreter for SCSI commands executed through
        !            10: .B /dev/scsi
        !            11: (see
        !            12: .IR scsi (4)).
        !            13: Many commands are applicable to more or less all SCSI devices;
        !            14: some are specific to the SONY WDA-3000-10 optical disk jukebox.
        !            15: Any details not found here are in the manual for the jukebox.
        !            16: .PP
        !            17: Typically commands are sent to a particular drive
        !            18: (a number between 0 and 7 inclusive)
        !            19: on a particular device
        !            20: (normally a number between 0 and 5 inclusive).
        !            21: Most commands take a drive parameter (a number).
        !            22: The device number is set by the
        !            23: .B id
        !            24: command.
        !            25: .PP
        !            26: Occasionally, commands fail and will print the result of a
        !            27: .B sense
        !            28: command which is normally needed to clear the error status.
        !            29: .PP
        !            30: All input is in lower case and keywords and numbers are separated by white space.
        !            31: Commands are separated by a newline or semicolon.
        !            32: .SS "General SCSI Commands"
        !            33: .TF "disk eject drive"
        !            34: .TP
        !            35: .BI capacity " drive"
        !            36: Report the capacity of
        !            37: .I drive
        !            38: as
        !            39: .BR "nblocks x blocksize" .
        !            40: .TP
        !            41: .BI "disk eject" " drive"
        !            42: Eject the disk
        !            43: (or other removable medium)
        !            44: from
        !            45: .IR drive .
        !            46: .TP
        !            47: .BI echo " number"
        !            48: Print
        !            49: .I number
        !            50: on standard output.
        !            51: .TP
        !            52: .B help
        !            53: Print a summary of the available commands.
        !            54: .TP
        !            55: .BI id " n"
        !            56: Set the destination SCSI bus device number.
        !            57: By default, it is 2 which is the normal device number for the SONY jukebox.
        !            58: .TP
        !            59: .BI inquiry " drive"
        !            60: Print various bits of status about
        !            61: .IR drive .
        !            62: For example,
        !            63: .IP
        !            64: .EX
        !            65: drive 2,0: WORM device, '    SONY     WDA-3000-10 2.D'
        !            66:        disk,write protect,,,ready (0x9)
        !            67: .EE
        !            68: .IP
        !            69: If
        !            70: .I drive
        !            71: is omitted, an inquiry is performed for drives 0 through 7.
        !            72: .TP
        !            73: .BI read " drive block"
        !            74: Print the contents of the 1024 byte block at
        !            75: .I block
        !            76: on
        !            77: .I drive
        !            78: in hexadecimal.
        !            79: .TP
        !            80: .BI "read id" " drive"
        !            81: Print the string starting at byte 42 in block 1 on
        !            82: .IR drive .
        !            83: This corresponds to the initial
        !            84: .I vol_id
        !            85: for
        !            86: .IR worm (8)
        !            87: disks.
        !            88: .TP
        !            89: .B reset
        !            90: Attempt to reset the SCSI interface.
        !            91: .TP
        !            92: .BI sense " drive"
        !            93: Print the sense data for
        !            94: .IR drive .
        !            95: Some of the interpretations of the sense bytes are idiosyncratic to SONY.
        !            96: .TP
        !            97: .BI "ext sense" " drive"
        !            98: Print the extended sense data for
        !            99: .IR drive .
        !           100: Most of the interpretations of the extended sense bytes are idiosyncratic to SONY.
        !           101: .TP
        !           102: .BI sleep " n"
        !           103: Sleep for
        !           104: .I n
        !           105: seconds.
        !           106: .TP
        !           107: .BI start " drive"
        !           108: Start
        !           109: .I drive
        !           110: spinning.
        !           111: .TP
        !           112: .BI stop " drive"
        !           113: Stop
        !           114: .IR drive .
        !           115: .TP
        !           116: .BI test " drive"
        !           117: Test unit ready for
        !           118: .IR drive .
        !           119: .PD
        !           120: .SS "SONY Commands"
        !           121: .TP
        !           122: .BI alternate " drive"
        !           123: Print the replacement block tables from the disk.
        !           124: .TP
        !           125: .BI media " drive blkno nblks"
        !           126: Print a summary of the media quality in
        !           127: .I drive
        !           128: for the
        !           129: .I nblks
        !           130: blocks starting at block number
        !           131: .IR blkno .
        !           132: For example, a dirty disk can yield
        !           133: .IP
        !           134: .EX
        !           135: drive 0: media check for 1000 blocks [0-999], upper drive
        !           136: 849 good, 1 unwritten, 147 <50% burst, 3 >96% burst, 
        !           137: .EE
        !           138: .IP
        !           139: Please report any instances of messages including
        !           140: .B "rare error"
        !           141: to the jukebox guru.
        !           142: .PD
        !           143: .TP
        !           144: .BI "ext media" " drive blkno nblks"
        !           145: A verbose form of the
        !           146: .B media
        !           147: command.
        !           148: .PD
        !           149: .SS "Jukebox Commands"
        !           150: .TP
        !           151: .B config
        !           152: Print the configuration data for the jukebox.
        !           153: .TP
        !           154: .BI "rel" " drive shelf side"
        !           155: Release the disk from
        !           156: .I drive
        !           157: to
        !           158: .IR shelf .
        !           159: The value of
        !           160: .I side
        !           161: indicates whether it should be inverted on the way
        !           162: .RB ( b )
        !           163: or not
        !           164: .RB ( a ).
        !           165: If
        !           166: .I shelf
        !           167: and
        !           168: .I side
        !           169: are absent,
        !           170: the disk is restored to its former shelf.
        !           171: .PD0
        !           172: .TP
        !           173: .BI "set" " shelf side drive"
        !           174: Put the disk from
        !           175: .I shelf
        !           176: into
        !           177: .IR drive .
        !           178: The value of
        !           179: .I side
        !           180: indicates whether it should be inverted on the way
        !           181: .RB ( b )
        !           182: or not
        !           183: .RB ( a ).
        !           184: .TP
        !           185: .BI internal " n"
        !           186: Execute various internal reports and diagnostics.
        !           187: .B "internal -1"
        !           188: with no argument will print a list of available diagnostics.
        !           189: .TP
        !           190: .BI "status" " drive"
        !           191: Print the status for
        !           192: .IR drive .
        !           193: An absent
        !           194: .I drive
        !           195: is taken as 0.
        !           196: As the status is for the jukebox as a whole,
        !           197: the value of
        !           198: .I drive
        !           199: doesn't matter.
        !           200: A sample status output shows the jukebox hides the mapping
        !           201: of logical drive number and actual drive:
        !           202: .IP
        !           203: .EX
        !           204: drive 0: ready,disk in LUN,power on,disk in drive 0, return shelf 2
        !           205: drive 1: not ready,no disk in LUN,power on,disk in shelf 0
        !           206: drive 2: not ready,no disk in LUN,power on,disk in shelf 0
        !           207: drive 3: ready,disk in LUN,power on,disk in drive 1, return shelf 0
        !           208: drive 4: not ready,no disk in LUN,power on,disk in shelf 0
        !           209: drive 5: not ready,no disk in LUN,power on,disk in shelf 0
        !           210: drive 6: not ready,no disk in LUN,power on,disk in shelf 0
        !           211: drive 7: not ready,no disk in LUN,power on,disk in shelf 0
        !           212: 0: no disk
        !           213: 1: no disk
        !           214: 2: disk,
        !           215: I/O shelf: no disk
        !           216: carrier: disk shelf=0
        !           217: upper drive: disk, LUN=0
        !           218: lower drive: disk, LUN=3
        !           219: .EE
        !           220: .SH "SEE ALSO"
        !           221: .IR worm (8), 
        !           222: .IR scsi (4)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.