xref: /dragonfly/sys/bus/cam/scsi/scsi_all.c (revision e2f5ccfb)
1 /*
2  * Implementation of Utility functions for all SCSI device types.
3  *
4  * Copyright (c) 1997, 1998 Justin T. Gibbs.
5  * Copyright (c) 1997, 1998, 2003 Kenneth D. Merry.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions, and the following disclaimer,
13  *    without modification, immediately at the beginning of the file.
14  * 2. The name of the author may not be used to endorse or promote products
15  *    derived from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
21  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  * $FreeBSD: src/sys/cam/scsi/scsi_all.c,v 1.14.2.11 2003/10/30 15:06:35 thomas Exp $
30  * $DragonFly: src/sys/bus/cam/scsi/scsi_all.c,v 1.27 2008/05/18 20:30:19 pavalos Exp $
31  */
32 
33 #include <sys/param.h>
34 
35 #ifdef _KERNEL
36 
37 #include <opt_scsi.h>
38 #include <sys/systm.h>
39 #include <sys/libkern.h>
40 #include <sys/kernel.h>
41 #include <sys/sysctl.h>
42 
43 #else
44 
45 #include <errno.h>
46 #include <stdio.h>
47 #include <stdlib.h>
48 #include <string.h>
49 
50 #define ksnprintf	snprintf	/* ick, userland uses us too */
51 #define kprintf		printf
52 #endif
53 
54 #include "../cam.h"
55 #include "../cam_ccb.h"
56 #include "../cam_xpt.h"
57 #include "scsi_all.h"
58 #include <sys/sbuf.h>
59 #ifndef _KERNEL
60 #include <sys/camlib.h>
61 
62 #ifndef FALSE
63 #define FALSE   0
64 #endif /* FALSE */
65 #ifndef TRUE
66 #define TRUE    1
67 #endif /* TRUE */
68 #define ERESTART        -1              /* restart syscall */
69 #define EJUSTRETURN     -2              /* don't modify regs, just return */
70 #endif /* !_KERNEL */
71 
72 /*
73  * This is the default number of seconds we wait for devices to settle
74  * after a SCSI bus reset.
75  */
76 #ifndef SCSI_DELAY
77 #define SCSI_DELAY 2000
78 #endif
79 /*
80  * All devices need _some_ sort of bus settle delay, so we'll set it to
81  * a minimum value of 100ms. Note that this is pertinent only for SPI-
82  * not transport like Fibre Channel or iSCSI where 'delay' is completely
83  * meaningless.
84  */
85 #ifndef SCSI_MIN_DELAY
86 #define SCSI_MIN_DELAY 100
87 #endif
88 /*
89  * Make sure the user isn't using seconds instead of milliseconds.
90  */
91 #if (SCSI_DELAY < SCSI_MIN_DELAY && SCSI_DELAY != 0)
92 #error "SCSI_DELAY is in milliseconds, not seconds!  Please use a larger value"
93 #endif
94 
95 int scsi_delay;
96 
97 static int	ascentrycomp(const void *key, const void *member);
98 static int	senseentrycomp(const void *key, const void *member);
99 static void	fetchtableentries(int sense_key, int asc, int ascq,
100 				  struct scsi_inquiry_data *,
101 				  const struct sense_key_table_entry **,
102 				  const struct asc_table_entry **);
103 #ifdef _KERNEL
104 static void	init_scsi_delay(void);
105 static int	sysctl_scsi_delay(SYSCTL_HANDLER_ARGS);
106 static int	set_scsi_delay(int delay);
107 #endif
108 
109 #if !defined(SCSI_NO_OP_STRINGS)
110 
111 #define D 0x001
112 #define T 0x002
113 #define L 0x004
114 #define P 0x008
115 #define W 0x010
116 #define R 0x020
117 #define S 0x040
118 #define O 0x080
119 #define M 0x100
120 #define C 0x200
121 #define A 0x400
122 #define E 0x800
123 
124 #define ALL 0xFFF
125 
126 static struct op_table_entry plextor_cd_ops[] = {
127 	{0xD8, R, "CD-DA READ"}
128 };
129 
130 static struct scsi_op_quirk_entry scsi_op_quirk_table[] = {
131 	{
132 		/*
133 		 * I believe that 0xD8 is the Plextor proprietary command
134 		 * to read CD-DA data.  I'm not sure which Plextor CDROM
135 		 * models support the command, though.  I know for sure
136 		 * that the 4X, 8X, and 12X models do, and presumably the
137 		 * 12-20X does.  I don't know about any earlier models,
138 		 * though.  If anyone has any more complete information,
139 		 * feel free to change this quirk entry.
140 		 */
141 		{T_CDROM, SIP_MEDIA_REMOVABLE, "PLEXTOR", "CD-ROM PX*", "*"},
142 		sizeof(plextor_cd_ops)/sizeof(struct op_table_entry),
143 		plextor_cd_ops
144 	}
145 };
146 
147 static struct op_table_entry scsi_op_codes[] = {
148 /*
149  * From: ftp://ftp.symbios.com/pub/standards/io/t10/drafts/spc/op-num.txt
150  * Modifications by Kenneth Merry (ken@FreeBSD.ORG)
151  *
152  * Note:  order is important in this table, scsi_op_desc() currently
153  * depends on the opcodes in the table being in order to save search time.
154  */
155 /*
156  * File: OP-NUM.TXT
157  *
158  * SCSI Operation Codes
159  * Numeric Sorted Listing
160  * as of 11/13/96
161  *
162  *     D - DIRECT ACCESS DEVICE (SBC)                    device column key
163  *     .T - SEQUENTIAL ACCESS DEVICE (SSC)              -------------------
164  *     . L - PRINTER DEVICE (SSC)                       M = Mandatory
165  *     .  P - PROCESSOR DEVICE (SPC)                    O = Optional
166  *     .  .W - WRITE ONCE READ MULTIPLE DEVICE (SBC)    V = Vendor specific
167  *     .  . R - CD DEVICE (MMC)                         R = Reserved
168  *     .  .  S - SCANNER DEVICE (SGC)                   Z = Obsolete
169  *     .  .  .O - OPTICAL MEMORY DEVICE (SBC)
170  *     .  .  . M - MEDIA CHANGER DEVICE (SMC)
171  *     .  .  .  C - COMMUNICATION DEVICE (SSC)
172  *     .  .  .  .A - STORAGE ARRAY DEVICE (SCC)
173  *     .  .  .  . E - ENCLOSURE SERVICES DEVICE (SES)
174  * OP  DTLPWRSOMCAE  Description
175  * --  ------------  ---------------------------------------------------- */
176 /* 00  MMMMMMMMMMMM  TEST UNIT READY */
177 {0x00, ALL, 		"TEST UNIT READY"},
178 
179 /* 01   M            REWIND */
180 {0x01, T,           "REWIND"},
181 /* 01  Z V ZO ZO     REZERO UNIT */
182 {0x01, D|L|W|O|M,   "REZERO UNIT"},
183 
184 /* 02  VVVVVV  V   */
185 
186 /* 03  MMMMMMMMMMMM  REQUEST SENSE */
187 {0x03, ALL,         "REQUEST SENSE"},
188 
189 /* 04  M    O O      FORMAT UNIT */
190 {0x04, D|R|O,       "FORMAT UNIT"},
191 /* 04   O            FORMAT MEDIUM */
192 {0x04, T,           "FORMAT MEDIUM"},
193 /* 04    O           FORMAT */
194 {0x04, L,           "FORMAT"},
195 
196 /* 05  VMVVVV  V     READ BLOCK LIMITS */
197 {0x05, T,           "READ BLOCK LIMITS"},
198 
199 /* 06  VVVVVV  V   */
200 
201 /* 07  OVV O  OV     REASSIGN BLOCKS */
202 {0x07, D|W|O,       "REASSIGN BLOCKS"},
203 /* 07          O     INITIALIZE ELEMENT STATUS */
204 {0x07, M,           "INITIALIZE ELEMENT STATUS"},
205 
206 /* 08  OMV OO OV     READ(06) */
207 {0x08, D|T|W|R|O,   "READ(06)"},
208 /* 08     O          RECEIVE */
209 {0x08, P,           "RECEIVE"},
210 /* 08           M    GET MESSAGE(06) */
211 {0x08, C,           "GET MESSAGE(06)"},
212 
213 /* 09  VVVVVV  V   */
214 
215 /* 0A  OM  O  OV     WRITE(06) */
216 {0x0A, D|T|W|O, "WRITE(06)"},
217 /* 0A     M          SEND(06) */
218 {0x0A, P,           "SEND(06)"},
219 /* 0A           M    SEND MESSAGE(06) */
220 {0x0A, C,           "SEND MESSAGE(06)"},
221 /* 0A    M           PRINT */
222 {0x0A, L,           "PRINT"},
223 
224 /* 0B  Z   ZO ZV     SEEK(06) */
225 {0x0B, D|W|R|O,     "SEEK(06)"},
226 /* 0B    O           SLEW AND PRINT */
227 {0x0B, L,           "SLEW AND PRINT"},
228 
229 /* 0C  VVVVVV  V   */
230 /* 0D  VVVVVV  V   */
231 /* 0E  VVVVVV  V   */
232 /* 0F  VOVVVV  V     READ REVERSE */
233 {0x0F, T,           "READ REVERSE"},
234 
235 /* 10  VM VVV        WRITE FILEMARKS */
236 {0x10, T,           "WRITE FILEMARKS"},
237 /* 10    O O         SYNCHRONIZE BUFFER */
238 {0x10, L|W,         "SYNCHRONIZE BUFFER"},
239 
240 /* 11  VMVVVV        SPACE */
241 {0x11, T,           "SPACE"},
242 
243 /* 12  MMMMMMMMMMMM  INQUIRY */
244 {0x12, ALL,         "INQUIRY"},
245 
246 /* 13  VOVVVV        VERIFY(06) */
247 {0x13, T,           "VERIFY(06)"},
248 
249 /* 14  VOOVVV        RECOVER BUFFERED DATA */
250 {0x14, T|L,         "RECOVER BUFFERED DATA"},
251 
252 /* 15  OMO OOOOOOOO  MODE SELECT(06) */
253 {0x15, ALL & ~(P),    "MODE SELECT(06)"},
254 
255 /* 16  MMMOMMMM   O  RESERVE(06) */
256 {0x16, D|T|L|P|W|R|S|O|E, "RESERVE(06)"},
257 /* 16          M     RESERVE ELEMENT(06) */
258 {0x16, M,           "RESERVE ELEMENT(06)"},
259 
260 /* 17  MMMOMMMM   O  RELEASE(06) */
261 {0x17, ALL & ~(M|C|A), "RELEASE(06)"},
262 /* 17          M     RELEASE ELEMENT(06) */
263 {0x17, M,           "RELEASE ELEMENT(06)"},
264 
265 /* 18  OOOOOOOO      COPY */
266 {0x18, ALL & ~(M|C|A|E), "COPY"},
267 
268 /* 19  VMVVVV        ERASE */
269 {0x19, T,           "ERASE"},
270 
271 /* 1A  OMO OOOOOOOO  MODE SENSE(06) */
272 {0x1A, ALL & ~(P),  "MODE SENSE(06)"},
273 
274 /* 1B  O   OM O      STOP START UNIT */
275 {0x1B, D|W|R|O,     "STOP START UNIT"},
276 /* 1B   O            LOAD UNLOAD */
277 {0x1B, T,           "LOAD UNLOAD"},
278 /* 1B        O       SCAN */
279 {0x1B, S,           "SCAN"},
280 /* 1B    O           STOP PRINT */
281 {0x1B, L,           "STOP PRINT"},
282 
283 /* 1C  OOOOOOOOOO M  RECEIVE DIAGNOSTIC RESULTS */
284 {0x1C, ALL & ~(A),  "RECEIVE DIAGNOSTIC RESULTS"},
285 
286 /* 1D  MMMMMMMMMMMM  SEND DIAGNOSTIC */
287 {0x1D, ALL,         "SEND DIAGNOSTIC"},
288 
289 /* 1E  OO  OM OO     PREVENT ALLOW MEDIUM REMOVAL */
290 {0x1E, D|T|W|R|O|M, "PREVENT ALLOW MEDIUM REMOVAL"},
291 
292 /* 1F */
293 /* 20  V   VV V */
294 /* 21  V   VV V */
295 /* 22  V   VV V */
296 /* 23  V   VV V */
297 
298 /* 24  V   VVM       SET WINDOW */
299 {0x24, S,           "SET WINDOW"},
300 
301 /* 25  M   M  M      READ CAPACITY */
302 {0x25, D|W|O,       "READ CAPACITY"},
303 /* 25       M        READ CD RECORDED CAPACITY */
304 {0x25, R,           "READ CD RECORDED CAPACITY"},
305 /* 25        O       GET WINDOW */
306 {0x25, S,           "GET WINDOW"},
307 
308 /* 26  V   VV */
309 /* 27  V   VV */
310 
311 /* 28  M   MMMM      READ(10) */
312 {0x28, D|W|R|S|O,   "READ(10)"},
313 /* 28           O    GET MESSAGE(10) */
314 {0x28, C,           "GET MESSAGE(10)"},
315 
316 /* 29  V   VV O      READ GENERATION */
317 {0x29, O,           "READ GENERATION"},
318 
319 /* 2A  M   MM M      WRITE(10) */
320 {0x2A, D|W|R|O,     "WRITE(10)"},
321 /* 2A        O       SEND(10) */
322 {0x2A, S,           "SEND(10)"},
323 /* 2A           O    SEND MESSAGE(10) */
324 {0x2A, C,           "SEND MESSAGE(10)"},
325 
326 /* 2B  O   OM O      SEEK(10) */
327 {0x2B, D|W|R|O,     "SEEK(10)"},
328 /* 2B   O            LOCATE */
329 {0x2B, T,           "LOCATE"},
330 /* 2B          O     POSITION TO ELEMENT */
331 {0x2B, M,           "POSITION TO ELEMENT"},
332 
333 /* 2C  V      O      ERASE(10) */
334 {0x2C, O,           "ERASE(10)"},
335 
336 /* 2D  V   O  O      READ UPDATED BLOCK */
337 {0x2D, W|O,         "READ UPDATED BLOCK"},
338 
339 /* 2E  O   O  O      WRITE AND VERIFY(10) */
340 {0x2E, D|W|O,       "WRITE AND VERIFY(10)"},
341 
342 /* 2F  O   OO O      VERIFY(10) */
343 {0x2F, D|W|R|O,     "VERIFY(10)"},
344 
345 /* 30  Z   ZO Z      SEARCH DATA HIGH(10) */
346 {0x30, D|W|R|O,     "SEARCH DATA HIGH(10)"},
347 
348 /* 31  Z   ZO Z      SEARCH DATA EQUAL(10) */
349 {0x31, D|W|R|O,     "SEARCH DATA EQUAL(10)"},
350 /* 31        O       OBJECT POSITION */
351 {0x31, S,           "OBJECT POSITION"},
352 
353 /* 32  Z   ZO Z      SEARCH DATA LOW(10) */
354 {0x32, D|W|R|O,     "SEARCH DATA LOW(10"},
355 
356 /* 33  O   OO O      SET LIMITS(10) */
357 {0x33, D|W|R|O,     "SET LIMITS(10)"},
358 
359 /* 34  O   OO O      PRE-FETCH */
360 {0x34, D|W|R|O,     "PRE-FETCH"},
361 /* 34   O            READ POSITION */
362 {0x34, T,           "READ POSITION"},
363 /* 34        O       GET DATA BUFFER STATUS */
364 {0x34, S,           "GET DATA BUFFER STATUS"},
365 
366 /* 35  O   OM O      SYNCHRONIZE CACHE */
367 {0x35, D|W|R|O,     "SYNCHRONIZE CACHE"},
368 
369 /* 36  O   OO O      LOCK UNLOCK CACHE */
370 {0x36, D|W|R|O,     "LOCK UNLOCK CACHE"},
371 
372 /* 37  O      O      READ DEFECT DATA(10) */
373 {0x37, D|O,         "READ DEFECT DATA(10)"},
374 
375 /* 38      O  O      MEDIUM SCAN */
376 {0x38, W|O,         "MEDIUM SCAN"},
377 
378 /* 39  OOOOOOOO      COMPARE */
379 {0x39, ALL & ~(M|C|A|E), "COMPARE"},
380 
381 /* 3A  OOOOOOOO      COPY AND VERIFY */
382 {0x3A, ALL & ~(M|C|A|E), "COPY AND VERIFY"},
383 
384 /* 3B  OOOOOOOOOO O  WRITE BUFFER */
385 {0x3B, ALL & ~(A),  "WRITE BUFFER"},
386 
387 /* 3C  OOOOOOOOOO    READ BUFFER */
388 {0x3C, ALL & ~(A|E),"READ BUFFER"},
389 
390 /* 3D      O  O      UPDATE BLOCK */
391 {0x3D, W|O,         "UPDATE BLOCK"},
392 
393 /* 3E  O   OO O      READ LONG */
394 {0x3E, D|W|R|O,     "READ LONG"},
395 
396 /* 3F  O   O  O      WRITE LONG */
397 {0x3F, D|W|O,       "WRITE LONG"},
398 
399 /* 40  OOOOOOOOOO    CHANGE DEFINITION */
400 {0x40, ALL & ~(A|E),"CHANGE DEFINITION"},
401 
402 /* 41  O             WRITE SAME */
403 {0x41, D,           "WRITE SAME"},
404 
405 /* 42       M        READ SUB-CHANNEL */
406 {0x42, R,           "READ SUB-CHANNEL"},
407 
408 /* 43       M        READ TOC/PMA/ATIP {MMC Proposed} */
409 {0x43, R,           "READ TOC/PMA/ATIP {MMC Proposed}"},
410 
411 /* 44   M            REPORT DENSITY SUPPORT */
412 {0x44, T,           "REPORT DENSITY SUPPORT"},
413 /* 44       M        READ HEADER */
414 {0x44, R,           "READ HEADER"},
415 
416 /* 45       O        PLAY AUDIO(10) */
417 {0x45, R,           "PLAY AUDIO(10)"},
418 
419 /* 46 */
420 
421 /* 47       O        PLAY AUDIO MSF */
422 {0x47, R,           "PLAY AUDIO MSF"},
423 
424 /* 48       O        PLAY AUDIO TRACK INDEX */
425 {0x48, R,           "PLAY AUDIO TRACK INDEX"},
426 
427 /* 49       O        PLAY TRACK RELATIVE(10) */
428 {0x49, R,           "PLAY TRACK RELATIVE(10)"},
429 
430 /* 4A */
431 
432 /* 4B       O        PAUSE/RESUME */
433 {0x4B, R,           "PAUSE/RESUME"},
434 
435 /* 4C  OOOOOOOOOOO   LOG SELECT */
436 {0x4C, ALL & ~(E),  "LOG SELECT"},
437 
438 /* 4D  OOOOOOOOOOO   LOG SENSE */
439 {0x4D, ALL & ~(E),  "LOG SENSE"},
440 
441 /* 4E       O        STOP PLAY/SCAN {MMC Proposed} */
442 {0x4E, R,           "STOP PLAY/SCAN {MMC Proposed}"},
443 
444 /* 4F */
445 
446 /* 50  O             XDWRITE(10) */
447 {0x50, D,           "XDWRITE(10)"},
448 
449 /* 51  O             XPWRITE(10) */
450 {0x51, D,           "XPWRITE(10)"},
451 /* 51       M        READ DISC INFORMATION {MMC Proposed} */
452 {0x51, R,           "READ DISC INFORMATION {MMC Proposed}"},
453 
454 /* 52  O             XDREAD(10) */
455 {0x52, D,           "XDREAD(10)"},
456 /* 52       M        READ TRACK INFORMATION {MMC Proposed} */
457 {0x52, R,           "READ TRACK INFORMATION {MMC Proposed}"},
458 
459 /* 53       M        RESERVE TRACK {MMC Proposed} */
460 {0x53, R,           "RESERVE TRACK {MMC Proposed}"},
461 
462 /* 54       O        SEND OPC INFORMATION {MMC Proposed} */
463 {0x54, R,           "SEND OPC INFORMATION {MMC Proposed}"},
464 
465 /* 55  OOO OOOOOOOO  MODE SELECT(10) */
466 {0x55, ALL & ~(P),  "MODE SELECT(10)"},
467 
468 /* 56  MMMOMMMM   O  RESERVE(10) */
469 {0x56, ALL & ~(M|C|A), "RESERVE(10)"},
470 /* 56          M     RESERVE ELEMENT(10) */
471 {0x56, M,           "RESERVE ELEMENT(10)"},
472 
473 /* 57  MMMOMMMM   O  RELEASE(10) */
474 {0x57, ALL & ~(M|C|A), "RELEASE(10"},
475 /* 57          M     RELEASE ELEMENT(10) */
476 {0x57, M,           "RELEASE ELEMENT(10)"},
477 
478 /* 58       O        REPAIR TRACK {MMC Proposed} */
479 {0x58, R,           "REPAIR TRACK {MMC Proposed}"},
480 
481 /* 59       O        READ MASTER CUE {MMC Proposed} */
482 {0x59, R,           "READ MASTER CUE {MMC Proposed}"},
483 
484 /* 5A  OOO OOOOOOOO  MODE SENSE(10) */
485 {0x5A, ALL & ~(P),  "MODE SENSE(10)"},
486 
487 /* 5B       M        CLOSE TRACK/SESSION {MMC Proposed} */
488 {0x5B, R,           "CLOSE TRACK/SESSION {MMC Proposed}"},
489 
490 /* 5C       O        READ BUFFER CAPACITY {MMC Proposed} */
491 {0x5C, R,           "READ BUFFER CAPACITY {MMC Proposed}"},
492 
493 /* 5D       O        SEND CUE SHEET {MMC Proposed} */
494 {0x5D, R,           "SEND CUE SHEET {MMC Proposed}"},
495 
496 /* 5E  OOOOOOOOO  O  PERSISTENT RESERVE IN */
497 {0x5E, ALL & ~(C|A),"PERSISTENT RESERVE IN"},
498 
499 /* 5F  OOOOOOOOO  O  PERSISTENT RESERVE OUT */
500 {0x5F, ALL & ~(C|A),"PERSISTENT RESERVE OUT"},
501 
502 /* 80  O             XDWRITE EXTENDED(16) */
503 {0x80, D,           "XDWRITE EXTENDED(16)"},
504 
505 /* 81  O             REBUILD(16) */
506 {0x81, D,           "REBUILD(16)"},
507 
508 /* 82  O             REGENERATE(16) */
509 {0x82, D,           "REGENERATE(16)"},
510 
511 /* 83 */
512 /* 84 */
513 /* 85 */
514 /* 86 */
515 /* 87 */
516 /* 88  MM  OO O    O   READ(16) */
517 {0x88, D|T|W|R|O,     "READ(16)"},
518 /* 89 */
519 /* 8A  OM  O  O    O   WRITE(16) */
520 {0x8A, D|T|W|R|O,     "WRITE(16)"},
521 /* 8B */
522 /* 8C */
523 /* 8D */
524 /* 8E */
525 /* 8F */
526 /* 90 */
527 /* 91 */
528 /* 92 */
529 /* 93 */
530 /* 94 */
531 /* 95 */
532 /* 96 */
533 /* 97 */
534 /* 98 */
535 /* 99 */
536 /* 9A */
537 /* 9B */
538 /* 9C */
539 /* 9D */
540 /* XXX KDM ALL for these?  op-num.txt defines them for none.. */
541 /* 9E                  SERVICE ACTION IN(16) */
542 {0x9E, ALL,           "SERVICE ACTION IN(16)"},
543 /* 9F                  SERVICE ACTION OUT(16) */
544 {0x9F, ALL,           "SERVICE ACTION OUT(16)"},
545 
546 /* A0  OOOOOOOOOOO   REPORT LUNS */
547 {0xA0, ALL & ~(E),  "REPORT LUNS"},
548 
549 /* A1       O        BLANK {MMC Proposed} */
550 {0xA1, R,           "BLANK {MMC Proposed}"},
551 
552 /* A2       O        WRITE CD MSF {MMC Proposed} */
553 {0xA2, R,           "WRITE CD MSF {MMC Proposed}"},
554 
555 /* A3            M   MAINTENANCE (IN) */
556 {0xA3, A,           "MAINTENANCE (IN)"},
557 
558 /* A4            O   MAINTENANCE (OUT) */
559 {0xA4, A,           "MAINTENANCE (OUT)"},
560 
561 /* A5   O      M     MOVE MEDIUM */
562 {0xA5, T|M,         "MOVE MEDIUM"},
563 /* A5       O        PLAY AUDIO(12) */
564 {0xA5, R,           "PLAY AUDIO(12)"},
565 
566 /* A6          O     EXCHANGE MEDIUM */
567 {0xA6, M,           "EXCHANGE MEDIUM"},
568 /* A6       O        LOAD/UNLOAD CD {MMC Proposed} */
569 {0xA6, R,           "LOAD/UNLOAD CD {MMC Proposed}"},
570 
571 /* A7  OO  OO OO     MOVE MEDIUM ATTACHED */
572 {0xA7, D|T|W|R|O|M, "MOVE MEDIUM ATTACHED"},
573 
574 /* A8  O   OM O      READ(12) */
575 {0xA8,D|W|R|O,      "READ(12)"},
576 /* A8           O    GET MESSAGE(12) */
577 {0xA8, C,           "GET MESSAGE(12)"},
578 
579 /* A9       O        PLAY TRACK RELATIVE(12) */
580 {0xA9, R,           "PLAY TRACK RELATIVE(12)"},
581 
582 /* AA  O   O  O      WRITE(12) */
583 {0xAA,D|W|O,        "WRITE(12)"},
584 /* AA       O        WRITE CD(12) {MMC Proposed} */
585 {0xAA, R,           "WRITE CD(12) {MMC Proposed}"},
586 /* AA           O    SEND MESSAGE(12) */
587 {0xAA, C,           "SEND MESSAGE(12)"},
588 
589 /* AB */
590 
591 /* AC         O      ERASE(12) */
592 {0xAC, O,           "ERASE(12)"},
593 
594 /* AD */
595 
596 /* AE      O  O      WRITE AND VERIFY(12) */
597 {0xAE, W|O,         "WRITE AND VERIFY(12)"},
598 
599 /* AF      OO O      VERIFY(12) */
600 {0xAF, W|R|O,       "VERIFY(12)"},
601 
602 /* B0      ZO Z      SEARCH DATA HIGH(12) */
603 {0xB0, W|R|O,       "SEARCH DATA HIGH(12)"},
604 
605 /* B1      ZO Z      SEARCH DATA EQUAL(12) */
606 {0xB1, W|R|O,       "SEARCH DATA EQUAL(12)"},
607 
608 /* B2      ZO Z      SEARCH DATA LOW(12) */
609 {0xB2, W|R|O,       "SEARCH DATA LOW(12)"},
610 
611 /* B3      OO O      SET LIMITS(12) */
612 {0xB3, W|R|O,       "SET LIMITS(12)"},
613 
614 /* B4  OO  OO OO     READ ELEMENT STATUS ATTACHED */
615 {0xB4, D|T|W|R|O|M, "READ ELEMENT STATUS ATTACHED"},
616 
617 /* B5          O     REQUEST VOLUME ELEMENT ADDRESS */
618 {0xB5, M,           "REQUEST VOLUME ELEMENT ADDRESS"},
619 
620 /* B6          O     SEND VOLUME TAG */
621 {0xB6, M,           "SEND VOLUME TAG"},
622 
623 /* B7         O      READ DEFECT DATA(12) */
624 {0xB7, O,           "READ DEFECT DATA(12)"},
625 
626 /* B8   O      M     READ ELEMENT STATUS */
627 {0xB8, T|M,         "READ ELEMENT STATUS"},
628 /* B8       O        SET CD SPEED {MMC Proposed} */
629 {0xB8, R,           "SET CD SPEED {MMC Proposed}"},
630 
631 /* B9       M        READ CD MSF {MMC Proposed} */
632 {0xB9, R,           "READ CD MSF {MMC Proposed}"},
633 
634 /* BA       O        SCAN {MMC Proposed} */
635 {0xBA, R,           "SCAN {MMC Proposed}"},
636 /* BA            M   REDUNDANCY GROUP (IN) */
637 {0xBA, A,           "REDUNDANCY GROUP (IN)"},
638 
639 /* BB       O        SET CD-ROM SPEED {proposed} */
640 {0xBB, R,           "SET CD-ROM SPEED {proposed}"},
641 /* BB            O   REDUNDANCY GROUP (OUT) */
642 {0xBB, A,           "REDUNDANCY GROUP (OUT)"},
643 
644 /* BC       O        PLAY CD {MMC Proposed} */
645 {0xBC, R,           "PLAY CD {MMC Proposed}"},
646 /* BC            M   SPARE (IN) */
647 {0xBC, A,           "SPARE (IN)"},
648 
649 /* BD       M        MECHANISM STATUS {MMC Proposed} */
650 {0xBD, R,           "MECHANISM STATUS {MMC Proposed}"},
651 /* BD            O   SPARE (OUT) */
652 {0xBD, A,           "SPARE (OUT)"},
653 
654 /* BE       O        READ CD {MMC Proposed} */
655 {0xBE, R,           "READ CD {MMC Proposed}"},
656 /* BE            M   VOLUME SET (IN) */
657 {0xBE, A,           "VOLUME SET (IN)"},
658 
659 /* BF            O   VOLUME SET (OUT) */
660 {0xBF, A,           "VOLUME SET (OUT)"}
661 };
662 
663 const char *
664 scsi_op_desc(u_int16_t opcode, struct scsi_inquiry_data *inq_data)
665 {
666 	caddr_t match;
667 	int i, j;
668 	u_int16_t opmask;
669 	u_int16_t pd_type;
670 	int       num_ops[2];
671 	struct op_table_entry *table[2];
672 	int num_tables;
673 
674 	pd_type = SID_TYPE(inq_data);
675 
676 	match = cam_quirkmatch((caddr_t)inq_data,
677 			       (caddr_t)scsi_op_quirk_table,
678 			       sizeof(scsi_op_quirk_table)/
679 			       sizeof(*scsi_op_quirk_table),
680 			       sizeof(*scsi_op_quirk_table),
681 			       scsi_inquiry_match);
682 
683 	if (match != NULL) {
684 		table[0] = ((struct scsi_op_quirk_entry *)match)->op_table;
685 		num_ops[0] = ((struct scsi_op_quirk_entry *)match)->num_ops;
686 		table[1] = scsi_op_codes;
687 		num_ops[1] = sizeof(scsi_op_codes)/sizeof(scsi_op_codes[0]);
688 		num_tables = 2;
689 	} else {
690 		/*
691 		 * If this is true, we have a vendor specific opcode that
692 		 * wasn't covered in the quirk table.
693 		 */
694 		if ((opcode > 0xBF) || ((opcode > 0x5F) && (opcode < 0x80)))
695 			return("Vendor Specific Command");
696 
697 		table[0] = scsi_op_codes;
698 		num_ops[0] = sizeof(scsi_op_codes)/sizeof(scsi_op_codes[0]);
699 		num_tables = 1;
700 	}
701 
702 	/* RBC is 'Simplified' Direct Access Device */
703 	if (pd_type == T_RBC)
704 		pd_type = T_DIRECT;
705 
706 	opmask = 1 << pd_type;
707 
708 	for (j = 0; j < num_tables; j++) {
709 		for (i = 0;i < num_ops[j] && table[j][i].opcode <= opcode; i++){
710 			if ((table[j][i].opcode == opcode)
711 			 && ((table[j][i].opmask & opmask) != 0))
712 				return(table[j][i].desc);
713 		}
714 	}
715 
716 	/*
717 	 * If we can't find a match for the command in the table, we just
718 	 * assume it's a vendor specifc command.
719 	 */
720 	return("Vendor Specific Command");
721 
722 }
723 
724 #else /* SCSI_NO_OP_STRINGS */
725 
726 const char *
727 scsi_op_desc(u_int16_t opcode, struct scsi_inquiry_data *inq_data)
728 {
729 	return("");
730 }
731 
732 #endif
733 
734 
735 #if !defined(SCSI_NO_SENSE_STRINGS)
736 #define SST(asc, ascq, action, desc) \
737 	asc, ascq, action, desc
738 #else
739 const char empty_string[] = "";
740 
741 #define SST(asc, ascq, action, desc) \
742 	asc, ascq, action, empty_string
743 #endif
744 
745 const struct sense_key_table_entry sense_key_table[] =
746 {
747 	{ SSD_KEY_NO_SENSE, SS_NOP, "NO SENSE" },
748 	{ SSD_KEY_RECOVERED_ERROR, SS_NOP|SSQ_PRINT_SENSE, "RECOVERED ERROR" },
749 	{
750 	  SSD_KEY_NOT_READY, SS_TUR|SSQ_MANY|SSQ_DECREMENT_COUNT|EBUSY,
751 	  "NOT READY"
752 	},
753 	{ SSD_KEY_MEDIUM_ERROR, SS_RDEF, "MEDIUM ERROR" },
754 	{ SSD_KEY_HARDWARE_ERROR, SS_RDEF, "HARDWARE FAILURE" },
755 	{ SSD_KEY_ILLEGAL_REQUEST, SS_FATAL|EINVAL, "ILLEGAL REQUEST" },
756 	{ SSD_KEY_UNIT_ATTENTION, SS_FATAL|ENXIO, "UNIT ATTENTION" },
757 	{ SSD_KEY_DATA_PROTECT, SS_FATAL|EACCES, "DATA PROTECT" },
758 	{ SSD_KEY_BLANK_CHECK, SS_FATAL|ENOSPC, "BLANK CHECK" },
759 	{ SSD_KEY_Vendor_Specific, SS_FATAL|EIO, "Vendor Specific" },
760 	{ SSD_KEY_COPY_ABORTED, SS_FATAL|EIO, "COPY ABORTED" },
761 	{ SSD_KEY_ABORTED_COMMAND, SS_RDEF, "ABORTED COMMAND" },
762 	{ SSD_KEY_EQUAL, SS_NOP, "EQUAL" },
763 	{ SSD_KEY_VOLUME_OVERFLOW, SS_FATAL|EIO, "VOLUME OVERFLOW" },
764 	{ SSD_KEY_MISCOMPARE, SS_NOP, "MISCOMPARE" },
765 	{ SSD_KEY_RESERVED, SS_FATAL|EIO, "RESERVED" }
766 };
767 
768 const int sense_key_table_size =
769     sizeof(sense_key_table)/sizeof(sense_key_table[0]);
770 
771 static struct asc_table_entry quantum_fireball_entries[] = {
772 	{SST(0x04, 0x0b, SS_START|SSQ_DECREMENT_COUNT|ENXIO,
773 	     "Logical unit not ready, initializing cmd. required")}
774 };
775 
776 static struct asc_table_entry sony_mo_entries[] = {
777 	{SST(0x04, 0x00, SS_START|SSQ_DECREMENT_COUNT|ENXIO,
778 	     "Logical unit not ready, cause not reportable")}
779 };
780 
781 static struct scsi_sense_quirk_entry sense_quirk_table[] = {
782 	{
783 		/*
784 		 * The Quantum Fireball ST and SE like to return 0x04 0x0b when
785 		 * they really should return 0x04 0x02.  0x04,0x0b isn't
786 		 * defined in any SCSI spec, and it isn't mentioned in the
787 		 * hardware manual for these drives.
788 		 */
789 		{T_DIRECT, SIP_MEDIA_FIXED, "QUANTUM", "FIREBALL S*", "*"},
790 		/*num_sense_keys*/0,
791 		sizeof(quantum_fireball_entries)/sizeof(struct asc_table_entry),
792 		/*sense key entries*/NULL,
793 		quantum_fireball_entries
794 	},
795 	{
796 		/*
797 		 * This Sony MO drive likes to return 0x04, 0x00 when it
798 		 * isn't spun up.
799 		 */
800 		{T_DIRECT, SIP_MEDIA_REMOVABLE, "SONY", "SMO-*", "*"},
801 		/*num_sense_keys*/0,
802 		sizeof(sony_mo_entries)/sizeof(struct asc_table_entry),
803 		/*sense key entries*/NULL,
804 		sony_mo_entries
805 	}
806 };
807 
808 const int sense_quirk_table_size =
809     sizeof(sense_quirk_table)/sizeof(sense_quirk_table[0]);
810 
811 static struct asc_table_entry asc_table[] = {
812 /*
813  * From File: ASC-NUM.TXT
814  * SCSI ASC/ASCQ Assignments
815  * Numeric Sorted Listing
816  * as of  5/12/97
817  *
818  * D - DIRECT ACCESS DEVICE (SBC)                     device column key
819  * .T - SEQUENTIAL ACCESS DEVICE (SSC)               -------------------
820  * . L - PRINTER DEVICE (SSC)                           blank = reserved
821  * .  P - PROCESSOR DEVICE (SPC)                     not blank = allowed
822  * .  .W - WRITE ONCE READ MULTIPLE DEVICE (SBC)
823  * .  . R - CD DEVICE (MMC)
824  * .  .  S - SCANNER DEVICE (SGC)
825  * .  .  .O - OPTICAL MEMORY DEVICE (SBC)
826  * .  .  . M - MEDIA CHANGER DEVICE (SMC)
827  * .  .  .  C - COMMUNICATION DEVICE (SSC)
828  * .  .  .  .A - STORAGE ARRAY DEVICE (SCC)
829  * .  .  .  . E - ENCLOSURE SERVICES DEVICE (SES)
830  * DTLPWRSOMCAE        ASC   ASCQ  Action  Description
831  * ------------        ----  ----  ------  -----------------------------------*/
832 /* DTLPWRSOMCAE */{SST(0x00, 0x00, SS_NOP,
833 			"No additional sense information") },
834 /*  T    S      */{SST(0x00, 0x01, SS_RDEF,
835 			"Filemark detected") },
836 /*  T    S      */{SST(0x00, 0x02, SS_RDEF,
837 			"End-of-partition/medium detected") },
838 /*  T           */{SST(0x00, 0x03, SS_RDEF,
839 			"Setmark detected") },
840 /*  T    S      */{SST(0x00, 0x04, SS_RDEF,
841 			"Beginning-of-partition/medium detected") },
842 /*  T    S      */{SST(0x00, 0x05, SS_RDEF,
843 			"End-of-data detected") },
844 /* DTLPWRSOMCAE */{SST(0x00, 0x06, SS_RDEF,
845 			"I/O process terminated") },
846 /*      R       */{SST(0x00, 0x11, SS_FATAL|EBUSY,
847 			"Audio play operation in progress") },
848 /*      R       */{SST(0x00, 0x12, SS_NOP,
849 			"Audio play operation paused") },
850 /*      R       */{SST(0x00, 0x13, SS_NOP,
851 			"Audio play operation successfully completed") },
852 /*      R       */{SST(0x00, 0x14, SS_RDEF,
853 			"Audio play operation stopped due to error") },
854 /*      R       */{SST(0x00, 0x15, SS_NOP,
855 			"No current audio status to return") },
856 /* DTLPWRSOMCAE */{SST(0x00, 0x16, SS_FATAL|EBUSY,
857 			"Operation in progress") },
858 /* DTL WRSOM AE */{SST(0x00, 0x17, SS_RDEF,
859 			"Cleaning requested") },
860 /* D   W  O     */{SST(0x01, 0x00, SS_RDEF,
861 			"No index/sector signal") },
862 /* D   WR OM    */{SST(0x02, 0x00, SS_RDEF,
863 			"No seek complete") },
864 /* DTL W SO     */{SST(0x03, 0x00, SS_RDEF,
865 			"Peripheral device write fault") },
866 /*  T           */{SST(0x03, 0x01, SS_RDEF,
867 			"No write current") },
868 /*  T           */{SST(0x03, 0x02, SS_RDEF,
869 			"Excessive write errors") },
870 /* DTLPWRSOMCAE */{SST(0x04, 0x00, SS_TUR|SSQ_MANY|SSQ_DECREMENT_COUNT|EIO,
871 			"Logical unit not ready, cause not reportable") },
872 /* DTLPWRSOMCAE */{SST(0x04, 0x01, SS_TUR|SSQ_MANY|SSQ_DECREMENT_COUNT|EBUSY,
873 			"Logical unit is in process of becoming ready") },
874 /* DTLPWRSOMCAE */{SST(0x04, 0x02, SS_START|SSQ_DECREMENT_COUNT|ENXIO,
875 			"Logical unit not ready, initializing cmd. required") },
876 /* DTLPWRSOMCAE */{SST(0x04, 0x03, SS_FATAL|ENXIO,
877 			"Logical unit not ready, manual intervention required")},
878 /* DTL    O     */{SST(0x04, 0x04, SS_FATAL|EBUSY,
879 			"Logical unit not ready, format in progress") },
880 /* DT  W  OMCA  */{SST(0x04, 0x05, SS_FATAL|EBUSY,
881 			"Logical unit not ready, rebuild in progress") },
882 /* DT  W  OMCA  */{SST(0x04, 0x06, SS_FATAL|EBUSY,
883 			"Logical unit not ready, recalculation in progress") },
884 /* DTLPWRSOMCAE */{SST(0x04, 0x07, SS_FATAL|EBUSY,
885 			"Logical unit not ready, operation in progress") },
886 /*      R       */{SST(0x04, 0x08, SS_FATAL|EBUSY,
887 			"Logical unit not ready, long write in progress") },
888 /* DTL WRSOMCAE */{SST(0x05, 0x00, SS_RDEF,
889 			"Logical unit does not respond to selection") },
890 /* D   WR OM    */{SST(0x06, 0x00, SS_RDEF,
891 			"No reference position found") },
892 /* DTL WRSOM    */{SST(0x07, 0x00, SS_RDEF,
893 			"Multiple peripheral devices selected") },
894 /* DTL WRSOMCAE */{SST(0x08, 0x00, SS_RDEF,
895 			"Logical unit communication failure") },
896 /* DTL WRSOMCAE */{SST(0x08, 0x01, SS_RDEF,
897 			"Logical unit communication time-out") },
898 /* DTL WRSOMCAE */{SST(0x08, 0x02, SS_RDEF,
899 			"Logical unit communication parity error") },
900 /* DT   R OM    */{SST(0x08, 0x03, SS_RDEF,
901 			"Logical unit communication crc error (ultra-dma/32)")},
902 /* DT  WR O     */{SST(0x09, 0x00, SS_RDEF,
903 			"Track following error") },
904 /*     WR O     */{SST(0x09, 0x01, SS_RDEF,
905 			"Tracking servo failure") },
906 /*     WR O     */{SST(0x09, 0x02, SS_RDEF,
907 			"Focus servo failure") },
908 /*     WR O     */{SST(0x09, 0x03, SS_RDEF,
909 			"Spindle servo failure") },
910 /* DT  WR O     */{SST(0x09, 0x04, SS_RDEF,
911 			"Head select fault") },
912 /* DTLPWRSOMCAE */{SST(0x0A, 0x00, SS_FATAL|ENOSPC,
913 			"Error log overflow") },
914 /* DTLPWRSOMCAE */{SST(0x0B, 0x00, SS_RDEF,
915 			"Warning") },
916 /* DTLPWRSOMCAE */{SST(0x0B, 0x01, SS_RDEF,
917 			"Specified temperature exceeded") },
918 /* DTLPWRSOMCAE */{SST(0x0B, 0x02, SS_RDEF,
919 			"Enclosure degraded") },
920 /*  T   RS      */{SST(0x0C, 0x00, SS_RDEF,
921 			"Write error") },
922 /* D   W  O     */{SST(0x0C, 0x01, SS_NOP|SSQ_PRINT_SENSE,
923 			"Write error - recovered with auto reallocation") },
924 /* D   W  O     */{SST(0x0C, 0x02, SS_RDEF,
925 			"Write error - auto reallocation failed") },
926 /* D   W  O     */{SST(0x0C, 0x03, SS_RDEF,
927 			"Write error - recommend reassignment") },
928 /* DT  W  O     */{SST(0x0C, 0x04, SS_RDEF,
929 			"Compression check miscompare error") },
930 /* DT  W  O     */{SST(0x0C, 0x05, SS_RDEF,
931 			"Data expansion occurred during compression") },
932 /* DT  W  O     */{SST(0x0C, 0x06, SS_RDEF,
933 			"Block not compressible") },
934 /*      R       */{SST(0x0C, 0x07, SS_RDEF,
935 			"Write error - recovery needed") },
936 /*      R       */{SST(0x0C, 0x08, SS_RDEF,
937 			"Write error - recovery failed") },
938 /*      R       */{SST(0x0C, 0x09, SS_RDEF,
939 			"Write error - loss of streaming") },
940 /*      R       */{SST(0x0C, 0x0A, SS_RDEF,
941 			"Write error - padding blocks added") },
942 /* D   W  O     */{SST(0x10, 0x00, SS_RDEF,
943 			"ID CRC or ECC error") },
944 /* DT  WRSO     */{SST(0x11, 0x00, SS_RDEF,
945 			"Unrecovered read error") },
946 /* DT  W SO     */{SST(0x11, 0x01, SS_RDEF,
947 			"Read retries exhausted") },
948 /* DT  W SO     */{SST(0x11, 0x02, SS_RDEF,
949 			"Error too long to correct") },
950 /* DT  W SO     */{SST(0x11, 0x03, SS_RDEF,
951 			"Multiple read errors") },
952 /* D   W  O     */{SST(0x11, 0x04, SS_RDEF,
953 			"Unrecovered read error - auto reallocate failed") },
954 /*     WR O     */{SST(0x11, 0x05, SS_RDEF,
955 			"L-EC uncorrectable error") },
956 /*     WR O     */{SST(0x11, 0x06, SS_RDEF,
957 			"CIRC unrecovered error") },
958 /*     W  O     */{SST(0x11, 0x07, SS_RDEF,
959 			"Data re-synchronization error") },
960 /*  T           */{SST(0x11, 0x08, SS_RDEF,
961 			"Incomplete block read") },
962 /*  T           */{SST(0x11, 0x09, SS_RDEF,
963 			"No gap found") },
964 /* DT     O     */{SST(0x11, 0x0A, SS_RDEF,
965 			"Miscorrected error") },
966 /* D   W  O     */{SST(0x11, 0x0B, SS_RDEF,
967 			"Unrecovered read error - recommend reassignment") },
968 /* D   W  O     */{SST(0x11, 0x0C, SS_RDEF,
969 			"Unrecovered read error - recommend rewrite the data")},
970 /* DT  WR O     */{SST(0x11, 0x0D, SS_RDEF,
971 			"De-compression CRC error") },
972 /* DT  WR O     */{SST(0x11, 0x0E, SS_RDEF,
973 			"Cannot decompress using declared algorithm") },
974 /*      R       */{SST(0x11, 0x0F, SS_RDEF,
975 			"Error reading UPC/EAN number") },
976 /*      R       */{SST(0x11, 0x10, SS_RDEF,
977 			"Error reading ISRC number") },
978 /*      R       */{SST(0x11, 0x11, SS_RDEF,
979 			"Read error - loss of streaming") },
980 /* D   W  O     */{SST(0x12, 0x00, SS_RDEF,
981 			"Address mark not found for id field") },
982 /* D   W  O     */{SST(0x13, 0x00, SS_RDEF,
983 			"Address mark not found for data field") },
984 /* DTL WRSO     */{SST(0x14, 0x00, SS_RDEF,
985 			"Recorded entity not found") },
986 /* DT  WR O     */{SST(0x14, 0x01, SS_RDEF,
987 			"Record not found") },
988 /*  T           */{SST(0x14, 0x02, SS_RDEF,
989 			"Filemark or setmark not found") },
990 /*  T           */{SST(0x14, 0x03, SS_RDEF,
991 			"End-of-data not found") },
992 /*  T           */{SST(0x14, 0x04, SS_RDEF,
993 			"Block sequence error") },
994 /* DT  W  O     */{SST(0x14, 0x05, SS_RDEF,
995 			"Record not found - recommend reassignment") },
996 /* DT  W  O     */{SST(0x14, 0x06, SS_RDEF,
997 			"Record not found - data auto-reallocated") },
998 /* DTL WRSOM    */{SST(0x15, 0x00, SS_RDEF,
999 			"Random positioning error") },
1000 /* DTL WRSOM    */{SST(0x15, 0x01, SS_RDEF,
1001 			"Mechanical positioning error") },
1002 /* DT  WR O     */{SST(0x15, 0x02, SS_RDEF,
1003 			"Positioning error detected by read of medium") },
1004 /* D   W  O     */{SST(0x16, 0x00, SS_RDEF,
1005 			"Data synchronization mark error") },
1006 /* D   W  O     */{SST(0x16, 0x01, SS_RDEF,
1007 			"Data sync error - data rewritten") },
1008 /* D   W  O     */{SST(0x16, 0x02, SS_RDEF,
1009 			"Data sync error - recommend rewrite") },
1010 /* D   W  O     */{SST(0x16, 0x03, SS_NOP|SSQ_PRINT_SENSE,
1011 			"Data sync error - data auto-reallocated") },
1012 /* D   W  O     */{SST(0x16, 0x04, SS_RDEF,
1013 			"Data sync error - recommend reassignment") },
1014 /* DT  WRSO     */{SST(0x17, 0x00, SS_NOP|SSQ_PRINT_SENSE,
1015 			"Recovered data with no error correction applied") },
1016 /* DT  WRSO     */{SST(0x17, 0x01, SS_NOP|SSQ_PRINT_SENSE,
1017 			"Recovered data with retries") },
1018 /* DT  WR O     */{SST(0x17, 0x02, SS_NOP|SSQ_PRINT_SENSE,
1019 			"Recovered data with positive head offset") },
1020 /* DT  WR O     */{SST(0x17, 0x03, SS_NOP|SSQ_PRINT_SENSE,
1021 			"Recovered data with negative head offset") },
1022 /*     WR O     */{SST(0x17, 0x04, SS_NOP|SSQ_PRINT_SENSE,
1023 			"Recovered data with retries and/or CIRC applied") },
1024 /* D   WR O     */{SST(0x17, 0x05, SS_NOP|SSQ_PRINT_SENSE,
1025 			"Recovered data using previous sector id") },
1026 /* D   W  O     */{SST(0x17, 0x06, SS_NOP|SSQ_PRINT_SENSE,
1027 			"Recovered data without ECC - data auto-reallocated") },
1028 /* D   W  O     */{SST(0x17, 0x07, SS_NOP|SSQ_PRINT_SENSE,
1029 			"Recovered data without ECC - recommend reassignment")},
1030 /* D   W  O     */{SST(0x17, 0x08, SS_NOP|SSQ_PRINT_SENSE,
1031 			"Recovered data without ECC - recommend rewrite") },
1032 /* D   W  O     */{SST(0x17, 0x09, SS_NOP|SSQ_PRINT_SENSE,
1033 			"Recovered data without ECC - data rewritten") },
1034 /* D   W  O     */{SST(0x18, 0x00, SS_NOP|SSQ_PRINT_SENSE,
1035 			"Recovered data with error correction applied") },
1036 /* D   WR O     */{SST(0x18, 0x01, SS_NOP|SSQ_PRINT_SENSE,
1037 			"Recovered data with error corr. & retries applied") },
1038 /* D   WR O     */{SST(0x18, 0x02, SS_NOP|SSQ_PRINT_SENSE,
1039 			"Recovered data - data auto-reallocated") },
1040 /*      R       */{SST(0x18, 0x03, SS_NOP|SSQ_PRINT_SENSE,
1041 			"Recovered data with CIRC") },
1042 /*      R       */{SST(0x18, 0x04, SS_NOP|SSQ_PRINT_SENSE,
1043 			"Recovered data with L-EC") },
1044 /* D   WR O     */{SST(0x18, 0x05, SS_NOP|SSQ_PRINT_SENSE,
1045 			"Recovered data - recommend reassignment") },
1046 /* D   WR O     */{SST(0x18, 0x06, SS_NOP|SSQ_PRINT_SENSE,
1047 			"Recovered data - recommend rewrite") },
1048 /* D   W  O     */{SST(0x18, 0x07, SS_NOP|SSQ_PRINT_SENSE,
1049 			"Recovered data with ECC - data rewritten") },
1050 /* D      O     */{SST(0x19, 0x00, SS_RDEF,
1051 			"Defect list error") },
1052 /* D      O     */{SST(0x19, 0x01, SS_RDEF,
1053 			"Defect list not available") },
1054 /* D      O     */{SST(0x19, 0x02, SS_RDEF,
1055 			"Defect list error in primary list") },
1056 /* D      O     */{SST(0x19, 0x03, SS_RDEF,
1057 			"Defect list error in grown list") },
1058 /* DTLPWRSOMCAE */{SST(0x1A, 0x00, SS_RDEF,
1059 			"Parameter list length error") },
1060 /* DTLPWRSOMCAE */{SST(0x1B, 0x00, SS_RDEF,
1061 			"Synchronous data transfer error") },
1062 /* D      O     */{SST(0x1C, 0x00, SS_RDEF,
1063 			"Defect list not found") },
1064 /* D      O     */{SST(0x1C, 0x01, SS_RDEF,
1065 			"Primary defect list not found") },
1066 /* D      O     */{SST(0x1C, 0x02, SS_RDEF,
1067 			"Grown defect list not found") },
1068 /* D   W  O     */{SST(0x1D, 0x00, SS_FATAL,
1069 			"Miscompare during verify operation" )},
1070 /* D   W  O     */{SST(0x1E, 0x00, SS_NOP|SSQ_PRINT_SENSE,
1071 			"Recovered id with ecc correction") },
1072 /* D      O     */{SST(0x1F, 0x00, SS_RDEF,
1073 			"Partial defect list transfer") },
1074 /* DTLPWRSOMCAE */{SST(0x20, 0x00, SS_FATAL|EINVAL,
1075 			"Invalid command operation code") },
1076 /* DT  WR OM    */{SST(0x21, 0x00, SS_FATAL|EINVAL,
1077 			"Logical block address out of range" )},
1078 /* DT  WR OM    */{SST(0x21, 0x01, SS_FATAL|EINVAL,
1079 			"Invalid element address") },
1080 /* D            */{SST(0x22, 0x00, SS_FATAL|EINVAL,
1081 			"Illegal function") }, /* Deprecated. Use 20 00, 24 00, or 26 00 instead */
1082 /* DTLPWRSOMCAE */{SST(0x24, 0x00, SS_FATAL|EINVAL,
1083 			"Invalid field in CDB") },
1084 /* DTLPWRSOMCAE */{SST(0x25, 0x00, SS_FATAL|ENXIO,
1085 			"Logical unit not supported") },
1086 /* DTLPWRSOMCAE */{SST(0x26, 0x00, SS_FATAL|EINVAL,
1087 			"Invalid field in parameter list") },
1088 /* DTLPWRSOMCAE */{SST(0x26, 0x01, SS_FATAL|EINVAL,
1089 			"Parameter not supported") },
1090 /* DTLPWRSOMCAE */{SST(0x26, 0x02, SS_FATAL|EINVAL,
1091 			"Parameter value invalid") },
1092 /* DTLPWRSOMCAE */{SST(0x26, 0x03, SS_FATAL|EINVAL,
1093 			"Threshold parameters not supported") },
1094 /* DTLPWRSOMCAE */{SST(0x26, 0x04, SS_FATAL|EINVAL,
1095 			"Invalid release of active persistent reservation") },
1096 /* DT  W  O     */{SST(0x27, 0x00, SS_FATAL|EACCES,
1097 			"Write protected") },
1098 /* DT  W  O     */{SST(0x27, 0x01, SS_FATAL|EACCES,
1099 			"Hardware write protected") },
1100 /* DT  W  O     */{SST(0x27, 0x02, SS_FATAL|EACCES,
1101 			"Logical unit software write protected") },
1102 /*  T           */{SST(0x27, 0x03, SS_FATAL|EACCES,
1103 			"Associated write protect") },
1104 /*  T           */{SST(0x27, 0x04, SS_FATAL|EACCES,
1105 			"Persistent write protect") },
1106 /*  T           */{SST(0x27, 0x05, SS_FATAL|EACCES,
1107 			"Permanent write protect") },
1108 /* DTLPWRSOMCAE */{SST(0x28, 0x00, SS_FATAL|ENXIO,
1109 			"Not ready to ready change, medium may have changed") },
1110 /* DTLPWRSOMCAE */{SST(0x28, 0x01, SS_FATAL|ENXIO,
1111 			"Import or export element accessed") },
1112 /*
1113  * XXX JGibbs - All of these should use the same errno, but I don't think
1114  * ENXIO is the correct choice.  Should we borrow from the networking
1115  * errnos?  ECONNRESET anyone?
1116  */
1117 /* DTLPWRSOMCAE */{SST(0x29, 0x00, SS_FATAL|ENXIO,
1118 			"Power on, reset, or bus device reset occurred") },
1119 /* DTLPWRSOMCAE */{SST(0x29, 0x01, SS_RDEF,
1120 			"Power on occurred") },
1121 /* DTLPWRSOMCAE */{SST(0x29, 0x02, SS_RDEF,
1122 			"Scsi bus reset occurred") },
1123 /* DTLPWRSOMCAE */{SST(0x29, 0x03, SS_RDEF,
1124 			"Bus device reset function occurred") },
1125 /* DTLPWRSOMCAE */{SST(0x29, 0x04, SS_RDEF,
1126 			"Device internal reset") },
1127 /* DTLPWRSOMCAE */{SST(0x29, 0x05, SS_RDEF,
1128 			"Transceiver mode changed to single-ended") },
1129 /* DTLPWRSOMCAE */{SST(0x29, 0x06, SS_RDEF,
1130 			"Transceiver mode changed to LVD") },
1131 /* DTL WRSOMCAE */{SST(0x2A, 0x00, SS_RDEF,
1132 			"Parameters changed") },
1133 /* DTL WRSOMCAE */{SST(0x2A, 0x01, SS_RDEF,
1134 			"Mode parameters changed") },
1135 /* DTL WRSOMCAE */{SST(0x2A, 0x02, SS_RDEF,
1136 			"Log parameters changed") },
1137 /* DTLPWRSOMCAE */{SST(0x2A, 0x03, SS_RDEF,
1138 			"Reservations preempted") },
1139 /* DTLPWRSO C   */{SST(0x2B, 0x00, SS_RDEF,
1140 			"Copy cannot execute since host cannot disconnect") },
1141 /* DTLPWRSOMCAE */{SST(0x2C, 0x00, SS_RDEF,
1142 			"Command sequence error") },
1143 /*       S      */{SST(0x2C, 0x01, SS_RDEF,
1144 			"Too many windows specified") },
1145 /*       S      */{SST(0x2C, 0x02, SS_RDEF,
1146 			"Invalid combination of windows specified") },
1147 /*      R       */{SST(0x2C, 0x03, SS_RDEF,
1148 			"Current program area is not empty") },
1149 /*      R       */{SST(0x2C, 0x04, SS_RDEF,
1150 			"Current program area is empty") },
1151 /*  T           */{SST(0x2D, 0x00, SS_RDEF,
1152 			"Overwrite error on update in place") },
1153 /* DTLPWRSOMCAE */{SST(0x2F, 0x00, SS_RDEF,
1154 			"Commands cleared by another initiator") },
1155 /* DT  WR OM    */{SST(0x30, 0x00, SS_RDEF,
1156 			"Incompatible medium installed") },
1157 /* DT  WR O     */{SST(0x30, 0x01, SS_RDEF,
1158 			"Cannot read medium - unknown format") },
1159 /* DT  WR O     */{SST(0x30, 0x02, SS_RDEF,
1160 			"Cannot read medium - incompatible format") },
1161 /* DT           */{SST(0x30, 0x03, SS_RDEF,
1162 			"Cleaning cartridge installed") },
1163 /* DT  WR O     */{SST(0x30, 0x04, SS_RDEF,
1164 			"Cannot write medium - unknown format") },
1165 /* DT  WR O     */{SST(0x30, 0x05, SS_RDEF,
1166 			"Cannot write medium - incompatible format") },
1167 /* DT  W  O     */{SST(0x30, 0x06, SS_RDEF,
1168 			"Cannot format medium - incompatible medium") },
1169 /* DTL WRSOM AE */{SST(0x30, 0x07, SS_RDEF,
1170 			"Cleaning failure") },
1171 /*      R       */{SST(0x30, 0x08, SS_RDEF,
1172 			"Cannot write - application code mismatch") },
1173 /*      R       */{SST(0x30, 0x09, SS_RDEF,
1174 			"Current session not fixated for append") },
1175 /* DT  WR O     */{SST(0x31, 0x00, SS_RDEF,
1176 			"Medium format corrupted") },
1177 /* D L  R O     */{SST(0x31, 0x01, SS_RDEF,
1178 			"Format command failed") },
1179 /* D   W  O     */{SST(0x32, 0x00, SS_RDEF,
1180 			"No defect spare location available") },
1181 /* D   W  O     */{SST(0x32, 0x01, SS_RDEF,
1182 			"Defect list update failure") },
1183 /*  T           */{SST(0x33, 0x00, SS_RDEF,
1184 			"Tape length error") },
1185 /* DTLPWRSOMCAE */{SST(0x34, 0x00, SS_RDEF,
1186 			"Enclosure failure") },
1187 /* DTLPWRSOMCAE */{SST(0x35, 0x00, SS_RDEF,
1188 			"Enclosure services failure") },
1189 /* DTLPWRSOMCAE */{SST(0x35, 0x01, SS_RDEF,
1190 			"Unsupported enclosure function") },
1191 /* DTLPWRSOMCAE */{SST(0x35, 0x02, SS_RDEF,
1192 			"Enclosure services unavailable") },
1193 /* DTLPWRSOMCAE */{SST(0x35, 0x03, SS_RDEF,
1194 			"Enclosure services transfer failure") },
1195 /* DTLPWRSOMCAE */{SST(0x35, 0x04, SS_RDEF,
1196 			"Enclosure services transfer refused") },
1197 /*   L          */{SST(0x36, 0x00, SS_RDEF,
1198 			"Ribbon, ink, or toner failure") },
1199 /* DTL WRSOMCAE */{SST(0x37, 0x00, SS_RDEF,
1200 			"Rounded parameter") },
1201 /* DTL WRSOMCAE */{SST(0x39, 0x00, SS_RDEF,
1202 			"Saving parameters not supported") },
1203 /* DTL WRSOM    */{SST(0x3A, 0x00, SS_FATAL|ENXIO,
1204 			"Medium not present") },
1205 /* DT  WR OM    */{SST(0x3A, 0x01, SS_FATAL|ENXIO,
1206 			"Medium not present - tray closed") },
1207 /* DT  WR OM    */{SST(0x3A, 0x02, SS_FATAL|ENXIO,
1208 			"Medium not present - tray open") },
1209 /*  TL          */{SST(0x3B, 0x00, SS_RDEF,
1210 			"Sequential positioning error") },
1211 /*  T           */{SST(0x3B, 0x01, SS_RDEF,
1212 			"Tape position error at beginning-of-medium") },
1213 /*  T           */{SST(0x3B, 0x02, SS_RDEF,
1214 			"Tape position error at end-of-medium") },
1215 /*   L          */{SST(0x3B, 0x03, SS_RDEF,
1216 			"Tape or electronic vertical forms unit not ready") },
1217 /*   L          */{SST(0x3B, 0x04, SS_RDEF,
1218 			"Slew failure") },
1219 /*   L          */{SST(0x3B, 0x05, SS_RDEF,
1220 			"Paper jam") },
1221 /*   L          */{SST(0x3B, 0x06, SS_RDEF,
1222 			"Failed to sense top-of-form") },
1223 /*   L          */{SST(0x3B, 0x07, SS_RDEF,
1224 			"Failed to sense bottom-of-form") },
1225 /*  T           */{SST(0x3B, 0x08, SS_RDEF,
1226 			"Reposition error") },
1227 /*       S      */{SST(0x3B, 0x09, SS_RDEF,
1228 			"Read past end of medium") },
1229 /*       S      */{SST(0x3B, 0x0A, SS_RDEF,
1230 			"Read past beginning of medium") },
1231 /*       S      */{SST(0x3B, 0x0B, SS_RDEF,
1232 			"Position past end of medium") },
1233 /*  T    S      */{SST(0x3B, 0x0C, SS_RDEF,
1234 			"Position past beginning of medium") },
1235 /* DT  WR OM    */{SST(0x3B, 0x0D, SS_FATAL|ENOSPC,
1236 			"Medium destination element full") },
1237 /* DT  WR OM    */{SST(0x3B, 0x0E, SS_RDEF,
1238 			"Medium source element empty") },
1239 /*      R       */{SST(0x3B, 0x0F, SS_RDEF,
1240 			"End of medium reached") },
1241 /* DT  WR OM    */{SST(0x3B, 0x11, SS_RDEF,
1242 			"Medium magazine not accessible") },
1243 /* DT  WR OM    */{SST(0x3B, 0x12, SS_RDEF,
1244 			"Medium magazine removed") },
1245 /* DT  WR OM    */{SST(0x3B, 0x13, SS_RDEF,
1246 			"Medium magazine inserted") },
1247 /* DT  WR OM    */{SST(0x3B, 0x14, SS_RDEF,
1248 			"Medium magazine locked") },
1249 /* DT  WR OM    */{SST(0x3B, 0x15, SS_RDEF,
1250 			"Medium magazine unlocked") },
1251 /* DTLPWRSOMCAE */{SST(0x3D, 0x00, SS_RDEF,
1252 			"Invalid bits in identify message") },
1253 /* DTLPWRSOMCAE */{SST(0x3E, 0x00, SS_RDEF,
1254 			"Logical unit has not self-configured yet") },
1255 /* DTLPWRSOMCAE */{SST(0x3E, 0x01, SS_RDEF,
1256 			"Logical unit failure") },
1257 /* DTLPWRSOMCAE */{SST(0x3E, 0x02, SS_RDEF,
1258 			"Timeout on logical unit") },
1259 /* DTLPWRSOMCAE */{SST(0x3F, 0x00, SS_RDEF,
1260 			"Target operating conditions have changed") },
1261 /* DTLPWRSOMCAE */{SST(0x3F, 0x01, SS_RDEF,
1262 			"Microcode has been changed") },
1263 /* DTLPWRSOMC   */{SST(0x3F, 0x02, SS_RDEF,
1264 			"Changed operating definition") },
1265 /* DTLPWRSOMCAE */{SST(0x3F, 0x03, SS_RDEF,
1266 			"Inquiry data has changed") },
1267 /* DT  WR OMCAE */{SST(0x3F, 0x04, SS_RDEF,
1268 			"Component device attached") },
1269 /* DT  WR OMCAE */{SST(0x3F, 0x05, SS_RDEF,
1270 			"Device identifier changed") },
1271 /* DT  WR OMCAE */{SST(0x3F, 0x06, SS_RDEF,
1272 			"Redundancy group created or modified") },
1273 /* DT  WR OMCAE */{SST(0x3F, 0x07, SS_RDEF,
1274 			"Redundancy group deleted") },
1275 /* DT  WR OMCAE */{SST(0x3F, 0x08, SS_RDEF,
1276 			"Spare created or modified") },
1277 /* DT  WR OMCAE */{SST(0x3F, 0x09, SS_RDEF,
1278 			"Spare deleted") },
1279 /* DT  WR OMCAE */{SST(0x3F, 0x0A, SS_RDEF,
1280 			"Volume set created or modified") },
1281 /* DT  WR OMCAE */{SST(0x3F, 0x0B, SS_RDEF,
1282 			"Volume set deleted") },
1283 /* DT  WR OMCAE */{SST(0x3F, 0x0C, SS_RDEF,
1284 			"Volume set deassigned") },
1285 /* DT  WR OMCAE */{SST(0x3F, 0x0D, SS_RDEF,
1286 			"Volume set reassigned") },
1287 /* D            */{SST(0x40, 0x00, SS_RDEF,
1288 			"Ram failure") }, /* deprecated - use 40 NN instead */
1289 /* DTLPWRSOMCAE */{SST(0x40, 0x80, SS_RDEF,
1290 			"Diagnostic failure: ASCQ = Component ID") },
1291 /* DTLPWRSOMCAE */{SST(0x40, 0xFF, SS_RDEF|SSQ_RANGE,
1292 			NULL) },/* Range 0x80->0xFF */
1293 /* D            */{SST(0x41, 0x00, SS_RDEF,
1294 			"Data path failure") }, /* deprecated - use 40 NN instead */
1295 /* D            */{SST(0x42, 0x00, SS_RDEF,
1296 			"Power-on or self-test failure") }, /* deprecated - use 40 NN instead */
1297 /* DTLPWRSOMCAE */{SST(0x43, 0x00, SS_RDEF,
1298 			"Message error") },
1299 /* DTLPWRSOMCAE */{SST(0x44, 0x00, SS_RDEF,
1300 			"Internal target failure") },
1301 /* DTLPWRSOMCAE */{SST(0x45, 0x00, SS_RDEF,
1302 			"Select or reselect failure") },
1303 /* DTLPWRSOMC   */{SST(0x46, 0x00, SS_RDEF,
1304 			"Unsuccessful soft reset") },
1305 /* DTLPWRSOMCAE */{SST(0x47, 0x00, SS_RDEF,
1306 			"SCSI parity error") },
1307 /* DTLPWRSOMCAE */{SST(0x48, 0x00, SS_RDEF,
1308 			"Initiator detected error message received") },
1309 /* DTLPWRSOMCAE */{SST(0x49, 0x00, SS_RDEF,
1310 			"Invalid message error") },
1311 /* DTLPWRSOMCAE */{SST(0x4A, 0x00, SS_RDEF,
1312 			"Command phase error") },
1313 /* DTLPWRSOMCAE */{SST(0x4B, 0x00, SS_RDEF,
1314 			"Data phase error") },
1315 /* DTLPWRSOMCAE */{SST(0x4C, 0x00, SS_RDEF,
1316 			"Logical unit failed self-configuration") },
1317 /* DTLPWRSOMCAE */{SST(0x4D, 0x00, SS_RDEF,
1318 			"Tagged overlapped commands: ASCQ = Queue tag ID") },
1319 /* DTLPWRSOMCAE */{SST(0x4D, 0xFF, SS_RDEF|SSQ_RANGE,
1320 			NULL)}, /* Range 0x00->0xFF */
1321 /* DTLPWRSOMCAE */{SST(0x4E, 0x00, SS_RDEF,
1322 			"Overlapped commands attempted") },
1323 /*  T           */{SST(0x50, 0x00, SS_RDEF,
1324 			"Write append error") },
1325 /*  T           */{SST(0x50, 0x01, SS_RDEF,
1326 			"Write append position error") },
1327 /*  T           */{SST(0x50, 0x02, SS_RDEF,
1328 			"Position error related to timing") },
1329 /*  T     O     */{SST(0x51, 0x00, SS_RDEF,
1330 			"Erase failure") },
1331 /*  T           */{SST(0x52, 0x00, SS_RDEF,
1332 			"Cartridge fault") },
1333 /* DTL WRSOM    */{SST(0x53, 0x00, SS_RDEF,
1334 			"Media load or eject failed") },
1335 /*  T           */{SST(0x53, 0x01, SS_RDEF,
1336 			"Unload tape failure") },
1337 /* DT  WR OM    */{SST(0x53, 0x02, SS_RDEF,
1338 			"Medium removal prevented") },
1339 /*    P         */{SST(0x54, 0x00, SS_RDEF,
1340 			"Scsi to host system interface failure") },
1341 /*    P         */{SST(0x55, 0x00, SS_RDEF,
1342 			"System resource failure") },
1343 /* D      O     */{SST(0x55, 0x01, SS_FATAL|ENOSPC,
1344 			"System buffer full") },
1345 /*      R       */{SST(0x57, 0x00, SS_RDEF,
1346 			"Unable to recover table-of-contents") },
1347 /*        O     */{SST(0x58, 0x00, SS_RDEF,
1348 			"Generation does not exist") },
1349 /*        O     */{SST(0x59, 0x00, SS_RDEF,
1350 			"Updated block read") },
1351 /* DTLPWRSOM    */{SST(0x5A, 0x00, SS_RDEF,
1352 			"Operator request or state change input") },
1353 /* DT  WR OM    */{SST(0x5A, 0x01, SS_RDEF,
1354 			"Operator medium removal request") },
1355 /* DT  W  O     */{SST(0x5A, 0x02, SS_RDEF,
1356 			"Operator selected write protect") },
1357 /* DT  W  O     */{SST(0x5A, 0x03, SS_RDEF,
1358 			"Operator selected write permit") },
1359 /* DTLPWRSOM    */{SST(0x5B, 0x00, SS_RDEF,
1360 			"Log exception") },
1361 /* DTLPWRSOM    */{SST(0x5B, 0x01, SS_RDEF,
1362 			"Threshold condition met") },
1363 /* DTLPWRSOM    */{SST(0x5B, 0x02, SS_RDEF,
1364 			"Log counter at maximum") },
1365 /* DTLPWRSOM    */{SST(0x5B, 0x03, SS_RDEF,
1366 			"Log list codes exhausted") },
1367 /* D      O     */{SST(0x5C, 0x00, SS_RDEF,
1368 			"RPL status change") },
1369 /* D      O     */{SST(0x5C, 0x01, SS_NOP|SSQ_PRINT_SENSE,
1370 			"Spindles synchronized") },
1371 /* D      O     */{SST(0x5C, 0x02, SS_RDEF,
1372 			"Spindles not synchronized") },
1373 /* DTLPWRSOMCAE */{SST(0x5D, 0x00, SS_RDEF,
1374 			"Failure prediction threshold exceeded") },
1375 /* DTLPWRSOMCAE */{SST(0x5D, 0xFF, SS_RDEF,
1376 			"Failure prediction threshold exceeded (false)") },
1377 /* DTLPWRSO CA  */{SST(0x5E, 0x00, SS_RDEF,
1378 			"Low power condition on") },
1379 /* DTLPWRSO CA  */{SST(0x5E, 0x01, SS_RDEF,
1380 			"Idle condition activated by timer") },
1381 /* DTLPWRSO CA  */{SST(0x5E, 0x02, SS_RDEF,
1382 			"Standby condition activated by timer") },
1383 /* DTLPWRSO CA  */{SST(0x5E, 0x03, SS_RDEF,
1384 			"Idle condition activated by command") },
1385 /* DTLPWRSO CA  */{SST(0x5E, 0x04, SS_RDEF,
1386 			"Standby condition activated by command") },
1387 /*       S      */{SST(0x60, 0x00, SS_RDEF,
1388 			"Lamp failure") },
1389 /*       S      */{SST(0x61, 0x00, SS_RDEF,
1390 			"Video acquisition error") },
1391 /*       S      */{SST(0x61, 0x01, SS_RDEF,
1392 			"Unable to acquire video") },
1393 /*       S      */{SST(0x61, 0x02, SS_RDEF,
1394 			"Out of focus") },
1395 /*       S      */{SST(0x62, 0x00, SS_RDEF,
1396 			"Scan head positioning error") },
1397 /*      R       */{SST(0x63, 0x00, SS_RDEF,
1398 			"End of user area encountered on this track") },
1399 /*      R       */{SST(0x63, 0x01, SS_FATAL|ENOSPC,
1400 			"Packet does not fit in available space") },
1401 /*      R       */{SST(0x64, 0x00, SS_FATAL|ENXIO,
1402 			"Illegal mode for this track") },
1403 /*      R       */{SST(0x64, 0x01, SS_RDEF,
1404 			"Invalid packet size") },
1405 /* DTLPWRSOMCAE */{SST(0x65, 0x00, SS_RDEF,
1406 			"Voltage fault") },
1407 /*       S      */{SST(0x66, 0x00, SS_RDEF,
1408 			"Automatic document feeder cover up") },
1409 /*       S      */{SST(0x66, 0x01, SS_RDEF,
1410 			"Automatic document feeder lift up") },
1411 /*       S      */{SST(0x66, 0x02, SS_RDEF,
1412 			"Document jam in automatic document feeder") },
1413 /*       S      */{SST(0x66, 0x03, SS_RDEF,
1414 			"Document miss feed automatic in document feeder") },
1415 /*           A  */{SST(0x67, 0x00, SS_RDEF,
1416 			"Configuration failure") },
1417 /*           A  */{SST(0x67, 0x01, SS_RDEF,
1418 			"Configuration of incapable logical units failed") },
1419 /*           A  */{SST(0x67, 0x02, SS_RDEF,
1420 			"Add logical unit failed") },
1421 /*           A  */{SST(0x67, 0x03, SS_RDEF,
1422 			"Modification of logical unit failed") },
1423 /*           A  */{SST(0x67, 0x04, SS_RDEF,
1424 			"Exchange of logical unit failed") },
1425 /*           A  */{SST(0x67, 0x05, SS_RDEF,
1426 			"Remove of logical unit failed") },
1427 /*           A  */{SST(0x67, 0x06, SS_RDEF,
1428 			"Attachment of logical unit failed") },
1429 /*           A  */{SST(0x67, 0x07, SS_RDEF,
1430 			"Creation of logical unit failed") },
1431 /*           A  */{SST(0x68, 0x00, SS_RDEF,
1432 			"Logical unit not configured") },
1433 /*           A  */{SST(0x69, 0x00, SS_RDEF,
1434 			"Data loss on logical unit") },
1435 /*           A  */{SST(0x69, 0x01, SS_RDEF,
1436 			"Multiple logical unit failures") },
1437 /*           A  */{SST(0x69, 0x02, SS_RDEF,
1438 			"Parity/data mismatch") },
1439 /*           A  */{SST(0x6A, 0x00, SS_RDEF,
1440 			"Informational, refer to log") },
1441 /*           A  */{SST(0x6B, 0x00, SS_RDEF,
1442 			"State change has occurred") },
1443 /*           A  */{SST(0x6B, 0x01, SS_RDEF,
1444 			"Redundancy level got better") },
1445 /*           A  */{SST(0x6B, 0x02, SS_RDEF,
1446 			"Redundancy level got worse") },
1447 /*           A  */{SST(0x6C, 0x00, SS_RDEF,
1448 			"Rebuild failure occurred") },
1449 /*           A  */{SST(0x6D, 0x00, SS_RDEF,
1450 			"Recalculate failure occurred") },
1451 /*           A  */{SST(0x6E, 0x00, SS_RDEF,
1452 			"Command to logical unit failed") },
1453 /*  T           */{SST(0x70, 0x00, SS_RDEF,
1454 			"Decompression exception short: ASCQ = Algorithm ID") },
1455 /*  T           */{SST(0x70, 0xFF, SS_RDEF|SSQ_RANGE,
1456 			NULL) }, /* Range 0x00 -> 0xFF */
1457 /*  T           */{SST(0x71, 0x00, SS_RDEF,
1458 			"Decompression exception long: ASCQ = Algorithm ID") },
1459 /*  T           */{SST(0x71, 0xFF, SS_RDEF|SSQ_RANGE,
1460 			NULL) }, /* Range 0x00 -> 0xFF */
1461 /*      R       */{SST(0x72, 0x00, SS_RDEF,
1462 			"Session fixation error") },
1463 /*      R       */{SST(0x72, 0x01, SS_RDEF,
1464 			"Session fixation error writing lead-in") },
1465 /*      R       */{SST(0x72, 0x02, SS_RDEF,
1466 			"Session fixation error writing lead-out") },
1467 /*      R       */{SST(0x72, 0x03, SS_RDEF,
1468 			"Session fixation error - incomplete track in session") },
1469 /*      R       */{SST(0x72, 0x04, SS_RDEF,
1470 			"Empty or partially written reserved track") },
1471 /*      R       */{SST(0x73, 0x00, SS_RDEF,
1472 			"CD control error") },
1473 /*      R       */{SST(0x73, 0x01, SS_RDEF,
1474 			"Power calibration area almost full") },
1475 /*      R       */{SST(0x73, 0x02, SS_FATAL|ENOSPC,
1476 			"Power calibration area is full") },
1477 /*      R       */{SST(0x73, 0x03, SS_RDEF,
1478 			"Power calibration area error") },
1479 /*      R       */{SST(0x73, 0x04, SS_RDEF,
1480 			"Program memory area update failure") },
1481 /*      R       */{SST(0x73, 0x05, SS_RDEF,
1482 			"program memory area is full") }
1483 };
1484 
1485 const int asc_table_size = sizeof(asc_table)/sizeof(asc_table[0]);
1486 
1487 struct asc_key
1488 {
1489 	int asc;
1490 	int ascq;
1491 };
1492 
1493 static int
1494 ascentrycomp(const void *key, const void *member)
1495 {
1496 	int asc;
1497 	int ascq;
1498 	const struct asc_table_entry *table_entry;
1499 
1500 	asc = ((const struct asc_key *)key)->asc;
1501 	ascq = ((const struct asc_key *)key)->ascq;
1502 	table_entry = (const struct asc_table_entry *)member;
1503 
1504 	if (asc >= table_entry->asc) {
1505 
1506 		if (asc > table_entry->asc)
1507 			return (1);
1508 
1509 		if (ascq <= table_entry->ascq) {
1510 			/* Check for ranges */
1511 			if (ascq == table_entry->ascq
1512 			 || ((table_entry->action & SSQ_RANGE) != 0
1513 			   && ascq >= (table_entry - 1)->ascq))
1514 				return (0);
1515 			return (-1);
1516 		}
1517 		return (1);
1518 	}
1519 	return (-1);
1520 }
1521 
1522 static int
1523 senseentrycomp(const void *key, const void *member)
1524 {
1525 	int sense_key;
1526 	const struct sense_key_table_entry *table_entry;
1527 
1528 	sense_key = *((const int *)key);
1529 	table_entry = (const struct sense_key_table_entry *)member;
1530 
1531 	if (sense_key >= table_entry->sense_key) {
1532 		if (sense_key == table_entry->sense_key)
1533 			return (0);
1534 		return (1);
1535 	}
1536 	return (-1);
1537 }
1538 
1539 static void
1540 fetchtableentries(int sense_key, int asc, int ascq,
1541 		  struct scsi_inquiry_data *inq_data,
1542 		  const struct sense_key_table_entry **sense_entry,
1543 		  const struct asc_table_entry **asc_entry)
1544 {
1545 	caddr_t match;
1546 	const struct asc_table_entry *asc_tables[2];
1547 	const struct sense_key_table_entry *sense_tables[2];
1548 	struct asc_key asc_ascq;
1549 	size_t asc_tables_size[2];
1550 	size_t sense_tables_size[2];
1551 	int num_asc_tables;
1552 	int num_sense_tables;
1553 	int i;
1554 
1555 	/* Default to failure */
1556 	*sense_entry = NULL;
1557 	*asc_entry = NULL;
1558 	match = NULL;
1559 	if (inq_data != NULL)
1560 		match = cam_quirkmatch((caddr_t)inq_data,
1561 				       (caddr_t)sense_quirk_table,
1562 				       sense_quirk_table_size,
1563 				       sizeof(*sense_quirk_table),
1564 				       scsi_inquiry_match);
1565 
1566 	if (match != NULL) {
1567 		struct scsi_sense_quirk_entry *quirk;
1568 
1569 		quirk = (struct scsi_sense_quirk_entry *)match;
1570 		asc_tables[0] = quirk->asc_info;
1571 		asc_tables_size[0] = quirk->num_ascs;
1572 		asc_tables[1] = asc_table;
1573 		asc_tables_size[1] = asc_table_size;
1574 		num_asc_tables = 2;
1575 		sense_tables[0] = quirk->sense_key_info;
1576 		sense_tables_size[0] = quirk->num_sense_keys;
1577 		sense_tables[1] = sense_key_table;
1578 		sense_tables_size[1] = sense_key_table_size;
1579 		num_sense_tables = 2;
1580 	} else {
1581 		asc_tables[0] = asc_table;
1582 		asc_tables_size[0] = asc_table_size;
1583 		num_asc_tables = 1;
1584 		sense_tables[0] = sense_key_table;
1585 		sense_tables_size[0] = sense_key_table_size;
1586 		num_sense_tables = 1;
1587 	}
1588 
1589 	asc_ascq.asc = asc;
1590 	asc_ascq.ascq = ascq;
1591 	for (i = 0; i < num_asc_tables; i++) {
1592 		void *found_entry;
1593 
1594 		found_entry = bsearch(&asc_ascq, asc_tables[i],
1595 				      asc_tables_size[i],
1596 				      sizeof(**asc_tables),
1597 				      ascentrycomp);
1598 
1599 		if (found_entry) {
1600 			*asc_entry = (struct asc_table_entry *)found_entry;
1601 			break;
1602 		}
1603 	}
1604 
1605 	for (i = 0; i < num_sense_tables; i++) {
1606 		void *found_entry;
1607 
1608 		found_entry = bsearch(&sense_key, sense_tables[i],
1609 				      sense_tables_size[i],
1610 				      sizeof(**sense_tables),
1611 				      senseentrycomp);
1612 
1613 		if (found_entry) {
1614 			*sense_entry =
1615 			    (struct sense_key_table_entry *)found_entry;
1616 			break;
1617 		}
1618 	}
1619 }
1620 
1621 void
1622 scsi_sense_desc(int sense_key, int asc, int ascq,
1623 		struct scsi_inquiry_data *inq_data,
1624 		const char **sense_key_desc, const char **asc_desc)
1625 {
1626 	const struct asc_table_entry *asc_entry;
1627 	const struct sense_key_table_entry *sense_entry;
1628 
1629 	fetchtableentries(sense_key, asc, ascq,
1630 			  inq_data,
1631 			  &sense_entry,
1632 			  &asc_entry);
1633 
1634 	*sense_key_desc = sense_entry->desc;
1635 
1636 	if (asc_entry != NULL)
1637 		*asc_desc = asc_entry->desc;
1638 	else if (asc >= 0x80 && asc <= 0xff)
1639 		*asc_desc = "Vendor Specific ASC";
1640 	else if (ascq >= 0x80 && ascq <= 0xff)
1641 		*asc_desc = "Vendor Specific ASCQ";
1642 	else
1643 		*asc_desc = "Reserved ASC/ASCQ pair";
1644 }
1645 
1646 /*
1647  * Given sense and device type information, return the appropriate action.
1648  * If we do not understand the specific error as identified by the ASC/ASCQ
1649  * pair, fall back on the more generic actions derived from the sense key.
1650  */
1651 scsi_sense_action
1652 scsi_error_action(struct ccb_scsiio *csio, struct scsi_inquiry_data *inq_data,
1653 		  u_int32_t sense_flags)
1654 {
1655 	const struct asc_table_entry *asc_entry;
1656 	const struct sense_key_table_entry *sense_entry;
1657 	int error_code, sense_key, asc, ascq;
1658 	scsi_sense_action action;
1659 
1660 	scsi_extract_sense(&csio->sense_data, &error_code,
1661 			   &sense_key, &asc, &ascq);
1662 
1663 	if (error_code == SSD_DEFERRED_ERROR) {
1664 		/*
1665 		 * XXX dufault@FreeBSD.org
1666 		 * This error doesn't relate to the command associated
1667 		 * with this request sense.  A deferred error is an error
1668 		 * for a command that has already returned GOOD status
1669 		 * (see SCSI2 8.2.14.2).
1670 		 *
1671 		 * By my reading of that section, it looks like the current
1672 		 * command has been cancelled, we should now clean things up
1673 		 * (hopefully recovering any lost data) and then retry the
1674 		 * current command.  There are two easy choices, both wrong:
1675 		 *
1676 		 * 1. Drop through (like we had been doing), thus treating
1677 		 *    this as if the error were for the current command and
1678 		 *    return and stop the current command.
1679 		 *
1680 		 * 2. Issue a retry (like I made it do) thus hopefully
1681 		 *    recovering the current transfer, and ignoring the
1682 		 *    fact that we've dropped a command.
1683 		 *
1684 		 * These should probably be handled in a device specific
1685 		 * sense handler or punted back up to a user mode daemon
1686 		 */
1687 		action = SS_RETRY|SSQ_DECREMENT_COUNT|SSQ_PRINT_SENSE;
1688 	} else {
1689 		fetchtableentries(sense_key, asc, ascq,
1690 				  inq_data,
1691 				  &sense_entry,
1692 				  &asc_entry);
1693 
1694 		/*
1695 		 * Override the 'No additional Sense' entry (0,0)
1696 		 * with the error action of the sense key.
1697 		 */
1698 		if (asc_entry != NULL
1699 		 && (asc != 0 || ascq != 0))
1700 			action = asc_entry->action;
1701 		else
1702 			action = sense_entry->action;
1703 
1704 		if (sense_key == SSD_KEY_RECOVERED_ERROR) {
1705 			/*
1706 			 * The action succeeded but the device wants
1707 			 * the user to know that some recovery action
1708 			 * was required.
1709 			 */
1710 			action &= ~(SS_MASK|SSQ_MASK|SS_ERRMASK);
1711 			action |= SS_NOP|SSQ_PRINT_SENSE;
1712 		} else if (sense_key == SSD_KEY_ILLEGAL_REQUEST) {
1713 			if ((sense_flags & SF_QUIET_IR) != 0)
1714 				action &= ~SSQ_PRINT_SENSE;
1715 		} else if (sense_key == SSD_KEY_UNIT_ATTENTION) {
1716 			if ((sense_flags & SF_RETRY_UA) != 0
1717 			 && (action & SS_MASK) == SS_FAIL) {
1718 				action &= ~(SS_MASK|SSQ_MASK);
1719 				action |= SS_RETRY|SSQ_DECREMENT_COUNT|
1720 					  SSQ_PRINT_SENSE;
1721 			}
1722 		}
1723 	}
1724 #ifdef KERNEL
1725 	if (bootverbose)
1726 		sense_flags |= SF_PRINT_ALWAYS;
1727 #endif
1728 	if ((sense_flags & SF_PRINT_ALWAYS) != 0)
1729 		action |= SSQ_PRINT_SENSE;
1730 	else if ((sense_flags & SF_NO_PRINT) != 0)
1731 		action &= ~SSQ_PRINT_SENSE;
1732 
1733 	return (action);
1734 }
1735 
1736 char *
1737 scsi_cdb_string(u_int8_t *cdb_ptr, char *cdb_string, size_t len)
1738 {
1739 	u_int8_t cdb_len;
1740 	int i;
1741 
1742 	if (cdb_ptr == NULL)
1743 		return("");
1744 
1745 	/* Silence warnings */
1746 	cdb_len = 0;
1747 
1748 	/*
1749 	 * This is taken from the SCSI-3 draft spec.
1750 	 * (T10/1157D revision 0.3)
1751 	 * The top 3 bits of an opcode are the group code.  The next 5 bits
1752 	 * are the command code.
1753 	 * Group 0:  six byte commands
1754 	 * Group 1:  ten byte commands
1755 	 * Group 2:  ten byte commands
1756 	 * Group 3:  reserved
1757 	 * Group 4:  sixteen byte commands
1758 	 * Group 5:  twelve byte commands
1759 	 * Group 6:  vendor specific
1760 	 * Group 7:  vendor specific
1761 	 */
1762 	switch((*cdb_ptr >> 5) & 0x7) {
1763 		case 0:
1764 			cdb_len = 6;
1765 			break;
1766 		case 1:
1767 		case 2:
1768 			cdb_len = 10;
1769 			break;
1770 		case 3:
1771 		case 6:
1772 		case 7:
1773 			/* in this case, just print out the opcode */
1774 			cdb_len = 1;
1775 			break;
1776 		case 4:
1777 			cdb_len = 16;
1778 			break;
1779 		case 5:
1780 			cdb_len = 12;
1781 			break;
1782 	}
1783 	*cdb_string = '\0';
1784 	for (i = 0; i < cdb_len; i++)
1785 		ksnprintf(cdb_string + strlen(cdb_string),
1786 			  len - strlen(cdb_string), "%x ", cdb_ptr[i]);
1787 
1788 	return(cdb_string);
1789 }
1790 
1791 const char *
1792 scsi_status_string(struct ccb_scsiio *csio)
1793 {
1794 	switch(csio->scsi_status) {
1795 	case SCSI_STATUS_OK:
1796 		return("OK");
1797 	case SCSI_STATUS_CHECK_COND:
1798 		return("Check Condition");
1799 	case SCSI_STATUS_BUSY:
1800 		return("Busy");
1801 	case SCSI_STATUS_INTERMED:
1802 		return("Intermediate");
1803 	case SCSI_STATUS_INTERMED_COND_MET:
1804 		return("Intermediate-Condition Met");
1805 	case SCSI_STATUS_RESERV_CONFLICT:
1806 		return("Reservation Conflict");
1807 	case SCSI_STATUS_CMD_TERMINATED:
1808 		return("Command Terminated");
1809 	case SCSI_STATUS_QUEUE_FULL:
1810 		return("Queue Full");
1811 	case SCSI_STATUS_ACA_ACTIVE:
1812 		return("ACA Active");
1813 	case SCSI_STATUS_TASK_ABORTED:
1814 		return("Task Aborted");
1815 	default: {
1816 		static char unkstr[64];
1817 		ksnprintf(unkstr, sizeof(unkstr), "Unknown %#x",
1818 			  csio->scsi_status);
1819 		return(unkstr);
1820 	}
1821 	}
1822 }
1823 
1824 /*
1825  * scsi_command_string() returns 0 for success and -1 for failure.
1826  */
1827 #ifdef _KERNEL
1828 int
1829 scsi_command_string(struct ccb_scsiio *csio, struct sbuf *sb)
1830 #else
1831 int
1832 scsi_command_string(struct cam_device *device, struct ccb_scsiio *csio,
1833 		    struct sbuf *sb)
1834 #endif
1835 {
1836 	struct scsi_inquiry_data *inq_data;
1837 	char cdb_str[(SCSI_MAX_CDBLEN * 3) + 1];
1838 #ifdef _KERNEL
1839 	struct	  ccb_getdev cgd;
1840 #endif
1841 
1842 #ifdef _KERNEL
1843 	/*
1844 	 * Get the device information.
1845 	 */
1846 	xpt_setup_ccb(&cgd.ccb_h,
1847 		      csio->ccb_h.path,
1848 		      /*priority*/ 1);
1849 	cgd.ccb_h.func_code = XPT_GDEV_TYPE;
1850 	xpt_action((union ccb *)&cgd);
1851 
1852 	/*
1853 	 * If the device is unconfigured, just pretend that it is a hard
1854 	 * drive.  scsi_op_desc() needs this.
1855 	 */
1856 	if (cgd.ccb_h.status == CAM_DEV_NOT_THERE)
1857 		cgd.inq_data.device = T_DIRECT;
1858 
1859 	inq_data = &cgd.inq_data;
1860 
1861 #else /* !_KERNEL */
1862 
1863 	inq_data = &device->inq_data;
1864 
1865 #endif /* _KERNEL/!_KERNEL */
1866 
1867 	if ((csio->ccb_h.flags & CAM_CDB_POINTER) != 0) {
1868 		sbuf_printf(sb, "%s. CDB: %s",
1869 			    scsi_op_desc(csio->cdb_io.cdb_ptr[0], inq_data),
1870 			    scsi_cdb_string(csio->cdb_io.cdb_ptr, cdb_str,
1871 					    sizeof(cdb_str)));
1872 	} else {
1873 		sbuf_printf(sb, "%s. CDB: %s",
1874 			    scsi_op_desc(csio->cdb_io.cdb_bytes[0], inq_data),
1875 			    scsi_cdb_string(csio->cdb_io.cdb_bytes, cdb_str,
1876 					    sizeof(cdb_str)));
1877 	}
1878 
1879 	return(0);
1880 }
1881 
1882 /*
1883  * scsi_sense_sbuf() returns 0 for success and -1 for failure.
1884  */
1885 #ifdef _KERNEL
1886 int
1887 scsi_sense_sbuf(struct ccb_scsiio *csio, struct sbuf *sb,
1888 		scsi_sense_string_flags flags)
1889 #else /* !_KERNEL */
1890 int
1891 scsi_sense_sbuf(struct cam_device *device, struct ccb_scsiio *csio,
1892 		struct sbuf *sb, scsi_sense_string_flags flags)
1893 #endif /* _KERNEL/!_KERNEL */
1894 {
1895 	struct	  scsi_sense_data *sense;
1896 	struct	  scsi_inquiry_data *inq_data;
1897 #ifdef _KERNEL
1898 	struct	  ccb_getdev cgd;
1899 #endif /* _KERNEL */
1900 	u_int32_t info;
1901 	int	  error_code;
1902 	int	  sense_key;
1903 	int	  asc, ascq;
1904 	char	  path_str[64];
1905 
1906 #ifndef _KERNEL
1907 	if (device == NULL)
1908 		return(-1);
1909 #endif /* !_KERNEL */
1910 	if ((csio == NULL) || (sb == NULL))
1911 		return(-1);
1912 
1913 	/*
1914 	 * If the CDB is a physical address, we can't deal with it..
1915 	 */
1916 	if ((csio->ccb_h.flags & CAM_CDB_PHYS) != 0)
1917 		flags &= ~SSS_FLAG_PRINT_COMMAND;
1918 
1919 #ifdef _KERNEL
1920 	xpt_path_string(csio->ccb_h.path, path_str, sizeof(path_str));
1921 #else /* !_KERNEL */
1922 	cam_path_string(device, path_str, sizeof(path_str));
1923 #endif /* _KERNEL/!_KERNEL */
1924 
1925 #ifdef _KERNEL
1926 	/*
1927 	 * Get the device information.
1928 	 */
1929 	xpt_setup_ccb(&cgd.ccb_h,
1930 		      csio->ccb_h.path,
1931 		      /*priority*/ 1);
1932 	cgd.ccb_h.func_code = XPT_GDEV_TYPE;
1933 	xpt_action((union ccb *)&cgd);
1934 
1935 	/*
1936 	 * If the device is unconfigured, just pretend that it is a hard
1937 	 * drive.  scsi_op_desc() needs this.
1938 	 */
1939 	if (cgd.ccb_h.status == CAM_DEV_NOT_THERE)
1940 		cgd.inq_data.device = T_DIRECT;
1941 
1942 	inq_data = &cgd.inq_data;
1943 
1944 #else /* !_KERNEL */
1945 
1946 	inq_data = &device->inq_data;
1947 
1948 #endif /* _KERNEL/!_KERNEL */
1949 
1950 	sense = NULL;
1951 
1952 	if (flags & SSS_FLAG_PRINT_COMMAND) {
1953 
1954 		sbuf_cat(sb, path_str);
1955 
1956 #ifdef _KERNEL
1957 		scsi_command_string(csio, sb);
1958 #else /* !_KERNEL */
1959 		scsi_command_string(device, csio, sb);
1960 #endif /* _KERNEL/!_KERNEL */
1961 	}
1962 
1963 	/*
1964 	 * If the sense data is a physical pointer, forget it.
1965 	 */
1966 	if (csio->ccb_h.flags & CAM_SENSE_PTR) {
1967 		if (csio->ccb_h.flags & CAM_SENSE_PHYS)
1968 			return(-1);
1969 		else {
1970 			/*
1971 			 * bcopy the pointer to avoid unaligned access
1972 			 * errors on finicky architectures.  We don't
1973 			 * ensure that the sense data is pointer aligned.
1974 			 */
1975 			bcopy(&csio->sense_data, &sense,
1976 			      sizeof(struct scsi_sense_data *));
1977 		}
1978 	} else {
1979 		/*
1980 		 * If the physical sense flag is set, but the sense pointer
1981 		 * is not also set, we assume that the user is an idiot and
1982 		 * return.  (Well, okay, it could be that somehow, the
1983 		 * entire csio is physical, but we would have probably core
1984 		 * dumped on one of the bogus pointer deferences above
1985 		 * already.)
1986 		 */
1987 		if (csio->ccb_h.flags & CAM_SENSE_PHYS)
1988 			return(-1);
1989 		else
1990 			sense = &csio->sense_data;
1991 	}
1992 
1993 
1994 	sbuf_cat(sb, path_str);
1995 
1996 	error_code = sense->error_code & SSD_ERRCODE;
1997 	sense_key = sense->flags & SSD_KEY;
1998 
1999 	switch (error_code) {
2000 	case SSD_DEFERRED_ERROR:
2001 		sbuf_printf(sb, "Deferred Error: ");
2002 
2003 		/* FALLTHROUGH */
2004 	case SSD_CURRENT_ERROR:
2005 	{
2006 		const char *sense_key_desc;
2007 		const char *asc_desc;
2008 
2009 		asc = (sense->extra_len >= 5) ? sense->add_sense_code : 0;
2010 		ascq = (sense->extra_len >= 6) ? sense->add_sense_code_qual : 0;
2011 		scsi_sense_desc(sense_key, asc, ascq, inq_data,
2012 				&sense_key_desc, &asc_desc);
2013 		sbuf_cat(sb, sense_key_desc);
2014 
2015 		info = scsi_4btoul(sense->info);
2016 
2017 		if (sense->error_code & SSD_ERRCODE_VALID) {
2018 
2019 			switch (sense_key) {
2020 			case SSD_KEY_NOT_READY:
2021 			case SSD_KEY_ILLEGAL_REQUEST:
2022 			case SSD_KEY_UNIT_ATTENTION:
2023 			case SSD_KEY_DATA_PROTECT:
2024 				break;
2025 			case SSD_KEY_BLANK_CHECK:
2026 				sbuf_printf(sb, " req sz: %d (decimal)", info);
2027 				break;
2028 			default:
2029 				if (info) {
2030 					if (sense->flags & SSD_ILI) {
2031 						sbuf_printf(sb, " ILI (length "
2032 							"mismatch): %d", info);
2033 
2034 					} else {
2035 						sbuf_printf(sb, " info:%x",
2036 							    info);
2037 					}
2038 				}
2039 			}
2040 		} else if (info) {
2041 			sbuf_printf(sb, " info?:%x", info);
2042 		}
2043 
2044 		if (sense->extra_len >= 4) {
2045 			if (bcmp(sense->cmd_spec_info, "\0\0\0\0", 4)) {
2046 				sbuf_printf(sb, " csi:%x,%x,%x,%x",
2047 					    sense->cmd_spec_info[0],
2048 					    sense->cmd_spec_info[1],
2049 					    sense->cmd_spec_info[2],
2050 					    sense->cmd_spec_info[3]);
2051 			}
2052 		}
2053 
2054 		sbuf_printf(sb, " asc:%x,%x\n%s%s", asc, ascq,
2055 			    path_str, asc_desc);
2056 
2057 		if (sense->extra_len >= 7 && sense->fru) {
2058 			sbuf_printf(sb, " field replaceable unit: %x",
2059 				    sense->fru);
2060 		}
2061 
2062 		if ((sense->extra_len >= 10)
2063 		 && (sense->sense_key_spec[0] & SSD_SCS_VALID) != 0) {
2064 			switch(sense_key) {
2065 			case SSD_KEY_ILLEGAL_REQUEST: {
2066 				int bad_command;
2067 				char tmpstr2[40];
2068 
2069 				if (sense->sense_key_spec[0] & 0x40)
2070 					bad_command = 1;
2071 				else
2072 					bad_command = 0;
2073 
2074 				tmpstr2[0] = '\0';
2075 
2076 				/* Bit pointer is valid */
2077 				if (sense->sense_key_spec[0] & 0x08)
2078 					ksnprintf(tmpstr2, sizeof(tmpstr2),
2079 						 "bit %d",
2080 						sense->sense_key_spec[0] & 0x7);
2081 					sbuf_printf(sb,
2082 						   ": %s byte %d %s is invalid",
2083 						    bad_command ?
2084 						    "Command" : "Data",
2085 						    scsi_2btoul(
2086 						    &sense->sense_key_spec[1]),
2087 						    tmpstr2);
2088 				break;
2089 			}
2090 			case SSD_KEY_RECOVERED_ERROR:
2091 			case SSD_KEY_HARDWARE_ERROR:
2092 			case SSD_KEY_MEDIUM_ERROR:
2093 				sbuf_printf(sb, " actual retry count: %d",
2094 					    scsi_2btoul(
2095 					    &sense->sense_key_spec[1]));
2096 				break;
2097 			default:
2098 				sbuf_printf(sb, " sks:%#x,%#x",
2099 					    sense->sense_key_spec[0],
2100 					    scsi_2btoul(
2101 					    &sense->sense_key_spec[1]));
2102 				break;
2103 			}
2104 		}
2105 		break;
2106 
2107 	}
2108 	default:
2109 		sbuf_printf(sb, "Sense Error Code 0x%x", sense->error_code);
2110 		if (sense->error_code & SSD_ERRCODE_VALID) {
2111 			sbuf_printf(sb, " at block no. %d (decimal)",
2112 				    info = scsi_4btoul(sense->info));
2113 		}
2114 	}
2115 
2116 	sbuf_printf(sb, "\n");
2117 
2118 	return(0);
2119 }
2120 
2121 #ifdef _KERNEL
2122 char *
2123 scsi_sense_string(struct ccb_scsiio *csio, char *str, int str_len)
2124 #else /* !_KERNEL */
2125 char *
2126 scsi_sense_string(struct cam_device *device, struct ccb_scsiio *csio,
2127 		  char *str, int str_len)
2128 #endif /* _KERNEL/!_KERNEL */
2129 {
2130 	struct sbuf sb;
2131 
2132 	sbuf_new(&sb, str, str_len, 0);
2133 
2134 #ifdef _KERNEL
2135 	scsi_sense_sbuf(csio, &sb, SSS_FLAG_PRINT_COMMAND);
2136 #else /* !_KERNEL */
2137 	scsi_sense_sbuf(device, csio, &sb, SSS_FLAG_PRINT_COMMAND);
2138 #endif /* _KERNEL/!_KERNEL */
2139 
2140 	sbuf_finish(&sb);
2141 
2142 	return(sbuf_data(&sb));
2143 }
2144 
2145 #ifdef _KERNEL
2146 void
2147 scsi_sense_print(struct ccb_scsiio *csio)
2148 {
2149 	struct sbuf sb;
2150 	char str[512];
2151 
2152 	sbuf_new(&sb, str, sizeof(str), 0);
2153 
2154 	scsi_sense_sbuf(csio, &sb, SSS_FLAG_PRINT_COMMAND);
2155 
2156 	sbuf_finish(&sb);
2157 
2158 	kprintf("%s", sbuf_data(&sb));
2159 }
2160 
2161 #else /* !_KERNEL */
2162 void
2163 scsi_sense_print(struct cam_device *device, struct ccb_scsiio *csio,
2164 		 FILE *ofile)
2165 {
2166 	struct sbuf sb;
2167 	char str[512];
2168 
2169 	if ((device == NULL) || (csio == NULL) || (ofile == NULL))
2170 		return;
2171 
2172 	sbuf_new(&sb, str, sizeof(str), 0);
2173 
2174 	scsi_sense_sbuf(device, csio, &sb, SSS_FLAG_PRINT_COMMAND);
2175 
2176 	sbuf_finish(&sb);
2177 
2178 	fprintf(ofile, "%s", sbuf_data(&sb));
2179 }
2180 
2181 #endif /* _KERNEL/!_KERNEL */
2182 
2183 /*
2184  * This function currently requires at least 36 bytes, or
2185  * SHORT_INQUIRY_LENGTH, worth of data to function properly.  If this
2186  * function needs more or less data in the future, another length should be
2187  * defined in scsi_all.h to indicate the minimum amount of data necessary
2188  * for this routine to function properly.
2189  */
2190 void
2191 scsi_print_inquiry(struct scsi_inquiry_data *inq_data)
2192 {
2193 	u_int8_t type;
2194 	char *dtype, *qtype;
2195 	char vendor[16], product[48], revision[16], rstr[4];
2196 
2197 	type = SID_TYPE(inq_data);
2198 
2199 	/*
2200 	 * Figure out basic device type and qualifier.
2201 	 */
2202 	if (SID_QUAL_IS_VENDOR_UNIQUE(inq_data)) {
2203 		qtype = "(vendor-unique qualifier)";
2204 	} else {
2205 		switch (SID_QUAL(inq_data)) {
2206 		case SID_QUAL_LU_CONNECTED:
2207 			qtype = "";
2208 			break;
2209 
2210 		case SID_QUAL_LU_OFFLINE:
2211 			qtype = "(offline)";
2212 			break;
2213 
2214 		case SID_QUAL_RSVD:
2215 			qtype = "(reserved qualifier)";
2216 			break;
2217 		default:
2218 		case SID_QUAL_BAD_LU:
2219 			qtype = "(lun not supported)";
2220 			break;
2221 		}
2222 	}
2223 
2224 	switch (type) {
2225 	case T_DIRECT:
2226 		dtype = "Direct Access";
2227 		break;
2228 	case T_SEQUENTIAL:
2229 		dtype = "Sequential Access";
2230 		break;
2231 	case T_PRINTER:
2232 		dtype = "Printer";
2233 		break;
2234 	case T_PROCESSOR:
2235 		dtype = "Processor";
2236 		break;
2237 	case T_CDROM:
2238 		dtype = "CD-ROM";
2239 		break;
2240 	case T_WORM:
2241 		dtype = "Worm";
2242 		break;
2243 	case T_SCANNER:
2244 		dtype = "Scanner";
2245 		break;
2246 	case T_OPTICAL:
2247 		dtype = "Optical";
2248 		break;
2249 	case T_CHANGER:
2250 		dtype = "Changer";
2251 		break;
2252 	case T_COMM:
2253 		dtype = "Communication";
2254 		break;
2255 	case T_STORARRAY:
2256 		dtype = "Storage Array";
2257 		break;
2258 	case T_ENCLOSURE:
2259 		dtype = "Enclosure Services";
2260 		break;
2261 	case T_RBC:
2262 		dtype = "Simplified Direct Access";
2263 		break;
2264 	case T_OCRW:
2265 		dtype = "Optical Card Read/Write";
2266 		break;
2267 	case T_NODEVICE:
2268 		dtype = "Uninstalled";
2269 	default:
2270 		dtype = "unknown";
2271 		break;
2272 	}
2273 
2274 	cam_strvis(vendor, inq_data->vendor, sizeof(inq_data->vendor),
2275 		   sizeof(vendor));
2276 	cam_strvis(product, inq_data->product, sizeof(inq_data->product),
2277 		   sizeof(product));
2278 	cam_strvis(revision, inq_data->revision, sizeof(inq_data->revision),
2279 		   sizeof(revision));
2280 
2281 	if (SID_ANSI_REV(inq_data) == SCSI_REV_CCS)
2282 		bcopy("CCS", rstr, 4);
2283 	else
2284 		ksnprintf(rstr, sizeof (rstr), "%d", SID_ANSI_REV(inq_data));
2285 	kprintf("<%s %s %s> %s %s SCSI-%s device %s\n",
2286 	       vendor, product, revision,
2287 	       SID_IS_REMOVABLE(inq_data) ? "Removable" : "Fixed",
2288 	       dtype, rstr, qtype);
2289 }
2290 
2291 /*
2292  * Table of syncrates that don't follow the "divisible by 4"
2293  * rule. This table will be expanded in future SCSI specs.
2294  */
2295 static struct {
2296 	u_int period_factor;
2297 	u_int period;	/* in 100ths of ns */
2298 } scsi_syncrates[] = {
2299 	{ 0x08, 625 },	/* FAST-160 */
2300 	{ 0x09, 1250 },	/* FAST-80 */
2301 	{ 0x0a, 2500 },	/* FAST-40 40MHz */
2302 	{ 0x0b, 3030 },	/* FAST-40 33MHz */
2303 	{ 0x0c, 5000 }	/* FAST-20 */
2304 };
2305 
2306 /*
2307  * Return the frequency in kHz corresponding to the given
2308  * sync period factor.
2309  */
2310 u_int
2311 scsi_calc_syncsrate(u_int period_factor)
2312 {
2313 	int i;
2314 	int num_syncrates;
2315 
2316 	/*
2317 	 * It's a bug if period is zero, but if it is anyway, don't
2318 	 * die with a divide fault- instead return something which
2319 	 * 'approximates' async
2320 	 */
2321 	if (period_factor == 0) {
2322 		return (3300);
2323 	}
2324 
2325 	num_syncrates = sizeof(scsi_syncrates) / sizeof(scsi_syncrates[0]);
2326 	/* See if the period is in the "exception" table */
2327 	for (i = 0; i < num_syncrates; i++) {
2328 
2329 		if (period_factor == scsi_syncrates[i].period_factor) {
2330 			/* Period in kHz */
2331 			return (100000000 / scsi_syncrates[i].period);
2332 		}
2333 	}
2334 
2335 	/*
2336 	 * Wasn't in the table, so use the standard
2337 	 * 4 times conversion.
2338 	 */
2339 	return (10000000 / (period_factor * 4 * 10));
2340 }
2341 
2342 /*
2343  * Return the SCSI sync parameter that corresponsd to
2344  * the passed in period in 10ths of ns.
2345  */
2346 u_int
2347 scsi_calc_syncparam(u_int period)
2348 {
2349 	int i;
2350 	int num_syncrates;
2351 
2352 	if (period == 0)
2353 		return (~0);	/* Async */
2354 
2355 	/* Adjust for exception table being in 100ths. */
2356 	period *= 10;
2357 	num_syncrates = sizeof(scsi_syncrates) / sizeof(scsi_syncrates[0]);
2358 	/* See if the period is in the "exception" table */
2359 	for (i = 0; i < num_syncrates; i++) {
2360 
2361 		if (period <= scsi_syncrates[i].period) {
2362 			/* Period in 100ths of ns */
2363 			return (scsi_syncrates[i].period_factor);
2364 		}
2365 	}
2366 
2367 	/*
2368 	 * Wasn't in the table, so use the standard
2369 	 * 1/4 period in ns conversion.
2370 	 */
2371 	return (period/400);
2372 }
2373 
2374 void
2375 scsi_test_unit_ready(struct ccb_scsiio *csio, u_int32_t retries,
2376 		     void (*cbfcnp)(struct cam_periph *, union ccb *),
2377 		     u_int8_t tag_action, u_int8_t sense_len, u_int32_t timeout)
2378 {
2379 	struct scsi_test_unit_ready *scsi_cmd;
2380 
2381 	cam_fill_csio(csio,
2382 		      retries,
2383 		      cbfcnp,
2384 		      CAM_DIR_NONE,
2385 		      tag_action,
2386 		      /*data_ptr*/NULL,
2387 		      /*dxfer_len*/0,
2388 		      sense_len,
2389 		      sizeof(*scsi_cmd),
2390 		      timeout);
2391 
2392 	scsi_cmd = (struct scsi_test_unit_ready *)&csio->cdb_io.cdb_bytes;
2393 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2394 	scsi_cmd->opcode = TEST_UNIT_READY;
2395 }
2396 
2397 void
2398 scsi_request_sense(struct ccb_scsiio *csio, u_int32_t retries,
2399 		   void (*cbfcnp)(struct cam_periph *, union ccb *),
2400 		   void *data_ptr, u_int8_t dxfer_len, u_int8_t tag_action,
2401 		   u_int8_t sense_len, u_int32_t timeout)
2402 {
2403 	struct scsi_request_sense *scsi_cmd;
2404 
2405 	cam_fill_csio(csio,
2406 		      retries,
2407 		      cbfcnp,
2408 		      CAM_DIR_IN,
2409 		      tag_action,
2410 		      data_ptr,
2411 		      dxfer_len,
2412 		      sense_len,
2413 		      sizeof(*scsi_cmd),
2414 		      timeout);
2415 
2416 	scsi_cmd = (struct scsi_request_sense *)&csio->cdb_io.cdb_bytes;
2417 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2418 	scsi_cmd->opcode = REQUEST_SENSE;
2419 	scsi_cmd->length = dxfer_len;
2420 }
2421 
2422 void
2423 scsi_inquiry(struct ccb_scsiio *csio, u_int32_t retries,
2424 	     void (*cbfcnp)(struct cam_periph *, union ccb *),
2425 	     u_int8_t tag_action, u_int8_t *inq_buf, u_int32_t inq_len,
2426 	     int evpd, u_int8_t page_code, u_int8_t sense_len,
2427 	     u_int32_t timeout)
2428 {
2429 	struct scsi_inquiry *scsi_cmd;
2430 
2431 	cam_fill_csio(csio,
2432 		      retries,
2433 		      cbfcnp,
2434 		      /*flags*/CAM_DIR_IN,
2435 		      tag_action,
2436 		      /*data_ptr*/inq_buf,
2437 		      /*dxfer_len*/inq_len,
2438 		      sense_len,
2439 		      sizeof(*scsi_cmd),
2440 		      timeout);
2441 
2442 	scsi_cmd = (struct scsi_inquiry *)&csio->cdb_io.cdb_bytes;
2443 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2444 	scsi_cmd->opcode = INQUIRY;
2445 	if (evpd) {
2446 		scsi_cmd->byte2 |= SI_EVPD;
2447 		scsi_cmd->page_code = page_code;
2448 	}
2449 	/*
2450 	 * A 'transfer units' count of 256 is coded as
2451 	 * zero for all commands with a single byte count
2452 	 * field.
2453 	 */
2454 	if (inq_len == 256)
2455 		inq_len = 0;
2456 	scsi_cmd->length = inq_len;
2457 }
2458 
2459 void
2460 scsi_mode_sense(struct ccb_scsiio *csio, u_int32_t retries,
2461 		void (*cbfcnp)(struct cam_periph *, union ccb *),
2462 		u_int8_t tag_action, int dbd, u_int8_t page_code,
2463 		u_int8_t page, u_int8_t *param_buf, u_int32_t param_len,
2464 		u_int8_t sense_len, u_int32_t timeout)
2465 {
2466 	scsi_mode_sense_len(csio, retries, cbfcnp, tag_action, dbd,
2467 			    page_code, page, param_buf, param_len, 0,
2468 			    sense_len, timeout);
2469 }
2470 
2471 void
2472 scsi_mode_sense_len(struct ccb_scsiio *csio, u_int32_t retries,
2473 		    void (*cbfcnp)(struct cam_periph *, union ccb *),
2474 		    u_int8_t tag_action, int dbd, u_int8_t page_code,
2475 		    u_int8_t page, u_int8_t *param_buf, u_int32_t param_len,
2476 		    int minimum_cmd_size, u_int8_t sense_len, u_int32_t timeout)
2477 {
2478 	u_int8_t cdb_len;
2479 
2480 	/*
2481 	 * Use the smallest possible command to perform the operation.
2482 	 */
2483 	if ((param_len < 256) && (minimum_cmd_size < 10)) {
2484 		/*
2485 		 * We can fit in a 6 byte cdb.
2486 		 */
2487 		struct scsi_mode_sense_6 *scsi_cmd;
2488 
2489 		scsi_cmd = (struct scsi_mode_sense_6 *)&csio->cdb_io.cdb_bytes;
2490 		bzero(scsi_cmd, sizeof(*scsi_cmd));
2491 		scsi_cmd->opcode = MODE_SENSE_6;
2492 		if (dbd != 0)
2493 			scsi_cmd->byte2 |= SMS_DBD;
2494 		scsi_cmd->page = page_code | page;
2495 		scsi_cmd->length = param_len;
2496 		cdb_len = sizeof(*scsi_cmd);
2497 	} else {
2498 		/*
2499 		 * Need a 10 byte cdb.
2500 		 */
2501 		struct scsi_mode_sense_10 *scsi_cmd;
2502 
2503 		scsi_cmd = (struct scsi_mode_sense_10 *)&csio->cdb_io.cdb_bytes;
2504 		bzero(scsi_cmd, sizeof(*scsi_cmd));
2505 		scsi_cmd->opcode = MODE_SENSE_10;
2506 		if (dbd != 0)
2507 			scsi_cmd->byte2 |= SMS_DBD;
2508 		scsi_cmd->page = page_code | page;
2509 		scsi_ulto2b(param_len, scsi_cmd->length);
2510 		cdb_len = sizeof(*scsi_cmd);
2511 	}
2512 	cam_fill_csio(csio,
2513 		      retries,
2514 		      cbfcnp,
2515 		      CAM_DIR_IN,
2516 		      tag_action,
2517 		      param_buf,
2518 		      param_len,
2519 		      sense_len,
2520 		      cdb_len,
2521 		      timeout);
2522 }
2523 
2524 void
2525 scsi_mode_select(struct ccb_scsiio *csio, u_int32_t retries,
2526 		 void (*cbfcnp)(struct cam_periph *, union ccb *),
2527 		 u_int8_t tag_action, int scsi_page_fmt, int save_pages,
2528 		 u_int8_t *param_buf, u_int32_t param_len, u_int8_t sense_len,
2529 		 u_int32_t timeout)
2530 {
2531 	scsi_mode_select_len(csio, retries, cbfcnp, tag_action,
2532 			     scsi_page_fmt, save_pages, param_buf,
2533 			     param_len, 0, sense_len, timeout);
2534 }
2535 
2536 void
2537 scsi_mode_select_len(struct ccb_scsiio *csio, u_int32_t retries,
2538 		    void (*cbfcnp)(struct cam_periph *, union ccb *),
2539 		    u_int8_t tag_action, int scsi_page_fmt, int save_pages,
2540 		    u_int8_t *param_buf, u_int32_t param_len,
2541 		    int minimum_cmd_size, u_int8_t sense_len,
2542 		    u_int32_t timeout)
2543 {
2544 	u_int8_t cdb_len;
2545 
2546 	/*
2547 	 * Use the smallest possible command to perform the operation.
2548 	 */
2549 	if ((param_len < 256) && (minimum_cmd_size < 10)) {
2550 		/*
2551 		 * We can fit in a 6 byte cdb.
2552 		 */
2553 		struct scsi_mode_select_6 *scsi_cmd;
2554 
2555 		scsi_cmd = (struct scsi_mode_select_6 *)&csio->cdb_io.cdb_bytes;
2556 		bzero(scsi_cmd, sizeof(*scsi_cmd));
2557 		scsi_cmd->opcode = MODE_SELECT_6;
2558 		if (scsi_page_fmt != 0)
2559 			scsi_cmd->byte2 |= SMS_PF;
2560 		if (save_pages != 0)
2561 			scsi_cmd->byte2 |= SMS_SP;
2562 		scsi_cmd->length = param_len;
2563 		cdb_len = sizeof(*scsi_cmd);
2564 	} else {
2565 		/*
2566 		 * Need a 10 byte cdb.
2567 		 */
2568 		struct scsi_mode_select_10 *scsi_cmd;
2569 
2570 		scsi_cmd =
2571 		    (struct scsi_mode_select_10 *)&csio->cdb_io.cdb_bytes;
2572 		bzero(scsi_cmd, sizeof(*scsi_cmd));
2573 		scsi_cmd->opcode = MODE_SELECT_10;
2574 		if (scsi_page_fmt != 0)
2575 			scsi_cmd->byte2 |= SMS_PF;
2576 		if (save_pages != 0)
2577 			scsi_cmd->byte2 |= SMS_SP;
2578 		scsi_ulto2b(param_len, scsi_cmd->length);
2579 		cdb_len = sizeof(*scsi_cmd);
2580 	}
2581 	cam_fill_csio(csio,
2582 		      retries,
2583 		      cbfcnp,
2584 		      CAM_DIR_OUT,
2585 		      tag_action,
2586 		      param_buf,
2587 		      param_len,
2588 		      sense_len,
2589 		      cdb_len,
2590 		      timeout);
2591 }
2592 
2593 void
2594 scsi_read_capacity_16(struct ccb_scsiio *csio, uint32_t retries,
2595 		      void (*cbfcnp)(struct cam_periph *, union ccb *),
2596 		      uint8_t tag_action, uint64_t lba, int reladr, int pmi,
2597 		      struct scsi_read_capacity_data_long *rcap_buf,
2598 		      uint8_t sense_len, uint32_t timeout)
2599 {
2600 	struct scsi_read_capacity_16 *scsi_cmd;
2601 
2602 	cam_fill_csio(csio,
2603 		      retries,
2604 		      cbfcnp,
2605 		      /*flags*/CAM_DIR_IN,
2606 		      tag_action,
2607 		      /*data_ptr*/(u_int8_t *)rcap_buf,
2608 		      /*dxfer_len*/sizeof(*rcap_buf),
2609 		      sense_len,
2610 		      sizeof(*scsi_cmd),
2611 		      timeout);
2612 	scsi_cmd = (struct scsi_read_capacity_16 *)&csio->cdb_io.cdb_bytes;
2613 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2614 	scsi_cmd->opcode = SERVICE_ACTION_IN;
2615 	scsi_cmd->service_action = SRC16_SERVICE_ACTION;
2616 	scsi_u64to8b(lba, scsi_cmd->addr);
2617 	scsi_ulto4b(sizeof(*rcap_buf), scsi_cmd->alloc_len);
2618 	if (pmi)
2619 	       reladr |= SRC16_PMI;
2620 	if (reladr)
2621 	       reladr |= SRC16_RELADR;
2622 }
2623 
2624 /*
2625  * Prevent or allow the user to remove the media
2626  */
2627 void
2628 scsi_prevent(struct ccb_scsiio *csio, u_int32_t retries,
2629 	     void (*cbfcnp)(struct cam_periph *, union ccb *),
2630 	     u_int8_t tag_action, u_int8_t action,
2631 	     u_int8_t sense_len, u_int32_t timeout)
2632 {
2633 	struct scsi_prevent *scsi_cmd;
2634 
2635 	cam_fill_csio(csio,
2636 		      retries,
2637 		      cbfcnp,
2638 		      /*flags*/CAM_DIR_NONE,
2639 		      tag_action,
2640 		      /*data_ptr*/NULL,
2641 		      /*dxfer_len*/0,
2642 		      sense_len,
2643 		      sizeof(*scsi_cmd),
2644 		      timeout);
2645 
2646 	scsi_cmd = (struct scsi_prevent *)&csio->cdb_io.cdb_bytes;
2647 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2648 	scsi_cmd->opcode = PREVENT_ALLOW;
2649 	scsi_cmd->how = action;
2650 }
2651 
2652 /* XXX allow specification of address and PMI bit and LBA */
2653 void
2654 scsi_read_capacity(struct ccb_scsiio *csio, u_int32_t retries,
2655 		   void (*cbfcnp)(struct cam_periph *, union ccb *),
2656 		   u_int8_t tag_action,
2657 		   struct scsi_read_capacity_data *rcap_buf,
2658 		   u_int8_t sense_len, u_int32_t timeout)
2659 {
2660 	struct scsi_read_capacity *scsi_cmd;
2661 
2662 	cam_fill_csio(csio,
2663 		      retries,
2664 		      cbfcnp,
2665 		      /*flags*/CAM_DIR_IN,
2666 		      tag_action,
2667 		      /*data_ptr*/(u_int8_t *)rcap_buf,
2668 		      /*dxfer_len*/sizeof(*rcap_buf),
2669 		      sense_len,
2670 		      sizeof(*scsi_cmd),
2671 		      timeout);
2672 
2673 	scsi_cmd = (struct scsi_read_capacity *)&csio->cdb_io.cdb_bytes;
2674 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2675 	scsi_cmd->opcode = READ_CAPACITY;
2676 }
2677 
2678 void
2679 scsi_report_luns(struct ccb_scsiio *csio, u_int32_t retries,
2680 		 void (*cbfcnp)(struct cam_periph *, union ccb *),
2681 		 u_int8_t tag_action, u_int8_t select_report,
2682 		 struct scsi_report_luns_data *rpl_buf, u_int32_t alloc_len,
2683 		 u_int8_t sense_len, u_int32_t timeout)
2684 {
2685 	struct scsi_report_luns *scsi_cmd;
2686 
2687 	cam_fill_csio(csio,
2688 		      retries,
2689 		      cbfcnp,
2690 		      /*flags*/CAM_DIR_IN,
2691 		      tag_action,
2692 		      /*data_ptr*/(u_int8_t *)rpl_buf,
2693 		      /*dxfer_len*/alloc_len,
2694 		      sense_len,
2695 		      sizeof(*scsi_cmd),
2696 		      timeout);
2697 	scsi_cmd = (struct scsi_report_luns *)&csio->cdb_io.cdb_bytes;
2698 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2699 	scsi_cmd->opcode = REPORT_LUNS;
2700 	scsi_cmd->select_report = select_report;
2701 	scsi_ulto4b(alloc_len, scsi_cmd->length);
2702 }
2703 
2704 /*
2705  * Syncronize the media to the contents of the cache for
2706  * the given lba/count pair.  Specifying 0/0 means sync
2707  * the whole cache.
2708  */
2709 void
2710 scsi_synchronize_cache(struct ccb_scsiio *csio, u_int32_t retries,
2711 		       void (*cbfcnp)(struct cam_periph *, union ccb *),
2712 		       u_int8_t tag_action, u_int32_t begin_lba,
2713 		       u_int16_t lb_count, u_int8_t sense_len,
2714 		       u_int32_t timeout)
2715 {
2716 	struct scsi_sync_cache *scsi_cmd;
2717 
2718 	cam_fill_csio(csio,
2719 		      retries,
2720 		      cbfcnp,
2721 		      /*flags*/CAM_DIR_NONE,
2722 		      tag_action,
2723 		      /*data_ptr*/NULL,
2724 		      /*dxfer_len*/0,
2725 		      sense_len,
2726 		      sizeof(*scsi_cmd),
2727 		      timeout);
2728 
2729 	scsi_cmd = (struct scsi_sync_cache *)&csio->cdb_io.cdb_bytes;
2730 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2731 	scsi_cmd->opcode = SYNCHRONIZE_CACHE;
2732 	scsi_ulto4b(begin_lba, scsi_cmd->begin_lba);
2733 	scsi_ulto2b(lb_count, scsi_cmd->lb_count);
2734 }
2735 
2736 void
2737 scsi_read_write(struct ccb_scsiio *csio, u_int32_t retries,
2738 		void (*cbfcnp)(struct cam_periph *, union ccb *),
2739 		u_int8_t tag_action, int readop, u_int8_t byte2,
2740 		int minimum_cmd_size, u_int64_t lba, u_int32_t block_count,
2741 		u_int8_t *data_ptr, u_int32_t dxfer_len, u_int8_t sense_len,
2742 		u_int32_t timeout)
2743 {
2744 	u_int8_t cdb_len;
2745 
2746 	/*
2747 	 * Use the smallest possible command to perform the operation
2748 	 * as some legacy hardware does not support the 10 byte commands.
2749 	 * If any of the bits in byte2 is set, we have to go with a larger
2750 	 * command.
2751 	 */
2752 	if ((minimum_cmd_size < 10)
2753 	 && ((lba & 0x1fffff) == lba)
2754 	 && ((block_count & 0xff) == block_count)
2755 	 && (byte2 == 0)) {
2756 		/*
2757 		 * We can fit in a 6 byte cdb.
2758 		 */
2759 		struct scsi_rw_6 *scsi_cmd;
2760 
2761 		scsi_cmd = (struct scsi_rw_6 *)&csio->cdb_io.cdb_bytes;
2762 		scsi_cmd->opcode = readop ? READ_6 : WRITE_6;
2763 		scsi_ulto3b(lba, scsi_cmd->addr);
2764 		scsi_cmd->length = block_count & 0xff;
2765 		scsi_cmd->control = 0;
2766 		cdb_len = sizeof(*scsi_cmd);
2767 
2768 		CAM_DEBUG(csio->ccb_h.path, CAM_DEBUG_SUBTRACE,
2769 			  ("6byte: %x%x%x:%d:%d\n", scsi_cmd->addr[0],
2770 			   scsi_cmd->addr[1], scsi_cmd->addr[2],
2771 			   scsi_cmd->length, dxfer_len));
2772 	} else if ((minimum_cmd_size < 12)
2773 		&& ((block_count & 0xffff) == block_count)
2774 		&& ((lba & 0xffffffffU) == lba)) {
2775 		/*
2776 		 * Need a 10 byte cdb.
2777 		 */
2778 		struct scsi_rw_10 *scsi_cmd;
2779 
2780 		scsi_cmd = (struct scsi_rw_10 *)&csio->cdb_io.cdb_bytes;
2781 		scsi_cmd->opcode = readop ? READ_10 : WRITE_10;
2782 		scsi_cmd->byte2 = byte2;
2783 		scsi_ulto4b(lba, scsi_cmd->addr);
2784 		scsi_cmd->reserved = 0;
2785 		scsi_ulto2b(block_count, scsi_cmd->length);
2786 		scsi_cmd->control = 0;
2787 		cdb_len = sizeof(*scsi_cmd);
2788 
2789 		CAM_DEBUG(csio->ccb_h.path, CAM_DEBUG_SUBTRACE,
2790 			  ("10byte: %x%x%x%x:%x%x: %d\n", scsi_cmd->addr[0],
2791 			   scsi_cmd->addr[1], scsi_cmd->addr[2],
2792 			   scsi_cmd->addr[3], scsi_cmd->length[0],
2793 			   scsi_cmd->length[1], dxfer_len));
2794 	} else if ((minimum_cmd_size < 16)
2795 		&& ((block_count & 0xffffffffU) == block_count)
2796 		&& ((lba & 0xffffffffU) == lba)) {
2797 		/*
2798 		 * The block count is too big for a 10 byte CDB, use a 12
2799 		 * byte CDB.
2800 		 */
2801 		struct scsi_rw_12 *scsi_cmd;
2802 
2803 		scsi_cmd = (struct scsi_rw_12 *)&csio->cdb_io.cdb_bytes;
2804 		scsi_cmd->opcode = readop ? READ_12 : WRITE_12;
2805 		scsi_cmd->byte2 = byte2;
2806 		scsi_ulto4b(lba, scsi_cmd->addr);
2807 		scsi_cmd->reserved = 0;
2808 		scsi_ulto4b(block_count, scsi_cmd->length);
2809 		scsi_cmd->control = 0;
2810 		cdb_len = sizeof(*scsi_cmd);
2811 
2812 		CAM_DEBUG(csio->ccb_h.path, CAM_DEBUG_SUBTRACE,
2813 			  ("12byte: %x%x%x%x:%x%x%x%x: %d\n", scsi_cmd->addr[0],
2814 			   scsi_cmd->addr[1], scsi_cmd->addr[2],
2815 			   scsi_cmd->addr[3], scsi_cmd->length[0],
2816 			   scsi_cmd->length[1], scsi_cmd->length[2],
2817 			   scsi_cmd->length[3], dxfer_len));
2818 	} else {
2819 		/*
2820 		 * 16 byte CDB.  We'll only get here if the LBA is larger
2821 		 * than 2^32, or if the user asks for a 16 byte command.
2822 		 */
2823 		struct scsi_rw_16 *scsi_cmd;
2824 
2825 		scsi_cmd = (struct scsi_rw_16 *)&csio->cdb_io.cdb_bytes;
2826 		scsi_cmd->opcode = readop ? READ_16 : WRITE_16;
2827 		scsi_cmd->byte2 = byte2;
2828 		scsi_u64to8b(lba, scsi_cmd->addr);
2829 		scsi_cmd->reserved = 0;
2830 		scsi_ulto4b(block_count, scsi_cmd->length);
2831 		scsi_cmd->control = 0;
2832 		cdb_len = sizeof(*scsi_cmd);
2833 	}
2834 	cam_fill_csio(csio,
2835 		      retries,
2836 		      cbfcnp,
2837 		      /*flags*/readop ? CAM_DIR_IN : CAM_DIR_OUT,
2838 		      tag_action,
2839 		      data_ptr,
2840 		      dxfer_len,
2841 		      sense_len,
2842 		      cdb_len,
2843 		      timeout);
2844 }
2845 
2846 void
2847 scsi_start_stop(struct ccb_scsiio *csio, u_int32_t retries,
2848 		void (*cbfcnp)(struct cam_periph *, union ccb *),
2849 		u_int8_t tag_action, int start, int load_eject,
2850 		int immediate, u_int8_t sense_len, u_int32_t timeout)
2851 {
2852 	struct scsi_start_stop_unit *scsi_cmd;
2853 	int extra_flags = 0;
2854 
2855 	scsi_cmd = (struct scsi_start_stop_unit *)&csio->cdb_io.cdb_bytes;
2856 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2857 	scsi_cmd->opcode = START_STOP_UNIT;
2858 	if (start != 0) {
2859 		scsi_cmd->how |= SSS_START;
2860 		/* it takes a lot of power to start a drive */
2861 		extra_flags |= CAM_HIGH_POWER;
2862 	}
2863 	if (load_eject != 0)
2864 		scsi_cmd->how |= SSS_LOEJ;
2865 	if (immediate != 0)
2866 		scsi_cmd->byte2 |= SSS_IMMED;
2867 
2868 	cam_fill_csio(csio,
2869 		      retries,
2870 		      cbfcnp,
2871 		      /*flags*/CAM_DIR_NONE | extra_flags,
2872 		      tag_action,
2873 		      /*data_ptr*/NULL,
2874 		      /*dxfer_len*/0,
2875 		      sense_len,
2876 		      sizeof(*scsi_cmd),
2877 		      timeout);
2878 
2879 }
2880 
2881 void
2882 scsi_log_sense(struct ccb_scsiio *csio, u_int32_t retries,
2883 	       void (*cbfcnp)(struct cam_periph *, union ccb *),
2884 	       u_int8_t tag_action, u_int8_t page_code, u_int8_t page,
2885 	       int save_pages, int ppc, u_int32_t paramptr,
2886 	       u_int8_t *param_buf, u_int32_t param_len, u_int8_t sense_len,
2887 	       u_int32_t timeout)
2888 {
2889 	struct scsi_log_sense *scsi_cmd;
2890 	u_int8_t cdb_len;
2891 
2892 	scsi_cmd = (struct scsi_log_sense *)&csio->cdb_io.cdb_bytes;
2893 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2894 	scsi_cmd->opcode = LOG_SENSE;
2895 	scsi_cmd->page = page_code | page;
2896 	if (save_pages != 0)
2897 		scsi_cmd->byte2 |= SLS_SP;
2898 	if (ppc != 0)
2899 		scsi_cmd->byte2 |= SLS_PPC;
2900 	scsi_ulto2b(paramptr, scsi_cmd->paramptr);
2901 	scsi_ulto2b(param_len, scsi_cmd->length);
2902 	cdb_len = sizeof(*scsi_cmd);
2903 
2904 	cam_fill_csio(csio,
2905 		      retries,
2906 		      cbfcnp,
2907 		      /*flags*/CAM_DIR_IN,
2908 		      tag_action,
2909 		      /*data_ptr*/param_buf,
2910 		      /*dxfer_len*/param_len,
2911 		      sense_len,
2912 		      cdb_len,
2913 		      timeout);
2914 }
2915 
2916 void
2917 scsi_log_select(struct ccb_scsiio *csio, u_int32_t retries,
2918 		void (*cbfcnp)(struct cam_periph *, union ccb *),
2919 		u_int8_t tag_action, u_int8_t page_code, int save_pages,
2920 		int pc_reset, u_int8_t *param_buf, u_int32_t param_len,
2921 		u_int8_t sense_len, u_int32_t timeout)
2922 {
2923 	struct scsi_log_select *scsi_cmd;
2924 	u_int8_t cdb_len;
2925 
2926 	scsi_cmd = (struct scsi_log_select *)&csio->cdb_io.cdb_bytes;
2927 	bzero(scsi_cmd, sizeof(*scsi_cmd));
2928 	scsi_cmd->opcode = LOG_SELECT;
2929 	scsi_cmd->page = page_code & SLS_PAGE_CODE;
2930 	if (save_pages != 0)
2931 		scsi_cmd->byte2 |= SLS_SP;
2932 	if (pc_reset != 0)
2933 		scsi_cmd->byte2 |= SLS_PCR;
2934 	scsi_ulto2b(param_len, scsi_cmd->length);
2935 	cdb_len = sizeof(*scsi_cmd);
2936 
2937 	cam_fill_csio(csio,
2938 		      retries,
2939 		      cbfcnp,
2940 		      /*flags*/CAM_DIR_OUT,
2941 		      tag_action,
2942 		      /*data_ptr*/param_buf,
2943 		      /*dxfer_len*/param_len,
2944 		      sense_len,
2945 		      cdb_len,
2946 		      timeout);
2947 }
2948 
2949 /*
2950  * Try make as good a match as possible with
2951  * available sub drivers
2952  */
2953 int
2954 scsi_inquiry_match(caddr_t inqbuffer, caddr_t table_entry)
2955 {
2956 	struct scsi_inquiry_pattern *entry;
2957 	struct scsi_inquiry_data *inq;
2958 
2959 	entry = (struct scsi_inquiry_pattern *)table_entry;
2960 	inq = (struct scsi_inquiry_data *)inqbuffer;
2961 
2962 	if (((SID_TYPE(inq) == entry->type)
2963 	  || (entry->type == T_ANY))
2964 	 && (SID_IS_REMOVABLE(inq) ? entry->media_type & SIP_MEDIA_REMOVABLE
2965 				   : entry->media_type & SIP_MEDIA_FIXED)
2966 	 && (cam_strmatch(inq->vendor, entry->vendor, sizeof(inq->vendor)) == 0)
2967 	 && (cam_strmatch(inq->product, entry->product,
2968 			  sizeof(inq->product)) == 0)
2969 	 && (cam_strmatch(inq->revision, entry->revision,
2970 			  sizeof(inq->revision)) == 0)) {
2971 		return (0);
2972 	}
2973         return (-1);
2974 }
2975 
2976 #ifdef _KERNEL
2977 static void
2978 init_scsi_delay(void)
2979 {
2980 	int delay;
2981 
2982 	delay = SCSI_DELAY;
2983 	TUNABLE_INT_FETCH("kern.cam.scsi_delay", &delay);
2984 
2985 	if (set_scsi_delay(delay) != 0) {
2986 		kprintf("cam: invalid value for tunable kern.cam.scsi_delay\n");
2987 		set_scsi_delay(SCSI_DELAY);
2988 	}
2989 }
2990 SYSINIT(scsi_delay, SI_BOOT1_TUNABLES, SI_ORDER_ANY, init_scsi_delay, NULL);
2991 
2992 static int
2993 sysctl_scsi_delay(SYSCTL_HANDLER_ARGS)
2994 {
2995 	int error, delay;
2996 
2997 	delay = scsi_delay;
2998 	error = sysctl_handle_int(oidp, &delay, 0, req);
2999 	if (error != 0 || req->newptr == NULL)
3000 		return (error);
3001 	return (set_scsi_delay(delay));
3002 }
3003 SYSCTL_PROC(_kern_cam, OID_AUTO, scsi_delay, CTLTYPE_INT|CTLFLAG_RW,
3004     0, 0, sysctl_scsi_delay, "I",
3005     "Delay to allow devices to settle after a SCSI bus reset (ms)");
3006 
3007 static int
3008 set_scsi_delay(int delay)
3009 {
3010 	/*
3011          * If someone sets this to 0, we assume that they want the
3012          * minimum allowable bus settle delay.
3013 	 */
3014 	if (delay == 0) {
3015 		kprintf("cam: using minimum scsi_delay (%dms)\n",
3016 		    SCSI_MIN_DELAY);
3017 		delay = SCSI_MIN_DELAY;
3018 	}
3019 	if (delay < SCSI_MIN_DELAY)
3020 		return (EINVAL);
3021 	scsi_delay = delay;
3022 	return (0);
3023 }
3024 #endif /* _KERNEL */
3025 
3026 /*
3027  * Try make as good a match as possible with
3028  * available sub drivers
3029  */
3030 int
3031 scsi_static_inquiry_match(caddr_t inqbuffer, caddr_t table_entry)
3032 {
3033 	struct scsi_static_inquiry_pattern *entry;
3034 	struct scsi_inquiry_data *inq;
3035 
3036 	entry = (struct scsi_static_inquiry_pattern *)table_entry;
3037 	inq = (struct scsi_inquiry_data *)inqbuffer;
3038 
3039 	if (((SID_TYPE(inq) == entry->type)
3040 	  || (entry->type == T_ANY))
3041 	 && (SID_IS_REMOVABLE(inq) ? entry->media_type & SIP_MEDIA_REMOVABLE
3042 				   : entry->media_type & SIP_MEDIA_FIXED)
3043 	 && (cam_strmatch(inq->vendor, entry->vendor, sizeof(inq->vendor)) == 0)
3044 	 && (cam_strmatch(inq->product, entry->product,
3045 			  sizeof(inq->product)) == 0)
3046 	 && (cam_strmatch(inq->revision, entry->revision,
3047 			  sizeof(inq->revision)) == 0)) {
3048 		return (0);
3049 	}
3050         return (-1);
3051 }
3052