![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to scsish.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / man8|
Return to scsish.8 CVS log | Up to [Research Unix] / researchv10dc / man / man8 |
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.