xref: /freebsd/sys/cam/scsi/scsi_all.h (revision ee7b0571c2c18bdec848ed2044223cc88db29bd8)
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 #define	SPRI_MAX_LEN		0xffff
282 	u_int8_t control;
283 };
284 
285 struct scsi_per_res_in_header
286 {
287 	u_int8_t generation[4];
288 	u_int8_t length[4];
289 };
290 
291 struct scsi_per_res_key
292 {
293 	u_int8_t key[8];
294 };
295 
296 struct scsi_per_res_in_keys
297 {
298 	struct scsi_per_res_in_header header;
299 	struct scsi_per_res_key keys[0];
300 };
301 
302 struct scsi_per_res_cap
303 {
304 	uint8_t length[2];
305 	uint8_t flags1;
306 #define	SPRI_RLR_C		0x80
307 #define	SPRI_CRH		0x10
308 #define	SPRI_SIP_C		0x08
309 #define	SPRI_ATP_C		0x04
310 #define	SPRI_PTPL_C		0x01
311 	uint8_t flags2;
312 #define	SPRI_TMV		0x80
313 #define	SPRI_ALLOW_CMD_MASK	0x70
314 #define	SPRI_ALLOW_CMD_SHIFT	4
315 #define	SPRI_ALLOW_NA		0x00
316 #define	SPRI_ALLOW_1		0x10
317 #define	SPRI_ALLOW_2		0x20
318 #define	SPRI_ALLOW_3		0x30
319 #define	SPRI_ALLOW_4		0x40
320 #define	SPRI_PTPL_A		0x01
321 	uint8_t type_mask[2];
322 #define	SPRI_TM_WR_EX_AR	0x8000
323 #define	SPRI_TM_EX_AC_RO	0x4000
324 #define	SPRI_TM_WR_EX_RO	0x2000
325 #define	SPRI_TM_EX_AC		0x0800
326 #define	SPRI_TM_WR_EX		0x0200
327 #define	SPRI_TM_EX_AC_AR	0x0001
328 	uint8_t reserved[2];
329 };
330 
331 struct scsi_per_res_in_rsrv_data
332 {
333 	uint8_t reservation[8];
334 	uint8_t scope_addr[4];
335 	uint8_t reserved;
336 	uint8_t scopetype;
337 #define	SPRT_WE    0x01
338 #define	SPRT_EA    0x03
339 #define	SPRT_WERO  0x05
340 #define	SPRT_EARO  0x06
341 #define	SPRT_WEAR  0x07
342 #define	SPRT_EAAR  0x08
343 	uint8_t extent_length[2];
344 };
345 
346 struct scsi_per_res_in_rsrv
347 {
348 	struct scsi_per_res_in_header header;
349 	struct scsi_per_res_in_rsrv_data data;
350 };
351 
352 struct scsi_per_res_in_full_desc
353 {
354 	struct scsi_per_res_key res_key;
355 	uint8_t reserved1[4];
356 	uint8_t flags;
357 #define	SPRI_FULL_ALL_TG_PT	0x02
358 #define	SPRI_FULL_R_HOLDER	0x01
359 	uint8_t scopetype;
360 	uint8_t reserved2[4];
361 	uint8_t rel_trgt_port_id[2];
362 	uint8_t additional_length[4];
363 	uint8_t transport_id[];
364 };
365 
366 struct scsi_per_res_in_full
367 {
368 	struct scsi_per_res_in_header header;
369 	struct scsi_per_res_in_full_desc desc[];
370 };
371 
372 struct scsi_per_res_out
373 {
374 	u_int8_t opcode;
375 	u_int8_t action;
376 #define	SPRO_REGISTER		0x00
377 #define	SPRO_RESERVE		0x01
378 #define	SPRO_RELEASE		0x02
379 #define	SPRO_CLEAR		0x03
380 #define	SPRO_PREEMPT		0x04
381 #define	SPRO_PRE_ABO		0x05
382 #define	SPRO_REG_IGNO		0x06
383 #define	SPRO_REG_MOVE		0x07
384 #define	SPRO_REPL_LOST_RES	0x08
385 #define	SPRO_ACTION_MASK	0x1f
386 	u_int8_t scope_type;
387 #define	SPR_SCOPE_MASK		0xf0
388 #define	SPR_SCOPE_SHIFT		4
389 #define	SPR_LU_SCOPE		0x00
390 #define	SPR_EXTENT_SCOPE	0x10
391 #define	SPR_ELEMENT_SCOPE	0x20
392 #define	SPR_TYPE_MASK		0x0f
393 #define	SPR_TYPE_RD_SHARED	0x00
394 #define	SPR_TYPE_WR_EX		0x01
395 #define	SPR_TYPE_RD_EX		0x02
396 #define	SPR_TYPE_EX_AC		0x03
397 #define	SPR_TYPE_SHARED		0x04
398 #define	SPR_TYPE_WR_EX_RO	0x05
399 #define	SPR_TYPE_EX_AC_RO	0x06
400 #define	SPR_TYPE_WR_EX_AR	0x07
401 #define	SPR_TYPE_EX_AC_AR	0x08
402 	u_int8_t reserved[2];
403 	u_int8_t length[4];
404 	u_int8_t control;
405 };
406 
407 struct scsi_per_res_out_parms
408 {
409 	struct scsi_per_res_key res_key;
410 	u_int8_t serv_act_res_key[8];
411 	u_int8_t scope_spec_address[4];
412 	u_int8_t flags;
413 #define	SPR_SPEC_I_PT		0x08
414 #define	SPR_ALL_TG_PT		0x04
415 #define	SPR_APTPL		0x01
416 	u_int8_t reserved1;
417 	u_int8_t extent_length[2];
418 	u_int8_t transport_id_list[];
419 };
420 
421 struct scsi_per_res_out_trans_ids {
422 	u_int8_t additional_length[4];
423 	u_int8_t transport_ids[];
424 };
425 
426 /*
427  * Used with REGISTER AND MOVE serivce action of the PERSISTENT RESERVE OUT
428  * command.
429  */
430 struct scsi_per_res_reg_move
431 {
432 	struct scsi_per_res_key res_key;
433 	u_int8_t serv_act_res_key[8];
434 	u_int8_t reserved;
435 	u_int8_t flags;
436 #define	SPR_REG_MOVE_UNREG	0x02
437 #define	SPR_REG_MOVE_APTPL	0x01
438 	u_int8_t rel_trgt_port_id[2];
439 	u_int8_t transport_id_length[4];
440 	u_int8_t transport_id[];
441 };
442 
443 struct scsi_transportid_header
444 {
445 	uint8_t format_protocol;
446 #define	SCSI_TRN_FORMAT_MASK		0xc0
447 #define	SCSI_TRN_FORMAT_SHIFT		6
448 #define	SCSI_TRN_PROTO_MASK		0x0f
449 };
450 
451 struct scsi_transportid_fcp
452 {
453 	uint8_t format_protocol;
454 #define	SCSI_TRN_FCP_FORMAT_DEFAULT	0x00
455 	uint8_t reserved1[7];
456 	uint8_t n_port_name[8];
457 	uint8_t reserved2[8];
458 };
459 
460 struct scsi_transportid_spi
461 {
462 	uint8_t format_protocol;
463 #define	SCSI_TRN_SPI_FORMAT_DEFAULT	0x00
464 	uint8_t reserved1;
465 	uint8_t scsi_addr[2];
466 	uint8_t obsolete[2];
467 	uint8_t rel_trgt_port_id[2];
468 	uint8_t reserved2[16];
469 };
470 
471 struct scsi_transportid_1394
472 {
473 	uint8_t format_protocol;
474 #define	SCSI_TRN_1394_FORMAT_DEFAULT	0x00
475 	uint8_t reserved1[7];
476 	uint8_t eui64[8];
477 	uint8_t reserved2[8];
478 };
479 
480 struct scsi_transportid_rdma
481 {
482 	uint8_t format_protocol;
483 #define	SCSI_TRN_RDMA_FORMAT_DEFAULT	0x00
484 	uint8_t reserved[7];
485 #define	SCSI_TRN_RDMA_PORT_LEN		16
486 	uint8_t initiator_port_id[SCSI_TRN_RDMA_PORT_LEN];
487 };
488 
489 struct scsi_transportid_iscsi_device
490 {
491 	uint8_t format_protocol;
492 #define	SCSI_TRN_ISCSI_FORMAT_DEVICE	0x00
493 	uint8_t reserved;
494 	uint8_t additional_length[2];
495 	uint8_t iscsi_name[];
496 };
497 
498 struct scsi_transportid_iscsi_port
499 {
500 	uint8_t format_protocol;
501 #define	SCSI_TRN_ISCSI_FORMAT_PORT	0x40
502 	uint8_t reserved;
503 	uint8_t additional_length[2];
504 	uint8_t iscsi_name[];
505 	/*
506 	 * Followed by a separator and iSCSI initiator session ID
507 	 */
508 };
509 
510 struct scsi_transportid_sas
511 {
512 	uint8_t format_protocol;
513 #define	SCSI_TRN_SAS_FORMAT_DEFAULT	0x00
514 	uint8_t reserved1[3];
515 	uint8_t sas_address[8];
516 	uint8_t reserved2[12];
517 };
518 
519 struct scsi_sop_routing_id_norm {
520 	uint8_t bus;
521 	uint8_t devfunc;
522 #define	SCSI_TRN_SOP_BUS_MAX		0xff
523 #define	SCSI_TRN_SOP_DEV_MAX		0x1f
524 #define	SCSI_TRN_SOP_DEV_MASK		0xf8
525 #define	SCSI_TRN_SOP_DEV_SHIFT		3
526 #define	SCSI_TRN_SOP_FUNC_NORM_MASK	0x07
527 #define	SCSI_TRN_SOP_FUNC_NORM_MAX	0x07
528 };
529 
530 struct scsi_sop_routing_id_alt {
531 	uint8_t bus;
532 	uint8_t function;
533 #define	SCSI_TRN_SOP_FUNC_ALT_MAX	0xff
534 };
535 
536 struct scsi_transportid_sop
537 {
538 	uint8_t format_protocol;
539 #define	SCSI_TRN_SOP_FORMAT_DEFAULT	0x00
540 	uint8_t reserved1;
541 	uint8_t routing_id[2];
542 	uint8_t reserved2[20];
543 };
544 
545 struct scsi_log_sense
546 {
547 	u_int8_t opcode;
548 	u_int8_t byte2;
549 #define	SLS_SP				0x01
550 #define	SLS_PPC				0x02
551 	u_int8_t page;
552 #define	SLS_PAGE_CODE 			0x3F
553 #define	SLS_ALL_PAGES_PAGE		0x00
554 #define	SLS_OVERRUN_PAGE		0x01
555 #define	SLS_ERROR_WRITE_PAGE		0x02
556 #define	SLS_ERROR_READ_PAGE		0x03
557 #define	SLS_ERROR_READREVERSE_PAGE	0x04
558 #define	SLS_ERROR_VERIFY_PAGE		0x05
559 #define	SLS_ERROR_NONMEDIUM_PAGE	0x06
560 #define	SLS_ERROR_LASTN_PAGE		0x07
561 #define	SLS_SELF_TEST_PAGE		0x10
562 #define	SLS_IE_PAGE			0x2f
563 #define	SLS_PAGE_CTRL_MASK		0xC0
564 #define	SLS_PAGE_CTRL_THRESHOLD		0x00
565 #define	SLS_PAGE_CTRL_CUMULATIVE	0x40
566 #define	SLS_PAGE_CTRL_THRESH_DEFAULT	0x80
567 #define	SLS_PAGE_CTRL_CUMUL_DEFAULT	0xC0
568 	u_int8_t reserved[2];
569 	u_int8_t paramptr[2];
570 	u_int8_t length[2];
571 	u_int8_t control;
572 };
573 
574 struct scsi_log_select
575 {
576 	u_int8_t opcode;
577 	u_int8_t byte2;
578 /*	SLS_SP				0x01 */
579 #define	SLS_PCR				0x02
580 	u_int8_t page;
581 /*	SLS_PAGE_CTRL_MASK		0xC0 */
582 /*	SLS_PAGE_CTRL_THRESHOLD		0x00 */
583 /*	SLS_PAGE_CTRL_CUMULATIVE	0x40 */
584 /*	SLS_PAGE_CTRL_THRESH_DEFAULT	0x80 */
585 /*	SLS_PAGE_CTRL_CUMUL_DEFAULT	0xC0 */
586 	u_int8_t reserved[4];
587 	u_int8_t length[2];
588 	u_int8_t control;
589 };
590 
591 struct scsi_log_header
592 {
593 	u_int8_t page;
594 	u_int8_t reserved;
595 	u_int8_t datalen[2];
596 };
597 
598 struct scsi_log_param_header {
599 	u_int8_t param_code[2];
600 	u_int8_t param_control;
601 #define	SLP_LP				0x01
602 #define	SLP_LBIN			0x02
603 #define	SLP_TMC_MASK			0x0C
604 #define	SLP_TMC_ALWAYS			0x00
605 #define	SLP_TMC_EQUAL			0x04
606 #define	SLP_TMC_NOTEQUAL		0x08
607 #define	SLP_TMC_GREATER			0x0C
608 #define	SLP_ETC				0x10
609 #define	SLP_TSD				0x20
610 #define	SLP_DS				0x40
611 #define	SLP_DU				0x80
612 	u_int8_t param_len;
613 };
614 
615 struct scsi_control_page {
616 	u_int8_t page_code;
617 	u_int8_t page_length;
618 	u_int8_t rlec;
619 #define	SCP_RLEC			0x01	/*Report Log Exception Cond*/
620 #define	SCP_GLTSD			0x02	/*Global Logging target
621 						  save disable */
622 #define	SCP_DSENSE			0x04	/*Descriptor Sense */
623 #define	SCP_DPICZ			0x08	/*Disable Prot. Info Check
624 						  if Prot. Field is Zero */
625 #define	SCP_TMF_ONLY			0x10	/*TM Functions Only*/
626 #define	SCP_TST_MASK			0xE0	/*Task Set Type Mask*/
627 #define	SCP_TST_ONE			0x00	/*One Task Set*/
628 #define	SCP_TST_SEPARATE		0x20	/*Separate Task Sets*/
629 	u_int8_t queue_flags;
630 #define	SCP_QUEUE_ALG_MASK		0xF0
631 #define	SCP_QUEUE_ALG_RESTRICTED	0x00
632 #define	SCP_QUEUE_ALG_UNRESTRICTED	0x10
633 #define	SCP_NUAR			0x08	/*No UA on release*/
634 #define	SCP_QUEUE_ERR			0x02	/*Queued I/O aborted for CACs*/
635 #define	SCP_QUEUE_DQUE			0x01	/*Queued I/O disabled*/
636 	u_int8_t eca_and_aen;
637 #define	SCP_EECA			0x80	/*Enable Extended CA*/
638 #define	SCP_RAC				0x40	/*Report a check*/
639 #define	SCP_SWP				0x08	/*Software Write Protect*/
640 #define	SCP_RAENP			0x04	/*Ready AEN Permission*/
641 #define	SCP_UAAENP			0x02	/*UA AEN Permission*/
642 #define	SCP_EAENP			0x01	/*Error AEN Permission*/
643 	u_int8_t flags4;
644 #define	SCP_ATO				0x80	/*Application tag owner*/
645 #define	SCP_TAS				0x40	/*Task aborted status*/
646 #define	SCP_ATMPE			0x20	/*Application tag mode page*/
647 #define	SCP_RWWP			0x10	/*Reject write without prot*/
648 	u_int8_t aen_holdoff_period[2];
649 	u_int8_t busy_timeout_period[2];
650 	u_int8_t extended_selftest_completion_time[2];
651 };
652 
653 struct scsi_cache_page {
654 	u_int8_t page_code;
655 #define	SCHP_PAGE_SAVABLE		0x80	/* Page is savable */
656 	u_int8_t page_length;
657 	u_int8_t cache_flags;
658 #define	SCHP_FLAGS_WCE			0x04	/* Write Cache Enable */
659 #define	SCHP_FLAGS_MF			0x02	/* Multiplication factor */
660 #define	SCHP_FLAGS_RCD			0x01	/* Read Cache Disable */
661 	u_int8_t rw_cache_policy;
662 	u_int8_t dis_prefetch[2];
663 	u_int8_t min_prefetch[2];
664 	u_int8_t max_prefetch[2];
665 	u_int8_t max_prefetch_ceil[2];
666 };
667 
668 /*
669  * XXX KDM
670  * Updated version of the cache page, as of SBC.  Update this to SBC-3 and
671  * rationalize the two.
672  */
673 struct scsi_caching_page {
674 	uint8_t page_code;
675 #define	SMS_CACHING_PAGE		0x08
676 	uint8_t page_length;
677 	uint8_t flags1;
678 #define	SCP_IC		0x80
679 #define	SCP_ABPF	0x40
680 #define	SCP_CAP		0x20
681 #define	SCP_DISC	0x10
682 #define	SCP_SIZE	0x08
683 #define	SCP_WCE		0x04
684 #define	SCP_MF		0x02
685 #define	SCP_RCD		0x01
686 	uint8_t ret_priority;
687 	uint8_t disable_pf_transfer_len[2];
688 	uint8_t min_prefetch[2];
689 	uint8_t max_prefetch[2];
690 	uint8_t max_pf_ceiling[2];
691 	uint8_t flags2;
692 #define	SCP_FSW		0x80
693 #define	SCP_LBCSS	0x40
694 #define	SCP_DRA		0x20
695 #define	SCP_VS1		0x10
696 #define	SCP_VS2		0x08
697 	uint8_t cache_segments;
698 	uint8_t cache_seg_size[2];
699 	uint8_t reserved;
700 	uint8_t non_cache_seg_size[3];
701 };
702 
703 /*
704  * XXX KDM move this off to a vendor shim.
705  */
706 struct copan_power_subpage {
707 	uint8_t page_code;
708 #define	PWR_PAGE_CODE		0x00
709 	uint8_t subpage;
710 #define	PWR_SUBPAGE_CODE	0x02
711 	uint8_t page_length[2];
712 	uint8_t page_version;
713 #define	PWR_VERSION		    0x01
714 	uint8_t total_luns;
715 	uint8_t max_active_luns;
716 #define	PWR_DFLT_MAX_LUNS	    0x07
717 	uint8_t reserved[25];
718 };
719 
720 /*
721  * XXX KDM move this off to a vendor shim.
722  */
723 struct copan_aps_subpage {
724 	uint8_t page_code;
725 #define	APS_PAGE_CODE		0x00
726 	uint8_t subpage;
727 #define	APS_SUBPAGE_CODE	0x03
728 	uint8_t page_length[2];
729 	uint8_t page_version;
730 #define	APS_VERSION		    0x00
731 	uint8_t lock_active;
732 #define	APS_LOCK_ACTIVE	    0x01
733 #define	APS_LOCK_INACTIVE	0x00
734 	uint8_t reserved[26];
735 };
736 
737 /*
738  * XXX KDM move this off to a vendor shim.
739  */
740 struct copan_debugconf_subpage {
741 	uint8_t page_code;
742 #define DBGCNF_PAGE_CODE		0x00
743 	uint8_t subpage;
744 #define DBGCNF_SUBPAGE_CODE	0xF0
745 	uint8_t page_length[2];
746 	uint8_t page_version;
747 #define DBGCNF_VERSION			0x00
748 	uint8_t ctl_time_io_secs[2];
749 };
750 
751 
752 struct scsi_info_exceptions_page {
753 	u_int8_t page_code;
754 #define	SIEP_PAGE_SAVABLE		0x80	/* Page is savable */
755 	u_int8_t page_length;
756 	u_int8_t info_flags;
757 #define	SIEP_FLAGS_PERF			0x80
758 #define	SIEP_FLAGS_EBF			0x20
759 #define	SIEP_FLAGS_EWASC		0x10
760 #define	SIEP_FLAGS_DEXCPT		0x08
761 #define	SIEP_FLAGS_TEST			0x04
762 #define	SIEP_FLAGS_EBACKERR		0x02
763 #define	SIEP_FLAGS_LOGERR		0x01
764 	u_int8_t mrie;
765 	u_int8_t interval_timer[4];
766 	u_int8_t report_count[4];
767 };
768 
769 /*
770  * SCSI protocol identifier values, current as of SPC4r36l.
771  */
772 #define	SCSI_PROTO_FC		0x00	/* Fibre Channel */
773 #define	SCSI_PROTO_SPI		0x01	/* Parallel SCSI */
774 #define	SCSI_PROTO_SSA		0x02	/* Serial Storage Arch. */
775 #define	SCSI_PROTO_1394		0x03	/* IEEE 1394 (Firewire) */
776 #define	SCSI_PROTO_RDMA		0x04	/* SCSI RDMA Protocol */
777 #define	SCSI_PROTO_ISCSI	0x05	/* Internet SCSI */
778 #define	SCSI_PROTO_iSCSI	0x05	/* Internet SCSI */
779 #define	SCSI_PROTO_SAS		0x06	/* SAS Serial SCSI Protocol */
780 #define	SCSI_PROTO_ADT		0x07	/* Automation/Drive Int. Trans. Prot.*/
781 #define	SCSI_PROTO_ADITP	0x07	/* Automation/Drive Int. Trans. Prot.*/
782 #define	SCSI_PROTO_ATA		0x08	/* AT Attachment Interface */
783 #define	SCSI_PROTO_UAS		0x09	/* USB Atached SCSI */
784 #define	SCSI_PROTO_SOP		0x0a	/* SCSI over PCI Express */
785 #define	SCSI_PROTO_NONE		0x0f	/* No specific protocol */
786 
787 struct scsi_proto_specific_page {
788 	u_int8_t page_code;
789 #define	SPSP_PAGE_SAVABLE		0x80	/* Page is savable */
790 	u_int8_t page_length;
791 	u_int8_t protocol;
792 #define	SPSP_PROTO_FC			SCSI_PROTO_FC
793 #define	SPSP_PROTO_SPI			SCSI_PROTO_SPI
794 #define	SPSP_PROTO_SSA			SCSI_PROTO_SSA
795 #define	SPSP_PROTO_1394			SCSI_PROTO_1394
796 #define	SPSP_PROTO_RDMA			SCSI_PROTO_RDMA
797 #define	SPSP_PROTO_ISCSI		SCSI_PROTO_ISCSI
798 #define	SPSP_PROTO_SAS			SCSI_PROTO_SAS
799 #define	SPSP_PROTO_ADT			SCSI_PROTO_ADITP
800 #define	SPSP_PROTO_ATA			SCSI_PROTO_ATA
801 #define	SPSP_PROTO_UAS			SCSI_PROTO_UAS
802 #define	SPSP_PROTO_SOP			SCSI_PROTO_SOP
803 #define	SPSP_PROTO_NONE			SCSI_PROTO_NONE
804 };
805 
806 struct scsi_reserve
807 {
808 	u_int8_t opcode;
809 	u_int8_t byte2;
810 #define	SR_EXTENT	0x01
811 #define	SR_ID_MASK	0x0e
812 #define	SR_3RDPTY	0x10
813 #define	SR_LUN_MASK	0xe0
814 	u_int8_t resv_id;
815 	u_int8_t length[2];
816 	u_int8_t control;
817 };
818 
819 struct scsi_reserve_10 {
820 	uint8_t	opcode;
821 	uint8_t	byte2;
822 #define	SR10_3RDPTY	0x10
823 #define	SR10_LONGID	0x02
824 #define	SR10_EXTENT	0x01
825 	uint8_t resv_id;
826 	uint8_t thirdparty_id;
827 	uint8_t reserved[3];
828 	uint8_t length[2];
829 	uint8_t control;
830 };
831 
832 
833 struct scsi_release
834 {
835 	u_int8_t opcode;
836 	u_int8_t byte2;
837 	u_int8_t resv_id;
838 	u_int8_t unused[1];
839 	u_int8_t length;
840 	u_int8_t control;
841 };
842 
843 struct scsi_release_10 {
844 	uint8_t opcode;
845 	uint8_t byte2;
846 	uint8_t resv_id;
847 	uint8_t thirdparty_id;
848 	uint8_t reserved[3];
849 	uint8_t length[2];
850 	uint8_t control;
851 };
852 
853 struct scsi_prevent
854 {
855 	u_int8_t opcode;
856 	u_int8_t byte2;
857 	u_int8_t unused[2];
858 	u_int8_t how;
859 	u_int8_t control;
860 };
861 #define	PR_PREVENT 0x01
862 #define	PR_ALLOW   0x00
863 
864 struct scsi_sync_cache
865 {
866 	u_int8_t opcode;
867 	u_int8_t byte2;
868 #define	SSC_IMMED	0x02
869 #define	SSC_RELADR	0x01
870 	u_int8_t begin_lba[4];
871 	u_int8_t reserved;
872 	u_int8_t lb_count[2];
873 	u_int8_t control;
874 };
875 
876 struct scsi_sync_cache_16
877 {
878 	uint8_t opcode;
879 	uint8_t byte2;
880 	uint8_t begin_lba[8];
881 	uint8_t lb_count[4];
882 	uint8_t reserved;
883 	uint8_t control;
884 };
885 
886 struct scsi_format {
887 	uint8_t opcode;
888 	uint8_t byte2;
889 #define	SF_LONGLIST		0x20
890 #define	SF_FMTDATA		0x10
891 #define	SF_CMPLIST		0x08
892 #define	SF_FORMAT_MASK		0x07
893 #define	SF_FORMAT_BLOCK		0x00
894 #define	SF_FORMAT_LONG_BLOCK	0x03
895 #define	SF_FORMAT_BFI		0x04
896 #define	SF_FORMAT_PHYS		0x05
897 	uint8_t vendor;
898 	uint8_t interleave[2];
899 	uint8_t control;
900 };
901 
902 struct scsi_format_header_short {
903 	uint8_t reserved;
904 #define	SF_DATA_FOV	0x80
905 #define	SF_DATA_DPRY	0x40
906 #define	SF_DATA_DCRT	0x20
907 #define	SF_DATA_STPF	0x10
908 #define	SF_DATA_IP	0x08
909 #define	SF_DATA_DSP	0x04
910 #define	SF_DATA_IMMED	0x02
911 #define	SF_DATA_VS	0x01
912 	uint8_t byte2;
913 	uint8_t defect_list_len[2];
914 };
915 
916 struct scsi_format_header_long {
917 	uint8_t reserved;
918 	uint8_t byte2;
919 	uint8_t reserved2[2];
920 	uint8_t defect_list_len[4];
921 };
922 
923 struct scsi_changedef
924 {
925 	u_int8_t opcode;
926 	u_int8_t byte2;
927 	u_int8_t unused1;
928 	u_int8_t how;
929 	u_int8_t unused[4];
930 	u_int8_t datalen;
931 	u_int8_t control;
932 };
933 
934 struct scsi_read_buffer
935 {
936 	u_int8_t opcode;
937 	u_int8_t byte2;
938 #define	RWB_MODE		0x1F
939 #define	RWB_MODE_HDR_DATA	0x00
940 #define	RWB_MODE_VENDOR		0x01
941 #define	RWB_MODE_DATA		0x02
942 #define	RWB_MODE_DESCR		0x03
943 #define	RWB_MODE_DOWNLOAD	0x04
944 #define	RWB_MODE_DOWNLOAD_SAVE	0x05
945 #define	RWB_MODE_ECHO		0x0A
946 #define	RWB_MODE_ECHO_DESCR	0x0B
947 #define	RWB_MODE_ERROR_HISTORY	0x1C
948         u_int8_t buffer_id;
949         u_int8_t offset[3];
950         u_int8_t length[3];
951         u_int8_t control;
952 };
953 
954 struct scsi_write_buffer
955 {
956 	u_int8_t opcode;
957 	u_int8_t byte2;
958 	u_int8_t buffer_id;
959 	u_int8_t offset[3];
960 	u_int8_t length[3];
961 	u_int8_t control;
962 };
963 
964 struct scsi_rw_6
965 {
966 	u_int8_t opcode;
967 	u_int8_t addr[3];
968 /* only 5 bits are valid in the MSB address byte */
969 #define	SRW_TOPADDR	0x1F
970 	u_int8_t length;
971 	u_int8_t control;
972 };
973 
974 struct scsi_rw_10
975 {
976 	u_int8_t opcode;
977 #define	SRW10_RELADDR	0x01
978 /* EBP defined for WRITE(10) only */
979 #define	SRW10_EBP	0x04
980 #define	SRW10_FUA	0x08
981 #define	SRW10_DPO	0x10
982 	u_int8_t byte2;
983 	u_int8_t addr[4];
984 	u_int8_t reserved;
985 	u_int8_t length[2];
986 	u_int8_t control;
987 };
988 
989 struct scsi_rw_12
990 {
991 	u_int8_t opcode;
992 #define	SRW12_RELADDR	0x01
993 #define	SRW12_FUA	0x08
994 #define	SRW12_DPO	0x10
995 	u_int8_t byte2;
996 	u_int8_t addr[4];
997 	u_int8_t length[4];
998 	u_int8_t reserved;
999 	u_int8_t control;
1000 };
1001 
1002 struct scsi_rw_16
1003 {
1004 	u_int8_t opcode;
1005 #define	SRW16_RELADDR	0x01
1006 #define	SRW16_FUA	0x08
1007 #define	SRW16_DPO	0x10
1008 	u_int8_t byte2;
1009 	u_int8_t addr[8];
1010 	u_int8_t length[4];
1011 	u_int8_t reserved;
1012 	u_int8_t control;
1013 };
1014 
1015 struct scsi_write_same_10
1016 {
1017 	uint8_t	opcode;
1018 	uint8_t	byte2;
1019 #define	SWS_LBDATA	0x02
1020 #define	SWS_PBDATA	0x04
1021 #define	SWS_UNMAP	0x08
1022 #define	SWS_ANCHOR	0x10
1023 	uint8_t	addr[4];
1024 	uint8_t	group;
1025 	uint8_t	length[2];
1026 	uint8_t	control;
1027 };
1028 
1029 struct scsi_write_same_16
1030 {
1031 	uint8_t	opcode;
1032 	uint8_t	byte2;
1033 	uint8_t	addr[8];
1034 	uint8_t	length[4];
1035 	uint8_t	group;
1036 	uint8_t	control;
1037 };
1038 
1039 struct scsi_unmap
1040 {
1041 	uint8_t	opcode;
1042 	uint8_t	byte2;
1043 #define	SU_ANCHOR	0x01
1044 	uint8_t	reserved[4];
1045 	uint8_t	group;
1046 	uint8_t	length[2];
1047 	uint8_t	control;
1048 };
1049 
1050 struct scsi_unmap_header
1051 {
1052 	uint8_t	length[2];
1053 	uint8_t	desc_length[2];
1054 	uint8_t	reserved[4];
1055 };
1056 
1057 struct scsi_unmap_desc
1058 {
1059 	uint8_t	lba[8];
1060 	uint8_t	length[4];
1061 	uint8_t	reserved[4];
1062 };
1063 
1064 struct scsi_write_verify_10
1065 {
1066 	uint8_t	opcode;
1067 	uint8_t	byte2;
1068 #define	SWV_BYTCHK		0x02
1069 #define	SWV_DPO			0x10
1070 #define	SWV_WRPROECT_MASK	0xe0
1071 	uint8_t	addr[4];
1072 	uint8_t	group;
1073 	uint8_t length[2];
1074 	uint8_t	control;
1075 };
1076 
1077 struct scsi_write_verify_12
1078 {
1079 	uint8_t	opcode;
1080 	uint8_t	byte2;
1081 	uint8_t	addr[4];
1082 	uint8_t	length[4];
1083 	uint8_t	group;
1084 	uint8_t	control;
1085 };
1086 
1087 struct scsi_write_verify_16
1088 {
1089 	uint8_t	opcode;
1090 	uint8_t	byte2;
1091 	uint8_t	addr[8];
1092 	uint8_t	length[4];
1093 	uint8_t	group;
1094 	uint8_t	control;
1095 };
1096 
1097 
1098 struct scsi_start_stop_unit
1099 {
1100 	u_int8_t opcode;
1101 	u_int8_t byte2;
1102 #define	SSS_IMMED		0x01
1103 	u_int8_t reserved[2];
1104 	u_int8_t how;
1105 #define	SSS_START		0x01
1106 #define	SSS_LOEJ		0x02
1107 #define	SSS_PC_MASK		0xf0
1108 #define	SSS_PC_START_VALID	0x00
1109 #define	SSS_PC_ACTIVE		0x10
1110 #define	SSS_PC_IDLE		0x20
1111 #define	SSS_PC_STANDBY		0x30
1112 #define	SSS_PC_LU_CONTROL	0x70
1113 #define	SSS_PC_FORCE_IDLE_0	0xa0
1114 #define	SSS_PC_FORCE_STANDBY_0	0xb0
1115 	u_int8_t control;
1116 };
1117 
1118 struct ata_pass_12 {
1119 	u_int8_t opcode;
1120 	u_int8_t protocol;
1121 #define	AP_PROTO_HARD_RESET	(0x00 << 1)
1122 #define	AP_PROTO_SRST		(0x01 << 1)
1123 #define	AP_PROTO_NON_DATA	(0x03 << 1)
1124 #define	AP_PROTO_PIO_IN		(0x04 << 1)
1125 #define	AP_PROTO_PIO_OUT	(0x05 << 1)
1126 #define	AP_PROTO_DMA		(0x06 << 1)
1127 #define	AP_PROTO_DMA_QUEUED	(0x07 << 1)
1128 #define	AP_PROTO_DEVICE_DIAG	(0x08 << 1)
1129 #define	AP_PROTO_DEVICE_RESET	(0x09 << 1)
1130 #define	AP_PROTO_UDMA_IN	(0x0a << 1)
1131 #define	AP_PROTO_UDMA_OUT	(0x0b << 1)
1132 #define	AP_PROTO_FPDMA		(0x0c << 1)
1133 #define	AP_PROTO_RESP_INFO	(0x0f << 1)
1134 #define	AP_MULTI	0xe0
1135 	u_int8_t flags;
1136 #define	AP_T_LEN	0x03
1137 #define	AP_BB		0x04
1138 #define	AP_T_DIR	0x08
1139 #define	AP_CK_COND	0x20
1140 #define	AP_OFFLINE	0x60
1141 	u_int8_t features;
1142 	u_int8_t sector_count;
1143 	u_int8_t lba_low;
1144 	u_int8_t lba_mid;
1145 	u_int8_t lba_high;
1146 	u_int8_t device;
1147 	u_int8_t command;
1148 	u_int8_t reserved;
1149 	u_int8_t control;
1150 };
1151 
1152 struct scsi_maintenance_in
1153 {
1154         uint8_t  opcode;
1155         uint8_t  byte2;
1156 #define SERVICE_ACTION_MASK  0x1f
1157 #define SA_RPRT_TRGT_GRP     0x0a
1158         uint8_t  reserved[4];
1159 	uint8_t  length[4];
1160 	uint8_t  reserved1;
1161 	uint8_t  control;
1162 };
1163 
1164 struct scsi_report_supported_opcodes
1165 {
1166         uint8_t  opcode;
1167         uint8_t  service_action;
1168         uint8_t  options;
1169 #define RSO_RCTD		0x80
1170 #define RSO_OPTIONS_MASK	0x07
1171 #define RSO_OPTIONS_ALL		0x00
1172 #define RSO_OPTIONS_OC		0x01
1173 #define RSO_OPTIONS_OC_SA	0x02
1174         uint8_t  requested_opcode;
1175         uint8_t  requested_service_action[2];
1176 	uint8_t  length[4];
1177 	uint8_t  reserved1;
1178 	uint8_t  control;
1179 };
1180 
1181 struct scsi_report_supported_opcodes_timeout
1182 {
1183 	uint8_t  length[2];
1184 	uint8_t  reserved;
1185 	uint8_t  cmd_specific;
1186 	uint8_t  nominal_time[4];
1187 	uint8_t  recommended_time[4];
1188 };
1189 
1190 struct scsi_report_supported_opcodes_descr
1191 {
1192 	uint8_t  opcode;
1193 	uint8_t  reserved;
1194 	uint8_t  service_action[2];
1195 	uint8_t  reserved2;
1196 	uint8_t  flags;
1197 #define RSO_SERVACTV		0x01
1198 #define RSO_CTDP		0x02
1199 	uint8_t  cdb_length[2];
1200 	struct scsi_report_supported_opcodes_timeout timeout[0];
1201 };
1202 
1203 struct scsi_report_supported_opcodes_all
1204 {
1205 	uint8_t  length[4];
1206 	struct scsi_report_supported_opcodes_descr descr[0];
1207 };
1208 
1209 struct scsi_report_supported_opcodes_one
1210 {
1211 	uint8_t  reserved;
1212 	uint8_t  support;
1213 #define RSO_ONE_CTDP		0x80
1214 	uint8_t  cdb_length[2];
1215 	uint8_t  cdb_usage[];
1216 };
1217 
1218 struct scsi_report_supported_tmf
1219 {
1220 	uint8_t  opcode;
1221 	uint8_t  service_action;
1222 	uint8_t  reserved[4];
1223 	uint8_t  length[4];
1224 	uint8_t  reserved1;
1225 	uint8_t  control;
1226 };
1227 
1228 struct scsi_report_supported_tmf_data
1229 {
1230 	uint8_t  byte1;
1231 #define RST_WAKES		0x01
1232 #define RST_TRS			0x02
1233 #define RST_QTS			0x04
1234 #define RST_LURS		0x08
1235 #define RST_CTSS		0x10
1236 #define RST_CACAS		0x20
1237 #define RST_ATSS		0x40
1238 #define RST_ATS			0x80
1239 	uint8_t  byte2;
1240 #define RST_ITNRS		0x01
1241 #define RST_QTSS		0x02
1242 #define RST_QAES		0x04
1243 	uint8_t  reserved[2];
1244 };
1245 
1246 struct scsi_report_timestamp
1247 {
1248 	uint8_t  opcode;
1249 	uint8_t  service_action;
1250 	uint8_t  reserved[4];
1251 	uint8_t  length[4];
1252 	uint8_t  reserved1;
1253 	uint8_t  control;
1254 };
1255 
1256 struct scsi_report_timestamp_data
1257 {
1258 	uint8_t  length[2];
1259 	uint8_t  origin;
1260 #define RTS_ORIG_MASK		0x00
1261 #define RTS_ORIG_ZERO		0x00
1262 #define RTS_ORIG_SET		0x02
1263 #define RTS_ORIG_OUTSIDE	0x03
1264 	uint8_t  reserved;
1265 	uint8_t  timestamp[6];
1266 	uint8_t  reserve2[2];
1267 };
1268 
1269 struct scsi_receive_copy_status_lid1
1270 {
1271 	uint8_t  opcode;
1272 	uint8_t  service_action;
1273 #define RCS_RCS_LID1		0x00
1274 	uint8_t  list_identifier;
1275 	uint8_t  reserved[7];
1276 	uint8_t  length[4];
1277 	uint8_t  reserved1;
1278 	uint8_t  control;
1279 };
1280 
1281 struct scsi_receive_copy_status_lid1_data
1282 {
1283 	uint8_t  available_data[4];
1284 	uint8_t  copy_command_status;
1285 #define RCS_CCS_INPROG		0x00
1286 #define RCS_CCS_COMPLETED	0x01
1287 #define RCS_CCS_ERROR		0x02
1288 	uint8_t  segments_processed[2];
1289 	uint8_t  transfer_count_units;
1290 #define RCS_TC_BYTES		0x00
1291 #define RCS_TC_KBYTES		0x01
1292 #define RCS_TC_MBYTES		0x02
1293 #define RCS_TC_GBYTES		0x03
1294 #define RCS_TC_TBYTES		0x04
1295 #define RCS_TC_PBYTES		0x05
1296 #define RCS_TC_EBYTES		0x06
1297 #define RCS_TC_LBAS		0xf1
1298 	uint8_t  transfer_count[4];
1299 };
1300 
1301 struct scsi_receive_copy_failure_details
1302 {
1303 	uint8_t  opcode;
1304 	uint8_t  service_action;
1305 #define RCS_RCFD		0x04
1306 	uint8_t  list_identifier;
1307 	uint8_t  reserved[7];
1308 	uint8_t  length[4];
1309 	uint8_t  reserved1;
1310 	uint8_t  control;
1311 };
1312 
1313 struct scsi_receive_copy_failure_details_data
1314 {
1315 	uint8_t  available_data[4];
1316 	uint8_t  reserved[52];
1317 	uint8_t  copy_command_status;
1318 	uint8_t  reserved2;
1319 	uint8_t  sense_data_length[2];
1320 	uint8_t  sense_data[];
1321 };
1322 
1323 struct scsi_receive_copy_status_lid4
1324 {
1325 	uint8_t  opcode;
1326 	uint8_t  service_action;
1327 #define RCS_RCS_LID4		0x05
1328 	uint8_t  list_identifier[4];
1329 	uint8_t  reserved[4];
1330 	uint8_t  length[4];
1331 	uint8_t  reserved1;
1332 	uint8_t  control;
1333 };
1334 
1335 struct scsi_receive_copy_status_lid4_data
1336 {
1337 	uint8_t  available_data[4];
1338 	uint8_t  response_to_service_action;
1339 	uint8_t  copy_command_status;
1340 #define RCS_CCS_COMPLETED_PROD	0x03
1341 #define RCS_CCS_COMPLETED_RESID	0x04
1342 #define RCS_CCS_INPROG_FGBG	0x10
1343 #define RCS_CCS_INPROG_FG	0x11
1344 #define RCS_CCS_INPROG_BG	0x12
1345 #define RCS_CCS_ABORTED		0x60
1346 	uint8_t  operation_counter[2];
1347 	uint8_t  estimated_status_update_delay[4];
1348 	uint8_t  extended_copy_completion_status;
1349 	uint8_t  length_of_the_sense_data_field;
1350 	uint8_t  sense_data_length;
1351 	uint8_t  transfer_count_units;
1352 	uint8_t  transfer_count[8];
1353 	uint8_t  segments_processed[2];
1354 	uint8_t  reserved[2];
1355 	uint8_t  sense_data[];
1356 };
1357 
1358 struct scsi_receive_copy_operating_parameters
1359 {
1360 	uint8_t  opcode;
1361 	uint8_t  service_action;
1362 #define RCS_RCOP		0x03
1363 	uint8_t  reserved[8];
1364 	uint8_t  length[4];
1365 	uint8_t  reserved1;
1366 	uint8_t  control;
1367 };
1368 
1369 struct scsi_receive_copy_operating_parameters_data
1370 {
1371 	uint8_t  length[4];
1372 	uint8_t  snlid;
1373 #define RCOP_SNLID		0x01
1374 	uint8_t  reserved[3];
1375 	uint8_t  maximum_cscd_descriptor_count[2];
1376 	uint8_t  maximum_segment_descriptor_count[2];
1377 	uint8_t  maximum_descriptor_list_length[4];
1378 	uint8_t  maximum_segment_length[4];
1379 	uint8_t  maximum_inline_data_length[4];
1380 	uint8_t  held_data_limit[4];
1381 	uint8_t  maximum_stream_device_transfer_size[4];
1382 	uint8_t  reserved2[2];
1383 	uint8_t  total_concurrent_copies[2];
1384 	uint8_t  maximum_concurrent_copies;
1385 	uint8_t  data_segment_granularity;
1386 	uint8_t  inline_data_granularity;
1387 	uint8_t  held_data_granularity;
1388 	uint8_t  reserved3[3];
1389 	uint8_t  implemented_descriptor_list_length;
1390 	uint8_t  list_of_implemented_descriptor_type_codes[0];
1391 };
1392 
1393 struct scsi_extended_copy
1394 {
1395 	uint8_t  opcode;
1396 	uint8_t  service_action;
1397 #define EC_EC_LID1		0x00
1398 #define EC_EC_LID4		0x01
1399 	uint8_t  reserved[8];
1400 	uint8_t  length[4];
1401 	uint8_t  reserved1;
1402 	uint8_t  control;
1403 };
1404 
1405 struct scsi_ec_cscd_dtsp
1406 {
1407 	uint8_t  flags;
1408 #define EC_CSCD_FIXED		0x01
1409 #define EC_CSCD_PAD		0x04
1410 	uint8_t  block_length[3];
1411 };
1412 
1413 struct scsi_ec_cscd
1414 {
1415 	uint8_t  type_code;
1416 #define EC_CSCD_EXT		0xff
1417 	uint8_t  luidt_pdt;
1418 #define EC_LUIDT_MASK		0xc0
1419 #define EC_LUIDT_LUN		0x00
1420 #define EC_LUIDT_PROXY_TOKEN	0x40
1421 	uint8_t  relative_initiator_port[2];
1422 	uint8_t  cscd_params[24];
1423 	struct scsi_ec_cscd_dtsp dtsp;
1424 };
1425 
1426 struct scsi_ec_cscd_id
1427 {
1428 	uint8_t  type_code;
1429 #define EC_CSCD_ID		0xe4
1430 	uint8_t  luidt_pdt;
1431 	uint8_t  relative_initiator_port[2];
1432 	uint8_t  codeset;
1433 	uint8_t  id_type;
1434 	uint8_t  reserved;
1435 	uint8_t  length;
1436 	uint8_t  designator[20];
1437 	struct scsi_ec_cscd_dtsp dtsp;
1438 };
1439 
1440 struct scsi_ec_segment
1441 {
1442 	uint8_t  type_code;
1443 	uint8_t  flags;
1444 #define EC_SEG_DC		0x02
1445 #define EC_SEG_CAT		0x01
1446 	uint8_t  descr_length[2];
1447 	uint8_t  params[];
1448 };
1449 
1450 struct scsi_ec_segment_b2b
1451 {
1452 	uint8_t  type_code;
1453 #define EC_SEG_B2B		0x02
1454 	uint8_t  flags;
1455 	uint8_t  descr_length[2];
1456 	uint8_t  src_cscd[2];
1457 	uint8_t  dst_cscd[2];
1458 	uint8_t  reserved[2];
1459 	uint8_t  number_of_blocks[2];
1460 	uint8_t  src_lba[8];
1461 	uint8_t  dst_lba[8];
1462 };
1463 
1464 struct scsi_ec_segment_verify
1465 {
1466 	uint8_t  type_code;
1467 #define EC_SEG_VERIFY		0x07
1468 	uint8_t  reserved;
1469 	uint8_t  descr_length[2];
1470 	uint8_t  src_cscd[2];
1471 	uint8_t  reserved2[2];
1472 	uint8_t  tur;
1473 	uint8_t  reserved3[3];
1474 };
1475 
1476 struct scsi_ec_segment_register_key
1477 {
1478 	uint8_t  type_code;
1479 #define EC_SEG_REGISTER_KEY	0x14
1480 	uint8_t  reserved;
1481 	uint8_t  descr_length[2];
1482 	uint8_t  reserved2[2];
1483 	uint8_t  dst_cscd[2];
1484 	uint8_t  res_key[8];
1485 	uint8_t  sa_res_key[8];
1486 	uint8_t  reserved3[4];
1487 };
1488 
1489 struct scsi_extended_copy_lid1_data
1490 {
1491 	uint8_t  list_identifier;
1492 	uint8_t  flags;
1493 #define EC_PRIORITY		0x07
1494 #define EC_LIST_ID_USAGE_MASK	0x18
1495 #define EC_LIST_ID_USAGE_FULL	0x08
1496 #define EC_LIST_ID_USAGE_NOHOLD	0x10
1497 #define EC_LIST_ID_USAGE_NONE	0x18
1498 #define EC_STR			0x20
1499 	uint8_t  cscd_list_length[2];
1500 	uint8_t  reserved[4];
1501 	uint8_t  segment_list_length[4];
1502 	uint8_t  inline_data_length[4];
1503 	uint8_t  data[];
1504 };
1505 
1506 struct scsi_extended_copy_lid4_data
1507 {
1508 	uint8_t  list_format;
1509 #define EC_LIST_FORMAT		0x01
1510 	uint8_t  flags;
1511 	uint8_t  header_cscd_list_length[2];
1512 	uint8_t  reserved[11];
1513 	uint8_t  flags2;
1514 #define EC_IMMED		0x01
1515 #define EC_G_SENSE		0x02
1516 	uint8_t  header_cscd_type_code;
1517 	uint8_t  reserved2[3];
1518 	uint8_t  list_identifier[4];
1519 	uint8_t  reserved3[18];
1520 	uint8_t  cscd_list_length[2];
1521 	uint8_t  segment_list_length[2];
1522 	uint8_t  inline_data_length[2];
1523 	uint8_t  data[];
1524 };
1525 
1526 struct scsi_copy_operation_abort
1527 {
1528 	uint8_t  opcode;
1529 	uint8_t  service_action;
1530 #define EC_COA			0x1c
1531 	uint8_t  list_identifier[4];
1532 	uint8_t  reserved[9];
1533 	uint8_t  control;
1534 };
1535 
1536 struct ata_pass_16 {
1537 	u_int8_t opcode;
1538 	u_int8_t protocol;
1539 #define	AP_EXTEND	0x01
1540 	u_int8_t flags;
1541 #define	AP_FLAG_TLEN_NO_DATA	(0 << 0)
1542 #define	AP_FLAG_TLEN_FEAT	(1 << 0)
1543 #define	AP_FLAG_TLEN_SECT_CNT	(2 << 0)
1544 #define	AP_FLAG_TLEN_STPSIU	(3 << 0)
1545 #define	AP_FLAG_BYT_BLOK_BYTES	(0 << 2)
1546 #define	AP_FLAG_BYT_BLOK_BLOCKS	(1 << 2)
1547 #define	AP_FLAG_TDIR_TO_DEV	(0 << 3)
1548 #define	AP_FLAG_TDIR_FROM_DEV	(1 << 3)
1549 #define	AP_FLAG_CHK_COND	(1 << 5)
1550 	u_int8_t features_ext;
1551 	u_int8_t features;
1552 	u_int8_t sector_count_ext;
1553 	u_int8_t sector_count;
1554 	u_int8_t lba_low_ext;
1555 	u_int8_t lba_low;
1556 	u_int8_t lba_mid_ext;
1557 	u_int8_t lba_mid;
1558 	u_int8_t lba_high_ext;
1559 	u_int8_t lba_high;
1560 	u_int8_t device;
1561 	u_int8_t command;
1562 	u_int8_t control;
1563 };
1564 
1565 #define	SC_SCSI_1 0x01
1566 #define	SC_SCSI_2 0x03
1567 
1568 /*
1569  * Opcodes
1570  */
1571 
1572 #define	TEST_UNIT_READY		0x00
1573 #define	REQUEST_SENSE		0x03
1574 #define	READ_6			0x08
1575 #define	WRITE_6			0x0A
1576 #define	INQUIRY			0x12
1577 #define	MODE_SELECT_6		0x15
1578 #define	MODE_SENSE_6		0x1A
1579 #define	START_STOP_UNIT		0x1B
1580 #define	START_STOP		0x1B
1581 #define	RESERVE      		0x16
1582 #define	RELEASE      		0x17
1583 #define	RECEIVE_DIAGNOSTIC	0x1C
1584 #define	SEND_DIAGNOSTIC		0x1D
1585 #define	PREVENT_ALLOW		0x1E
1586 #define	READ_CAPACITY		0x25
1587 #define	READ_10			0x28
1588 #define	WRITE_10		0x2A
1589 #define	POSITION_TO_ELEMENT	0x2B
1590 #define	WRITE_VERIFY_10		0x2E
1591 #define	VERIFY_10		0x2F
1592 #define	SYNCHRONIZE_CACHE	0x35
1593 #define	READ_DEFECT_DATA_10	0x37
1594 #define	WRITE_BUFFER            0x3B
1595 #define	READ_BUFFER             0x3C
1596 #define	CHANGE_DEFINITION	0x40
1597 #define	WRITE_SAME_10		0x41
1598 #define	UNMAP			0x42
1599 #define	LOG_SELECT		0x4C
1600 #define	LOG_SENSE		0x4D
1601 #define	MODE_SELECT_10		0x55
1602 #define	RESERVE_10		0x56
1603 #define	RELEASE_10		0x57
1604 #define	MODE_SENSE_10		0x5A
1605 #define	PERSISTENT_RES_IN	0x5E
1606 #define	PERSISTENT_RES_OUT	0x5F
1607 #define	EXTENDED_COPY		0x83
1608 #define	RECEIVE_COPY_STATUS	0x84
1609 #define	ATA_PASS_16		0x85
1610 #define	READ_16			0x88
1611 #define	COMPARE_AND_WRITE	0x89
1612 #define	WRITE_16		0x8A
1613 #define	WRITE_VERIFY_16		0x8E
1614 #define	VERIFY_16		0x8F
1615 #define	SYNCHRONIZE_CACHE_16	0x91
1616 #define	WRITE_SAME_16		0x93
1617 #define	SERVICE_ACTION_IN	0x9E
1618 #define	REPORT_LUNS		0xA0
1619 #define	ATA_PASS_12		0xA1
1620 #define	MAINTENANCE_IN		0xA3
1621 #define	MAINTENANCE_OUT		0xA4
1622 #define	MOVE_MEDIUM     	0xA5
1623 #define	READ_12			0xA8
1624 #define	WRITE_12		0xAA
1625 #define	WRITE_VERIFY_12		0xAE
1626 #define	VERIFY_12		0xAF
1627 #define	READ_ELEMENT_STATUS	0xB8
1628 #define	READ_CD			0xBE
1629 
1630 /* Maintenance In Service Action Codes */
1631 #define	REPORT_IDENTIFYING_INFRMATION		0x05
1632 #define	REPORT_TARGET_PORT_GROUPS		0x0A
1633 #define	REPORT_ALIASES				0x0B
1634 #define	REPORT_SUPPORTED_OPERATION_CODES	0x0C
1635 #define	REPORT_SUPPORTED_TASK_MANAGEMENT_FUNCTIONS	0x0D
1636 #define	REPORT_PRIORITY				0x0E
1637 #define	REPORT_TIMESTAMP			0x0F
1638 #define	MANAGEMENT_PROTOCOL_IN			0x10
1639 /* Maintenance Out Service Action Codes */
1640 #define	SET_IDENTIFY_INFORMATION		0x06
1641 #define	SET_TARGET_PORT_GROUPS			0x0A
1642 #define	CHANGE_ALIASES				0x0B
1643 #define	SET_PRIORITY				0x0E
1644 #define	SET_TIMESTAMP				0x0F
1645 #define	MANGAEMENT_PROTOCOL_OUT			0x10
1646 
1647 /*
1648  * Device Types
1649  */
1650 #define	T_DIRECT	0x00
1651 #define	T_SEQUENTIAL	0x01
1652 #define	T_PRINTER	0x02
1653 #define	T_PROCESSOR	0x03
1654 #define	T_WORM		0x04
1655 #define	T_CDROM		0x05
1656 #define	T_SCANNER	0x06
1657 #define	T_OPTICAL 	0x07
1658 #define	T_CHANGER	0x08
1659 #define	T_COMM		0x09
1660 #define	T_ASC0		0x0a
1661 #define	T_ASC1		0x0b
1662 #define	T_STORARRAY	0x0c
1663 #define	T_ENCLOSURE	0x0d
1664 #define	T_RBC		0x0e
1665 #define	T_OCRW		0x0f
1666 #define	T_OSD		0x11
1667 #define	T_ADC		0x12
1668 #define	T_NODEVICE	0x1f
1669 #define	T_ANY		0xff	/* Used in Quirk table matches */
1670 
1671 #define	T_REMOV		1
1672 #define	T_FIXED		0
1673 
1674 /*
1675  * This length is the initial inquiry length used by the probe code, as
1676  * well as the length necessary for scsi_print_inquiry() to function
1677  * correctly.  If either use requires a different length in the future,
1678  * the two values should be de-coupled.
1679  */
1680 #define	SHORT_INQUIRY_LENGTH	36
1681 
1682 struct scsi_inquiry_data
1683 {
1684 	u_int8_t device;
1685 #define	SID_TYPE(inq_data) ((inq_data)->device & 0x1f)
1686 #define	SID_QUAL(inq_data) (((inq_data)->device & 0xE0) >> 5)
1687 #define	SID_QUAL_LU_CONNECTED	0x00	/*
1688 					 * The specified peripheral device
1689 					 * type is currently connected to
1690 					 * logical unit.  If the target cannot
1691 					 * determine whether or not a physical
1692 					 * device is currently connected, it
1693 					 * shall also use this peripheral
1694 					 * qualifier when returning the INQUIRY
1695 					 * data.  This peripheral qualifier
1696 					 * does not mean that the device is
1697 					 * ready for access by the initiator.
1698 					 */
1699 #define	SID_QUAL_LU_OFFLINE	0x01	/*
1700 					 * The target is capable of supporting
1701 					 * the specified peripheral device type
1702 					 * on this logical unit; however, the
1703 					 * physical device is not currently
1704 					 * connected to this logical unit.
1705 					 */
1706 #define	SID_QUAL_RSVD		0x02
1707 #define	SID_QUAL_BAD_LU		0x03	/*
1708 					 * The target is not capable of
1709 					 * supporting a physical device on
1710 					 * this logical unit. For this
1711 					 * peripheral qualifier the peripheral
1712 					 * device type shall be set to 1Fh to
1713 					 * provide compatibility with previous
1714 					 * versions of SCSI. All other
1715 					 * peripheral device type values are
1716 					 * reserved for this peripheral
1717 					 * qualifier.
1718 					 */
1719 #define	SID_QUAL_IS_VENDOR_UNIQUE(inq_data) ((SID_QUAL(inq_data) & 0x08) != 0)
1720 	u_int8_t dev_qual2;
1721 #define	SID_QUAL2	0x7F
1722 #define	SID_LU_CONG	0x40
1723 #define	SID_RMB		0x80
1724 #define	SID_IS_REMOVABLE(inq_data) (((inq_data)->dev_qual2 & SID_RMB) != 0)
1725 	u_int8_t version;
1726 #define	SID_ANSI_REV(inq_data) ((inq_data)->version & 0x07)
1727 #define		SCSI_REV_0		0
1728 #define		SCSI_REV_CCS		1
1729 #define		SCSI_REV_2		2
1730 #define		SCSI_REV_SPC		3
1731 #define		SCSI_REV_SPC2		4
1732 #define		SCSI_REV_SPC3		5
1733 #define		SCSI_REV_SPC4		6
1734 
1735 #define	SID_ECMA	0x38
1736 #define	SID_ISO		0xC0
1737 	u_int8_t response_format;
1738 #define	SID_AENC	0x80
1739 #define	SID_TrmIOP	0x40
1740 #define	SID_NormACA	0x20
1741 #define	SID_HiSup	0x10
1742 	u_int8_t additional_length;
1743 #define	SID_ADDITIONAL_LENGTH(iqd)					\
1744 	((iqd)->additional_length +					\
1745 	__offsetof(struct scsi_inquiry_data, additional_length) + 1)
1746 	u_int8_t spc3_flags;
1747 #define	SPC3_SID_PROTECT	0x01
1748 #define	SPC3_SID_3PC		0x08
1749 #define	SPC3_SID_TPGS_MASK	0x30
1750 #define	SPC3_SID_TPGS_IMPLICIT	0x10
1751 #define	SPC3_SID_TPGS_EXPLICIT	0x20
1752 #define	SPC3_SID_ACC		0x40
1753 #define	SPC3_SID_SCCS		0x80
1754 	u_int8_t spc2_flags;
1755 #define	SPC2_SID_ADDR16		0x01
1756 #define	SPC2_SID_MChngr 	0x08
1757 #define	SPC2_SID_MultiP 	0x10
1758 #define	SPC2_SID_EncServ	0x40
1759 #define	SPC2_SID_BQueue		0x80
1760 
1761 #define	INQ_DATA_TQ_ENABLED(iqd)				\
1762     ((SID_ANSI_REV(iqd) < SCSI_REV_SPC2)? ((iqd)->flags & SID_CmdQue) :	\
1763     (((iqd)->flags & SID_CmdQue) && !((iqd)->spc2_flags & SPC2_SID_BQueue)) || \
1764     (!((iqd)->flags & SID_CmdQue) && ((iqd)->spc2_flags & SPC2_SID_BQueue)))
1765 
1766 	u_int8_t flags;
1767 #define	SID_SftRe	0x01
1768 #define	SID_CmdQue	0x02
1769 #define	SID_Linked	0x08
1770 #define	SID_Sync	0x10
1771 #define	SID_WBus16	0x20
1772 #define	SID_WBus32	0x40
1773 #define	SID_RelAdr	0x80
1774 #define	SID_VENDOR_SIZE   8
1775 	char	 vendor[SID_VENDOR_SIZE];
1776 #define	SID_PRODUCT_SIZE  16
1777 	char	 product[SID_PRODUCT_SIZE];
1778 #define	SID_REVISION_SIZE 4
1779 	char	 revision[SID_REVISION_SIZE];
1780 	/*
1781 	 * The following fields were taken from SCSI Primary Commands - 2
1782 	 * (SPC-2) Revision 14, Dated 11 November 1999
1783 	 */
1784 #define	SID_VENDOR_SPECIFIC_0_SIZE	20
1785 	u_int8_t vendor_specific0[SID_VENDOR_SPECIFIC_0_SIZE];
1786 	/*
1787 	 * An extension of SCSI Parallel Specific Values
1788 	 */
1789 #define	SID_SPI_IUS		0x01
1790 #define	SID_SPI_QAS		0x02
1791 #define	SID_SPI_CLOCK_ST	0x00
1792 #define	SID_SPI_CLOCK_DT	0x04
1793 #define	SID_SPI_CLOCK_DT_ST	0x0C
1794 #define	SID_SPI_MASK		0x0F
1795 	u_int8_t spi3data;
1796 	u_int8_t reserved2;
1797 	/*
1798 	 * Version Descriptors, stored 2 byte values.
1799 	 */
1800 	u_int8_t version1[2];
1801 	u_int8_t version2[2];
1802 	u_int8_t version3[2];
1803 	u_int8_t version4[2];
1804 	u_int8_t version5[2];
1805 	u_int8_t version6[2];
1806 	u_int8_t version7[2];
1807 	u_int8_t version8[2];
1808 
1809 	u_int8_t reserved3[22];
1810 
1811 #define	SID_VENDOR_SPECIFIC_1_SIZE	160
1812 	u_int8_t vendor_specific1[SID_VENDOR_SPECIFIC_1_SIZE];
1813 };
1814 
1815 /*
1816  * This structure is more suited to initiator operation, because the
1817  * maximum number of supported pages is already allocated.
1818  */
1819 struct scsi_vpd_supported_page_list
1820 {
1821 	u_int8_t device;
1822 	u_int8_t page_code;
1823 #define	SVPD_SUPPORTED_PAGE_LIST	0x00
1824 #define	SVPD_SUPPORTED_PAGES_HDR_LEN	4
1825 	u_int8_t reserved;
1826 	u_int8_t length;	/* number of VPD entries */
1827 #define	SVPD_SUPPORTED_PAGES_SIZE	251
1828 	u_int8_t list[SVPD_SUPPORTED_PAGES_SIZE];
1829 };
1830 
1831 /*
1832  * This structure is more suited to target operation, because the
1833  * number of supported pages is left to the user to allocate.
1834  */
1835 struct scsi_vpd_supported_pages
1836 {
1837 	u_int8_t device;
1838 	u_int8_t page_code;
1839 	u_int8_t reserved;
1840 #define	SVPD_SUPPORTED_PAGES	0x00
1841 	u_int8_t length;
1842 	u_int8_t page_list[0];
1843 };
1844 
1845 
1846 struct scsi_vpd_unit_serial_number
1847 {
1848 	u_int8_t device;
1849 	u_int8_t page_code;
1850 #define	SVPD_UNIT_SERIAL_NUMBER	0x80
1851 	u_int8_t reserved;
1852 	u_int8_t length; /* serial number length */
1853 #define	SVPD_SERIAL_NUM_SIZE 251
1854 	u_int8_t serial_num[SVPD_SERIAL_NUM_SIZE];
1855 };
1856 
1857 struct scsi_vpd_device_id
1858 {
1859 	u_int8_t device;
1860 	u_int8_t page_code;
1861 #define	SVPD_DEVICE_ID			0x83
1862 #define	SVPD_DEVICE_ID_MAX_SIZE		252
1863 #define	SVPD_DEVICE_ID_HDR_LEN \
1864     __offsetof(struct scsi_vpd_device_id, desc_list)
1865 	u_int8_t length[2];
1866 	u_int8_t desc_list[];
1867 };
1868 
1869 struct scsi_vpd_id_descriptor
1870 {
1871 	u_int8_t	proto_codeset;
1872 	/*
1873 	 * See the SCSI_PROTO definitions above for the protocols.
1874 	 */
1875 #define	SVPD_ID_PROTO_SHIFT	4
1876 #define	SVPD_ID_CODESET_BINARY	0x01
1877 #define	SVPD_ID_CODESET_ASCII	0x02
1878 #define	SVPD_ID_CODESET_UTF8	0x03
1879 #define	SVPD_ID_CODESET_MASK	0x0f
1880 	u_int8_t	id_type;
1881 #define	SVPD_ID_PIV		0x80
1882 #define	SVPD_ID_ASSOC_LUN	0x00
1883 #define	SVPD_ID_ASSOC_PORT	0x10
1884 #define	SVPD_ID_ASSOC_TARGET	0x20
1885 #define	SVPD_ID_ASSOC_MASK	0x30
1886 #define	SVPD_ID_TYPE_VENDOR	0x00
1887 #define	SVPD_ID_TYPE_T10	0x01
1888 #define	SVPD_ID_TYPE_EUI64	0x02
1889 #define	SVPD_ID_TYPE_NAA	0x03
1890 #define	SVPD_ID_TYPE_RELTARG	0x04
1891 #define	SVPD_ID_TYPE_TPORTGRP	0x05
1892 #define	SVPD_ID_TYPE_LUNGRP	0x06
1893 #define	SVPD_ID_TYPE_MD5_LUN_ID	0x07
1894 #define	SVPD_ID_TYPE_SCSI_NAME	0x08
1895 #define	SVPD_ID_TYPE_MASK	0x0f
1896 	u_int8_t	reserved;
1897 	u_int8_t	length;
1898 #define	SVPD_DEVICE_ID_DESC_HDR_LEN \
1899     __offsetof(struct scsi_vpd_id_descriptor, identifier)
1900 	u_int8_t	identifier[];
1901 };
1902 
1903 struct scsi_vpd_id_t10
1904 {
1905 	u_int8_t	vendor[8];
1906 	u_int8_t	vendor_spec_id[0];
1907 };
1908 
1909 struct scsi_vpd_id_eui64
1910 {
1911 	u_int8_t	ieee_company_id[3];
1912 	u_int8_t	extension_id[5];
1913 };
1914 
1915 struct scsi_vpd_id_naa_basic
1916 {
1917 	uint8_t naa;
1918 	/* big endian, packed:
1919 	uint8_t	naa : 4;
1920 	uint8_t naa_desig : 4;
1921 	*/
1922 #define	SVPD_ID_NAA_NAA_SHIFT		4
1923 #define	SVPD_ID_NAA_IEEE_EXT		0x02
1924 #define	SVPD_ID_NAA_LOCAL_REG		0x03
1925 #define	SVPD_ID_NAA_IEEE_REG		0x05
1926 #define	SVPD_ID_NAA_IEEE_REG_EXT	0x06
1927 	uint8_t	naa_data[];
1928 };
1929 
1930 struct scsi_vpd_id_naa_ieee_extended_id
1931 {
1932 	uint8_t naa;
1933 	uint8_t vendor_specific_id_a;
1934 	uint8_t ieee_company_id[3];
1935 	uint8_t vendor_specific_id_b[4];
1936 };
1937 
1938 struct scsi_vpd_id_naa_local_reg
1939 {
1940 	uint8_t naa;
1941 	uint8_t local_value[7];
1942 };
1943 
1944 struct scsi_vpd_id_naa_ieee_reg
1945 {
1946 	uint8_t naa;
1947 	uint8_t reg_value[7];
1948 	/* big endian, packed:
1949 	uint8_t naa_basic : 4;
1950 	uint8_t ieee_company_id_0 : 4;
1951 	uint8_t ieee_company_id_1[2];
1952 	uint8_t ieee_company_id_2 : 4;
1953 	uint8_t vendor_specific_id_0 : 4;
1954 	uint8_t vendor_specific_id_1[4];
1955 	*/
1956 };
1957 
1958 struct scsi_vpd_id_naa_ieee_reg_extended
1959 {
1960 	uint8_t naa;
1961 	uint8_t reg_value[15];
1962 	/* big endian, packed:
1963 	uint8_t naa_basic : 4;
1964 	uint8_t ieee_company_id_0 : 4;
1965 	uint8_t ieee_company_id_1[2];
1966 	uint8_t ieee_company_id_2 : 4;
1967 	uint8_t vendor_specific_id_0 : 4;
1968 	uint8_t vendor_specific_id_1[4];
1969 	uint8_t vendor_specific_id_ext[8];
1970 	*/
1971 };
1972 
1973 struct scsi_vpd_id_rel_trgt_port_id
1974 {
1975 	uint8_t obsolete[2];
1976 	uint8_t rel_trgt_port_id[2];
1977 };
1978 
1979 struct scsi_vpd_id_trgt_port_grp_id
1980 {
1981 	uint8_t reserved[2];
1982 	uint8_t trgt_port_grp[2];
1983 };
1984 
1985 struct scsi_vpd_id_lun_grp_id
1986 {
1987 	uint8_t reserved[2];
1988 	uint8_t log_unit_grp[2];
1989 };
1990 
1991 struct scsi_vpd_id_md5_lun_id
1992 {
1993 	uint8_t lun_id[16];
1994 };
1995 
1996 struct scsi_vpd_id_scsi_name
1997 {
1998 	uint8_t name_string[256];
1999 };
2000 
2001 struct scsi_service_action_in
2002 {
2003 	uint8_t opcode;
2004 	uint8_t service_action;
2005 	uint8_t action_dependent[13];
2006 	uint8_t control;
2007 };
2008 
2009 struct scsi_diag_page {
2010 	uint8_t page_code;
2011 	uint8_t page_specific_flags;
2012 	uint8_t length[2];
2013 	uint8_t params[0];
2014 };
2015 
2016 struct scsi_vpd_port_designation
2017 {
2018 	uint8_t reserved[2];
2019 	uint8_t relative_port_id[2];
2020 	uint8_t reserved2[2];
2021 	uint8_t initiator_transportid_length[2];
2022 	uint8_t initiator_transportid[0];
2023 };
2024 
2025 struct scsi_vpd_port_designation_cont
2026 {
2027 	uint8_t reserved[2];
2028 	uint8_t target_port_descriptors_length[2];
2029 	struct scsi_vpd_id_descriptor target_port_descriptors[0];
2030 };
2031 
2032 struct scsi_vpd_scsi_ports
2033 {
2034 	u_int8_t device;
2035 	u_int8_t page_code;
2036 #define	SVPD_SCSI_PORTS		0x88
2037 	u_int8_t page_length[2];
2038 	struct scsi_vpd_port_designation design[];
2039 };
2040 
2041 /*
2042  * ATA Information VPD Page based on
2043  * T10/2126-D Revision 04
2044  */
2045 #define SVPD_ATA_INFORMATION		0x89
2046 
2047 
2048 struct scsi_vpd_tpc_descriptor
2049 {
2050 	uint8_t desc_type[2];
2051 	uint8_t desc_length[2];
2052 	uint8_t parameters[];
2053 };
2054 
2055 struct scsi_vpd_tpc_descriptor_sc_descr
2056 {
2057 	uint8_t opcode;
2058 	uint8_t sa_length;
2059 	uint8_t supported_service_actions[0];
2060 };
2061 
2062 struct scsi_vpd_tpc_descriptor_sc
2063 {
2064 	uint8_t desc_type[2];
2065 #define	SVPD_TPC_SC			0x0001
2066 	uint8_t desc_length[2];
2067 	uint8_t list_length;
2068 	struct scsi_vpd_tpc_descriptor_sc_descr descr[];
2069 };
2070 
2071 struct scsi_vpd_tpc_descriptor_pd
2072 {
2073 	uint8_t desc_type[2];
2074 #define	SVPD_TPC_PD			0x0004
2075 	uint8_t desc_length[2];
2076 	uint8_t reserved[4];
2077 	uint8_t maximum_cscd_descriptor_count[2];
2078 	uint8_t maximum_segment_descriptor_count[2];
2079 	uint8_t maximum_descriptor_list_length[4];
2080 	uint8_t maximum_inline_data_length[4];
2081 	uint8_t reserved2[12];
2082 };
2083 
2084 struct scsi_vpd_tpc_descriptor_sd
2085 {
2086 	uint8_t desc_type[2];
2087 #define	SVPD_TPC_SD			0x0008
2088 	uint8_t desc_length[2];
2089 	uint8_t list_length;
2090 	uint8_t supported_descriptor_codes[];
2091 };
2092 
2093 struct scsi_vpd_tpc_descriptor_sdid
2094 {
2095 	uint8_t desc_type[2];
2096 #define	SVPD_TPC_SDID			0x000C
2097 	uint8_t desc_length[2];
2098 	uint8_t list_length[2];
2099 	uint8_t supported_descriptor_ids[];
2100 };
2101 
2102 struct scsi_vpd_tpc_descriptor_gco
2103 {
2104 	uint8_t desc_type[2];
2105 #define	SVPD_TPC_GCO			0x8001
2106 	uint8_t desc_length[2];
2107 	uint8_t total_concurrent_copies[4];
2108 	uint8_t maximum_identified_concurrent_copies[4];
2109 	uint8_t maximum_segment_length[4];
2110 	uint8_t data_segment_granularity;
2111 	uint8_t inline_data_granularity;
2112 	uint8_t reserved[18];
2113 };
2114 
2115 struct scsi_vpd_tpc
2116 {
2117 	uint8_t device;
2118 	uint8_t page_code;
2119 #define	SVPD_SCSI_TPC			0x8F
2120 	uint8_t page_length[2];
2121 	struct scsi_vpd_tpc_descriptor descr[];
2122 };
2123 
2124 /*
2125  * Block Device Characteristics VPD Page based on
2126  * T10/1799-D Revision 31
2127  */
2128 struct scsi_vpd_block_characteristics
2129 {
2130 	u_int8_t device;
2131 	u_int8_t page_code;
2132 #define SVPD_BDC			0xB1
2133 	u_int8_t page_length[2];
2134 	u_int8_t medium_rotation_rate[2];
2135 #define SVPD_BDC_RATE_NOT_REPORTED	0x00
2136 #define SVPD_BDC_RATE_NON_ROTATING	0x01
2137 	u_int8_t reserved1;
2138 	u_int8_t nominal_form_factor;
2139 #define SVPD_BDC_FORM_NOT_REPORTED	0x00
2140 #define SVPD_BDC_FORM_5_25INCH		0x01
2141 #define SVPD_BDC_FORM_3_5INCH		0x02
2142 #define SVPD_BDC_FORM_2_5INCH		0x03
2143 #define SVPD_BDC_FORM_1_5INCH		0x04
2144 #define SVPD_BDC_FORM_LESSTHAN_1_5INCH	0x05
2145 	u_int8_t reserved2[56];
2146 };
2147 
2148 /*
2149  * Logical Block Provisioning VPD Page based on
2150  * T10/1799-D Revision 31
2151  */
2152 struct scsi_vpd_logical_block_prov
2153 {
2154 	u_int8_t device;
2155 	u_int8_t page_code;
2156 #define	SVPD_LBP		0xB2
2157 	u_int8_t page_length[2];
2158 #define SVPD_LBP_PL_BASIC	0x04
2159 	u_int8_t threshold_exponent;
2160 	u_int8_t flags;
2161 #define SVPD_LBP_UNMAP		0x80
2162 #define SVPD_LBP_WS16		0x40
2163 #define SVPD_LBP_WS10		0x20
2164 #define SVPD_LBP_RZ		0x04
2165 #define SVPD_LBP_ANC_SUP	0x02
2166 #define SVPD_LBP_DP		0x01
2167 	u_int8_t prov_type;
2168 #define SVPD_LBP_RESOURCE	0x01
2169 #define SVPD_LBP_THIN		0x02
2170 	u_int8_t reserved;
2171 	/*
2172 	 * Provisioning Group Descriptor can be here if SVPD_LBP_DP is set
2173 	 * Its size can be determined from page_length - 4
2174 	 */
2175 };
2176 
2177 /*
2178  * Block Limits VDP Page based on
2179  * T10/1799-D Revision 31
2180  */
2181 struct scsi_vpd_block_limits
2182 {
2183 	u_int8_t device;
2184 	u_int8_t page_code;
2185 #define	SVPD_BLOCK_LIMITS	0xB0
2186 	u_int8_t page_length[2];
2187 #define SVPD_BL_PL_BASIC	0x10
2188 #define SVPD_BL_PL_TP		0x3C
2189 	u_int8_t reserved1;
2190 	u_int8_t max_cmp_write_len;
2191 	u_int8_t opt_txfer_len_grain[2];
2192 	u_int8_t max_txfer_len[4];
2193 	u_int8_t opt_txfer_len[4];
2194 	u_int8_t max_prefetch[4];
2195 	u_int8_t max_unmap_lba_cnt[4];
2196 	u_int8_t max_unmap_blk_cnt[4];
2197 	u_int8_t opt_unmap_grain[4];
2198 	u_int8_t unmap_grain_align[4];
2199 	u_int8_t max_write_same_length[8];
2200 	u_int8_t reserved2[20];
2201 };
2202 
2203 struct scsi_read_capacity
2204 {
2205 	u_int8_t opcode;
2206 	u_int8_t byte2;
2207 #define	SRC_RELADR	0x01
2208 	u_int8_t addr[4];
2209 	u_int8_t unused[2];
2210 	u_int8_t pmi;
2211 #define	SRC_PMI		0x01
2212 	u_int8_t control;
2213 };
2214 
2215 struct scsi_read_capacity_16
2216 {
2217 	uint8_t opcode;
2218 #define	SRC16_SERVICE_ACTION	0x10
2219 	uint8_t service_action;
2220 	uint8_t addr[8];
2221 	uint8_t alloc_len[4];
2222 #define	SRC16_PMI		0x01
2223 #define	SRC16_RELADR		0x02
2224 	uint8_t reladr;
2225 	uint8_t control;
2226 };
2227 
2228 struct scsi_read_capacity_data
2229 {
2230 	u_int8_t addr[4];
2231 	u_int8_t length[4];
2232 };
2233 
2234 struct scsi_read_capacity_data_long
2235 {
2236 	uint8_t addr[8];
2237 	uint8_t length[4];
2238 #define	SRC16_PROT_EN		0x01
2239 #define	SRC16_P_TYPE		0x0e
2240 #define	SRC16_PTYPE_1		0x00
2241 #define	SRC16_PTYPE_2		0x02
2242 #define	SRC16_PTYPE_3		0x04
2243 	uint8_t prot;
2244 #define	SRC16_LBPPBE		0x0f
2245 #define	SRC16_PI_EXPONENT	0xf0
2246 #define	SRC16_PI_EXPONENT_SHIFT	4
2247 	uint8_t prot_lbppbe;
2248 #define	SRC16_LALBA		0x3f
2249 #define	SRC16_LBPRZ		0x40
2250 #define	SRC16_LBPME		0x80
2251 /*
2252  * Alternate versions of these macros that are intended for use on a 16-bit
2253  * version of the lalba_lbp field instead of the array of 2 8 bit numbers.
2254  */
2255 #define	SRC16_LALBA_A		0x3fff
2256 #define	SRC16_LBPRZ_A		0x4000
2257 #define	SRC16_LBPME_A		0x8000
2258 	uint8_t lalba_lbp[2];
2259 	uint8_t	reserved[16];
2260 };
2261 
2262 struct scsi_report_luns
2263 {
2264 	uint8_t opcode;
2265 	uint8_t reserved1;
2266 #define	RPL_REPORT_DEFAULT	0x00
2267 #define	RPL_REPORT_WELLKNOWN	0x01
2268 #define	RPL_REPORT_ALL		0x02
2269 	uint8_t select_report;
2270 	uint8_t reserved2[3];
2271 	uint8_t length[4];
2272 	uint8_t reserved3;
2273 	uint8_t control;
2274 };
2275 
2276 struct scsi_report_luns_lundata {
2277 	uint8_t lundata[8];
2278 #define	RPL_LUNDATA_PERIPH_BUS_MASK	0x3f
2279 #define	RPL_LUNDATA_FLAT_LUN_MASK	0x3f
2280 #define	RPL_LUNDATA_FLAT_LUN_BITS	0x06
2281 #define	RPL_LUNDATA_LUN_TARG_MASK	0x3f
2282 #define	RPL_LUNDATA_LUN_BUS_MASK	0xe0
2283 #define	RPL_LUNDATA_LUN_LUN_MASK	0x1f
2284 #define	RPL_LUNDATA_EXT_LEN_MASK	0x30
2285 #define	RPL_LUNDATA_EXT_EAM_MASK	0x0f
2286 #define	RPL_LUNDATA_EXT_EAM_WK		0x01
2287 #define	RPL_LUNDATA_EXT_EAM_NOT_SPEC	0x0f
2288 #define	RPL_LUNDATA_ATYP_MASK	0xc0	/* MBZ for type 0 lun */
2289 #define	RPL_LUNDATA_ATYP_PERIPH	0x00
2290 #define	RPL_LUNDATA_ATYP_FLAT	0x40
2291 #define	RPL_LUNDATA_ATYP_LUN	0x80
2292 #define	RPL_LUNDATA_ATYP_EXTLUN	0xc0
2293 };
2294 
2295 struct scsi_report_luns_data {
2296 	u_int8_t length[4];	/* length of LUN inventory, in bytes */
2297 	u_int8_t reserved[4];	/* unused */
2298 	/*
2299 	 * LUN inventory- we only support the type zero form for now.
2300 	 */
2301 	struct scsi_report_luns_lundata luns[0];
2302 };
2303 
2304 struct scsi_target_group
2305 {
2306 	uint8_t opcode;
2307 	uint8_t service_action;
2308 #define	STG_PDF_MASK		0xe0
2309 #define	STG_PDF_LENGTH		0x00
2310 #define	STG_PDF_EXTENDED	0x20
2311 	uint8_t reserved1[4];
2312 	uint8_t length[4];
2313 	uint8_t reserved2;
2314 	uint8_t control;
2315 };
2316 
2317 struct scsi_target_port_descriptor {
2318 	uint8_t	reserved[2];
2319 	uint8_t	relative_target_port_identifier[2];
2320 	uint8_t desc_list[];
2321 };
2322 
2323 struct scsi_target_port_group_descriptor {
2324 	uint8_t	pref_state;
2325 #define	TPG_PRIMARY				0x80
2326 #define	TPG_ASYMMETRIC_ACCESS_STATE_MASK	0xf
2327 #define	TPG_ASYMMETRIC_ACCESS_OPTIMIZED		0x0
2328 #define	TPG_ASYMMETRIC_ACCESS_NONOPTIMIZED	0x1
2329 #define	TPG_ASYMMETRIC_ACCESS_STANDBY		0x2
2330 #define	TPG_ASYMMETRIC_ACCESS_UNAVAILABLE	0x3
2331 #define	TPG_ASYMMETRIC_ACCESS_LBA_DEPENDENT	0x4
2332 #define	TPG_ASYMMETRIC_ACCESS_OFFLINE		0xE
2333 #define	TPG_ASYMMETRIC_ACCESS_TRANSITIONING	0xF
2334 	uint8_t support;
2335 #define	TPG_AO_SUP	0x01
2336 #define	TPG_AN_SUP	0x02
2337 #define	TPG_S_SUP	0x04
2338 #define	TPG_U_SUP	0x08
2339 #define	TPG_LBD_SUP	0x10
2340 #define	TPG_O_SUP	0x40
2341 #define	TPG_T_SUP	0x80
2342 	uint8_t target_port_group[2];
2343 	uint8_t reserved;
2344 	uint8_t status;
2345 #define TPG_UNAVLBL      0
2346 #define TPG_SET_BY_STPG  0x01
2347 #define TPG_IMPLICIT     0x02
2348 	uint8_t vendor_specific;
2349 	uint8_t	target_port_count;
2350 	struct scsi_target_port_descriptor descriptors[];
2351 };
2352 
2353 struct scsi_target_group_data {
2354 	uint8_t length[4];	/* length of returned data, in bytes */
2355 	struct scsi_target_port_group_descriptor groups[];
2356 };
2357 
2358 struct scsi_target_group_data_extended {
2359 	uint8_t length[4];	/* length of returned data, in bytes */
2360 	uint8_t format_type;	/* STG_PDF_LENGTH or STG_PDF_EXTENDED */
2361 	uint8_t	implicit_transition_time;
2362 	uint8_t reserved[2];
2363 	struct scsi_target_port_group_descriptor groups[];
2364 };
2365 
2366 
2367 typedef enum {
2368 	SSD_TYPE_NONE,
2369 	SSD_TYPE_FIXED,
2370 	SSD_TYPE_DESC
2371 } scsi_sense_data_type;
2372 
2373 typedef enum {
2374 	SSD_ELEM_NONE,
2375 	SSD_ELEM_SKIP,
2376 	SSD_ELEM_DESC,
2377 	SSD_ELEM_SKS,
2378 	SSD_ELEM_COMMAND,
2379 	SSD_ELEM_INFO,
2380 	SSD_ELEM_FRU,
2381 	SSD_ELEM_STREAM,
2382 	SSD_ELEM_MAX
2383 } scsi_sense_elem_type;
2384 
2385 
2386 struct scsi_sense_data
2387 {
2388 	uint8_t error_code;
2389 	/*
2390 	 * SPC-4 says that the maximum length of sense data is 252 bytes.
2391 	 * So this structure is exactly 252 bytes log.
2392 	 */
2393 #define	SSD_FULL_SIZE 252
2394 	uint8_t sense_buf[SSD_FULL_SIZE - 1];
2395 	/*
2396 	 * XXX KDM is this still a reasonable minimum size?
2397 	 */
2398 #define	SSD_MIN_SIZE 18
2399 	/*
2400 	 * Maximum value for the extra_len field in the sense data.
2401 	 */
2402 #define	SSD_EXTRA_MAX 244
2403 };
2404 
2405 /*
2406  * Fixed format sense data.
2407  */
2408 struct scsi_sense_data_fixed
2409 {
2410 	u_int8_t error_code;
2411 #define	SSD_ERRCODE			0x7F
2412 #define		SSD_CURRENT_ERROR	0x70
2413 #define		SSD_DEFERRED_ERROR	0x71
2414 #define	SSD_ERRCODE_VALID	0x80
2415 	u_int8_t segment;
2416 	u_int8_t flags;
2417 #define	SSD_KEY				0x0F
2418 #define		SSD_KEY_NO_SENSE	0x00
2419 #define		SSD_KEY_RECOVERED_ERROR	0x01
2420 #define		SSD_KEY_NOT_READY	0x02
2421 #define		SSD_KEY_MEDIUM_ERROR	0x03
2422 #define		SSD_KEY_HARDWARE_ERROR	0x04
2423 #define		SSD_KEY_ILLEGAL_REQUEST	0x05
2424 #define		SSD_KEY_UNIT_ATTENTION	0x06
2425 #define		SSD_KEY_DATA_PROTECT	0x07
2426 #define		SSD_KEY_BLANK_CHECK	0x08
2427 #define		SSD_KEY_Vendor_Specific	0x09
2428 #define		SSD_KEY_COPY_ABORTED	0x0a
2429 #define		SSD_KEY_ABORTED_COMMAND	0x0b
2430 #define		SSD_KEY_EQUAL		0x0c
2431 #define		SSD_KEY_VOLUME_OVERFLOW	0x0d
2432 #define		SSD_KEY_MISCOMPARE	0x0e
2433 #define		SSD_KEY_COMPLETED	0x0f
2434 #define	SSD_ILI		0x20
2435 #define	SSD_EOM		0x40
2436 #define	SSD_FILEMARK	0x80
2437 	u_int8_t info[4];
2438 	u_int8_t extra_len;
2439 	u_int8_t cmd_spec_info[4];
2440 	u_int8_t add_sense_code;
2441 	u_int8_t add_sense_code_qual;
2442 	u_int8_t fru;
2443 	u_int8_t sense_key_spec[3];
2444 #define	SSD_SCS_VALID		0x80
2445 #define	SSD_FIELDPTR_CMD	0x40
2446 #define	SSD_BITPTR_VALID	0x08
2447 #define	SSD_BITPTR_VALUE	0x07
2448 	u_int8_t extra_bytes[14];
2449 #define	SSD_FIXED_IS_PRESENT(sense, length, field) 			\
2450 	((length >= (offsetof(struct scsi_sense_data_fixed, field) +	\
2451 	sizeof(sense->field))) ? 1 :0)
2452 #define	SSD_FIXED_IS_FILLED(sense, field) 				\
2453 	((((offsetof(struct scsi_sense_data_fixed, field) +		\
2454 	sizeof(sense->field)) -						\
2455 	(offsetof(struct scsi_sense_data_fixed, extra_len) +		\
2456 	sizeof(sense->extra_len))) <= sense->extra_len) ? 1 : 0)
2457 };
2458 
2459 /*
2460  * Descriptor format sense data definitions.
2461  * Introduced in SPC-3.
2462  */
2463 struct scsi_sense_data_desc
2464 {
2465 	uint8_t	error_code;
2466 #define	SSD_DESC_CURRENT_ERROR	0x72
2467 #define	SSD_DESC_DEFERRED_ERROR	0x73
2468 	uint8_t sense_key;
2469 	uint8_t	add_sense_code;
2470 	uint8_t	add_sense_code_qual;
2471 	uint8_t	reserved[3];
2472 	/*
2473 	 * Note that SPC-4, section 4.5.2.1 says that the extra_len field
2474 	 * must be less than or equal to 244.
2475 	 */
2476 	uint8_t	extra_len;
2477 	uint8_t	sense_desc[0];
2478 #define	SSD_DESC_IS_PRESENT(sense, length, field) 			\
2479 	((length >= (offsetof(struct scsi_sense_data_desc, field) +	\
2480 	sizeof(sense->field))) ? 1 :0)
2481 };
2482 
2483 struct scsi_sense_desc_header
2484 {
2485 	uint8_t desc_type;
2486 	uint8_t length;
2487 };
2488 /*
2489  * The information provide in the Information descriptor is device type or
2490  * command specific information, and defined in a command standard.
2491  *
2492  * Note that any changes to the field names or positions in this structure,
2493  * even reserved fields, should be accompanied by an examination of the
2494  * code in ctl_set_sense() that uses them.
2495  *
2496  * Maximum descriptors allowed: 1 (as of SPC-4)
2497  */
2498 struct scsi_sense_info
2499 {
2500 	uint8_t	desc_type;
2501 #define	SSD_DESC_INFO	0x00
2502 	uint8_t	length;
2503 	uint8_t	byte2;
2504 #define	SSD_INFO_VALID	0x80
2505 	uint8_t	reserved;
2506 	uint8_t	info[8];
2507 };
2508 
2509 /*
2510  * Command-specific information depends on the command for which the
2511  * reported condition occured.
2512  *
2513  * Note that any changes to the field names or positions in this structure,
2514  * even reserved fields, should be accompanied by an examination of the
2515  * code in ctl_set_sense() that uses them.
2516  *
2517  * Maximum descriptors allowed: 1 (as of SPC-4)
2518  */
2519 struct scsi_sense_command
2520 {
2521 	uint8_t	desc_type;
2522 #define	SSD_DESC_COMMAND	0x01
2523 	uint8_t	length;
2524 	uint8_t	reserved[2];
2525 	uint8_t	command_info[8];
2526 };
2527 
2528 /*
2529  * Sense key specific descriptor.  The sense key specific data format
2530  * depends on the sense key in question.
2531  *
2532  * Maximum descriptors allowed: 1 (as of SPC-4)
2533  */
2534 struct scsi_sense_sks
2535 {
2536 	uint8_t	desc_type;
2537 #define	SSD_DESC_SKS		0x02
2538 	uint8_t	length;
2539 	uint8_t reserved1[2];
2540 	uint8_t	sense_key_spec[3];
2541 #define	SSD_SKS_VALID		0x80
2542 	uint8_t reserved2;
2543 };
2544 
2545 /*
2546  * This is used for the Illegal Request sense key (0x05) only.
2547  */
2548 struct scsi_sense_sks_field
2549 {
2550 	uint8_t	byte0;
2551 #define	SSD_SKS_FIELD_VALID	0x80
2552 #define	SSD_SKS_FIELD_CMD	0x40
2553 #define	SSD_SKS_BPV		0x08
2554 #define	SSD_SKS_BIT_VALUE	0x07
2555 	uint8_t	field[2];
2556 };
2557 
2558 
2559 /*
2560  * This is used for the Hardware Error (0x04), Medium Error (0x03) and
2561  * Recovered Error (0x01) sense keys.
2562  */
2563 struct scsi_sense_sks_retry
2564 {
2565 	uint8_t byte0;
2566 #define	SSD_SKS_RETRY_VALID	0x80
2567 	uint8_t actual_retry_count[2];
2568 };
2569 
2570 /*
2571  * Used with the NO Sense (0x00) or Not Ready (0x02) sense keys.
2572  */
2573 struct scsi_sense_sks_progress
2574 {
2575 	uint8_t byte0;
2576 #define	SSD_SKS_PROGRESS_VALID	0x80
2577 	uint8_t progress[2];
2578 #define	SSD_SKS_PROGRESS_DENOM	0x10000
2579 };
2580 
2581 /*
2582  * Used with the Copy Aborted (0x0a) sense key.
2583  */
2584 struct scsi_sense_sks_segment
2585 {
2586 	uint8_t byte0;
2587 #define	SSD_SKS_SEGMENT_VALID	0x80
2588 #define	SSD_SKS_SEGMENT_SD	0x20
2589 #define	SSD_SKS_SEGMENT_BPV	0x08
2590 #define	SSD_SKS_SEGMENT_BITPTR	0x07
2591 	uint8_t field[2];
2592 };
2593 
2594 /*
2595  * Used with the Unit Attention (0x06) sense key.
2596  *
2597  * This is currently used to indicate that the unit attention condition
2598  * queue has overflowed (when the overflow bit is set).
2599  */
2600 struct scsi_sense_sks_overflow
2601 {
2602 	uint8_t byte0;
2603 #define	SSD_SKS_OVERFLOW_VALID	0x80
2604 #define	SSD_SKS_OVERFLOW_SET	0x01
2605 	uint8_t	reserved[2];
2606 };
2607 
2608 /*
2609  * This specifies which component is associated with the sense data.  There
2610  * is no standard meaning for the fru value.
2611  *
2612  * Maximum descriptors allowed: 1 (as of SPC-4)
2613  */
2614 struct scsi_sense_fru
2615 {
2616 	uint8_t	desc_type;
2617 #define	SSD_DESC_FRU		0x03
2618 	uint8_t	length;
2619 	uint8_t reserved;
2620 	uint8_t fru;
2621 };
2622 
2623 /*
2624  * Used for Stream commands, defined in SSC-4.
2625  *
2626  * Maximum descriptors allowed: 1 (as of SPC-4)
2627  */
2628 
2629 struct scsi_sense_stream
2630 {
2631 	uint8_t	desc_type;
2632 #define	SSD_DESC_STREAM		0x04
2633 	uint8_t	length;
2634 	uint8_t	reserved;
2635 	uint8_t	byte3;
2636 #define	SSD_DESC_STREAM_FM	0x80
2637 #define	SSD_DESC_STREAM_EOM	0x40
2638 #define	SSD_DESC_STREAM_ILI	0x20
2639 };
2640 
2641 /*
2642  * Used for Block commands, defined in SBC-3.
2643  *
2644  * This is currently (as of SBC-3) only used for the Incorrect Length
2645  * Indication (ILI) bit, which says that the data length requested in the
2646  * READ LONG or WRITE LONG command did not match the length of the logical
2647  * block.
2648  *
2649  * Maximum descriptors allowed: 1 (as of SPC-4)
2650  */
2651 struct scsi_sense_block
2652 {
2653 	uint8_t	desc_type;
2654 #define	SSD_DESC_BLOCK		0x05
2655 	uint8_t	length;
2656 	uint8_t	reserved;
2657 	uint8_t	byte3;
2658 #define	SSD_DESC_BLOCK_ILI	0x20
2659 };
2660 
2661 /*
2662  * Used for Object-Based Storage Devices (OSD-3).
2663  *
2664  * Maximum descriptors allowed: 1 (as of SPC-4)
2665  */
2666 struct scsi_sense_osd_objid
2667 {
2668 	uint8_t	desc_type;
2669 #define	SSD_DESC_OSD_OBJID	0x06
2670 	uint8_t	length;
2671 	uint8_t	reserved[6];
2672 	/*
2673 	 * XXX KDM provide the bit definitions here?  There are a lot of
2674 	 * them, and we don't have an OSD driver yet.
2675 	 */
2676 	uint8_t	not_init_cmds[4];
2677 	uint8_t	completed_cmds[4];
2678 	uint8_t	partition_id[8];
2679 	uint8_t	object_id[8];
2680 };
2681 
2682 /*
2683  * Used for Object-Based Storage Devices (OSD-3).
2684  *
2685  * Maximum descriptors allowed: 1 (as of SPC-4)
2686  */
2687 struct scsi_sense_osd_integrity
2688 {
2689 	uint8_t	desc_type;
2690 #define	SSD_DESC_OSD_INTEGRITY	0x07
2691 	uint8_t	length;
2692 	uint8_t	integ_check_val[32];
2693 };
2694 
2695 /*
2696  * Used for Object-Based Storage Devices (OSD-3).
2697  *
2698  * Maximum descriptors allowed: 1 (as of SPC-4)
2699  */
2700 struct scsi_sense_osd_attr_id
2701 {
2702 	uint8_t	desc_type;
2703 #define	SSD_DESC_OSD_ATTR_ID	0x08
2704 	uint8_t	length;
2705 	uint8_t	reserved[2];
2706 	uint8_t	attr_desc[0];
2707 };
2708 
2709 /*
2710  * Used with Sense keys No Sense (0x00) and Not Ready (0x02).
2711  *
2712  * Maximum descriptors allowed: 32 (as of SPC-4)
2713  */
2714 struct scsi_sense_progress
2715 {
2716 	uint8_t	desc_type;
2717 #define	SSD_DESC_PROGRESS	0x0a
2718 	uint8_t	length;
2719 	uint8_t	sense_key;
2720 	uint8_t	add_sense_code;
2721 	uint8_t	add_sense_code_qual;
2722 	uint8_t reserved;
2723 	uint8_t	progress[2];
2724 };
2725 
2726 /*
2727  * This is typically forwarded as the result of an EXTENDED COPY command.
2728  *
2729  * Maximum descriptors allowed: 2 (as of SPC-4)
2730  */
2731 struct scsi_sense_forwarded
2732 {
2733 	uint8_t	desc_type;
2734 #define	SSD_DESC_FORWARDED	0x0c
2735 	uint8_t	length;
2736 	uint8_t	byte2;
2737 #define	SSD_FORWARDED_FSDT	0x80
2738 #define	SSD_FORWARDED_SDS_MASK	0x0f
2739 #define	SSD_FORWARDED_SDS_UNK	0x00
2740 #define	SSD_FORWARDED_SDS_EXSRC	0x01
2741 #define	SSD_FORWARDED_SDS_EXDST	0x02
2742 };
2743 
2744 /*
2745  * Vendor-specific sense descriptor.  The desc_type field will be in the
2746  * range bewteen MIN and MAX inclusive.
2747  */
2748 struct scsi_sense_vendor
2749 {
2750 	uint8_t	desc_type;
2751 #define	SSD_DESC_VENDOR_MIN	0x80
2752 #define	SSD_DESC_VENDOR_MAX	0xff
2753 	uint8_t length;
2754 	uint8_t	data[0];
2755 };
2756 
2757 struct scsi_mode_header_6
2758 {
2759 	u_int8_t data_length;	/* Sense data length */
2760 	u_int8_t medium_type;
2761 	u_int8_t dev_spec;
2762 	u_int8_t blk_desc_len;
2763 };
2764 
2765 struct scsi_mode_header_10
2766 {
2767 	u_int8_t data_length[2];/* Sense data length */
2768 	u_int8_t medium_type;
2769 	u_int8_t dev_spec;
2770 	u_int8_t unused[2];
2771 	u_int8_t blk_desc_len[2];
2772 };
2773 
2774 struct scsi_mode_page_header
2775 {
2776 	u_int8_t page_code;
2777 #define	SMPH_PS		0x80
2778 #define	SMPH_SPF	0x40
2779 #define	SMPH_PC_MASK	0x3f
2780 	u_int8_t page_length;
2781 };
2782 
2783 struct scsi_mode_page_header_sp
2784 {
2785 	uint8_t page_code;
2786 	uint8_t subpage;
2787 	uint8_t page_length[2];
2788 };
2789 
2790 
2791 struct scsi_mode_blk_desc
2792 {
2793 	u_int8_t density;
2794 	u_int8_t nblocks[3];
2795 	u_int8_t reserved;
2796 	u_int8_t blklen[3];
2797 };
2798 
2799 #define	SCSI_DEFAULT_DENSITY	0x00	/* use 'default' density */
2800 #define	SCSI_SAME_DENSITY	0x7f	/* use 'same' density- >= SCSI-2 only */
2801 
2802 
2803 /*
2804  * Status Byte
2805  */
2806 #define	SCSI_STATUS_OK			0x00
2807 #define	SCSI_STATUS_CHECK_COND		0x02
2808 #define	SCSI_STATUS_COND_MET		0x04
2809 #define	SCSI_STATUS_BUSY		0x08
2810 #define	SCSI_STATUS_INTERMED		0x10
2811 #define	SCSI_STATUS_INTERMED_COND_MET	0x14
2812 #define	SCSI_STATUS_RESERV_CONFLICT	0x18
2813 #define	SCSI_STATUS_CMD_TERMINATED	0x22	/* Obsolete in SAM-2 */
2814 #define	SCSI_STATUS_QUEUE_FULL		0x28
2815 #define	SCSI_STATUS_ACA_ACTIVE		0x30
2816 #define	SCSI_STATUS_TASK_ABORTED	0x40
2817 
2818 struct scsi_inquiry_pattern {
2819 	u_int8_t   type;
2820 	u_int8_t   media_type;
2821 #define	SIP_MEDIA_REMOVABLE	0x01
2822 #define	SIP_MEDIA_FIXED		0x02
2823 	const char *vendor;
2824 	const char *product;
2825 	const char *revision;
2826 };
2827 
2828 struct scsi_static_inquiry_pattern {
2829 	u_int8_t   type;
2830 	u_int8_t   media_type;
2831 	char       vendor[SID_VENDOR_SIZE+1];
2832 	char       product[SID_PRODUCT_SIZE+1];
2833 	char       revision[SID_REVISION_SIZE+1];
2834 };
2835 
2836 struct scsi_sense_quirk_entry {
2837 	struct scsi_inquiry_pattern	inq_pat;
2838 	int				num_sense_keys;
2839 	int				num_ascs;
2840 	struct sense_key_table_entry	*sense_key_info;
2841 	struct asc_table_entry		*asc_info;
2842 };
2843 
2844 struct sense_key_table_entry {
2845 	u_int8_t    sense_key;
2846 	u_int32_t   action;
2847 	const char *desc;
2848 };
2849 
2850 struct asc_table_entry {
2851 	u_int8_t    asc;
2852 	u_int8_t    ascq;
2853 	u_int32_t   action;
2854 	const char *desc;
2855 };
2856 
2857 struct op_table_entry {
2858 	u_int8_t    opcode;
2859 	u_int32_t   opmask;
2860 	const char  *desc;
2861 };
2862 
2863 struct scsi_op_quirk_entry {
2864 	struct scsi_inquiry_pattern	inq_pat;
2865 	int				num_ops;
2866 	struct op_table_entry		*op_table;
2867 };
2868 
2869 typedef enum {
2870 	SSS_FLAG_NONE		= 0x00,
2871 	SSS_FLAG_PRINT_COMMAND	= 0x01
2872 } scsi_sense_string_flags;
2873 
2874 struct scsi_nv {
2875 	const char *name;
2876 	uint64_t value;
2877 };
2878 
2879 typedef enum {
2880 	SCSI_NV_FOUND,
2881 	SCSI_NV_AMBIGUOUS,
2882 	SCSI_NV_NOT_FOUND
2883 } scsi_nv_status;
2884 
2885 typedef enum {
2886 	SCSI_NV_FLAG_NONE	= 0x00,
2887 	SCSI_NV_FLAG_IG_CASE	= 0x01	/* Case insensitive comparison */
2888 } scsi_nv_flags;
2889 
2890 struct ccb_scsiio;
2891 struct cam_periph;
2892 union  ccb;
2893 #ifndef _KERNEL
2894 struct cam_device;
2895 #endif
2896 
2897 extern const char *scsi_sense_key_text[];
2898 
2899 struct sbuf;
2900 
2901 __BEGIN_DECLS
2902 void scsi_sense_desc(int sense_key, int asc, int ascq,
2903 		     struct scsi_inquiry_data *inq_data,
2904 		     const char **sense_key_desc, const char **asc_desc);
2905 scsi_sense_action scsi_error_action(struct ccb_scsiio* csio,
2906 				    struct scsi_inquiry_data *inq_data,
2907 				    u_int32_t sense_flags);
2908 const char *	scsi_status_string(struct ccb_scsiio *csio);
2909 
2910 void scsi_desc_iterate(struct scsi_sense_data_desc *sense, u_int sense_len,
2911 		       int (*iter_func)(struct scsi_sense_data_desc *sense,
2912 					u_int, struct scsi_sense_desc_header *,
2913 					void *), void *arg);
2914 uint8_t *scsi_find_desc(struct scsi_sense_data_desc *sense, u_int sense_len,
2915 			uint8_t desc_type);
2916 void scsi_set_sense_data(struct scsi_sense_data *sense_data,
2917 			 scsi_sense_data_type sense_format, int current_error,
2918 			 int sense_key, int asc, int ascq, ...) ;
2919 void scsi_set_sense_data_va(struct scsi_sense_data *sense_data,
2920 			    scsi_sense_data_type sense_format,
2921 			    int current_error, int sense_key, int asc,
2922 			    int ascq, va_list ap);
2923 int scsi_get_sense_info(struct scsi_sense_data *sense_data, u_int sense_len,
2924 			uint8_t info_type, uint64_t *info,
2925 			int64_t *signed_info);
2926 int scsi_get_sks(struct scsi_sense_data *sense_data, u_int sense_len,
2927 		 uint8_t *sks);
2928 int scsi_get_block_info(struct scsi_sense_data *sense_data, u_int sense_len,
2929 			struct scsi_inquiry_data *inq_data,
2930 			uint8_t *block_bits);
2931 int scsi_get_stream_info(struct scsi_sense_data *sense_data, u_int sense_len,
2932 			 struct scsi_inquiry_data *inq_data,
2933 			 uint8_t *stream_bits);
2934 void scsi_info_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len,
2935 		    struct scsi_inquiry_data *inq_data, uint64_t info);
2936 void scsi_command_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len,
2937 		       struct scsi_inquiry_data *inq_data, uint64_t csi);
2938 void scsi_progress_sbuf(struct sbuf *sb, uint16_t progress);
2939 int scsi_sks_sbuf(struct sbuf *sb, int sense_key, uint8_t *sks);
2940 void scsi_fru_sbuf(struct sbuf *sb, uint64_t fru);
2941 void scsi_stream_sbuf(struct sbuf *sb, uint8_t stream_bits, uint64_t info);
2942 void scsi_block_sbuf(struct sbuf *sb, uint8_t block_bits, uint64_t info);
2943 void scsi_sense_info_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2944 			  u_int sense_len, uint8_t *cdb, int cdb_len,
2945 			  struct scsi_inquiry_data *inq_data,
2946 			  struct scsi_sense_desc_header *header);
2947 
2948 void scsi_sense_command_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2949 			     u_int sense_len, uint8_t *cdb, int cdb_len,
2950 			     struct scsi_inquiry_data *inq_data,
2951 			     struct scsi_sense_desc_header *header);
2952 void scsi_sense_sks_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2953 			 u_int sense_len, uint8_t *cdb, int cdb_len,
2954 			 struct scsi_inquiry_data *inq_data,
2955 			 struct scsi_sense_desc_header *header);
2956 void scsi_sense_fru_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2957 			 u_int sense_len, uint8_t *cdb, int cdb_len,
2958 			 struct scsi_inquiry_data *inq_data,
2959 			 struct scsi_sense_desc_header *header);
2960 void scsi_sense_stream_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2961 			    u_int sense_len, uint8_t *cdb, int cdb_len,
2962 			    struct scsi_inquiry_data *inq_data,
2963 			    struct scsi_sense_desc_header *header);
2964 void scsi_sense_block_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2965 			   u_int sense_len, uint8_t *cdb, int cdb_len,
2966 			   struct scsi_inquiry_data *inq_data,
2967 			   struct scsi_sense_desc_header *header);
2968 void scsi_sense_progress_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2969 			      u_int sense_len, uint8_t *cdb, int cdb_len,
2970 			      struct scsi_inquiry_data *inq_data,
2971 			      struct scsi_sense_desc_header *header);
2972 void scsi_sense_generic_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2973 			     u_int sense_len, uint8_t *cdb, int cdb_len,
2974 			     struct scsi_inquiry_data *inq_data,
2975 			     struct scsi_sense_desc_header *header);
2976 void scsi_sense_desc_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
2977 			  u_int sense_len, uint8_t *cdb, int cdb_len,
2978 			  struct scsi_inquiry_data *inq_data,
2979 			  struct scsi_sense_desc_header *header);
2980 scsi_sense_data_type scsi_sense_type(struct scsi_sense_data *sense_data);
2981 
2982 void scsi_sense_only_sbuf(struct scsi_sense_data *sense, u_int sense_len,
2983 			  struct sbuf *sb, char *path_str,
2984 			  struct scsi_inquiry_data *inq_data, uint8_t *cdb,
2985 			  int cdb_len);
2986 
2987 #ifdef _KERNEL
2988 int		scsi_command_string(struct ccb_scsiio *csio, struct sbuf *sb);
2989 int		scsi_sense_sbuf(struct ccb_scsiio *csio, struct sbuf *sb,
2990 				scsi_sense_string_flags flags);
2991 char *		scsi_sense_string(struct ccb_scsiio *csio,
2992 				  char *str, int str_len);
2993 void		scsi_sense_print(struct ccb_scsiio *csio);
2994 int 		scsi_vpd_supported_page(struct cam_periph *periph,
2995 					uint8_t page_id);
2996 #else /* _KERNEL */
2997 int		scsi_command_string(struct cam_device *device,
2998 				    struct ccb_scsiio *csio, struct sbuf *sb);
2999 int		scsi_sense_sbuf(struct cam_device *device,
3000 				struct ccb_scsiio *csio, struct sbuf *sb,
3001 				scsi_sense_string_flags flags);
3002 char *		scsi_sense_string(struct cam_device *device,
3003 				  struct ccb_scsiio *csio,
3004 				  char *str, int str_len);
3005 void		scsi_sense_print(struct cam_device *device,
3006 				 struct ccb_scsiio *csio, FILE *ofile);
3007 #endif /* _KERNEL */
3008 
3009 const char *	scsi_op_desc(u_int16_t opcode,
3010 			     struct scsi_inquiry_data *inq_data);
3011 char *		scsi_cdb_string(u_int8_t *cdb_ptr, char *cdb_string,
3012 				size_t len);
3013 
3014 void		scsi_print_inquiry(struct scsi_inquiry_data *inq_data);
3015 void		scsi_print_inquiry_short(struct scsi_inquiry_data *inq_data);
3016 
3017 u_int		scsi_calc_syncsrate(u_int period_factor);
3018 u_int		scsi_calc_syncparam(u_int period);
3019 
3020 typedef int	(*scsi_devid_checkfn_t)(uint8_t *);
3021 int		scsi_devid_is_naa_ieee_reg(uint8_t *bufp);
3022 int		scsi_devid_is_sas_target(uint8_t *bufp);
3023 int		scsi_devid_is_lun_eui64(uint8_t *bufp);
3024 int		scsi_devid_is_lun_naa(uint8_t *bufp);
3025 int		scsi_devid_is_lun_name(uint8_t *bufp);
3026 int		scsi_devid_is_lun_t10(uint8_t *bufp);
3027 struct scsi_vpd_id_descriptor *
3028 		scsi_get_devid(struct scsi_vpd_device_id *id, uint32_t len,
3029 			       scsi_devid_checkfn_t ck_fn);
3030 
3031 int		scsi_transportid_sbuf(struct sbuf *sb,
3032 				      struct scsi_transportid_header *hdr,
3033 				      uint32_t valid_len);
3034 
3035 const char *	scsi_nv_to_str(struct scsi_nv *table, int num_table_entries,
3036 			       uint64_t value);
3037 
3038 scsi_nv_status	scsi_get_nv(struct scsi_nv *table, int num_table_entries,
3039 			    char *name, int *table_entry, scsi_nv_flags flags);
3040 
3041 int	scsi_parse_transportid_64bit(int proto_id, char *id_str,
3042 				     struct scsi_transportid_header **hdr,
3043 				     unsigned int *alloc_len,
3044 #ifdef _KERNEL
3045 				     struct malloc_type *type, int flags,
3046 #endif
3047 				     char *error_str, int error_str_len);
3048 
3049 int	scsi_parse_transportid_spi(char *id_str,
3050 				   struct scsi_transportid_header **hdr,
3051 				   unsigned int *alloc_len,
3052 #ifdef _KERNEL
3053 				   struct malloc_type *type, int flags,
3054 #endif
3055 				   char *error_str, int error_str_len);
3056 
3057 int	scsi_parse_transportid_rdma(char *id_str,
3058 				    struct scsi_transportid_header **hdr,
3059 				    unsigned int *alloc_len,
3060 #ifdef _KERNEL
3061 				    struct malloc_type *type, int flags,
3062 #endif
3063 				    char *error_str, int error_str_len);
3064 
3065 int	scsi_parse_transportid_iscsi(char *id_str,
3066 				     struct scsi_transportid_header **hdr,
3067 				     unsigned int *alloc_len,
3068 #ifdef _KERNEL
3069 				     struct malloc_type *type, int flags,
3070 #endif
3071 				     char *error_str,int error_str_len);
3072 
3073 int	scsi_parse_transportid_sop(char *id_str,
3074 				   struct scsi_transportid_header **hdr,
3075 				   unsigned int *alloc_len,
3076 #ifdef _KERNEL
3077 				   struct malloc_type *type, int flags,
3078 #endif
3079 				   char *error_str,int error_str_len);
3080 
3081 int	scsi_parse_transportid(char *transportid_str,
3082 			       struct scsi_transportid_header **hdr,
3083 			       unsigned int *alloc_len,
3084 #ifdef _KERNEL
3085 			       struct malloc_type *type, int flags,
3086 #endif
3087 			       char *error_str, int error_str_len);
3088 
3089 void		scsi_test_unit_ready(struct ccb_scsiio *csio, u_int32_t retries,
3090 				     void (*cbfcnp)(struct cam_periph *,
3091 						    union ccb *),
3092 				     u_int8_t tag_action,
3093 				     u_int8_t sense_len, u_int32_t timeout);
3094 
3095 void		scsi_request_sense(struct ccb_scsiio *csio, u_int32_t retries,
3096 				   void (*cbfcnp)(struct cam_periph *,
3097 						  union ccb *),
3098 				   void *data_ptr, u_int8_t dxfer_len,
3099 				   u_int8_t tag_action, u_int8_t sense_len,
3100 				   u_int32_t timeout);
3101 
3102 void		scsi_inquiry(struct ccb_scsiio *csio, u_int32_t retries,
3103 			     void (*cbfcnp)(struct cam_periph *, union ccb *),
3104 			     u_int8_t tag_action, u_int8_t *inq_buf,
3105 			     u_int32_t inq_len, int evpd, u_int8_t page_code,
3106 			     u_int8_t sense_len, u_int32_t timeout);
3107 
3108 void		scsi_mode_sense(struct ccb_scsiio *csio, u_int32_t retries,
3109 				void (*cbfcnp)(struct cam_periph *,
3110 					       union ccb *),
3111 				u_int8_t tag_action, int dbd,
3112 				u_int8_t page_code, u_int8_t page,
3113 				u_int8_t *param_buf, u_int32_t param_len,
3114 				u_int8_t sense_len, u_int32_t timeout);
3115 
3116 void		scsi_mode_sense_len(struct ccb_scsiio *csio, u_int32_t retries,
3117 				    void (*cbfcnp)(struct cam_periph *,
3118 						   union ccb *),
3119 				    u_int8_t tag_action, int dbd,
3120 				    u_int8_t page_code, u_int8_t page,
3121 				    u_int8_t *param_buf, u_int32_t param_len,
3122 				    int minimum_cmd_size, u_int8_t sense_len,
3123 				    u_int32_t timeout);
3124 
3125 void		scsi_mode_select(struct ccb_scsiio *csio, u_int32_t retries,
3126 				 void (*cbfcnp)(struct cam_periph *,
3127 						union ccb *),
3128 				 u_int8_t tag_action, int scsi_page_fmt,
3129 				 int save_pages, u_int8_t *param_buf,
3130 				 u_int32_t param_len, u_int8_t sense_len,
3131 				 u_int32_t timeout);
3132 
3133 void		scsi_mode_select_len(struct ccb_scsiio *csio, u_int32_t retries,
3134 				     void (*cbfcnp)(struct cam_periph *,
3135 						    union ccb *),
3136 				     u_int8_t tag_action, int scsi_page_fmt,
3137 				     int save_pages, u_int8_t *param_buf,
3138 				     u_int32_t param_len, int minimum_cmd_size,
3139 				     u_int8_t sense_len, u_int32_t timeout);
3140 
3141 void		scsi_log_sense(struct ccb_scsiio *csio, u_int32_t retries,
3142 			       void (*cbfcnp)(struct cam_periph *, union ccb *),
3143 			       u_int8_t tag_action, u_int8_t page_code,
3144 			       u_int8_t page, int save_pages, int ppc,
3145 			       u_int32_t paramptr, u_int8_t *param_buf,
3146 			       u_int32_t param_len, u_int8_t sense_len,
3147 			       u_int32_t timeout);
3148 
3149 void		scsi_log_select(struct ccb_scsiio *csio, u_int32_t retries,
3150 				void (*cbfcnp)(struct cam_periph *,
3151 				union ccb *), u_int8_t tag_action,
3152 				u_int8_t page_code, int save_pages,
3153 				int pc_reset, u_int8_t *param_buf,
3154 				u_int32_t param_len, u_int8_t sense_len,
3155 				u_int32_t timeout);
3156 
3157 void		scsi_prevent(struct ccb_scsiio *csio, u_int32_t retries,
3158 			     void (*cbfcnp)(struct cam_periph *, union ccb *),
3159 			     u_int8_t tag_action, u_int8_t action,
3160 			     u_int8_t sense_len, u_int32_t timeout);
3161 
3162 void		scsi_read_capacity(struct ccb_scsiio *csio, u_int32_t retries,
3163 				   void (*cbfcnp)(struct cam_periph *,
3164 				   union ccb *), u_int8_t tag_action,
3165 				   struct scsi_read_capacity_data *,
3166 				   u_int8_t sense_len, u_int32_t timeout);
3167 void		scsi_read_capacity_16(struct ccb_scsiio *csio, uint32_t retries,
3168 				      void (*cbfcnp)(struct cam_periph *,
3169 				      union ccb *), uint8_t tag_action,
3170 				      uint64_t lba, int reladr, int pmi,
3171 				      uint8_t *rcap_buf, int rcap_buf_len,
3172 				      uint8_t sense_len, uint32_t timeout);
3173 
3174 void		scsi_report_luns(struct ccb_scsiio *csio, u_int32_t retries,
3175 				 void (*cbfcnp)(struct cam_periph *,
3176 				 union ccb *), u_int8_t tag_action,
3177 				 u_int8_t select_report,
3178 				 struct scsi_report_luns_data *rpl_buf,
3179 				 u_int32_t alloc_len, u_int8_t sense_len,
3180 				 u_int32_t timeout);
3181 
3182 void		scsi_report_target_group(struct ccb_scsiio *csio, u_int32_t retries,
3183 				 void (*cbfcnp)(struct cam_periph *,
3184 				 union ccb *), u_int8_t tag_action,
3185 				 u_int8_t pdf,
3186 				 void *buf,
3187 				 u_int32_t alloc_len, u_int8_t sense_len,
3188 				 u_int32_t timeout);
3189 
3190 void		scsi_set_target_group(struct ccb_scsiio *csio, u_int32_t retries,
3191 				 void (*cbfcnp)(struct cam_periph *,
3192 				 union ccb *), u_int8_t tag_action, void *buf,
3193 				 u_int32_t alloc_len, u_int8_t sense_len,
3194 				 u_int32_t timeout);
3195 
3196 void		scsi_synchronize_cache(struct ccb_scsiio *csio,
3197 				       u_int32_t retries,
3198 				       void (*cbfcnp)(struct cam_periph *,
3199 				       union ccb *), u_int8_t tag_action,
3200 				       u_int32_t begin_lba, u_int16_t lb_count,
3201 				       u_int8_t sense_len, u_int32_t timeout);
3202 
3203 void scsi_receive_diagnostic_results(struct ccb_scsiio *csio, u_int32_t retries,
3204 				     void (*cbfcnp)(struct cam_periph *,
3205 						    union ccb*),
3206 				     uint8_t tag_action, int pcv,
3207 				     uint8_t page_code, uint8_t *data_ptr,
3208 				     uint16_t allocation_length,
3209 				     uint8_t sense_len, uint32_t timeout);
3210 
3211 void scsi_send_diagnostic(struct ccb_scsiio *csio, u_int32_t retries,
3212 			  void (*cbfcnp)(struct cam_periph *, union ccb *),
3213 			  uint8_t tag_action, int unit_offline,
3214 			  int device_offline, int self_test, int page_format,
3215 			  int self_test_code, uint8_t *data_ptr,
3216 			  uint16_t param_list_length, uint8_t sense_len,
3217 			  uint32_t timeout);
3218 
3219 void scsi_read_buffer(struct ccb_scsiio *csio, u_int32_t retries,
3220 			void (*cbfcnp)(struct cam_periph *, union ccb*),
3221 			uint8_t tag_action, int mode,
3222 			uint8_t buffer_id, u_int32_t offset,
3223 			uint8_t *data_ptr, uint32_t allocation_length,
3224 			uint8_t sense_len, uint32_t timeout);
3225 
3226 void scsi_write_buffer(struct ccb_scsiio *csio, u_int32_t retries,
3227 			void (*cbfcnp)(struct cam_periph *, union ccb *),
3228 			uint8_t tag_action, int mode,
3229 			uint8_t buffer_id, u_int32_t offset,
3230 			uint8_t *data_ptr, uint32_t param_list_length,
3231 			uint8_t sense_len, uint32_t timeout);
3232 
3233 #define	SCSI_RW_READ	0x0001
3234 #define	SCSI_RW_WRITE	0x0002
3235 #define	SCSI_RW_DIRMASK	0x0003
3236 #define	SCSI_RW_BIO	0x1000
3237 void scsi_read_write(struct ccb_scsiio *csio, u_int32_t retries,
3238 		     void (*cbfcnp)(struct cam_periph *, union ccb *),
3239 		     u_int8_t tag_action, int readop, u_int8_t byte2,
3240 		     int minimum_cmd_size, u_int64_t lba,
3241 		     u_int32_t block_count, u_int8_t *data_ptr,
3242 		     u_int32_t dxfer_len, u_int8_t sense_len,
3243 		     u_int32_t timeout);
3244 
3245 void scsi_write_same(struct ccb_scsiio *csio, u_int32_t retries,
3246 		     void (*cbfcnp)(struct cam_periph *, union ccb *),
3247 		     u_int8_t tag_action, u_int8_t byte2,
3248 		     int minimum_cmd_size, u_int64_t lba,
3249 		     u_int32_t block_count, u_int8_t *data_ptr,
3250 		     u_int32_t dxfer_len, u_int8_t sense_len,
3251 		     u_int32_t timeout);
3252 
3253 void scsi_ata_identify(struct ccb_scsiio *csio, u_int32_t retries,
3254 		       void (*cbfcnp)(struct cam_periph *, union ccb *),
3255 		       u_int8_t tag_action, u_int8_t *data_ptr,
3256 		       u_int16_t dxfer_len, u_int8_t sense_len,
3257 		       u_int32_t timeout);
3258 
3259 void scsi_ata_trim(struct ccb_scsiio *csio, u_int32_t retries,
3260 	           void (*cbfcnp)(struct cam_periph *, union ccb *),
3261 	           u_int8_t tag_action, u_int16_t block_count,
3262 	           u_int8_t *data_ptr, u_int16_t dxfer_len,
3263 	           u_int8_t sense_len, u_int32_t timeout);
3264 
3265 void scsi_ata_pass_16(struct ccb_scsiio *csio, u_int32_t retries,
3266 		      void (*cbfcnp)(struct cam_periph *, union ccb *),
3267 		      u_int32_t flags, u_int8_t tag_action,
3268 		      u_int8_t protocol, u_int8_t ata_flags, u_int16_t features,
3269 		      u_int16_t sector_count, uint64_t lba, u_int8_t command,
3270 		      u_int8_t control, u_int8_t *data_ptr, u_int16_t dxfer_len,
3271 		      u_int8_t sense_len, u_int32_t timeout);
3272 
3273 void scsi_unmap(struct ccb_scsiio *csio, u_int32_t retries,
3274 		void (*cbfcnp)(struct cam_periph *, union ccb *),
3275 		u_int8_t tag_action, u_int8_t byte2,
3276 		u_int8_t *data_ptr, u_int16_t dxfer_len,
3277 		u_int8_t sense_len, u_int32_t timeout);
3278 
3279 void scsi_start_stop(struct ccb_scsiio *csio, u_int32_t retries,
3280 		     void (*cbfcnp)(struct cam_periph *, union ccb *),
3281 		     u_int8_t tag_action, int start, int load_eject,
3282 		     int immediate, u_int8_t sense_len, u_int32_t timeout);
3283 
3284 void scsi_persistent_reserve_in(struct ccb_scsiio *csio, uint32_t retries,
3285 				void (*cbfcnp)(struct cam_periph *,union ccb *),
3286 				uint8_t tag_action, int service_action,
3287 				uint8_t *data_ptr, uint32_t dxfer_len,
3288 				int sense_len, int timeout);
3289 
3290 void scsi_persistent_reserve_out(struct ccb_scsiio *csio, uint32_t retries,
3291 				 void (*cbfcnp)(struct cam_periph *,
3292 				       union ccb *),
3293 				 uint8_t tag_action, int service_action,
3294 				 int scope, int res_type, uint8_t *data_ptr,
3295 				 uint32_t dxfer_len, int sense_len,
3296 				 int timeout);
3297 
3298 int		scsi_inquiry_match(caddr_t inqbuffer, caddr_t table_entry);
3299 int		scsi_static_inquiry_match(caddr_t inqbuffer,
3300 					  caddr_t table_entry);
3301 int		scsi_devid_match(uint8_t *rhs, size_t rhs_len,
3302 				 uint8_t *lhs, size_t lhs_len);
3303 
3304 void scsi_extract_sense(struct scsi_sense_data *sense, int *error_code,
3305 			int *sense_key, int *asc, int *ascq);
3306 int scsi_extract_sense_ccb(union ccb *ccb, int *error_code, int *sense_key,
3307 			   int *asc, int *ascq);
3308 void scsi_extract_sense_len(struct scsi_sense_data *sense,
3309 			    u_int sense_len, int *error_code, int *sense_key,
3310 			    int *asc, int *ascq, int show_errors);
3311 int scsi_get_sense_key(struct scsi_sense_data *sense, u_int sense_len,
3312 		       int show_errors);
3313 int scsi_get_asc(struct scsi_sense_data *sense, u_int sense_len,
3314 		 int show_errors);
3315 int scsi_get_ascq(struct scsi_sense_data *sense, u_int sense_len,
3316 		  int show_errors);
3317 static __inline void scsi_ulto2b(u_int32_t val, u_int8_t *bytes);
3318 static __inline void scsi_ulto3b(u_int32_t val, u_int8_t *bytes);
3319 static __inline void scsi_ulto4b(u_int32_t val, u_int8_t *bytes);
3320 static __inline void scsi_u64to8b(u_int64_t val, u_int8_t *bytes);
3321 static __inline uint32_t scsi_2btoul(const uint8_t *bytes);
3322 static __inline uint32_t scsi_3btoul(const uint8_t *bytes);
3323 static __inline int32_t scsi_3btol(const uint8_t *bytes);
3324 static __inline uint32_t scsi_4btoul(const uint8_t *bytes);
3325 static __inline uint64_t scsi_8btou64(const uint8_t *bytes);
3326 static __inline void *find_mode_page_6(struct scsi_mode_header_6 *mode_header);
3327 static __inline void *find_mode_page_10(struct scsi_mode_header_10 *mode_header);
3328 
3329 static __inline void
3330 scsi_ulto2b(u_int32_t val, u_int8_t *bytes)
3331 {
3332 
3333 	bytes[0] = (val >> 8) & 0xff;
3334 	bytes[1] = val & 0xff;
3335 }
3336 
3337 static __inline void
3338 scsi_ulto3b(u_int32_t val, u_int8_t *bytes)
3339 {
3340 
3341 	bytes[0] = (val >> 16) & 0xff;
3342 	bytes[1] = (val >> 8) & 0xff;
3343 	bytes[2] = val & 0xff;
3344 }
3345 
3346 static __inline void
3347 scsi_ulto4b(u_int32_t val, u_int8_t *bytes)
3348 {
3349 
3350 	bytes[0] = (val >> 24) & 0xff;
3351 	bytes[1] = (val >> 16) & 0xff;
3352 	bytes[2] = (val >> 8) & 0xff;
3353 	bytes[3] = val & 0xff;
3354 }
3355 
3356 static __inline void
3357 scsi_u64to8b(u_int64_t val, u_int8_t *bytes)
3358 {
3359 
3360 	bytes[0] = (val >> 56) & 0xff;
3361 	bytes[1] = (val >> 48) & 0xff;
3362 	bytes[2] = (val >> 40) & 0xff;
3363 	bytes[3] = (val >> 32) & 0xff;
3364 	bytes[4] = (val >> 24) & 0xff;
3365 	bytes[5] = (val >> 16) & 0xff;
3366 	bytes[6] = (val >> 8) & 0xff;
3367 	bytes[7] = val & 0xff;
3368 }
3369 
3370 static __inline uint32_t
3371 scsi_2btoul(const uint8_t *bytes)
3372 {
3373 	uint32_t rv;
3374 
3375 	rv = (bytes[0] << 8) |
3376 	     bytes[1];
3377 	return (rv);
3378 }
3379 
3380 static __inline uint32_t
3381 scsi_3btoul(const uint8_t *bytes)
3382 {
3383 	uint32_t rv;
3384 
3385 	rv = (bytes[0] << 16) |
3386 	     (bytes[1] << 8) |
3387 	     bytes[2];
3388 	return (rv);
3389 }
3390 
3391 static __inline int32_t
3392 scsi_3btol(const uint8_t *bytes)
3393 {
3394 	uint32_t rc = scsi_3btoul(bytes);
3395 
3396 	if (rc & 0x00800000)
3397 		rc |= 0xff000000;
3398 
3399 	return (int32_t) rc;
3400 }
3401 
3402 static __inline uint32_t
3403 scsi_4btoul(const uint8_t *bytes)
3404 {
3405 	uint32_t rv;
3406 
3407 	rv = (bytes[0] << 24) |
3408 	     (bytes[1] << 16) |
3409 	     (bytes[2] << 8) |
3410 	     bytes[3];
3411 	return (rv);
3412 }
3413 
3414 static __inline uint64_t
3415 scsi_8btou64(const uint8_t *bytes)
3416 {
3417         uint64_t rv;
3418 
3419 	rv = (((uint64_t)bytes[0]) << 56) |
3420 	     (((uint64_t)bytes[1]) << 48) |
3421 	     (((uint64_t)bytes[2]) << 40) |
3422 	     (((uint64_t)bytes[3]) << 32) |
3423 	     (((uint64_t)bytes[4]) << 24) |
3424 	     (((uint64_t)bytes[5]) << 16) |
3425 	     (((uint64_t)bytes[6]) << 8) |
3426 	     bytes[7];
3427 	return (rv);
3428 }
3429 
3430 /*
3431  * Given the pointer to a returned mode sense buffer, return a pointer to
3432  * the start of the first mode page.
3433  */
3434 static __inline void *
3435 find_mode_page_6(struct scsi_mode_header_6 *mode_header)
3436 {
3437 	void *page_start;
3438 
3439 	page_start = (void *)((u_int8_t *)&mode_header[1] +
3440 			      mode_header->blk_desc_len);
3441 
3442 	return(page_start);
3443 }
3444 
3445 static __inline void *
3446 find_mode_page_10(struct scsi_mode_header_10 *mode_header)
3447 {
3448 	void *page_start;
3449 
3450 	page_start = (void *)((u_int8_t *)&mode_header[1] +
3451 			       scsi_2btoul(mode_header->blk_desc_len));
3452 
3453 	return(page_start);
3454 }
3455 
3456 __END_DECLS
3457 
3458 #endif /*_SCSI_SCSI_ALL_H*/
3459