xref: /freebsd/sys/cam/scsi/scsi_all.h (revision 0572ccaa4543b0abef8ef81e384c1d04de9f3da1)
1 /*-
2  * Largely written by Julian Elischer (julian@tfs.com)
3  * for TRW Financial Systems.
4  *
5  * TRW Financial Systems, in accordance with their agreement with Carnegie
6  * Mellon University, makes this software available to CMU to distribute
7  * or use in any manner that they see fit as long as this message is kept with
8  * the software. For this reason TFS also grants any other persons or
9  * organisations permission to use or modify this software.
10  *
11  * TFS supplies this software to be publicly redistributed
12  * on the understanding that TFS is not responsible for the correct
13  * functioning of this software in any circumstances.
14  *
15  * Ported to run under 386BSD by Julian Elischer (julian@tfs.com) Sept 1992
16  *
17  * $FreeBSD$
18  */
19 
20 /*
21  * SCSI general  interface description
22  */
23 
24 #ifndef	_SCSI_SCSI_ALL_H
25 #define	_SCSI_SCSI_ALL_H 1
26 
27 #include <sys/cdefs.h>
28 #include <machine/stdarg.h>
29 
30 #ifdef _KERNEL
31 /*
32  * This is the number of seconds we wait for devices to settle after a SCSI
33  * bus reset.
34  */
35 extern int scsi_delay;
36 #endif /* _KERNEL */
37 
38 /*
39  * SCSI command format
40  */
41 
42 /*
43  * Define dome bits that are in ALL (or a lot of) scsi commands
44  */
45 #define	SCSI_CTL_LINK		0x01
46 #define	SCSI_CTL_FLAG		0x02
47 #define	SCSI_CTL_VENDOR		0xC0
48 #define	SCSI_CMD_LUN		0xA0	/* these two should not be needed */
49 #define	SCSI_CMD_LUN_SHIFT	5	/* LUN in the cmd is no longer SCSI */
50 
51 #define	SCSI_MAX_CDBLEN		16	/*
52 					 * 16 byte commands are in the
53 					 * SCSI-3 spec
54 					 */
55 #if defined(CAM_MAX_CDBLEN) && (CAM_MAX_CDBLEN < SCSI_MAX_CDBLEN)
56 #error "CAM_MAX_CDBLEN cannot be less than SCSI_MAX_CDBLEN"
57 #endif
58 
59 /* 6byte CDBs special case 0 length to be 256 */
60 #define	SCSI_CDB6_LEN(len)	((len) == 0 ? 256 : len)
61 
62 /*
63  * This type defines actions to be taken when a particular sense code is
64  * received.  Right now, these flags are only defined to take up 16 bits,
65  * but can be expanded in the future if necessary.
66  */
67 typedef enum {
68 	SS_NOP      = 0x000000,	/* Do nothing */
69 	SS_RETRY    = 0x010000,	/* Retry the command */
70 	SS_FAIL     = 0x020000,	/* Bail out */
71 	SS_START    = 0x030000,	/* Send a Start Unit command to the device,
72 				 * then retry the original command.
73 				 */
74 	SS_TUR      = 0x040000,	/* Send a Test Unit Ready command to the
75 				 * device, then retry the original command.
76 				 */
77 	SS_MASK     = 0xff0000
78 } scsi_sense_action;
79 
80 typedef enum {
81 	SSQ_NONE		= 0x0000,
82 	SSQ_DECREMENT_COUNT	= 0x0100,  /* Decrement the retry count */
83 	SSQ_MANY		= 0x0200,  /* send lots of recovery commands */
84 	SSQ_RANGE		= 0x0400,  /*
85 					    * This table entry represents the
86 					    * end of a range of ASCQs that
87 					    * have identical error actions
88 					    * and text.
89 					    */
90 	SSQ_PRINT_SENSE		= 0x0800,
91 	SSQ_UA			= 0x1000,  /* Broadcast UA. */
92 	SSQ_RESCAN		= 0x2000,  /* Rescan target for LUNs. */
93 	SSQ_LOST		= 0x4000,  /* Destroy the LUNs. */
94 	SSQ_MASK		= 0xff00
95 } scsi_sense_action_qualifier;
96 
97 /* Mask for error status values */
98 #define	SS_ERRMASK	0xff
99 
100 /* The default, retyable, error action */
101 #define	SS_RDEF		SS_RETRY|SSQ_DECREMENT_COUNT|SSQ_PRINT_SENSE|EIO
102 
103 /* The retyable, error action, with table specified error code */
104 #define	SS_RET		SS_RETRY|SSQ_DECREMENT_COUNT|SSQ_PRINT_SENSE
105 
106 /* Fatal error action, with table specified error code */
107 #define	SS_FATAL	SS_FAIL|SSQ_PRINT_SENSE
108 
109 struct scsi_generic
110 {
111 	u_int8_t opcode;
112 	u_int8_t bytes[11];
113 };
114 
115 struct scsi_request_sense
116 {
117 	u_int8_t opcode;
118 	u_int8_t byte2;
119 #define	SRS_DESC	0x01
120 	u_int8_t unused[2];
121 	u_int8_t length;
122 	u_int8_t control;
123 };
124 
125 struct scsi_test_unit_ready
126 {
127 	u_int8_t opcode;
128 	u_int8_t byte2;
129 	u_int8_t unused[3];
130 	u_int8_t control;
131 };
132 
133 struct scsi_receive_diag {
134 	uint8_t opcode;
135 	uint8_t byte2;
136 #define SRD_PCV		0x01
137 	uint8_t page_code;
138 	uint8_t length[2];
139 	uint8_t control;
140 };
141 
142 struct scsi_send_diag {
143 	uint8_t opcode;
144 	uint8_t byte2;
145 #define SSD_UNITOFFL				0x01
146 #define SSD_DEVOFFL				0x02
147 #define SSD_SELFTEST				0x04
148 #define SSD_PF					0x10
149 #define SSD_SELF_TEST_CODE_MASK			0xE0
150 #define SSD_SELF_TEST_CODE_SHIFT		5
151 #define		SSD_SELF_TEST_CODE_NONE		0x00
152 #define		SSD_SELF_TEST_CODE_BG_SHORT	0x01
153 #define		SSD_SELF_TEST_CODE_BG_EXTENDED	0x02
154 #define		SSD_SELF_TEST_CODE_BG_ABORT	0x04
155 #define		SSD_SELF_TEST_CODE_FG_SHORT	0x05
156 #define		SSD_SELF_TEST_CODE_FG_EXTENDED	0x06
157 	uint8_t	reserved;
158 	uint8_t	length[2];
159 	uint8_t control;
160 };
161 
162 struct scsi_sense
163 {
164 	u_int8_t opcode;
165 	u_int8_t byte2;
166 	u_int8_t unused[2];
167 	u_int8_t length;
168 	u_int8_t control;
169 };
170 
171 struct scsi_inquiry
172 {
173 	u_int8_t opcode;
174 	u_int8_t byte2;
175 #define	SI_EVPD 	0x01
176 #define	SI_CMDDT	0x02
177 	u_int8_t page_code;
178 	u_int8_t length[2];
179 	u_int8_t control;
180 };
181 
182 struct scsi_mode_sense_6
183 {
184 	u_int8_t opcode;
185 	u_int8_t byte2;
186 #define	SMS_DBD				0x08
187 	u_int8_t page;
188 #define	SMS_PAGE_CODE 			0x3F
189 #define	SMS_VENDOR_SPECIFIC_PAGE	0x00
190 #define	SMS_DISCONNECT_RECONNECT_PAGE	0x02
191 #define	SMS_FORMAT_DEVICE_PAGE		0x03
192 #define	SMS_GEOMETRY_PAGE		0x04
193 #define	SMS_CACHE_PAGE			0x08
194 #define	SMS_PERIPHERAL_DEVICE_PAGE	0x09
195 #define	SMS_CONTROL_MODE_PAGE		0x0A
196 #define	SMS_PROTO_SPECIFIC_PAGE		0x19
197 #define	SMS_INFO_EXCEPTIONS_PAGE	0x1C
198 #define	SMS_ALL_PAGES_PAGE		0x3F
199 #define	SMS_PAGE_CTRL_MASK		0xC0
200 #define	SMS_PAGE_CTRL_CURRENT 		0x00
201 #define	SMS_PAGE_CTRL_CHANGEABLE 	0x40
202 #define	SMS_PAGE_CTRL_DEFAULT 		0x80
203 #define	SMS_PAGE_CTRL_SAVED 		0xC0
204 	u_int8_t subpage;
205 #define	SMS_SUBPAGE_PAGE_0		0x00
206 #define	SMS_SUBPAGE_ALL			0xff
207 	u_int8_t length;
208 	u_int8_t control;
209 };
210 
211 struct scsi_mode_sense_10
212 {
213 	u_int8_t opcode;
214 	u_int8_t byte2;		/* same bits as small version */
215 #define	SMS10_LLBAA			0x10
216 	u_int8_t page; 		/* same bits as small version */
217 	u_int8_t subpage;
218 	u_int8_t unused[3];
219 	u_int8_t length[2];
220 	u_int8_t control;
221 };
222 
223 struct scsi_mode_select_6
224 {
225 	u_int8_t opcode;
226 	u_int8_t byte2;
227 #define	SMS_SP	0x01
228 #define	SMS_PF	0x10
229 	u_int8_t unused[2];
230 	u_int8_t length;
231 	u_int8_t control;
232 };
233 
234 struct scsi_mode_select_10
235 {
236 	u_int8_t opcode;
237 	u_int8_t byte2;		/* same bits as small version */
238 	u_int8_t unused[5];
239 	u_int8_t length[2];
240 	u_int8_t control;
241 };
242 
243 /*
244  * When sending a mode select to a tape drive, the medium type must be 0.
245  */
246 struct scsi_mode_hdr_6
247 {
248 	u_int8_t datalen;
249 	u_int8_t medium_type;
250 	u_int8_t dev_specific;
251 	u_int8_t block_descr_len;
252 };
253 
254 struct scsi_mode_hdr_10
255 {
256 	u_int8_t datalen[2];
257 	u_int8_t medium_type;
258 	u_int8_t dev_specific;
259 	u_int8_t reserved[2];
260 	u_int8_t block_descr_len[2];
261 };
262 
263 struct scsi_mode_block_descr
264 {
265 	u_int8_t density_code;
266 	u_int8_t num_blocks[3];
267 	u_int8_t reserved;
268 	u_int8_t block_len[3];
269 };
270 
271 struct scsi_per_res_in
272 {
273 	u_int8_t opcode;
274 	u_int8_t action;
275 #define	SPRI_RK	0x00
276 #define	SPRI_RR	0x01
277 #define	SPRI_RC	0x02
278 #define	SPRI_RS	0x03
279 	u_int8_t reserved[5];
280 	u_int8_t length[2];
281 	u_int8_t control;
282 };
283 
284 struct scsi_per_res_in_header
285 {
286 	u_int8_t generation[4];
287 	u_int8_t length[4];
288 };
289 
290 struct scsi_per_res_key
291 {
292 	u_int8_t key[8];
293 };
294 
295 struct scsi_per_res_in_keys
296 {
297 	struct scsi_per_res_in_header header;
298 	struct scsi_per_res_key keys[0];
299 };
300 
301 struct scsi_per_res_cap
302 {
303 	uint8_t length[2];
304 	uint8_t flags1;
305 #define	SPRI_CRH	0x10
306 #define	SPRI_SIP_C	0x08
307 #define	SPRI_ATP_C	0x04
308 #define	SPRI_PTPL_C	0x01
309 	uint8_t flags2;
310 #define	SPRI_TMV	0x80
311 #define	SPRI_PTPL_A	0x01
312 	uint8_t type_mask[2];
313 #define	SPRI_TM_WR_EX_AR	0x8000
314 #define	SPRI_TM_EX_AC_RO	0x4000
315 #define	SPRI_TM_WR_EX_RO	0x2000
316 #define	SPRI_TM_EX_AC		0x0800
317 #define	SPRI_TM_WR_EX		0x0200
318 #define	SPRI_TM_EX_AC_AR	0x0001
319 	uint8_t reserved[2];
320 };
321 
322 struct scsi_per_res_in_rsrv_data
323 {
324 	uint8_t reservation[8];
325 	uint8_t obsolete1[4];
326 	uint8_t reserved;
327 	uint8_t scopetype;
328 #define	SPRT_WE    0x01
329 #define	SPRT_EA    0x03
330 #define	SPRT_WERO  0x05
331 #define	SPRT_EARO  0x06
332 #define	SPRT_WEAR  0x07
333 #define	SPRT_EAAR  0x08
334 	uint8_t obsolete2[2];
335 };
336 
337 struct scsi_per_res_in_rsrv
338 {
339 	struct scsi_per_res_in_header header;
340 	struct scsi_per_res_in_rsrv_data data;
341 };
342 
343 struct scsi_per_res_out
344 {
345 	u_int8_t opcode;
346 	u_int8_t action;
347 #define	SPRO_REGISTER		0x00
348 #define	SPRO_RESERVE		0x01
349 #define	SPRO_RELEASE		0x02
350 #define	SPRO_CLEAR		0x03
351 #define	SPRO_PREEMPT		0x04
352 #define	SPRO_PRE_ABO		0x05
353 #define	SPRO_REG_IGNO		0x06
354 #define	SPRO_REG_MOVE		0x07
355 #define	SPRO_ACTION_MASK	0x1f
356 	u_int8_t scope_type;
357 #define	SPR_SCOPE_MASK		0xf0
358 #define	SPR_LU_SCOPE		0x00
359 #define	SPR_TYPE_MASK		0x0f
360 #define	SPR_TYPE_WR_EX		0x01
361 #define	SPR_TYPE_EX_AC		0x03
362 #define	SPR_TYPE_WR_EX_RO	0x05
363 #define	SPR_TYPE_EX_AC_RO	0x06
364 #define	SPR_TYPE_WR_EX_AR	0x07
365 #define	SPR_TYPE_EX_AC_AR	0x08
366 	u_int8_t reserved[2];
367 	u_int8_t length[4];
368 	u_int8_t control;
369 };
370 
371 struct scsi_per_res_out_parms
372 {
373 	struct scsi_per_res_key res_key;
374 	u_int8_t serv_act_res_key[8];
375 	u_int8_t obsolete1[4];
376 	u_int8_t flags;
377 #define	SPR_SPEC_I_PT		0x08
378 #define	SPR_ALL_TG_PT		0x04
379 #define	SPR_APTPL		0x01
380 	u_int8_t reserved1;
381 	u_int8_t obsolete2[2];
382 };
383 
384 
385 struct scsi_log_sense
386 {
387 	u_int8_t opcode;
388 	u_int8_t byte2;
389 #define	SLS_SP				0x01
390 #define	SLS_PPC				0x02
391 	u_int8_t page;
392 #define	SLS_PAGE_CODE 			0x3F
393 #define	SLS_ALL_PAGES_PAGE		0x00
394 #define	SLS_OVERRUN_PAGE		0x01
395 #define	SLS_ERROR_WRITE_PAGE		0x02
396 #define	SLS_ERROR_READ_PAGE		0x03
397 #define	SLS_ERROR_READREVERSE_PAGE	0x04
398 #define	SLS_ERROR_VERIFY_PAGE		0x05
399 #define	SLS_ERROR_NONMEDIUM_PAGE	0x06
400 #define	SLS_ERROR_LASTN_PAGE		0x07
401 #define	SLS_SELF_TEST_PAGE		0x10
402 #define	SLS_IE_PAGE			0x2f
403 #define	SLS_PAGE_CTRL_MASK		0xC0
404 #define	SLS_PAGE_CTRL_THRESHOLD		0x00
405 #define	SLS_PAGE_CTRL_CUMULATIVE	0x40
406 #define	SLS_PAGE_CTRL_THRESH_DEFAULT	0x80
407 #define	SLS_PAGE_CTRL_CUMUL_DEFAULT	0xC0
408 	u_int8_t reserved[2];
409 	u_int8_t paramptr[2];
410 	u_int8_t length[2];
411 	u_int8_t control;
412 };
413 
414 struct scsi_log_select
415 {
416 	u_int8_t opcode;
417 	u_int8_t byte2;
418 /*	SLS_SP				0x01 */
419 #define	SLS_PCR				0x02
420 	u_int8_t page;
421 /*	SLS_PAGE_CTRL_MASK		0xC0 */
422 /*	SLS_PAGE_CTRL_THRESHOLD		0x00 */
423 /*	SLS_PAGE_CTRL_CUMULATIVE	0x40 */
424 /*	SLS_PAGE_CTRL_THRESH_DEFAULT	0x80 */
425 /*	SLS_PAGE_CTRL_CUMUL_DEFAULT	0xC0 */
426 	u_int8_t reserved[4];
427 	u_int8_t length[2];
428 	u_int8_t control;
429 };
430 
431 struct scsi_log_header
432 {
433 	u_int8_t page;
434 	u_int8_t reserved;
435 	u_int8_t datalen[2];
436 };
437 
438 struct scsi_log_param_header {
439 	u_int8_t param_code[2];
440 	u_int8_t param_control;
441 #define	SLP_LP				0x01
442 #define	SLP_LBIN			0x02
443 #define	SLP_TMC_MASK			0x0C
444 #define	SLP_TMC_ALWAYS			0x00
445 #define	SLP_TMC_EQUAL			0x04
446 #define	SLP_TMC_NOTEQUAL		0x08
447 #define	SLP_TMC_GREATER			0x0C
448 #define	SLP_ETC				0x10
449 #define	SLP_TSD				0x20
450 #define	SLP_DS				0x40
451 #define	SLP_DU				0x80
452 	u_int8_t param_len;
453 };
454 
455 struct scsi_control_page {
456 	u_int8_t page_code;
457 	u_int8_t page_length;
458 	u_int8_t rlec;
459 #define	SCP_RLEC			0x01	/*Report Log Exception Cond*/
460 #define	SCP_GLTSD			0x02	/*Global Logging target
461 						  save disable */
462 #define	SCP_DSENSE			0x04	/*Descriptor Sense */
463 #define	SCP_DPICZ			0x08	/*Disable Prot. Info Check
464 						  if Prot. Field is Zero */
465 #define	SCP_TMF_ONLY			0x10	/*TM Functions Only*/
466 #define	SCP_TST_MASK			0xE0	/*Task Set Type Mask*/
467 #define	SCP_TST_ONE			0x00	/*One Task Set*/
468 #define	SCP_TST_SEPARATE		0x20	/*Separate Task Sets*/
469 	u_int8_t queue_flags;
470 #define	SCP_QUEUE_ALG_MASK		0xF0
471 #define	SCP_QUEUE_ALG_RESTRICTED	0x00
472 #define	SCP_QUEUE_ALG_UNRESTRICTED	0x10
473 #define	SCP_QUEUE_ERR			0x02	/*Queued I/O aborted for CACs*/
474 #define	SCP_QUEUE_DQUE			0x01	/*Queued I/O disabled*/
475 	u_int8_t eca_and_aen;
476 #define	SCP_EECA			0x80	/*Enable Extended CA*/
477 #define	SCP_RAENP			0x04	/*Ready AEN Permission*/
478 #define	SCP_UAAENP			0x02	/*UA AEN Permission*/
479 #define	SCP_EAENP			0x01	/*Error AEN Permission*/
480 	u_int8_t reserved;
481 	u_int8_t aen_holdoff_period[2];
482 };
483 
484 struct scsi_cache_page {
485 	u_int8_t page_code;
486 #define	SCHP_PAGE_SAVABLE		0x80	/* Page is savable */
487 	u_int8_t page_length;
488 	u_int8_t cache_flags;
489 #define	SCHP_FLAGS_WCE			0x04	/* Write Cache Enable */
490 #define	SCHP_FLAGS_MF			0x02	/* Multiplication factor */
491 #define	SCHP_FLAGS_RCD			0x01	/* Read Cache Disable */
492 	u_int8_t rw_cache_policy;
493 	u_int8_t dis_prefetch[2];
494 	u_int8_t min_prefetch[2];
495 	u_int8_t max_prefetch[2];
496 	u_int8_t max_prefetch_ceil[2];
497 };
498 
499 /*
500  * XXX KDM
501  * Updated version of the cache page, as of SBC.  Update this to SBC-3 and
502  * rationalize the two.
503  */
504 struct scsi_caching_page {
505 	uint8_t page_code;
506 #define	SMS_CACHING_PAGE		0x08
507 	uint8_t page_length;
508 	uint8_t flags1;
509 #define	SCP_IC		0x80
510 #define	SCP_ABPF	0x40
511 #define	SCP_CAP		0x20
512 #define	SCP_DISC	0x10
513 #define	SCP_SIZE	0x08
514 #define	SCP_WCE		0x04
515 #define	SCP_MF		0x02
516 #define	SCP_RCD		0x01
517 	uint8_t ret_priority;
518 	uint8_t disable_pf_transfer_len[2];
519 	uint8_t min_prefetch[2];
520 	uint8_t max_prefetch[2];
521 	uint8_t max_pf_ceiling[2];
522 	uint8_t flags2;
523 #define	SCP_FSW		0x80
524 #define	SCP_LBCSS	0x40
525 #define	SCP_DRA		0x20
526 #define	SCP_VS1		0x10
527 #define	SCP_VS2		0x08
528 	uint8_t cache_segments;
529 	uint8_t cache_seg_size[2];
530 	uint8_t reserved;
531 	uint8_t non_cache_seg_size[3];
532 };
533 
534 /*
535  * XXX KDM move this off to a vendor shim.
536  */
537 struct copan_power_subpage {
538 	uint8_t page_code;
539 #define	PWR_PAGE_CODE		0x00
540 	uint8_t subpage;
541 #define	PWR_SUBPAGE_CODE	0x02
542 	uint8_t page_length[2];
543 	uint8_t page_version;
544 #define	PWR_VERSION		    0x01
545 	uint8_t total_luns;
546 	uint8_t max_active_luns;
547 #define	PWR_DFLT_MAX_LUNS	    0x07
548 	uint8_t reserved[25];
549 };
550 
551 /*
552  * XXX KDM move this off to a vendor shim.
553  */
554 struct copan_aps_subpage {
555 	uint8_t page_code;
556 #define	APS_PAGE_CODE		0x00
557 	uint8_t subpage;
558 #define	APS_SUBPAGE_CODE	0x03
559 	uint8_t page_length[2];
560 	uint8_t page_version;
561 #define	APS_VERSION		    0x00
562 	uint8_t lock_active;
563 #define	APS_LOCK_ACTIVE	    0x01
564 #define	APS_LOCK_INACTIVE	0x00
565 	uint8_t reserved[26];
566 };
567 
568 /*
569  * XXX KDM move this off to a vendor shim.
570  */
571 struct copan_debugconf_subpage {
572 	uint8_t page_code;
573 #define DBGCNF_PAGE_CODE		0x00
574 	uint8_t subpage;
575 #define DBGCNF_SUBPAGE_CODE	0xF0
576 	uint8_t page_length[2];
577 	uint8_t page_version;
578 #define DBGCNF_VERSION			0x00
579 	uint8_t ctl_time_io_secs[2];
580 };
581 
582 
583 struct scsi_info_exceptions_page {
584 	u_int8_t page_code;
585 #define	SIEP_PAGE_SAVABLE		0x80	/* Page is savable */
586 	u_int8_t page_length;
587 	u_int8_t info_flags;
588 #define	SIEP_FLAGS_PERF			0x80
589 #define	SIEP_FLAGS_EBF			0x20
590 #define	SIEP_FLAGS_EWASC		0x10
591 #define	SIEP_FLAGS_DEXCPT		0x08
592 #define	SIEP_FLAGS_TEST			0x04
593 #define	SIEP_FLAGS_EBACKERR		0x02
594 #define	SIEP_FLAGS_LOGERR		0x01
595 	u_int8_t mrie;
596 	u_int8_t interval_timer[4];
597 	u_int8_t report_count[4];
598 };
599 
600 struct scsi_proto_specific_page {
601 	u_int8_t page_code;
602 #define	SPSP_PAGE_SAVABLE		0x80	/* Page is savable */
603 	u_int8_t page_length;
604 	u_int8_t protocol;
605 #define	SPSP_PROTO_FC			0x00
606 #define	SPSP_PROTO_SPI			0x01
607 #define	SPSP_PROTO_SSA			0x02
608 #define	SPSP_PROTO_1394			0x03
609 #define	SPSP_PROTO_RDMA			0x04
610 #define	SPSP_PROTO_ISCSI		0x05
611 #define	SPSP_PROTO_SAS			0x06
612 #define	SPSP_PROTO_ADT			0x07
613 #define	SPSP_PROTO_ATA			0x08
614 #define	SPSP_PROTO_NONE			0x0f
615 };
616 
617 struct scsi_reserve
618 {
619 	u_int8_t opcode;
620 	u_int8_t byte2;
621 #define	SR_EXTENT	0x01
622 #define	SR_ID_MASK	0x0e
623 #define	SR_3RDPTY	0x10
624 #define	SR_LUN_MASK	0xe0
625 	u_int8_t resv_id;
626 	u_int8_t length[2];
627 	u_int8_t control;
628 };
629 
630 struct scsi_reserve_10 {
631 	uint8_t	opcode;
632 	uint8_t	byte2;
633 #define	SR10_3RDPTY	0x10
634 #define	SR10_LONGID	0x02
635 #define	SR10_EXTENT	0x01
636 	uint8_t resv_id;
637 	uint8_t thirdparty_id;
638 	uint8_t reserved[3];
639 	uint8_t length[2];
640 	uint8_t control;
641 };
642 
643 
644 struct scsi_release
645 {
646 	u_int8_t opcode;
647 	u_int8_t byte2;
648 	u_int8_t resv_id;
649 	u_int8_t unused[1];
650 	u_int8_t length;
651 	u_int8_t control;
652 };
653 
654 struct scsi_release_10 {
655 	uint8_t opcode;
656 	uint8_t byte2;
657 	uint8_t resv_id;
658 	uint8_t thirdparty_id;
659 	uint8_t reserved[3];
660 	uint8_t length[2];
661 	uint8_t control;
662 };
663 
664 struct scsi_prevent
665 {
666 	u_int8_t opcode;
667 	u_int8_t byte2;
668 	u_int8_t unused[2];
669 	u_int8_t how;
670 	u_int8_t control;
671 };
672 #define	PR_PREVENT 0x01
673 #define	PR_ALLOW   0x00
674 
675 struct scsi_sync_cache
676 {
677 	u_int8_t opcode;
678 	u_int8_t byte2;
679 #define	SSC_IMMED	0x02
680 #define	SSC_RELADR	0x01
681 	u_int8_t begin_lba[4];
682 	u_int8_t reserved;
683 	u_int8_t lb_count[2];
684 	u_int8_t control;
685 };
686 
687 struct scsi_sync_cache_16
688 {
689 	uint8_t opcode;
690 	uint8_t byte2;
691 	uint8_t begin_lba[8];
692 	uint8_t lb_count[4];
693 	uint8_t reserved;
694 	uint8_t control;
695 };
696 
697 struct scsi_format {
698 	uint8_t opcode;
699 	uint8_t byte2;
700 #define	SF_LONGLIST		0x20
701 #define	SF_FMTDATA		0x10
702 #define	SF_CMPLIST		0x08
703 #define	SF_FORMAT_MASK		0x07
704 #define	SF_FORMAT_BLOCK		0x00
705 #define	SF_FORMAT_LONG_BLOCK	0x03
706 #define	SF_FORMAT_BFI		0x04
707 #define	SF_FORMAT_PHYS		0x05
708 	uint8_t vendor;
709 	uint8_t interleave[2];
710 	uint8_t control;
711 };
712 
713 struct scsi_format_header_short {
714 	uint8_t reserved;
715 #define	SF_DATA_FOV	0x80
716 #define	SF_DATA_DPRY	0x40
717 #define	SF_DATA_DCRT	0x20
718 #define	SF_DATA_STPF	0x10
719 #define	SF_DATA_IP	0x08
720 #define	SF_DATA_DSP	0x04
721 #define	SF_DATA_IMMED	0x02
722 #define	SF_DATA_VS	0x01
723 	uint8_t byte2;
724 	uint8_t defect_list_len[2];
725 };
726 
727 struct scsi_format_header_long {
728 	uint8_t reserved;
729 	uint8_t byte2;
730 	uint8_t reserved2[2];
731 	uint8_t defect_list_len[4];
732 };
733 
734 struct scsi_changedef
735 {
736 	u_int8_t opcode;
737 	u_int8_t byte2;
738 	u_int8_t unused1;
739 	u_int8_t how;
740 	u_int8_t unused[4];
741 	u_int8_t datalen;
742 	u_int8_t control;
743 };
744 
745 struct scsi_read_buffer
746 {
747 	u_int8_t opcode;
748 	u_int8_t byte2;
749 #define	RWB_MODE		0x07
750 #define	RWB_MODE_HDR_DATA	0x00
751 #define	RWB_MODE_VENDOR		0x01
752 #define	RWB_MODE_DATA		0x02
753 #define	RWB_MODE_DOWNLOAD	0x04
754 #define	RWB_MODE_DOWNLOAD_SAVE	0x05
755         u_int8_t buffer_id;
756         u_int8_t offset[3];
757         u_int8_t length[3];
758         u_int8_t control;
759 };
760 
761 struct scsi_write_buffer
762 {
763 	u_int8_t opcode;
764 	u_int8_t byte2;
765 	u_int8_t buffer_id;
766 	u_int8_t offset[3];
767 	u_int8_t length[3];
768 	u_int8_t control;
769 };
770 
771 struct scsi_rw_6
772 {
773 	u_int8_t opcode;
774 	u_int8_t addr[3];
775 /* only 5 bits are valid in the MSB address byte */
776 #define	SRW_TOPADDR	0x1F
777 	u_int8_t length;
778 	u_int8_t control;
779 };
780 
781 struct scsi_rw_10
782 {
783 	u_int8_t opcode;
784 #define	SRW10_RELADDR	0x01
785 /* EBP defined for WRITE(10) only */
786 #define	SRW10_EBP	0x04
787 #define	SRW10_FUA	0x08
788 #define	SRW10_DPO	0x10
789 	u_int8_t byte2;
790 	u_int8_t addr[4];
791 	u_int8_t reserved;
792 	u_int8_t length[2];
793 	u_int8_t control;
794 };
795 
796 struct scsi_rw_12
797 {
798 	u_int8_t opcode;
799 #define	SRW12_RELADDR	0x01
800 #define	SRW12_FUA	0x08
801 #define	SRW12_DPO	0x10
802 	u_int8_t byte2;
803 	u_int8_t addr[4];
804 	u_int8_t length[4];
805 	u_int8_t reserved;
806 	u_int8_t control;
807 };
808 
809 struct scsi_rw_16
810 {
811 	u_int8_t opcode;
812 #define	SRW16_RELADDR	0x01
813 #define	SRW16_FUA	0x08
814 #define	SRW16_DPO	0x10
815 	u_int8_t byte2;
816 	u_int8_t addr[8];
817 	u_int8_t length[4];
818 	u_int8_t reserved;
819 	u_int8_t control;
820 };
821 
822 struct scsi_write_same_10
823 {
824 	uint8_t	opcode;
825 	uint8_t	byte2;
826 #define	SWS_LBDATA	0x02
827 #define	SWS_PBDATA	0x04
828 #define	SWS_UNMAP	0x08
829 #define	SWS_ANCHOR	0x10
830 	uint8_t	addr[4];
831 	uint8_t	group;
832 	uint8_t	length[2];
833 	uint8_t	control;
834 };
835 
836 struct scsi_write_same_16
837 {
838 	uint8_t	opcode;
839 	uint8_t	byte2;
840 	uint8_t	addr[8];
841 	uint8_t	length[4];
842 	uint8_t	group;
843 	uint8_t	control;
844 };
845 
846 struct scsi_unmap
847 {
848 	uint8_t	opcode;
849 	uint8_t	byte2;
850 #define	SU_ANCHOR	0x01
851 	uint8_t	reserved[4];
852 	uint8_t	group;
853 	uint8_t	length[2];
854 	uint8_t	control;
855 };
856 
857 struct scsi_unmap_header
858 {
859 	uint8_t	length[2];
860 	uint8_t	desc_length[2];
861 	uint8_t	reserved[4];
862 };
863 
864 struct scsi_unmap_desc
865 {
866 	uint8_t	lba[8];
867 	uint8_t	length[4];
868 	uint8_t	reserved[4];
869 };
870 
871 struct scsi_write_verify_10
872 {
873 	uint8_t	opcode;
874 	uint8_t	byte2;
875 #define	SWV_BYTCHK		0x02
876 #define	SWV_DPO			0x10
877 #define	SWV_WRPROECT_MASK	0xe0
878 	uint8_t	addr[4];
879 	uint8_t	group;
880 	uint8_t length[2];
881 	uint8_t	control;
882 };
883 
884 struct scsi_write_verify_12
885 {
886 	uint8_t	opcode;
887 	uint8_t	byte2;
888 	uint8_t	addr[4];
889 	uint8_t	length[4];
890 	uint8_t	group;
891 	uint8_t	control;
892 };
893 
894 struct scsi_write_verify_16
895 {
896 	uint8_t	opcode;
897 	uint8_t	byte2;
898 	uint8_t	addr[8];
899 	uint8_t	length[4];
900 	uint8_t	group;
901 	uint8_t	control;
902 };
903 
904 
905 struct scsi_start_stop_unit
906 {
907 	u_int8_t opcode;
908 	u_int8_t byte2;
909 #define	SSS_IMMED		0x01
910 	u_int8_t reserved[2];
911 	u_int8_t how;
912 #define	SSS_START		0x01
913 #define	SSS_LOEJ		0x02
914 #define	SSS_PC_MASK		0xf0
915 #define	SSS_PC_START_VALID	0x00
916 #define	SSS_PC_ACTIVE		0x10
917 #define	SSS_PC_IDLE		0x20
918 #define	SSS_PC_STANDBY		0x30
919 #define	SSS_PC_LU_CONTROL	0x70
920 #define	SSS_PC_FORCE_IDLE_0	0xa0
921 #define	SSS_PC_FORCE_STANDBY_0	0xb0
922 	u_int8_t control;
923 };
924 
925 struct ata_pass_12 {
926 	u_int8_t opcode;
927 	u_int8_t protocol;
928 #define	AP_PROTO_HARD_RESET	(0x00 << 1)
929 #define	AP_PROTO_SRST		(0x01 << 1)
930 #define	AP_PROTO_NON_DATA	(0x03 << 1)
931 #define	AP_PROTO_PIO_IN		(0x04 << 1)
932 #define	AP_PROTO_PIO_OUT	(0x05 << 1)
933 #define	AP_PROTO_DMA		(0x06 << 1)
934 #define	AP_PROTO_DMA_QUEUED	(0x07 << 1)
935 #define	AP_PROTO_DEVICE_DIAG	(0x08 << 1)
936 #define	AP_PROTO_DEVICE_RESET	(0x09 << 1)
937 #define	AP_PROTO_UDMA_IN	(0x0a << 1)
938 #define	AP_PROTO_UDMA_OUT	(0x0b << 1)
939 #define	AP_PROTO_FPDMA		(0x0c << 1)
940 #define	AP_PROTO_RESP_INFO	(0x0f << 1)
941 #define	AP_MULTI	0xe0
942 	u_int8_t flags;
943 #define	AP_T_LEN	0x03
944 #define	AP_BB		0x04
945 #define	AP_T_DIR	0x08
946 #define	AP_CK_COND	0x20
947 #define	AP_OFFLINE	0x60
948 	u_int8_t features;
949 	u_int8_t sector_count;
950 	u_int8_t lba_low;
951 	u_int8_t lba_mid;
952 	u_int8_t lba_high;
953 	u_int8_t device;
954 	u_int8_t command;
955 	u_int8_t reserved;
956 	u_int8_t control;
957 };
958 
959 struct scsi_maintenance_in
960 {
961         uint8_t  opcode;
962         uint8_t  byte2;
963 #define SERVICE_ACTION_MASK  0x1f
964 #define SA_RPRT_TRGT_GRP     0x0a
965         uint8_t  reserved[4];
966 	uint8_t  length[4];
967 	uint8_t  reserved1;
968 	uint8_t  control;
969 };
970 
971 struct ata_pass_16 {
972 	u_int8_t opcode;
973 	u_int8_t protocol;
974 #define	AP_EXTEND	0x01
975 	u_int8_t flags;
976 #define	AP_FLAG_TLEN_NO_DATA	(0 << 0)
977 #define	AP_FLAG_TLEN_FEAT	(1 << 0)
978 #define	AP_FLAG_TLEN_SECT_CNT	(2 << 0)
979 #define	AP_FLAG_TLEN_STPSIU	(3 << 0)
980 #define	AP_FLAG_BYT_BLOK_BYTES	(0 << 2)
981 #define	AP_FLAG_BYT_BLOK_BLOCKS	(1 << 2)
982 #define	AP_FLAG_TDIR_TO_DEV	(0 << 3)
983 #define	AP_FLAG_TDIR_FROM_DEV	(1 << 3)
984 #define	AP_FLAG_CHK_COND	(1 << 5)
985 	u_int8_t features_ext;
986 	u_int8_t features;
987 	u_int8_t sector_count_ext;
988 	u_int8_t sector_count;
989 	u_int8_t lba_low_ext;
990 	u_int8_t lba_low;
991 	u_int8_t lba_mid_ext;
992 	u_int8_t lba_mid;
993 	u_int8_t lba_high_ext;
994 	u_int8_t lba_high;
995 	u_int8_t device;
996 	u_int8_t command;
997 	u_int8_t control;
998 };
999 
1000 #define	SC_SCSI_1 0x01
1001 #define	SC_SCSI_2 0x03
1002 
1003 /*
1004  * Opcodes
1005  */
1006 
1007 #define	TEST_UNIT_READY		0x00
1008 #define	REQUEST_SENSE		0x03
1009 #define	READ_6			0x08
1010 #define	WRITE_6			0x0A
1011 #define	INQUIRY			0x12
1012 #define	MODE_SELECT_6		0x15
1013 #define	MODE_SENSE_6		0x1A
1014 #define	START_STOP_UNIT		0x1B
1015 #define	START_STOP		0x1B
1016 #define	RESERVE      		0x16
1017 #define	RELEASE      		0x17
1018 #define	RECEIVE_DIAGNOSTIC	0x1C
1019 #define	SEND_DIAGNOSTIC		0x1D
1020 #define	PREVENT_ALLOW		0x1E
1021 #define	READ_CAPACITY		0x25
1022 #define	READ_10			0x28
1023 #define	WRITE_10		0x2A
1024 #define	POSITION_TO_ELEMENT	0x2B
1025 #define	WRITE_VERIFY_10		0x2E
1026 #define	VERIFY_10		0x2F
1027 #define	SYNCHRONIZE_CACHE	0x35
1028 #define	READ_DEFECT_DATA_10	0x37
1029 #define	WRITE_BUFFER            0x3B
1030 #define	READ_BUFFER             0x3C
1031 #define	CHANGE_DEFINITION	0x40
1032 #define	WRITE_SAME_10		0x41
1033 #define	UNMAP			0x42
1034 #define	LOG_SELECT		0x4C
1035 #define	LOG_SENSE		0x4D
1036 #define	MODE_SELECT_10		0x55
1037 #define	RESERVE_10		0x56
1038 #define	RELEASE_10		0x57
1039 #define	MODE_SENSE_10		0x5A
1040 #define	PERSISTENT_RES_IN	0x5E
1041 #define	PERSISTENT_RES_OUT	0x5F
1042 #define	ATA_PASS_16		0x85
1043 #define	READ_16			0x88
1044 #define	WRITE_16		0x8A
1045 #define	WRITE_VERIFY_16		0x8E
1046 #define	SYNCHRONIZE_CACHE_16	0x91
1047 #define	WRITE_SAME_16		0x93
1048 #define	SERVICE_ACTION_IN	0x9E
1049 #define	REPORT_LUNS		0xA0
1050 #define	ATA_PASS_12		0xA1
1051 #define	MAINTENANCE_IN		0xA3
1052 #define	MAINTENANCE_OUT		0xA4
1053 #define	MOVE_MEDIUM     	0xA5
1054 #define	READ_12			0xA8
1055 #define	WRITE_12		0xAA
1056 #define	WRITE_VERIFY_12		0xAE
1057 #define	READ_ELEMENT_STATUS	0xB8
1058 #define	READ_CD			0xBE
1059 
1060 /* Maintenance In Service Action Codes */
1061 #define	REPORT_IDENTIFYING_INFRMATION		0x05
1062 #define	REPORT_TARGET_PORT_GROUPS		0x0A
1063 #define	REPORT_ALIASES				0x0B
1064 #define	REPORT_SUPPORTED_OPERATION_CODES	0x0C
1065 #define	REPORT_SUPPORTED_TASK_MANAGEMENT_FUNCTIONS	0x0D
1066 #define	REPORT_PRIORITY				0x0E
1067 #define	REPORT_TIMESTAMP			0x0F
1068 #define	MANAGEMENT_PROTOCOL_IN			0x10
1069 /* Maintenance Out Service Action Codes */
1070 #define	SET_IDENTIFY_INFORMATION		0x06
1071 #define	SET_TARGET_PORT_GROUPS			0x0A
1072 #define	CHANGE_ALIASES				0x0B
1073 #define	SET_PRIORITY				0x0E
1074 #define	SET_TIMESTAMP				0x0F
1075 #define	MANGAEMENT_PROTOCOL_OUT			0x10
1076 
1077 /*
1078  * Device Types
1079  */
1080 #define	T_DIRECT	0x00
1081 #define	T_SEQUENTIAL	0x01
1082 #define	T_PRINTER	0x02
1083 #define	T_PROCESSOR	0x03
1084 #define	T_WORM		0x04
1085 #define	T_CDROM		0x05
1086 #define	T_SCANNER	0x06
1087 #define	T_OPTICAL 	0x07
1088 #define	T_CHANGER	0x08
1089 #define	T_COMM		0x09
1090 #define	T_ASC0		0x0a
1091 #define	T_ASC1		0x0b
1092 #define	T_STORARRAY	0x0c
1093 #define	T_ENCLOSURE	0x0d
1094 #define	T_RBC		0x0e
1095 #define	T_OCRW		0x0f
1096 #define	T_OSD		0x11
1097 #define	T_ADC		0x12
1098 #define	T_NODEVICE	0x1f
1099 #define	T_ANY		0xff	/* Used in Quirk table matches */
1100 
1101 #define	T_REMOV		1
1102 #define	T_FIXED		0
1103 
1104 /*
1105  * This length is the initial inquiry length used by the probe code, as
1106  * well as the length necessary for scsi_print_inquiry() to function
1107  * correctly.  If either use requires a different length in the future,
1108  * the two values should be de-coupled.
1109  */
1110 #define	SHORT_INQUIRY_LENGTH	36
1111 
1112 struct scsi_inquiry_data
1113 {
1114 	u_int8_t device;
1115 #define	SID_TYPE(inq_data) ((inq_data)->device & 0x1f)
1116 #define	SID_QUAL(inq_data) (((inq_data)->device & 0xE0) >> 5)
1117 #define	SID_QUAL_LU_CONNECTED	0x00	/*
1118 					 * The specified peripheral device
1119 					 * type is currently connected to
1120 					 * logical unit.  If the target cannot
1121 					 * determine whether or not a physical
1122 					 * device is currently connected, it
1123 					 * shall also use this peripheral
1124 					 * qualifier when returning the INQUIRY
1125 					 * data.  This peripheral qualifier
1126 					 * does not mean that the device is
1127 					 * ready for access by the initiator.
1128 					 */
1129 #define	SID_QUAL_LU_OFFLINE	0x01	/*
1130 					 * The target is capable of supporting
1131 					 * the specified peripheral device type
1132 					 * on this logical unit; however, the
1133 					 * physical device is not currently
1134 					 * connected to this logical unit.
1135 					 */
1136 #define	SID_QUAL_RSVD		0x02
1137 #define	SID_QUAL_BAD_LU		0x03	/*
1138 					 * The target is not capable of
1139 					 * supporting a physical device on
1140 					 * this logical unit. For this
1141 					 * peripheral qualifier the peripheral
1142 					 * device type shall be set to 1Fh to
1143 					 * provide compatibility with previous
1144 					 * versions of SCSI. All other
1145 					 * peripheral device type values are
1146 					 * reserved for this peripheral
1147 					 * qualifier.
1148 					 */
1149 #define	SID_QUAL_IS_VENDOR_UNIQUE(inq_data) ((SID_QUAL(inq_data) & 0x08) != 0)
1150 	u_int8_t dev_qual2;
1151 #define	SID_QUAL2	0x7F
1152 #define	SID_IS_REMOVABLE(inq_data) (((inq_data)->dev_qual2 & 0x80) != 0)
1153 	u_int8_t version;
1154 #define	SID_ANSI_REV(inq_data) ((inq_data)->version & 0x07)
1155 #define		SCSI_REV_0		0
1156 #define		SCSI_REV_CCS		1
1157 #define		SCSI_REV_2		2
1158 #define		SCSI_REV_SPC		3
1159 #define		SCSI_REV_SPC2		4
1160 #define		SCSI_REV_SPC3		5
1161 #define		SCSI_REV_SPC4		6
1162 
1163 #define	SID_ECMA	0x38
1164 #define	SID_ISO		0xC0
1165 	u_int8_t response_format;
1166 #define	SID_AENC	0x80
1167 #define	SID_TrmIOP	0x40
1168 #define	SID_NormACA	0x20
1169 #define	SID_HiSup	0x10
1170 	u_int8_t additional_length;
1171 #define	SID_ADDITIONAL_LENGTH(iqd)					\
1172 	((iqd)->additional_length +					\
1173 	__offsetof(struct scsi_inquiry_data, additional_length) + 1)
1174 	u_int8_t spc3_flags;
1175 #define	SPC3_SID_PROTECT	0x01
1176 #define	SPC3_SID_3PC		0x08
1177 #define	SPC3_SID_TPGS_MASK	0x30
1178 #define	SPC3_SID_TPGS_IMPLICIT	0x10
1179 #define	SPC3_SID_TPGS_EXPLICIT	0x20
1180 #define	SPC3_SID_ACC		0x40
1181 #define	SPC3_SID_SCCS		0x80
1182 	u_int8_t spc2_flags;
1183 #define	SPC2_SID_ADDR16		0x01
1184 #define	SPC2_SID_MChngr 	0x08
1185 #define	SPC2_SID_MultiP 	0x10
1186 #define	SPC2_SID_EncServ	0x40
1187 #define	SPC2_SID_BQueue		0x80
1188 
1189 #define	INQ_DATA_TQ_ENABLED(iqd)				\
1190     ((SID_ANSI_REV(iqd) < SCSI_REV_SPC2)? ((iqd)->flags & SID_CmdQue) :	\
1191     (((iqd)->flags & SID_CmdQue) && !((iqd)->spc2_flags & SPC2_SID_BQueue)) || \
1192     (!((iqd)->flags & SID_CmdQue) && ((iqd)->spc2_flags & SPC2_SID_BQueue)))
1193 
1194 	u_int8_t flags;
1195 #define	SID_SftRe	0x01
1196 #define	SID_CmdQue	0x02
1197 #define	SID_Linked	0x08
1198 #define	SID_Sync	0x10
1199 #define	SID_WBus16	0x20
1200 #define	SID_WBus32	0x40
1201 #define	SID_RelAdr	0x80
1202 #define	SID_VENDOR_SIZE   8
1203 	char	 vendor[SID_VENDOR_SIZE];
1204 #define	SID_PRODUCT_SIZE  16
1205 	char	 product[SID_PRODUCT_SIZE];
1206 #define	SID_REVISION_SIZE 4
1207 	char	 revision[SID_REVISION_SIZE];
1208 	/*
1209 	 * The following fields were taken from SCSI Primary Commands - 2
1210 	 * (SPC-2) Revision 14, Dated 11 November 1999
1211 	 */
1212 #define	SID_VENDOR_SPECIFIC_0_SIZE	20
1213 	u_int8_t vendor_specific0[SID_VENDOR_SPECIFIC_0_SIZE];
1214 	/*
1215 	 * An extension of SCSI Parallel Specific Values
1216 	 */
1217 #define	SID_SPI_IUS		0x01
1218 #define	SID_SPI_QAS		0x02
1219 #define	SID_SPI_CLOCK_ST	0x00
1220 #define	SID_SPI_CLOCK_DT	0x04
1221 #define	SID_SPI_CLOCK_DT_ST	0x0C
1222 #define	SID_SPI_MASK		0x0F
1223 	u_int8_t spi3data;
1224 	u_int8_t reserved2;
1225 	/*
1226 	 * Version Descriptors, stored 2 byte values.
1227 	 */
1228 	u_int8_t version1[2];
1229 	u_int8_t version2[2];
1230 	u_int8_t version3[2];
1231 	u_int8_t version4[2];
1232 	u_int8_t version5[2];
1233 	u_int8_t version6[2];
1234 	u_int8_t version7[2];
1235 	u_int8_t version8[2];
1236 
1237 	u_int8_t reserved3[22];
1238 
1239 #define	SID_VENDOR_SPECIFIC_1_SIZE	160
1240 	u_int8_t vendor_specific1[SID_VENDOR_SPECIFIC_1_SIZE];
1241 };
1242 
1243 /*
1244  * This structure is more suited to initiator operation, because the
1245  * maximum number of supported pages is already allocated.
1246  */
1247 struct scsi_vpd_supported_page_list
1248 {
1249 	u_int8_t device;
1250 	u_int8_t page_code;
1251 #define	SVPD_SUPPORTED_PAGE_LIST	0x00
1252 #define	SVPD_SUPPORTED_PAGES_HDR_LEN	4
1253 	u_int8_t reserved;
1254 	u_int8_t length;	/* number of VPD entries */
1255 #define	SVPD_SUPPORTED_PAGES_SIZE	251
1256 	u_int8_t list[SVPD_SUPPORTED_PAGES_SIZE];
1257 };
1258 
1259 /*
1260  * This structure is more suited to target operation, because the
1261  * number of supported pages is left to the user to allocate.
1262  */
1263 struct scsi_vpd_supported_pages
1264 {
1265 	u_int8_t device;
1266 	u_int8_t page_code;
1267 	u_int8_t reserved;
1268 #define	SVPD_SUPPORTED_PAGES	0x00
1269 	u_int8_t length;
1270 	u_int8_t page_list[0];
1271 };
1272 
1273 
1274 struct scsi_vpd_unit_serial_number
1275 {
1276 	u_int8_t device;
1277 	u_int8_t page_code;
1278 #define	SVPD_UNIT_SERIAL_NUMBER	0x80
1279 	u_int8_t reserved;
1280 	u_int8_t length; /* serial number length */
1281 #define	SVPD_SERIAL_NUM_SIZE 251
1282 	u_int8_t serial_num[SVPD_SERIAL_NUM_SIZE];
1283 };
1284 
1285 struct scsi_vpd_device_id
1286 {
1287 	u_int8_t device;
1288 	u_int8_t page_code;
1289 #define	SVPD_DEVICE_ID			0x83
1290 #define	SVPD_DEVICE_ID_MAX_SIZE		252
1291 #define	SVPD_DEVICE_ID_HDR_LEN \
1292     __offsetof(struct scsi_vpd_device_id, desc_list)
1293 	u_int8_t length[2];
1294 	u_int8_t desc_list[];
1295 };
1296 
1297 struct scsi_vpd_id_descriptor
1298 {
1299 	u_int8_t	proto_codeset;
1300 #define	SCSI_PROTO_FC		0x00
1301 #define	SCSI_PROTO_SPI		0x01
1302 #define	SCSI_PROTO_SSA		0x02
1303 #define	SCSI_PROTO_1394		0x03
1304 #define	SCSI_PROTO_RDMA		0x04
1305 #define	SCSI_PROTO_ISCSI	0x05
1306 #define	SCSI_PROTO_SAS		0x06
1307 #define	SCSI_PROTO_ADT		0x07
1308 #define	SCSI_PROTO_ATA		0x08
1309 #define	SVPD_ID_PROTO_SHIFT	4
1310 #define	SVPD_ID_CODESET_BINARY	0x01
1311 #define	SVPD_ID_CODESET_ASCII	0x02
1312 #define	SVPD_ID_CODESET_UTF8	0x03
1313 #define	SVPD_ID_CODESET_MASK	0x0f
1314 	u_int8_t	id_type;
1315 #define	SVPD_ID_PIV		0x80
1316 #define	SVPD_ID_ASSOC_LUN	0x00
1317 #define	SVPD_ID_ASSOC_PORT	0x10
1318 #define	SVPD_ID_ASSOC_TARGET	0x20
1319 #define	SVPD_ID_ASSOC_MASK	0x30
1320 #define	SVPD_ID_TYPE_VENDOR	0x00
1321 #define	SVPD_ID_TYPE_T10	0x01
1322 #define	SVPD_ID_TYPE_EUI64	0x02
1323 #define	SVPD_ID_TYPE_NAA	0x03
1324 #define	SVPD_ID_TYPE_RELTARG	0x04
1325 #define	SVPD_ID_TYPE_TPORTGRP	0x05
1326 #define	SVPD_ID_TYPE_LUNGRP	0x06
1327 #define	SVPD_ID_TYPE_MD5_LUN_ID	0x07
1328 #define	SVPD_ID_TYPE_SCSI_NAME	0x08
1329 #define	SVPD_ID_TYPE_MASK	0x0f
1330 	u_int8_t	reserved;
1331 	u_int8_t	length;
1332 #define	SVPD_DEVICE_ID_DESC_HDR_LEN \
1333     __offsetof(struct scsi_vpd_id_descriptor, identifier)
1334 	u_int8_t	identifier[];
1335 };
1336 
1337 struct scsi_vpd_id_t10
1338 {
1339 	u_int8_t	vendor[8];
1340 	u_int8_t	vendor_spec_id[0];
1341 };
1342 
1343 struct scsi_vpd_id_eui64
1344 {
1345 	u_int8_t	ieee_company_id[3];
1346 	u_int8_t	extension_id[5];
1347 };
1348 
1349 struct scsi_vpd_id_naa_basic
1350 {
1351 	uint8_t naa;
1352 	/* big endian, packed:
1353 	uint8_t	naa : 4;
1354 	uint8_t naa_desig : 4;
1355 	*/
1356 #define	SVPD_ID_NAA_NAA_SHIFT		4
1357 #define	SVPD_ID_NAA_IEEE_EXT		0x02
1358 #define	SVPD_ID_NAA_LOCAL_REG		0x03
1359 #define	SVPD_ID_NAA_IEEE_REG		0x05
1360 #define	SVPD_ID_NAA_IEEE_REG_EXT	0x06
1361 	uint8_t	naa_data[];
1362 };
1363 
1364 struct scsi_vpd_id_naa_ieee_extended_id
1365 {
1366 	uint8_t naa;
1367 	uint8_t vendor_specific_id_a;
1368 	uint8_t ieee_company_id[3];
1369 	uint8_t vendor_specific_id_b[4];
1370 };
1371 
1372 struct scsi_vpd_id_naa_local_reg
1373 {
1374 	uint8_t naa;
1375 	uint8_t local_value[7];
1376 };
1377 
1378 struct scsi_vpd_id_naa_ieee_reg
1379 {
1380 	uint8_t naa;
1381 	uint8_t reg_value[7];
1382 	/* big endian, packed:
1383 	uint8_t naa_basic : 4;
1384 	uint8_t ieee_company_id_0 : 4;
1385 	uint8_t ieee_company_id_1[2];
1386 	uint8_t ieee_company_id_2 : 4;
1387 	uint8_t vendor_specific_id_0 : 4;
1388 	uint8_t vendor_specific_id_1[4];
1389 	*/
1390 };
1391 
1392 struct scsi_vpd_id_naa_ieee_reg_extended
1393 {
1394 	uint8_t naa;
1395 	uint8_t reg_value[15];
1396 	/* big endian, packed:
1397 	uint8_t naa_basic : 4;
1398 	uint8_t ieee_company_id_0 : 4;
1399 	uint8_t ieee_company_id_1[2];
1400 	uint8_t ieee_company_id_2 : 4;
1401 	uint8_t vendor_specific_id_0 : 4;
1402 	uint8_t vendor_specific_id_1[4];
1403 	uint8_t vendor_specific_id_ext[8];
1404 	*/
1405 };
1406 
1407 struct scsi_vpd_id_rel_trgt_port_id
1408 {
1409 	uint8_t obsolete[2];
1410 	uint8_t rel_trgt_port_id[2];
1411 };
1412 
1413 struct scsi_vpd_id_trgt_port_grp_id
1414 {
1415 	uint8_t reserved[2];
1416 	uint8_t trgt_port_grp[2];
1417 };
1418 
1419 struct scsi_vpd_id_lun_grp_id
1420 {
1421 	uint8_t reserved[2];
1422 	uint8_t log_unit_grp[2];
1423 };
1424 
1425 struct scsi_vpd_id_md5_lun_id
1426 {
1427 	uint8_t lun_id[16];
1428 };
1429 
1430 struct scsi_vpd_id_scsi_name
1431 {
1432 	uint8_t name_string[256];
1433 };
1434 
1435 struct scsi_service_action_in
1436 {
1437 	uint8_t opcode;
1438 	uint8_t service_action;
1439 	uint8_t action_dependent[13];
1440 	uint8_t control;
1441 };
1442 
1443 struct scsi_diag_page {
1444 	uint8_t page_code;
1445 	uint8_t page_specific_flags;
1446 	uint8_t length[2];
1447 	uint8_t params[0];
1448 };
1449 
1450 /*
1451  * ATA Information VPD Page based on
1452  * T10/2126-D Revision 04
1453  */
1454 #define SVPD_ATA_INFORMATION		0x89
1455 
1456 /*
1457  * Block Device Characteristics VPD Page based on
1458  * T10/1799-D Revision 31
1459  */
1460 struct scsi_vpd_block_characteristics
1461 {
1462 	u_int8_t device;
1463 	u_int8_t page_code;
1464 #define SVPD_BDC			0xB1
1465 	u_int8_t page_length[2];
1466 	u_int8_t medium_rotation_rate[2];
1467 #define SVPD_BDC_RATE_NOT_REPORTED	0x00
1468 #define SVPD_BDC_RATE_NON_ROTATING	0x01
1469 	u_int8_t reserved1;
1470 	u_int8_t nominal_form_factor;
1471 #define SVPD_BDC_FORM_NOT_REPORTED	0x00
1472 #define SVPD_BDC_FORM_5_25INCH		0x01
1473 #define SVPD_BDC_FORM_3_5INCH		0x02
1474 #define SVPD_BDC_FORM_2_5INCH		0x03
1475 #define SVPD_BDC_FORM_1_5INCH		0x04
1476 #define SVPD_BDC_FORM_LESSTHAN_1_5INCH	0x05
1477 	u_int8_t reserved2[56];
1478 };
1479 
1480 /*
1481  * Logical Block Provisioning VPD Page based on
1482  * T10/1799-D Revision 31
1483  */
1484 struct scsi_vpd_logical_block_prov
1485 {
1486 	u_int8_t device;
1487 	u_int8_t page_code;
1488 #define	SVPD_LBP		0xB2
1489 	u_int8_t page_length[2];
1490 #define SVPD_LBP_PL_BASIC	0x04
1491 	u_int8_t threshold_exponent;
1492 	u_int8_t flags;
1493 #define SVPD_LBP_UNMAP		0x80
1494 #define SVPD_LBP_WS16		0x40
1495 #define SVPD_LBP_WS10		0x20
1496 #define SVPD_LBP_RZ		0x04
1497 #define SVPD_LBP_ANC_SUP	0x02
1498 #define SVPD_LBP_DP		0x01
1499 	u_int8_t prov_type;
1500 #define SVPD_LBP_RESOURCE	0x01
1501 #define SVPD_LBP_THIN		0x02
1502 	u_int8_t reserved;
1503 	/*
1504 	 * Provisioning Group Descriptor can be here if SVPD_LBP_DP is set
1505 	 * Its size can be determined from page_length - 4
1506 	 */
1507 };
1508 
1509 /*
1510  * Block Limits VDP Page based on
1511  * T10/1799-D Revision 31
1512  */
1513 struct scsi_vpd_block_limits
1514 {
1515 	u_int8_t device;
1516 	u_int8_t page_code;
1517 #define	SVPD_BLOCK_LIMITS	0xB0
1518 	u_int8_t page_length[2];
1519 #define SVPD_BL_PL_BASIC	0x10
1520 #define SVPD_BL_PL_TP		0x3C
1521 	u_int8_t reserved1;
1522 	u_int8_t max_cmp_write_len;
1523 	u_int8_t opt_txfer_len_grain[2];
1524 	u_int8_t max_txfer_len[4];
1525 	u_int8_t opt_txfer_len[4];
1526 	u_int8_t max_prefetch[4];
1527 	u_int8_t max_unmap_lba_cnt[4];
1528 	u_int8_t max_unmap_blk_cnt[4];
1529 	u_int8_t opt_unmap_grain[4];
1530 	u_int8_t unmap_grain_align[4];
1531 	u_int8_t max_write_same_length[8];
1532 	u_int8_t reserved2[20];
1533 };
1534 
1535 struct scsi_read_capacity
1536 {
1537 	u_int8_t opcode;
1538 	u_int8_t byte2;
1539 #define	SRC_RELADR	0x01
1540 	u_int8_t addr[4];
1541 	u_int8_t unused[2];
1542 	u_int8_t pmi;
1543 #define	SRC_PMI		0x01
1544 	u_int8_t control;
1545 };
1546 
1547 struct scsi_read_capacity_16
1548 {
1549 	uint8_t opcode;
1550 #define	SRC16_SERVICE_ACTION	0x10
1551 	uint8_t service_action;
1552 	uint8_t addr[8];
1553 	uint8_t alloc_len[4];
1554 #define	SRC16_PMI		0x01
1555 #define	SRC16_RELADR		0x02
1556 	uint8_t reladr;
1557 	uint8_t control;
1558 };
1559 
1560 struct scsi_read_capacity_data
1561 {
1562 	u_int8_t addr[4];
1563 	u_int8_t length[4];
1564 };
1565 
1566 struct scsi_read_capacity_data_long
1567 {
1568 	uint8_t addr[8];
1569 	uint8_t length[4];
1570 #define	SRC16_PROT_EN		0x01
1571 #define	SRC16_P_TYPE		0x0e
1572 #define	SRC16_PTYPE_1		0x00
1573 #define	SRC16_PTYPE_2		0x02
1574 #define	SRC16_PTYPE_3		0x04
1575 	uint8_t prot;
1576 #define	SRC16_LBPPBE		0x0f
1577 #define	SRC16_PI_EXPONENT	0xf0
1578 #define	SRC16_PI_EXPONENT_SHIFT	4
1579 	uint8_t prot_lbppbe;
1580 #define	SRC16_LALBA		0x3f
1581 #define	SRC16_LBPRZ		0x40
1582 #define	SRC16_LBPME		0x80
1583 /*
1584  * Alternate versions of these macros that are intended for use on a 16-bit
1585  * version of the lalba_lbp field instead of the array of 2 8 bit numbers.
1586  */
1587 #define	SRC16_LALBA_A		0x3fff
1588 #define	SRC16_LBPRZ_A		0x4000
1589 #define	SRC16_LBPME_A		0x8000
1590 	uint8_t lalba_lbp[2];
1591 	uint8_t	reserved[16];
1592 };
1593 
1594 struct scsi_report_luns
1595 {
1596 	uint8_t opcode;
1597 	uint8_t reserved1;
1598 #define	RPL_REPORT_DEFAULT	0x00
1599 #define	RPL_REPORT_WELLKNOWN	0x01
1600 #define	RPL_REPORT_ALL		0x02
1601 	uint8_t select_report;
1602 	uint8_t reserved2[3];
1603 	uint8_t length[4];
1604 	uint8_t reserved3;
1605 	uint8_t control;
1606 };
1607 
1608 struct scsi_report_luns_lundata {
1609 	uint8_t lundata[8];
1610 #define	RPL_LUNDATA_PERIPH_BUS_MASK	0x3f
1611 #define	RPL_LUNDATA_FLAT_LUN_MASK	0x3f
1612 #define	RPL_LUNDATA_FLAT_LUN_BITS	0x06
1613 #define	RPL_LUNDATA_LUN_TARG_MASK	0x3f
1614 #define	RPL_LUNDATA_LUN_BUS_MASK	0xe0
1615 #define	RPL_LUNDATA_LUN_LUN_MASK	0x1f
1616 #define	RPL_LUNDATA_EXT_LEN_MASK	0x30
1617 #define	RPL_LUNDATA_EXT_EAM_MASK	0x0f
1618 #define	RPL_LUNDATA_EXT_EAM_WK		0x01
1619 #define	RPL_LUNDATA_EXT_EAM_NOT_SPEC	0x0f
1620 #define	RPL_LUNDATA_ATYP_MASK	0xc0	/* MBZ for type 0 lun */
1621 #define	RPL_LUNDATA_ATYP_PERIPH	0x00
1622 #define	RPL_LUNDATA_ATYP_FLAT	0x40
1623 #define	RPL_LUNDATA_ATYP_LUN	0x80
1624 #define	RPL_LUNDATA_ATYP_EXTLUN	0xc0
1625 };
1626 
1627 struct scsi_report_luns_data {
1628 	u_int8_t length[4];	/* length of LUN inventory, in bytes */
1629 	u_int8_t reserved[4];	/* unused */
1630 	/*
1631 	 * LUN inventory- we only support the type zero form for now.
1632 	 */
1633 	struct scsi_report_luns_lundata luns[0];
1634 };
1635 
1636 struct scsi_target_group
1637 {
1638 	uint8_t opcode;
1639 	uint8_t service_action;
1640 #define	STG_PDF_LENGTH		0x00
1641 #define	RPL_PDF_EXTENDED	0x20
1642 	uint8_t reserved1[4];
1643 	uint8_t length[4];
1644 	uint8_t reserved2;
1645 	uint8_t control;
1646 };
1647 
1648 struct scsi_target_port_descriptor {
1649 	uint8_t	reserved[2];
1650 	uint8_t	relative_target_port_identifier[2];
1651 	uint8_t desc_list[];
1652 };
1653 
1654 struct scsi_target_port_group_descriptor {
1655 	uint8_t	pref_state;
1656 #define	TPG_PRIMARY				0x80
1657 #define	TPG_ASYMMETRIC_ACCESS_STATE_MASK	0xf
1658 #define	TPG_ASYMMETRIC_ACCESS_OPTIMIZED		0x0
1659 #define	TPG_ASYMMETRIC_ACCESS_NONOPTIMIZED	0x1
1660 #define	TPG_ASYMMETRIC_ACCESS_STANDBY		0x2
1661 #define	TPG_ASYMMETRIC_ACCESS_UNAVAILABLE	0x3
1662 #define	TPG_ASYMMETRIC_ACCESS_LBA_DEPENDENT	0x4
1663 #define	TPG_ASYMMETRIC_ACCESS_OFFLINE		0xE
1664 #define	TPG_ASYMMETRIC_ACCESS_TRANSITIONING	0xF
1665 	uint8_t support;
1666 #define	TPG_AO_SUP	0x01
1667 #define	TPG_AN_SUP	0x02
1668 #define	TPG_S_SUP	0x04
1669 #define	TPG_U_SUP	0x08
1670 #define	TPG_LBD_SUP	0x10
1671 #define	TPG_O_SUP	0x40
1672 #define	TPG_T_SUP	0x80
1673 	uint8_t target_port_group[2];
1674 	uint8_t reserved;
1675 	uint8_t status;
1676 #define TPG_UNAVLBL      0
1677 #define TPG_SET_BY_STPG  0x01
1678 #define TPG_IMPLICIT     0x02
1679 	uint8_t vendor_specific;
1680 	uint8_t	target_port_count;
1681 	struct scsi_target_port_descriptor descriptors[];
1682 };
1683 
1684 struct scsi_target_group_data {
1685 	uint8_t length[4];	/* length of returned data, in bytes */
1686 	struct scsi_target_port_group_descriptor groups[];
1687 };
1688 
1689 struct scsi_target_group_data_extended {
1690 	uint8_t length[4];	/* length of returned data, in bytes */
1691 	uint8_t format_type;	/* STG_PDF_LENGTH or RPL_PDF_EXTENDED */
1692 	uint8_t	implicit_transition_time;
1693 	uint8_t reserved[2];
1694 	struct scsi_target_port_group_descriptor groups[];
1695 };
1696 
1697 
1698 typedef enum {
1699 	SSD_TYPE_NONE,
1700 	SSD_TYPE_FIXED,
1701 	SSD_TYPE_DESC
1702 } scsi_sense_data_type;
1703 
1704 typedef enum {
1705 	SSD_ELEM_NONE,
1706 	SSD_ELEM_SKIP,
1707 	SSD_ELEM_DESC,
1708 	SSD_ELEM_SKS,
1709 	SSD_ELEM_COMMAND,
1710 	SSD_ELEM_INFO,
1711 	SSD_ELEM_FRU,
1712 	SSD_ELEM_STREAM,
1713 	SSD_ELEM_MAX
1714 } scsi_sense_elem_type;
1715 
1716 
1717 struct scsi_sense_data
1718 {
1719 	uint8_t error_code;
1720 	/*
1721 	 * SPC-4 says that the maximum length of sense data is 252 bytes.
1722 	 * So this structure is exactly 252 bytes log.
1723 	 */
1724 #define	SSD_FULL_SIZE 252
1725 	uint8_t sense_buf[SSD_FULL_SIZE - 1];
1726 	/*
1727 	 * XXX KDM is this still a reasonable minimum size?
1728 	 */
1729 #define	SSD_MIN_SIZE 18
1730 	/*
1731 	 * Maximum value for the extra_len field in the sense data.
1732 	 */
1733 #define	SSD_EXTRA_MAX 244
1734 };
1735 
1736 /*
1737  * Fixed format sense data.
1738  */
1739 struct scsi_sense_data_fixed
1740 {
1741 	u_int8_t error_code;
1742 #define	SSD_ERRCODE			0x7F
1743 #define		SSD_CURRENT_ERROR	0x70
1744 #define		SSD_DEFERRED_ERROR	0x71
1745 #define	SSD_ERRCODE_VALID	0x80
1746 	u_int8_t segment;
1747 	u_int8_t flags;
1748 #define	SSD_KEY				0x0F
1749 #define		SSD_KEY_NO_SENSE	0x00
1750 #define		SSD_KEY_RECOVERED_ERROR	0x01
1751 #define		SSD_KEY_NOT_READY	0x02
1752 #define		SSD_KEY_MEDIUM_ERROR	0x03
1753 #define		SSD_KEY_HARDWARE_ERROR	0x04
1754 #define		SSD_KEY_ILLEGAL_REQUEST	0x05
1755 #define		SSD_KEY_UNIT_ATTENTION	0x06
1756 #define		SSD_KEY_DATA_PROTECT	0x07
1757 #define		SSD_KEY_BLANK_CHECK	0x08
1758 #define		SSD_KEY_Vendor_Specific	0x09
1759 #define		SSD_KEY_COPY_ABORTED	0x0a
1760 #define		SSD_KEY_ABORTED_COMMAND	0x0b
1761 #define		SSD_KEY_EQUAL		0x0c
1762 #define		SSD_KEY_VOLUME_OVERFLOW	0x0d
1763 #define		SSD_KEY_MISCOMPARE	0x0e
1764 #define		SSD_KEY_COMPLETED	0x0f
1765 #define	SSD_ILI		0x20
1766 #define	SSD_EOM		0x40
1767 #define	SSD_FILEMARK	0x80
1768 	u_int8_t info[4];
1769 	u_int8_t extra_len;
1770 	u_int8_t cmd_spec_info[4];
1771 	u_int8_t add_sense_code;
1772 	u_int8_t add_sense_code_qual;
1773 	u_int8_t fru;
1774 	u_int8_t sense_key_spec[3];
1775 #define	SSD_SCS_VALID		0x80
1776 #define	SSD_FIELDPTR_CMD	0x40
1777 #define	SSD_BITPTR_VALID	0x08
1778 #define	SSD_BITPTR_VALUE	0x07
1779 	u_int8_t extra_bytes[14];
1780 #define	SSD_FIXED_IS_PRESENT(sense, length, field) 			\
1781 	((length >= (offsetof(struct scsi_sense_data_fixed, field) +	\
1782 	sizeof(sense->field))) ? 1 :0)
1783 #define	SSD_FIXED_IS_FILLED(sense, field) 				\
1784 	((((offsetof(struct scsi_sense_data_fixed, field) +		\
1785 	sizeof(sense->field)) -						\
1786 	(offsetof(struct scsi_sense_data_fixed, extra_len) +		\
1787 	sizeof(sense->extra_len))) <= sense->extra_len) ? 1 : 0)
1788 };
1789 
1790 /*
1791  * Descriptor format sense data definitions.
1792  * Introduced in SPC-3.
1793  */
1794 struct scsi_sense_data_desc
1795 {
1796 	uint8_t	error_code;
1797 #define	SSD_DESC_CURRENT_ERROR	0x72
1798 #define	SSD_DESC_DEFERRED_ERROR	0x73
1799 	uint8_t sense_key;
1800 	uint8_t	add_sense_code;
1801 	uint8_t	add_sense_code_qual;
1802 	uint8_t	reserved[3];
1803 	/*
1804 	 * Note that SPC-4, section 4.5.2.1 says that the extra_len field
1805 	 * must be less than or equal to 244.
1806 	 */
1807 	uint8_t	extra_len;
1808 	uint8_t	sense_desc[0];
1809 #define	SSD_DESC_IS_PRESENT(sense, length, field) 			\
1810 	((length >= (offsetof(struct scsi_sense_data_desc, field) +	\
1811 	sizeof(sense->field))) ? 1 :0)
1812 };
1813 
1814 struct scsi_sense_desc_header
1815 {
1816 	uint8_t desc_type;
1817 	uint8_t length;
1818 };
1819 /*
1820  * The information provide in the Information descriptor is device type or
1821  * command specific information, and defined in a command standard.
1822  *
1823  * Note that any changes to the field names or positions in this structure,
1824  * even reserved fields, should be accompanied by an examination of the
1825  * code in ctl_set_sense() that uses them.
1826  *
1827  * Maximum descriptors allowed: 1 (as of SPC-4)
1828  */
1829 struct scsi_sense_info
1830 {
1831 	uint8_t	desc_type;
1832 #define	SSD_DESC_INFO	0x00
1833 	uint8_t	length;
1834 	uint8_t	byte2;
1835 #define	SSD_INFO_VALID	0x80
1836 	uint8_t	reserved;
1837 	uint8_t	info[8];
1838 };
1839 
1840 /*
1841  * Command-specific information depends on the command for which the
1842  * reported condition occured.
1843  *
1844  * Note that any changes to the field names or positions in this structure,
1845  * even reserved fields, should be accompanied by an examination of the
1846  * code in ctl_set_sense() that uses them.
1847  *
1848  * Maximum descriptors allowed: 1 (as of SPC-4)
1849  */
1850 struct scsi_sense_command
1851 {
1852 	uint8_t	desc_type;
1853 #define	SSD_DESC_COMMAND	0x01
1854 	uint8_t	length;
1855 	uint8_t	reserved[2];
1856 	uint8_t	command_info[8];
1857 };
1858 
1859 /*
1860  * Sense key specific descriptor.  The sense key specific data format
1861  * depends on the sense key in question.
1862  *
1863  * Maximum descriptors allowed: 1 (as of SPC-4)
1864  */
1865 struct scsi_sense_sks
1866 {
1867 	uint8_t	desc_type;
1868 #define	SSD_DESC_SKS		0x02
1869 	uint8_t	length;
1870 	uint8_t reserved1[2];
1871 	uint8_t	sense_key_spec[3];
1872 #define	SSD_SKS_VALID		0x80
1873 	uint8_t reserved2;
1874 };
1875 
1876 /*
1877  * This is used for the Illegal Request sense key (0x05) only.
1878  */
1879 struct scsi_sense_sks_field
1880 {
1881 	uint8_t	byte0;
1882 #define	SSD_SKS_FIELD_VALID	0x80
1883 #define	SSD_SKS_FIELD_CMD	0x40
1884 #define	SSD_SKS_BPV		0x08
1885 #define	SSD_SKS_BIT_VALUE	0x07
1886 	uint8_t	field[2];
1887 };
1888 
1889 
1890 /*
1891  * This is used for the Hardware Error (0x04), Medium Error (0x03) and
1892  * Recovered Error (0x01) sense keys.
1893  */
1894 struct scsi_sense_sks_retry
1895 {
1896 	uint8_t byte0;
1897 #define	SSD_SKS_RETRY_VALID	0x80
1898 	uint8_t actual_retry_count[2];
1899 };
1900 
1901 /*
1902  * Used with the NO Sense (0x00) or Not Ready (0x02) sense keys.
1903  */
1904 struct scsi_sense_sks_progress
1905 {
1906 	uint8_t byte0;
1907 #define	SSD_SKS_PROGRESS_VALID	0x80
1908 	uint8_t progress[2];
1909 #define	SSD_SKS_PROGRESS_DENOM	0x10000
1910 };
1911 
1912 /*
1913  * Used with the Copy Aborted (0x0a) sense key.
1914  */
1915 struct scsi_sense_sks_segment
1916 {
1917 	uint8_t byte0;
1918 #define	SSD_SKS_SEGMENT_VALID	0x80
1919 #define	SSD_SKS_SEGMENT_SD	0x20
1920 #define	SSD_SKS_SEGMENT_BPV	0x08
1921 #define	SSD_SKS_SEGMENT_BITPTR	0x07
1922 	uint8_t field[2];
1923 };
1924 
1925 /*
1926  * Used with the Unit Attention (0x06) sense key.
1927  *
1928  * This is currently used to indicate that the unit attention condition
1929  * queue has overflowed (when the overflow bit is set).
1930  */
1931 struct scsi_sense_sks_overflow
1932 {
1933 	uint8_t byte0;
1934 #define	SSD_SKS_OVERFLOW_VALID	0x80
1935 #define	SSD_SKS_OVERFLOW_SET	0x01
1936 	uint8_t	reserved[2];
1937 };
1938 
1939 /*
1940  * This specifies which component is associated with the sense data.  There
1941  * is no standard meaning for the fru value.
1942  *
1943  * Maximum descriptors allowed: 1 (as of SPC-4)
1944  */
1945 struct scsi_sense_fru
1946 {
1947 	uint8_t	desc_type;
1948 #define	SSD_DESC_FRU		0x03
1949 	uint8_t	length;
1950 	uint8_t reserved;
1951 	uint8_t fru;
1952 };
1953 
1954 /*
1955  * Used for Stream commands, defined in SSC-4.
1956  *
1957  * Maximum descriptors allowed: 1 (as of SPC-4)
1958  */
1959 
1960 struct scsi_sense_stream
1961 {
1962 	uint8_t	desc_type;
1963 #define	SSD_DESC_STREAM		0x04
1964 	uint8_t	length;
1965 	uint8_t	reserved;
1966 	uint8_t	byte3;
1967 #define	SSD_DESC_STREAM_FM	0x80
1968 #define	SSD_DESC_STREAM_EOM	0x40
1969 #define	SSD_DESC_STREAM_ILI	0x20
1970 };
1971 
1972 /*
1973  * Used for Block commands, defined in SBC-3.
1974  *
1975  * This is currently (as of SBC-3) only used for the Incorrect Length
1976  * Indication (ILI) bit, which says that the data length requested in the
1977  * READ LONG or WRITE LONG command did not match the length of the logical
1978  * block.
1979  *
1980  * Maximum descriptors allowed: 1 (as of SPC-4)
1981  */
1982 struct scsi_sense_block
1983 {
1984 	uint8_t	desc_type;
1985 #define	SSD_DESC_BLOCK		0x05
1986 	uint8_t	length;
1987 	uint8_t	reserved;
1988 	uint8_t	byte3;
1989 #define	SSD_DESC_BLOCK_ILI	0x20
1990 };
1991 
1992 /*
1993  * Used for Object-Based Storage Devices (OSD-3).
1994  *
1995  * Maximum descriptors allowed: 1 (as of SPC-4)
1996  */
1997 struct scsi_sense_osd_objid
1998 {
1999 	uint8_t	desc_type;
2000 #define	SSD_DESC_OSD_OBJID	0x06
2001 	uint8_t	length;
2002 	uint8_t	reserved[6];
2003 	/*
2004 	 * XXX KDM provide the bit definitions here?  There are a lot of
2005 	 * them, and we don't have an OSD driver yet.
2006 	 */
2007 	uint8_t	not_init_cmds[4];
2008 	uint8_t	completed_cmds[4];
2009 	uint8_t	partition_id[8];
2010 	uint8_t	object_id[8];
2011 };
2012 
2013 /*
2014  * Used for Object-Based Storage Devices (OSD-3).
2015  *
2016  * Maximum descriptors allowed: 1 (as of SPC-4)
2017  */
2018 struct scsi_sense_osd_integrity
2019 {
2020 	uint8_t	desc_type;
2021 #define	SSD_DESC_OSD_INTEGRITY	0x07
2022 	uint8_t	length;
2023 	uint8_t	integ_check_val[32];
2024 };
2025 
2026 /*
2027  * Used for Object-Based Storage Devices (OSD-3).
2028  *
2029  * Maximum descriptors allowed: 1 (as of SPC-4)
2030  */
2031 struct scsi_sense_osd_attr_id
2032 {
2033 	uint8_t	desc_type;
2034 #define	SSD_DESC_OSD_ATTR_ID	0x08
2035 	uint8_t	length;
2036 	uint8_t	reserved[2];
2037 	uint8_t	attr_desc[0];
2038 };
2039 
2040 /*
2041  * Used with Sense keys No Sense (0x00) and Not Ready (0x02).
2042  *
2043  * Maximum descriptors allowed: 32 (as of SPC-4)
2044  */
2045 struct scsi_sense_progress
2046 {
2047 	uint8_t	desc_type;
2048 #define	SSD_DESC_PROGRESS	0x0a
2049 	uint8_t	length;
2050 	uint8_t	sense_key;
2051 	uint8_t	add_sense_code;
2052 	uint8_t	add_sense_code_qual;
2053 	uint8_t reserved;
2054 	uint8_t	progress[2];
2055 };
2056 
2057 /*
2058  * This is typically forwarded as the result of an EXTENDED COPY command.
2059  *
2060  * Maximum descriptors allowed: 2 (as of SPC-4)
2061  */
2062 struct scsi_sense_forwarded
2063 {
2064 	uint8_t	desc_type;
2065 #define	SSD_DESC_FORWARDED	0x0c
2066 	uint8_t	length;
2067 	uint8_t	byte2;
2068 #define	SSD_FORWARDED_FSDT	0x80
2069 #define	SSD_FORWARDED_SDS_MASK	0x0f
2070 #define	SSD_FORWARDED_SDS_UNK	0x00
2071 #define	SSD_FORWARDED_SDS_EXSRC	0x01
2072 #define	SSD_FORWARDED_SDS_EXDST	0x02
2073 };
2074 
2075 /*
2076  * Vendor-specific sense descriptor.  The desc_type field will be in the
2077  * range bewteen MIN and MAX inclusive.
2078  */
2079 struct scsi_sense_vendor
2080 {
2081 	uint8_t	desc_type;
2082 #define	SSD_DESC_VENDOR_MIN	0x80
2083 #define	SSD_DESC_VENDOR_MAX	0xff
2084 	uint8_t length;
2085 	uint8_t	data[0];
2086 };
2087 
2088 struct scsi_mode_header_6
2089 {
2090 	u_int8_t data_length;	/* Sense data length */
2091 	u_int8_t medium_type;
2092 	u_int8_t dev_spec;
2093 	u_int8_t blk_desc_len;
2094 };
2095 
2096 struct scsi_mode_header_10
2097 {
2098 	u_int8_t data_length[2];/* Sense data length */
2099 	u_int8_t medium_type;
2100 	u_int8_t dev_spec;
2101 	u_int8_t unused[2];
2102 	u_int8_t blk_desc_len[2];
2103 };
2104 
2105 struct scsi_mode_page_header
2106 {
2107 	u_int8_t page_code;
2108 #define	SMPH_PS		0x80
2109 #define	SMPH_SPF	0x40
2110 #define	SMPH_PC_MASK	0x3f
2111 	u_int8_t page_length;
2112 };
2113 
2114 struct scsi_mode_page_header_sp
2115 {
2116 	uint8_t page_code;
2117 	uint8_t subpage;
2118 	uint8_t page_length[2];
2119 };
2120 
2121 
2122 struct scsi_mode_blk_desc
2123 {
2124 	u_int8_t density;
2125 	u_int8_t nblocks[3];
2126 	u_int8_t reserved;
2127 	u_int8_t blklen[3];
2128 };
2129 
2130 #define	SCSI_DEFAULT_DENSITY	0x00	/* use 'default' density */
2131 #define	SCSI_SAME_DENSITY	0x7f	/* use 'same' density- >= SCSI-2 only */
2132 
2133 
2134 /*
2135  * Status Byte
2136  */
2137 #define	SCSI_STATUS_OK			0x00
2138 #define	SCSI_STATUS_CHECK_COND		0x02
2139 #define	SCSI_STATUS_COND_MET		0x04
2140 #define	SCSI_STATUS_BUSY		0x08
2141 #define	SCSI_STATUS_INTERMED		0x10
2142 #define	SCSI_STATUS_INTERMED_COND_MET	0x14
2143 #define	SCSI_STATUS_RESERV_CONFLICT	0x18
2144 #define	SCSI_STATUS_CMD_TERMINATED	0x22	/* Obsolete in SAM-2 */
2145 #define	SCSI_STATUS_QUEUE_FULL		0x28
2146 #define	SCSI_STATUS_ACA_ACTIVE		0x30
2147 #define	SCSI_STATUS_TASK_ABORTED	0x40
2148 
2149 struct scsi_inquiry_pattern {
2150 	u_int8_t   type;
2151 	u_int8_t   media_type;
2152 #define	SIP_MEDIA_REMOVABLE	0x01
2153 #define	SIP_MEDIA_FIXED		0x02
2154 	const char *vendor;
2155 	const char *product;
2156 	const char *revision;
2157 };
2158 
2159 struct scsi_static_inquiry_pattern {
2160 	u_int8_t   type;
2161 	u_int8_t   media_type;
2162 	char       vendor[SID_VENDOR_SIZE+1];
2163 	char       product[SID_PRODUCT_SIZE+1];
2164 	char       revision[SID_REVISION_SIZE+1];
2165 };
2166 
2167 struct scsi_sense_quirk_entry {
2168 	struct scsi_inquiry_pattern	inq_pat;
2169 	int				num_sense_keys;
2170 	int				num_ascs;
2171 	struct sense_key_table_entry	*sense_key_info;
2172 	struct asc_table_entry		*asc_info;
2173 };
2174 
2175 struct sense_key_table_entry {
2176 	u_int8_t    sense_key;
2177 	u_int32_t   action;
2178 	const char *desc;
2179 };
2180 
2181 struct asc_table_entry {
2182 	u_int8_t    asc;
2183 	u_int8_t    ascq;
2184 	u_int32_t   action;
2185 	const char *desc;
2186 };
2187 
2188 struct op_table_entry {
2189 	u_int8_t    opcode;
2190 	u_int32_t   opmask;
2191 	const char  *desc;
2192 };
2193 
2194 struct scsi_op_quirk_entry {
2195 	struct scsi_inquiry_pattern	inq_pat;
2196 	int				num_ops;
2197 	struct op_table_entry		*op_table;
2198 };
2199 
2200 typedef enum {
2201 	SSS_FLAG_NONE		= 0x00,
2202 	SSS_FLAG_PRINT_COMMAND	= 0x01
2203 } scsi_sense_string_flags;
2204 
2205 struct ccb_scsiio;
2206 struct cam_periph;
2207 union  ccb;
2208 #ifndef _KERNEL
2209 struct cam_device;
2210 #endif
2211 
2212 extern const char *scsi_sense_key_text[];
2213 
2214 struct sbuf;
2215 
2216 __BEGIN_DECLS
2217 void scsi_sense_desc(int sense_key, int asc, int ascq,
2218 		     struct scsi_inquiry_data *inq_data,
2219 		     const char **sense_key_desc, const char **asc_desc);
2220 scsi_sense_action scsi_error_action(struct ccb_scsiio* csio,
2221 				    struct scsi_inquiry_data *inq_data,
2222 				    u_int32_t sense_flags);
2223 const char *	scsi_status_string(struct ccb_scsiio *csio);
2224 
2225 void scsi_desc_iterate(struct scsi_sense_data_desc *sense, u_int sense_len,
2226 		       int (*iter_func)(struct scsi_sense_data_desc *sense,
2227 					u_int, struct scsi_sense_desc_header *,
2228 					void *), void *arg);
2229 uint8_t *scsi_find_desc(struct scsi_sense_data_desc *sense, u_int sense_len,
2230 			uint8_t desc_type);
2231 void scsi_set_sense_data(struct scsi_sense_data *sense_data,
2232 			 scsi_sense_data_type sense_format, int current_error,
2233 			 int sense_key, int asc, int ascq, ...) ;
2234 void scsi_set_sense_data_va(struct scsi_sense_data *sense_data,
2235 			    scsi_sense_data_type sense_format,
2236 			    int current_error, int sense_key, int asc,
2237 			    int ascq, va_list ap);
2238 int scsi_get_sense_info(struct scsi_sense_data *sense_data, u_int sense_len,
2239 			uint8_t info_type, uint64_t *info,
2240 			int64_t *signed_info);
2241 int scsi_get_sks(struct scsi_sense_data *sense_data, u_int sense_len,
2242 		 uint8_t *sks);
2243 int scsi_get_block_info(struct scsi_sense_data *sense_data, u_int sense_len,
2244 			struct scsi_inquiry_data *inq_data,
2245 			uint8_t *block_bits);
2246 int scsi_get_stream_info(struct scsi_sense_data *sense_data, u_int sense_len,
2247 			 struct scsi_inquiry_data *inq_data,
2248 			 uint8_t *stream_bits);
2249 void scsi_info_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len,
2250 		    struct scsi_inquiry_data *inq_data, uint64_t info);
2251 void scsi_command_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len,
2252 		       struct scsi_inquiry_data *inq_data, uint64_t csi);
2253 void scsi_progress_sbuf(struct sbuf *sb, uint16_t progress);
2254 int scsi_sks_sbuf(struct sbuf *sb, int sense_key, uint8_t *sks);
2255 void scsi_fru_sbuf(struct sbuf *sb, uint64_t fru);
2256 void scsi_stream_sbuf(struct sbuf *sb, uint8_t stream_bits, uint64_t info);
2257 void scsi_block_sbuf(struct sbuf *sb, uint8_t block_bits, uint64_t info);
2258 void scsi_sense_info_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2259 			  u_int sense_len, uint8_t *cdb, int cdb_len,
2260 			  struct scsi_inquiry_data *inq_data,
2261 			  struct scsi_sense_desc_header *header);
2262 
2263 void scsi_sense_command_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2264 			     u_int sense_len, uint8_t *cdb, int cdb_len,
2265 			     struct scsi_inquiry_data *inq_data,
2266 			     struct scsi_sense_desc_header *header);
2267 void scsi_sense_sks_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2268 			 u_int sense_len, uint8_t *cdb, int cdb_len,
2269 			 struct scsi_inquiry_data *inq_data,
2270 			 struct scsi_sense_desc_header *header);
2271 void scsi_sense_fru_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2272 			 u_int sense_len, uint8_t *cdb, int cdb_len,
2273 			 struct scsi_inquiry_data *inq_data,
2274 			 struct scsi_sense_desc_header *header);
2275 void scsi_sense_stream_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2276 			    u_int sense_len, uint8_t *cdb, int cdb_len,
2277 			    struct scsi_inquiry_data *inq_data,
2278 			    struct scsi_sense_desc_header *header);
2279 void scsi_sense_block_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2280 			   u_int sense_len, uint8_t *cdb, int cdb_len,
2281 			   struct scsi_inquiry_data *inq_data,
2282 			   struct scsi_sense_desc_header *header);
2283 void scsi_sense_progress_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2284 			      u_int sense_len, uint8_t *cdb, int cdb_len,
2285 			      struct scsi_inquiry_data *inq_data,
2286 			      struct scsi_sense_desc_header *header);
2287 void scsi_sense_generic_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2288 			     u_int sense_len, uint8_t *cdb, int cdb_len,
2289 			     struct scsi_inquiry_data *inq_data,
2290 			     struct scsi_sense_desc_header *header);
2291 void scsi_sense_desc_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2292 			  u_int sense_len, uint8_t *cdb, int cdb_len,
2293 			  struct scsi_inquiry_data *inq_data,
2294 			  struct scsi_sense_desc_header *header);
2295 scsi_sense_data_type scsi_sense_type(struct scsi_sense_data *sense_data);
2296 
2297 void scsi_sense_only_sbuf(struct scsi_sense_data *sense, u_int sense_len,
2298 			  struct sbuf *sb, char *path_str,
2299 			  struct scsi_inquiry_data *inq_data, uint8_t *cdb,
2300 			  int cdb_len);
2301 
2302 #ifdef _KERNEL
2303 int		scsi_command_string(struct ccb_scsiio *csio, struct sbuf *sb);
2304 int		scsi_sense_sbuf(struct ccb_scsiio *csio, struct sbuf *sb,
2305 				scsi_sense_string_flags flags);
2306 char *		scsi_sense_string(struct ccb_scsiio *csio,
2307 				  char *str, int str_len);
2308 void		scsi_sense_print(struct ccb_scsiio *csio);
2309 int 		scsi_vpd_supported_page(struct cam_periph *periph,
2310 					uint8_t page_id);
2311 #else /* _KERNEL */
2312 int		scsi_command_string(struct cam_device *device,
2313 				    struct ccb_scsiio *csio, struct sbuf *sb);
2314 int		scsi_sense_sbuf(struct cam_device *device,
2315 				struct ccb_scsiio *csio, struct sbuf *sb,
2316 				scsi_sense_string_flags flags);
2317 char *		scsi_sense_string(struct cam_device *device,
2318 				  struct ccb_scsiio *csio,
2319 				  char *str, int str_len);
2320 void		scsi_sense_print(struct cam_device *device,
2321 				 struct ccb_scsiio *csio, FILE *ofile);
2322 #endif /* _KERNEL */
2323 
2324 const char *	scsi_op_desc(u_int16_t opcode,
2325 			     struct scsi_inquiry_data *inq_data);
2326 char *		scsi_cdb_string(u_int8_t *cdb_ptr, char *cdb_string,
2327 				size_t len);
2328 
2329 void		scsi_print_inquiry(struct scsi_inquiry_data *inq_data);
2330 void		scsi_print_inquiry_short(struct scsi_inquiry_data *inq_data);
2331 
2332 u_int		scsi_calc_syncsrate(u_int period_factor);
2333 u_int		scsi_calc_syncparam(u_int period);
2334 
2335 typedef int	(*scsi_devid_checkfn_t)(uint8_t *);
2336 int		scsi_devid_is_naa_ieee_reg(uint8_t *bufp);
2337 int		scsi_devid_is_sas_target(uint8_t *bufp);
2338 int		scsi_devid_is_lun_eui64(uint8_t *bufp);
2339 int		scsi_devid_is_lun_naa(uint8_t *bufp);
2340 int		scsi_devid_is_lun_name(uint8_t *bufp);
2341 int		scsi_devid_is_lun_t10(uint8_t *bufp);
2342 struct scsi_vpd_id_descriptor *
2343 		scsi_get_devid(struct scsi_vpd_device_id *id, uint32_t len,
2344 			       scsi_devid_checkfn_t ck_fn);
2345 
2346 void		scsi_test_unit_ready(struct ccb_scsiio *csio, u_int32_t retries,
2347 				     void (*cbfcnp)(struct cam_periph *,
2348 						    union ccb *),
2349 				     u_int8_t tag_action,
2350 				     u_int8_t sense_len, u_int32_t timeout);
2351 
2352 void		scsi_request_sense(struct ccb_scsiio *csio, u_int32_t retries,
2353 				   void (*cbfcnp)(struct cam_periph *,
2354 						  union ccb *),
2355 				   void *data_ptr, u_int8_t dxfer_len,
2356 				   u_int8_t tag_action, u_int8_t sense_len,
2357 				   u_int32_t timeout);
2358 
2359 void		scsi_inquiry(struct ccb_scsiio *csio, u_int32_t retries,
2360 			     void (*cbfcnp)(struct cam_periph *, union ccb *),
2361 			     u_int8_t tag_action, u_int8_t *inq_buf,
2362 			     u_int32_t inq_len, int evpd, u_int8_t page_code,
2363 			     u_int8_t sense_len, u_int32_t timeout);
2364 
2365 void		scsi_mode_sense(struct ccb_scsiio *csio, u_int32_t retries,
2366 				void (*cbfcnp)(struct cam_periph *,
2367 					       union ccb *),
2368 				u_int8_t tag_action, int dbd,
2369 				u_int8_t page_code, u_int8_t page,
2370 				u_int8_t *param_buf, u_int32_t param_len,
2371 				u_int8_t sense_len, u_int32_t timeout);
2372 
2373 void		scsi_mode_sense_len(struct ccb_scsiio *csio, u_int32_t retries,
2374 				    void (*cbfcnp)(struct cam_periph *,
2375 						   union ccb *),
2376 				    u_int8_t tag_action, int dbd,
2377 				    u_int8_t page_code, u_int8_t page,
2378 				    u_int8_t *param_buf, u_int32_t param_len,
2379 				    int minimum_cmd_size, u_int8_t sense_len,
2380 				    u_int32_t timeout);
2381 
2382 void		scsi_mode_select(struct ccb_scsiio *csio, u_int32_t retries,
2383 				 void (*cbfcnp)(struct cam_periph *,
2384 						union ccb *),
2385 				 u_int8_t tag_action, int scsi_page_fmt,
2386 				 int save_pages, u_int8_t *param_buf,
2387 				 u_int32_t param_len, u_int8_t sense_len,
2388 				 u_int32_t timeout);
2389 
2390 void		scsi_mode_select_len(struct ccb_scsiio *csio, u_int32_t retries,
2391 				     void (*cbfcnp)(struct cam_periph *,
2392 						    union ccb *),
2393 				     u_int8_t tag_action, int scsi_page_fmt,
2394 				     int save_pages, u_int8_t *param_buf,
2395 				     u_int32_t param_len, int minimum_cmd_size,
2396 				     u_int8_t sense_len, u_int32_t timeout);
2397 
2398 void		scsi_log_sense(struct ccb_scsiio *csio, u_int32_t retries,
2399 			       void (*cbfcnp)(struct cam_periph *, union ccb *),
2400 			       u_int8_t tag_action, u_int8_t page_code,
2401 			       u_int8_t page, int save_pages, int ppc,
2402 			       u_int32_t paramptr, u_int8_t *param_buf,
2403 			       u_int32_t param_len, u_int8_t sense_len,
2404 			       u_int32_t timeout);
2405 
2406 void		scsi_log_select(struct ccb_scsiio *csio, u_int32_t retries,
2407 				void (*cbfcnp)(struct cam_periph *,
2408 				union ccb *), u_int8_t tag_action,
2409 				u_int8_t page_code, int save_pages,
2410 				int pc_reset, u_int8_t *param_buf,
2411 				u_int32_t param_len, u_int8_t sense_len,
2412 				u_int32_t timeout);
2413 
2414 void		scsi_prevent(struct ccb_scsiio *csio, u_int32_t retries,
2415 			     void (*cbfcnp)(struct cam_periph *, union ccb *),
2416 			     u_int8_t tag_action, u_int8_t action,
2417 			     u_int8_t sense_len, u_int32_t timeout);
2418 
2419 void		scsi_read_capacity(struct ccb_scsiio *csio, u_int32_t retries,
2420 				   void (*cbfcnp)(struct cam_periph *,
2421 				   union ccb *), u_int8_t tag_action,
2422 				   struct scsi_read_capacity_data *,
2423 				   u_int8_t sense_len, u_int32_t timeout);
2424 void		scsi_read_capacity_16(struct ccb_scsiio *csio, uint32_t retries,
2425 				      void (*cbfcnp)(struct cam_periph *,
2426 				      union ccb *), uint8_t tag_action,
2427 				      uint64_t lba, int reladr, int pmi,
2428 				      uint8_t *rcap_buf, int rcap_buf_len,
2429 				      uint8_t sense_len, uint32_t timeout);
2430 
2431 void		scsi_report_luns(struct ccb_scsiio *csio, u_int32_t retries,
2432 				 void (*cbfcnp)(struct cam_periph *,
2433 				 union ccb *), u_int8_t tag_action,
2434 				 u_int8_t select_report,
2435 				 struct scsi_report_luns_data *rpl_buf,
2436 				 u_int32_t alloc_len, u_int8_t sense_len,
2437 				 u_int32_t timeout);
2438 
2439 void		scsi_report_target_group(struct ccb_scsiio *csio, u_int32_t retries,
2440 				 void (*cbfcnp)(struct cam_periph *,
2441 				 union ccb *), u_int8_t tag_action,
2442 				 u_int8_t pdf,
2443 				 void *buf,
2444 				 u_int32_t alloc_len, u_int8_t sense_len,
2445 				 u_int32_t timeout);
2446 
2447 void		scsi_set_target_group(struct ccb_scsiio *csio, u_int32_t retries,
2448 				 void (*cbfcnp)(struct cam_periph *,
2449 				 union ccb *), u_int8_t tag_action, void *buf,
2450 				 u_int32_t alloc_len, u_int8_t sense_len,
2451 				 u_int32_t timeout);
2452 
2453 void		scsi_synchronize_cache(struct ccb_scsiio *csio,
2454 				       u_int32_t retries,
2455 				       void (*cbfcnp)(struct cam_periph *,
2456 				       union ccb *), u_int8_t tag_action,
2457 				       u_int32_t begin_lba, u_int16_t lb_count,
2458 				       u_int8_t sense_len, u_int32_t timeout);
2459 
2460 void scsi_receive_diagnostic_results(struct ccb_scsiio *csio, u_int32_t retries,
2461 				     void (*cbfcnp)(struct cam_periph *,
2462 						    union ccb*),
2463 				     uint8_t tag_action, int pcv,
2464 				     uint8_t page_code, uint8_t *data_ptr,
2465 				     uint16_t allocation_length,
2466 				     uint8_t sense_len, uint32_t timeout);
2467 
2468 void scsi_send_diagnostic(struct ccb_scsiio *csio, u_int32_t retries,
2469 			  void (*cbfcnp)(struct cam_periph *, union ccb *),
2470 			  uint8_t tag_action, int unit_offline,
2471 			  int device_offline, int self_test, int page_format,
2472 			  int self_test_code, uint8_t *data_ptr,
2473 			  uint16_t param_list_length, uint8_t sense_len,
2474 			  uint32_t timeout);
2475 
2476 void scsi_read_buffer(struct ccb_scsiio *csio, u_int32_t retries,
2477 			void (*cbfcnp)(struct cam_periph *, union ccb*),
2478 			uint8_t tag_action, int mode,
2479 			uint8_t buffer_id, u_int32_t offset,
2480 			uint8_t *data_ptr, uint32_t allocation_length,
2481 			uint8_t sense_len, uint32_t timeout);
2482 
2483 void scsi_write_buffer(struct ccb_scsiio *csio, u_int32_t retries,
2484 			void (*cbfcnp)(struct cam_periph *, union ccb *),
2485 			uint8_t tag_action, int mode,
2486 			uint8_t buffer_id, u_int32_t offset,
2487 			uint8_t *data_ptr, uint32_t param_list_length,
2488 			uint8_t sense_len, uint32_t timeout);
2489 
2490 #define	SCSI_RW_READ	0x0001
2491 #define	SCSI_RW_WRITE	0x0002
2492 #define	SCSI_RW_DIRMASK	0x0003
2493 #define	SCSI_RW_BIO	0x1000
2494 void scsi_read_write(struct ccb_scsiio *csio, u_int32_t retries,
2495 		     void (*cbfcnp)(struct cam_periph *, union ccb *),
2496 		     u_int8_t tag_action, int readop, u_int8_t byte2,
2497 		     int minimum_cmd_size, u_int64_t lba,
2498 		     u_int32_t block_count, u_int8_t *data_ptr,
2499 		     u_int32_t dxfer_len, u_int8_t sense_len,
2500 		     u_int32_t timeout);
2501 
2502 void scsi_write_same(struct ccb_scsiio *csio, u_int32_t retries,
2503 		     void (*cbfcnp)(struct cam_periph *, union ccb *),
2504 		     u_int8_t tag_action, u_int8_t byte2,
2505 		     int minimum_cmd_size, u_int64_t lba,
2506 		     u_int32_t block_count, u_int8_t *data_ptr,
2507 		     u_int32_t dxfer_len, u_int8_t sense_len,
2508 		     u_int32_t timeout);
2509 
2510 void scsi_ata_identify(struct ccb_scsiio *csio, u_int32_t retries,
2511 		       void (*cbfcnp)(struct cam_periph *, union ccb *),
2512 		       u_int8_t tag_action, u_int8_t *data_ptr,
2513 		       u_int16_t dxfer_len, u_int8_t sense_len,
2514 		       u_int32_t timeout);
2515 
2516 void scsi_ata_trim(struct ccb_scsiio *csio, u_int32_t retries,
2517 	           void (*cbfcnp)(struct cam_periph *, union ccb *),
2518 	           u_int8_t tag_action, u_int16_t block_count,
2519 	           u_int8_t *data_ptr, u_int16_t dxfer_len,
2520 	           u_int8_t sense_len, u_int32_t timeout);
2521 
2522 void scsi_ata_pass_16(struct ccb_scsiio *csio, u_int32_t retries,
2523 		      void (*cbfcnp)(struct cam_periph *, union ccb *),
2524 		      u_int32_t flags, u_int8_t tag_action,
2525 		      u_int8_t protocol, u_int8_t ata_flags, u_int16_t features,
2526 		      u_int16_t sector_count, uint64_t lba, u_int8_t command,
2527 		      u_int8_t control, u_int8_t *data_ptr, u_int16_t dxfer_len,
2528 		      u_int8_t sense_len, u_int32_t timeout);
2529 
2530 void scsi_unmap(struct ccb_scsiio *csio, u_int32_t retries,
2531 		void (*cbfcnp)(struct cam_periph *, union ccb *),
2532 		u_int8_t tag_action, u_int8_t byte2,
2533 		u_int8_t *data_ptr, u_int16_t dxfer_len,
2534 		u_int8_t sense_len, u_int32_t timeout);
2535 
2536 void scsi_start_stop(struct ccb_scsiio *csio, u_int32_t retries,
2537 		     void (*cbfcnp)(struct cam_periph *, union ccb *),
2538 		     u_int8_t tag_action, int start, int load_eject,
2539 		     int immediate, u_int8_t sense_len, u_int32_t timeout);
2540 
2541 int		scsi_inquiry_match(caddr_t inqbuffer, caddr_t table_entry);
2542 int		scsi_static_inquiry_match(caddr_t inqbuffer,
2543 					  caddr_t table_entry);
2544 int		scsi_devid_match(uint8_t *rhs, size_t rhs_len,
2545 				 uint8_t *lhs, size_t lhs_len);
2546 
2547 void scsi_extract_sense(struct scsi_sense_data *sense, int *error_code,
2548 			int *sense_key, int *asc, int *ascq);
2549 int scsi_extract_sense_ccb(union ccb *ccb, int *error_code, int *sense_key,
2550 			   int *asc, int *ascq);
2551 void scsi_extract_sense_len(struct scsi_sense_data *sense,
2552 			    u_int sense_len, int *error_code, int *sense_key,
2553 			    int *asc, int *ascq, int show_errors);
2554 int scsi_get_sense_key(struct scsi_sense_data *sense, u_int sense_len,
2555 		       int show_errors);
2556 int scsi_get_asc(struct scsi_sense_data *sense, u_int sense_len,
2557 		 int show_errors);
2558 int scsi_get_ascq(struct scsi_sense_data *sense, u_int sense_len,
2559 		  int show_errors);
2560 static __inline void scsi_ulto2b(u_int32_t val, u_int8_t *bytes);
2561 static __inline void scsi_ulto3b(u_int32_t val, u_int8_t *bytes);
2562 static __inline void scsi_ulto4b(u_int32_t val, u_int8_t *bytes);
2563 static __inline void scsi_u64to8b(u_int64_t val, u_int8_t *bytes);
2564 static __inline uint32_t scsi_2btoul(const uint8_t *bytes);
2565 static __inline uint32_t scsi_3btoul(const uint8_t *bytes);
2566 static __inline int32_t scsi_3btol(const uint8_t *bytes);
2567 static __inline uint32_t scsi_4btoul(const uint8_t *bytes);
2568 static __inline uint64_t scsi_8btou64(const uint8_t *bytes);
2569 static __inline void *find_mode_page_6(struct scsi_mode_header_6 *mode_header);
2570 static __inline void *find_mode_page_10(struct scsi_mode_header_10 *mode_header);
2571 
2572 static __inline void
2573 scsi_ulto2b(u_int32_t val, u_int8_t *bytes)
2574 {
2575 
2576 	bytes[0] = (val >> 8) & 0xff;
2577 	bytes[1] = val & 0xff;
2578 }
2579 
2580 static __inline void
2581 scsi_ulto3b(u_int32_t val, u_int8_t *bytes)
2582 {
2583 
2584 	bytes[0] = (val >> 16) & 0xff;
2585 	bytes[1] = (val >> 8) & 0xff;
2586 	bytes[2] = val & 0xff;
2587 }
2588 
2589 static __inline void
2590 scsi_ulto4b(u_int32_t val, u_int8_t *bytes)
2591 {
2592 
2593 	bytes[0] = (val >> 24) & 0xff;
2594 	bytes[1] = (val >> 16) & 0xff;
2595 	bytes[2] = (val >> 8) & 0xff;
2596 	bytes[3] = val & 0xff;
2597 }
2598 
2599 static __inline void
2600 scsi_u64to8b(u_int64_t val, u_int8_t *bytes)
2601 {
2602 
2603 	bytes[0] = (val >> 56) & 0xff;
2604 	bytes[1] = (val >> 48) & 0xff;
2605 	bytes[2] = (val >> 40) & 0xff;
2606 	bytes[3] = (val >> 32) & 0xff;
2607 	bytes[4] = (val >> 24) & 0xff;
2608 	bytes[5] = (val >> 16) & 0xff;
2609 	bytes[6] = (val >> 8) & 0xff;
2610 	bytes[7] = val & 0xff;
2611 }
2612 
2613 static __inline uint32_t
2614 scsi_2btoul(const uint8_t *bytes)
2615 {
2616 	uint32_t rv;
2617 
2618 	rv = (bytes[0] << 8) |
2619 	     bytes[1];
2620 	return (rv);
2621 }
2622 
2623 static __inline uint32_t
2624 scsi_3btoul(const uint8_t *bytes)
2625 {
2626 	uint32_t rv;
2627 
2628 	rv = (bytes[0] << 16) |
2629 	     (bytes[1] << 8) |
2630 	     bytes[2];
2631 	return (rv);
2632 }
2633 
2634 static __inline int32_t
2635 scsi_3btol(const uint8_t *bytes)
2636 {
2637 	uint32_t rc = scsi_3btoul(bytes);
2638 
2639 	if (rc & 0x00800000)
2640 		rc |= 0xff000000;
2641 
2642 	return (int32_t) rc;
2643 }
2644 
2645 static __inline uint32_t
2646 scsi_4btoul(const uint8_t *bytes)
2647 {
2648 	uint32_t rv;
2649 
2650 	rv = (bytes[0] << 24) |
2651 	     (bytes[1] << 16) |
2652 	     (bytes[2] << 8) |
2653 	     bytes[3];
2654 	return (rv);
2655 }
2656 
2657 static __inline uint64_t
2658 scsi_8btou64(const uint8_t *bytes)
2659 {
2660         uint64_t rv;
2661 
2662 	rv = (((uint64_t)bytes[0]) << 56) |
2663 	     (((uint64_t)bytes[1]) << 48) |
2664 	     (((uint64_t)bytes[2]) << 40) |
2665 	     (((uint64_t)bytes[3]) << 32) |
2666 	     (((uint64_t)bytes[4]) << 24) |
2667 	     (((uint64_t)bytes[5]) << 16) |
2668 	     (((uint64_t)bytes[6]) << 8) |
2669 	     bytes[7];
2670 	return (rv);
2671 }
2672 
2673 /*
2674  * Given the pointer to a returned mode sense buffer, return a pointer to
2675  * the start of the first mode page.
2676  */
2677 static __inline void *
2678 find_mode_page_6(struct scsi_mode_header_6 *mode_header)
2679 {
2680 	void *page_start;
2681 
2682 	page_start = (void *)((u_int8_t *)&mode_header[1] +
2683 			      mode_header->blk_desc_len);
2684 
2685 	return(page_start);
2686 }
2687 
2688 static __inline void *
2689 find_mode_page_10(struct scsi_mode_header_10 *mode_header)
2690 {
2691 	void *page_start;
2692 
2693 	page_start = (void *)((u_int8_t *)&mode_header[1] +
2694 			       scsi_2btoul(mode_header->blk_desc_len));
2695 
2696 	return(page_start);
2697 }
2698 
2699 __END_DECLS
2700 
2701 #endif /*_SCSI_SCSI_ALL_H*/
2702