scsi_all.h revision 271238
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: stable/10/sys/cam/scsi/scsi_all.h 271238 2014-09-07 21:30:47Z smh $
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 */
35extern 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 */
67typedef 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
80typedef 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
109struct scsi_generic
110{
111	u_int8_t opcode;
112	u_int8_t bytes[11];
113};
114
115struct 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
125struct 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
133struct 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
142struct 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
162struct 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
171struct 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
182struct 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
211struct 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
223struct 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
234struct 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 */
246struct 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
254struct 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
263struct 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
271struct 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
285struct scsi_per_res_in_header
286{
287	u_int8_t generation[4];
288	u_int8_t length[4];
289};
290
291struct scsi_per_res_key
292{
293	u_int8_t key[8];
294};
295
296struct scsi_per_res_in_keys
297{
298	struct scsi_per_res_in_header header;
299	struct scsi_per_res_key keys[0];
300};
301
302struct 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
331struct 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
346struct 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
352struct 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
366struct 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
372struct 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
407struct 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
421struct 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 */
430struct 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
443struct 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
451struct 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
460struct 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
471struct 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
480struct 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
489struct 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
498struct 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
510struct 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
519struct 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
530struct scsi_sop_routing_id_alt {
531	uint8_t bus;
532	uint8_t function;
533#define	SCSI_TRN_SOP_FUNC_ALT_MAX	0xff
534};
535
536struct 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
545struct 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
574struct 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
591struct scsi_log_header
592{
593	u_int8_t page;
594	u_int8_t reserved;
595	u_int8_t datalen[2];
596};
597
598struct 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
615struct 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
653struct 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 */
673struct 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 */
706struct 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 */
723struct 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 */
740struct 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
752struct 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
787struct 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
806struct 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
819struct 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
833struct 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
843struct 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
853struct 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
864struct 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
876struct 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
886struct 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
902struct 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
916struct 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
923struct 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
934struct 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
954struct 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
964struct 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
974struct 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
989struct 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
1002struct 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
1015struct 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
1029struct 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
1039struct 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
1050struct scsi_unmap_header
1051{
1052	uint8_t	length[2];
1053	uint8_t	desc_length[2];
1054	uint8_t	reserved[4];
1055};
1056
1057struct scsi_unmap_desc
1058{
1059	uint8_t	lba[8];
1060	uint8_t	length[4];
1061	uint8_t	reserved[4];
1062};
1063
1064struct 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
1077struct 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
1087struct 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
1098struct 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
1118struct 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
1152struct 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
1164struct 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
1181struct 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
1190struct 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
1203struct scsi_report_supported_opcodes_all
1204{
1205	uint8_t  length[4];
1206	struct scsi_report_supported_opcodes_descr descr[0];
1207};
1208
1209struct 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
1218struct 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
1228struct 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
1246struct 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
1256struct 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
1269struct 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
1281struct 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
1301struct 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
1313struct 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
1323struct 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
1335struct 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[6];
1355	uint8_t  sense_data[];
1356};
1357
1358struct 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
1369struct 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
1393struct 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
1405struct 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
1413struct 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
1426struct 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
1440struct 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
1450struct 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
1464struct 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
1476struct 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
1489struct 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
1506struct 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
1526struct 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
1536struct scsi_populate_token
1537{
1538	uint8_t  opcode;
1539	uint8_t  service_action;
1540#define EC_PT			0x10
1541	uint8_t  reserved[4];
1542	uint8_t  list_identifier[4];
1543	uint8_t  length[4];
1544	uint8_t  group_number;
1545	uint8_t  control;
1546};
1547
1548struct scsi_range_desc
1549{
1550	uint8_t	lba[8];
1551	uint8_t	length[4];
1552	uint8_t	reserved[4];
1553};
1554
1555struct scsi_populate_token_data
1556{
1557	uint8_t  length[2];
1558	uint8_t  flags;
1559#define EC_PT_IMMED			0x01
1560#define EC_PT_RTV			0x02
1561	uint8_t  reserved;
1562	uint8_t  inactivity_timeout[4];
1563	uint8_t  rod_type[4];
1564	uint8_t  reserved2[2];
1565	uint8_t  range_descriptor_length[2];
1566	struct scsi_range_desc desc[];
1567};
1568
1569struct scsi_write_using_token
1570{
1571	uint8_t  opcode;
1572	uint8_t  service_action;
1573#define EC_WUT			0x11
1574	uint8_t  reserved[4];
1575	uint8_t  list_identifier[4];
1576	uint8_t  length[4];
1577	uint8_t  group_number;
1578	uint8_t  control;
1579};
1580
1581struct scsi_write_using_token_data
1582{
1583	uint8_t  length[2];
1584	uint8_t  flags;
1585#define EC_WUT_IMMED			0x01
1586#define EC_WUT_DEL_TKN			0x02
1587	uint8_t  reserved[5];
1588	uint8_t  offset_into_rod[8];
1589	uint8_t  rod_token[512];
1590	uint8_t  reserved2[6];
1591	uint8_t  range_descriptor_length[2];
1592	struct scsi_range_desc desc[];
1593};
1594
1595struct scsi_receive_rod_token_information
1596{
1597	uint8_t  opcode;
1598	uint8_t  service_action;
1599#define RCS_RRTI		0x07
1600	uint8_t  list_identifier[4];
1601	uint8_t  reserved[4];
1602	uint8_t  length[4];
1603	uint8_t  reserved2;
1604	uint8_t  control;
1605};
1606
1607struct scsi_token
1608{
1609	uint8_t  type[4];
1610#define ROD_TYPE_INTERNAL	0x00000000
1611#define ROD_TYPE_AUR		0x00001000
1612#define ROD_TYPE_PIT_DEF	0x00080000
1613#define ROD_TYPE_PIT_VULN	0x00080001
1614#define ROD_TYPE_PIT_PERS	0x00080002
1615#define ROD_TYPE_PIT_ANY	0x0008FFFF
1616#define ROD_TYPE_BLOCK_ZERO	0xFFFF0001
1617	uint8_t  reserved[2];
1618	uint8_t  length[2];
1619	uint8_t  body[0];
1620};
1621
1622struct scsi_report_all_rod_tokens
1623{
1624	uint8_t  opcode;
1625	uint8_t  service_action;
1626#define RCS_RART		0x08
1627	uint8_t  reserved[8];
1628	uint8_t  length[4];
1629	uint8_t  reserved2;
1630	uint8_t  control;
1631};
1632
1633struct scsi_report_all_rod_tokens_data
1634{
1635	uint8_t  available_data[4];
1636	uint8_t  reserved[4];
1637	uint8_t  rod_management_token_list[];
1638};
1639
1640struct ata_pass_16 {
1641	u_int8_t opcode;
1642	u_int8_t protocol;
1643#define	AP_EXTEND	0x01
1644	u_int8_t flags;
1645#define	AP_FLAG_TLEN_NO_DATA	(0 << 0)
1646#define	AP_FLAG_TLEN_FEAT	(1 << 0)
1647#define	AP_FLAG_TLEN_SECT_CNT	(2 << 0)
1648#define	AP_FLAG_TLEN_STPSIU	(3 << 0)
1649#define	AP_FLAG_BYT_BLOK_BYTES	(0 << 2)
1650#define	AP_FLAG_BYT_BLOK_BLOCKS	(1 << 2)
1651#define	AP_FLAG_TDIR_TO_DEV	(0 << 3)
1652#define	AP_FLAG_TDIR_FROM_DEV	(1 << 3)
1653#define	AP_FLAG_CHK_COND	(1 << 5)
1654	u_int8_t features_ext;
1655	u_int8_t features;
1656	u_int8_t sector_count_ext;
1657	u_int8_t sector_count;
1658	u_int8_t lba_low_ext;
1659	u_int8_t lba_low;
1660	u_int8_t lba_mid_ext;
1661	u_int8_t lba_mid;
1662	u_int8_t lba_high_ext;
1663	u_int8_t lba_high;
1664	u_int8_t device;
1665	u_int8_t command;
1666	u_int8_t control;
1667};
1668
1669#define	SC_SCSI_1 0x01
1670#define	SC_SCSI_2 0x03
1671
1672/*
1673 * Opcodes
1674 */
1675
1676#define	TEST_UNIT_READY		0x00
1677#define	REQUEST_SENSE		0x03
1678#define	READ_6			0x08
1679#define	WRITE_6			0x0A
1680#define	INQUIRY			0x12
1681#define	MODE_SELECT_6		0x15
1682#define	MODE_SENSE_6		0x1A
1683#define	START_STOP_UNIT		0x1B
1684#define	START_STOP		0x1B
1685#define	RESERVE      		0x16
1686#define	RELEASE      		0x17
1687#define	RECEIVE_DIAGNOSTIC	0x1C
1688#define	SEND_DIAGNOSTIC		0x1D
1689#define	PREVENT_ALLOW		0x1E
1690#define	READ_CAPACITY		0x25
1691#define	READ_10			0x28
1692#define	WRITE_10		0x2A
1693#define	POSITION_TO_ELEMENT	0x2B
1694#define	WRITE_VERIFY_10		0x2E
1695#define	VERIFY_10		0x2F
1696#define	SYNCHRONIZE_CACHE	0x35
1697#define	READ_DEFECT_DATA_10	0x37
1698#define	WRITE_BUFFER            0x3B
1699#define	READ_BUFFER             0x3C
1700#define	CHANGE_DEFINITION	0x40
1701#define	WRITE_SAME_10		0x41
1702#define	UNMAP			0x42
1703#define	LOG_SELECT		0x4C
1704#define	LOG_SENSE		0x4D
1705#define	MODE_SELECT_10		0x55
1706#define	RESERVE_10		0x56
1707#define	RELEASE_10		0x57
1708#define	MODE_SENSE_10		0x5A
1709#define	PERSISTENT_RES_IN	0x5E
1710#define	PERSISTENT_RES_OUT	0x5F
1711#define	EXTENDED_COPY		0x83
1712#define	RECEIVE_COPY_STATUS	0x84
1713#define	ATA_PASS_16		0x85
1714#define	READ_16			0x88
1715#define	COMPARE_AND_WRITE	0x89
1716#define	WRITE_16		0x8A
1717#define	WRITE_VERIFY_16		0x8E
1718#define	VERIFY_16		0x8F
1719#define	SYNCHRONIZE_CACHE_16	0x91
1720#define	WRITE_SAME_16		0x93
1721#define	SERVICE_ACTION_IN	0x9E
1722#define	REPORT_LUNS		0xA0
1723#define	ATA_PASS_12		0xA1
1724#define	MAINTENANCE_IN		0xA3
1725#define	MAINTENANCE_OUT		0xA4
1726#define	MOVE_MEDIUM     	0xA5
1727#define	READ_12			0xA8
1728#define	WRITE_12		0xAA
1729#define	WRITE_VERIFY_12		0xAE
1730#define	VERIFY_12		0xAF
1731#define	READ_ELEMENT_STATUS	0xB8
1732#define	READ_CD			0xBE
1733
1734/* Maintenance In Service Action Codes */
1735#define	REPORT_IDENTIFYING_INFRMATION		0x05
1736#define	REPORT_TARGET_PORT_GROUPS		0x0A
1737#define	REPORT_ALIASES				0x0B
1738#define	REPORT_SUPPORTED_OPERATION_CODES	0x0C
1739#define	REPORT_SUPPORTED_TASK_MANAGEMENT_FUNCTIONS	0x0D
1740#define	REPORT_PRIORITY				0x0E
1741#define	REPORT_TIMESTAMP			0x0F
1742#define	MANAGEMENT_PROTOCOL_IN			0x10
1743/* Maintenance Out Service Action Codes */
1744#define	SET_IDENTIFY_INFORMATION		0x06
1745#define	SET_TARGET_PORT_GROUPS			0x0A
1746#define	CHANGE_ALIASES				0x0B
1747#define	SET_PRIORITY				0x0E
1748#define	SET_TIMESTAMP				0x0F
1749#define	MANGAEMENT_PROTOCOL_OUT			0x10
1750
1751/*
1752 * Device Types
1753 */
1754#define	T_DIRECT	0x00
1755#define	T_SEQUENTIAL	0x01
1756#define	T_PRINTER	0x02
1757#define	T_PROCESSOR	0x03
1758#define	T_WORM		0x04
1759#define	T_CDROM		0x05
1760#define	T_SCANNER	0x06
1761#define	T_OPTICAL 	0x07
1762#define	T_CHANGER	0x08
1763#define	T_COMM		0x09
1764#define	T_ASC0		0x0a
1765#define	T_ASC1		0x0b
1766#define	T_STORARRAY	0x0c
1767#define	T_ENCLOSURE	0x0d
1768#define	T_RBC		0x0e
1769#define	T_OCRW		0x0f
1770#define	T_OSD		0x11
1771#define	T_ADC		0x12
1772#define	T_NODEVICE	0x1f
1773#define	T_ANY		0xff	/* Used in Quirk table matches */
1774
1775#define	T_REMOV		1
1776#define	T_FIXED		0
1777
1778/*
1779 * This length is the initial inquiry length used by the probe code, as
1780 * well as the length necessary for scsi_print_inquiry() to function
1781 * correctly.  If either use requires a different length in the future,
1782 * the two values should be de-coupled.
1783 */
1784#define	SHORT_INQUIRY_LENGTH	36
1785
1786struct scsi_inquiry_data
1787{
1788	u_int8_t device;
1789#define	SID_TYPE(inq_data) ((inq_data)->device & 0x1f)
1790#define	SID_QUAL(inq_data) (((inq_data)->device & 0xE0) >> 5)
1791#define	SID_QUAL_LU_CONNECTED	0x00	/*
1792					 * The specified peripheral device
1793					 * type is currently connected to
1794					 * logical unit.  If the target cannot
1795					 * determine whether or not a physical
1796					 * device is currently connected, it
1797					 * shall also use this peripheral
1798					 * qualifier when returning the INQUIRY
1799					 * data.  This peripheral qualifier
1800					 * does not mean that the device is
1801					 * ready for access by the initiator.
1802					 */
1803#define	SID_QUAL_LU_OFFLINE	0x01	/*
1804					 * The target is capable of supporting
1805					 * the specified peripheral device type
1806					 * on this logical unit; however, the
1807					 * physical device is not currently
1808					 * connected to this logical unit.
1809					 */
1810#define	SID_QUAL_RSVD		0x02
1811#define	SID_QUAL_BAD_LU		0x03	/*
1812					 * The target is not capable of
1813					 * supporting a physical device on
1814					 * this logical unit. For this
1815					 * peripheral qualifier the peripheral
1816					 * device type shall be set to 1Fh to
1817					 * provide compatibility with previous
1818					 * versions of SCSI. All other
1819					 * peripheral device type values are
1820					 * reserved for this peripheral
1821					 * qualifier.
1822					 */
1823#define	SID_QUAL_IS_VENDOR_UNIQUE(inq_data) ((SID_QUAL(inq_data) & 0x08) != 0)
1824	u_int8_t dev_qual2;
1825#define	SID_QUAL2	0x7F
1826#define	SID_LU_CONG	0x40
1827#define	SID_RMB		0x80
1828#define	SID_IS_REMOVABLE(inq_data) (((inq_data)->dev_qual2 & SID_RMB) != 0)
1829	u_int8_t version;
1830#define	SID_ANSI_REV(inq_data) ((inq_data)->version & 0x07)
1831#define		SCSI_REV_0		0
1832#define		SCSI_REV_CCS		1
1833#define		SCSI_REV_2		2
1834#define		SCSI_REV_SPC		3
1835#define		SCSI_REV_SPC2		4
1836#define		SCSI_REV_SPC3		5
1837#define		SCSI_REV_SPC4		6
1838
1839#define	SID_ECMA	0x38
1840#define	SID_ISO		0xC0
1841	u_int8_t response_format;
1842#define	SID_AENC	0x80
1843#define	SID_TrmIOP	0x40
1844#define	SID_NormACA	0x20
1845#define	SID_HiSup	0x10
1846	u_int8_t additional_length;
1847#define	SID_ADDITIONAL_LENGTH(iqd)					\
1848	((iqd)->additional_length +					\
1849	__offsetof(struct scsi_inquiry_data, additional_length) + 1)
1850	u_int8_t spc3_flags;
1851#define	SPC3_SID_PROTECT	0x01
1852#define	SPC3_SID_3PC		0x08
1853#define	SPC3_SID_TPGS_MASK	0x30
1854#define	SPC3_SID_TPGS_IMPLICIT	0x10
1855#define	SPC3_SID_TPGS_EXPLICIT	0x20
1856#define	SPC3_SID_ACC		0x40
1857#define	SPC3_SID_SCCS		0x80
1858	u_int8_t spc2_flags;
1859#define	SPC2_SID_ADDR16		0x01
1860#define	SPC2_SID_MChngr 	0x08
1861#define	SPC2_SID_MultiP 	0x10
1862#define	SPC2_SID_EncServ	0x40
1863#define	SPC2_SID_BQueue		0x80
1864
1865#define	INQ_DATA_TQ_ENABLED(iqd)				\
1866    ((SID_ANSI_REV(iqd) < SCSI_REV_SPC2)? ((iqd)->flags & SID_CmdQue) :	\
1867    (((iqd)->flags & SID_CmdQue) && !((iqd)->spc2_flags & SPC2_SID_BQueue)) || \
1868    (!((iqd)->flags & SID_CmdQue) && ((iqd)->spc2_flags & SPC2_SID_BQueue)))
1869
1870	u_int8_t flags;
1871#define	SID_SftRe	0x01
1872#define	SID_CmdQue	0x02
1873#define	SID_Linked	0x08
1874#define	SID_Sync	0x10
1875#define	SID_WBus16	0x20
1876#define	SID_WBus32	0x40
1877#define	SID_RelAdr	0x80
1878#define	SID_VENDOR_SIZE   8
1879	char	 vendor[SID_VENDOR_SIZE];
1880#define	SID_PRODUCT_SIZE  16
1881	char	 product[SID_PRODUCT_SIZE];
1882#define	SID_REVISION_SIZE 4
1883	char	 revision[SID_REVISION_SIZE];
1884	/*
1885	 * The following fields were taken from SCSI Primary Commands - 2
1886	 * (SPC-2) Revision 14, Dated 11 November 1999
1887	 */
1888#define	SID_VENDOR_SPECIFIC_0_SIZE	20
1889	u_int8_t vendor_specific0[SID_VENDOR_SPECIFIC_0_SIZE];
1890	/*
1891	 * An extension of SCSI Parallel Specific Values
1892	 */
1893#define	SID_SPI_IUS		0x01
1894#define	SID_SPI_QAS		0x02
1895#define	SID_SPI_CLOCK_ST	0x00
1896#define	SID_SPI_CLOCK_DT	0x04
1897#define	SID_SPI_CLOCK_DT_ST	0x0C
1898#define	SID_SPI_MASK		0x0F
1899	u_int8_t spi3data;
1900	u_int8_t reserved2;
1901	/*
1902	 * Version Descriptors, stored 2 byte values.
1903	 */
1904	u_int8_t version1[2];
1905	u_int8_t version2[2];
1906	u_int8_t version3[2];
1907	u_int8_t version4[2];
1908	u_int8_t version5[2];
1909	u_int8_t version6[2];
1910	u_int8_t version7[2];
1911	u_int8_t version8[2];
1912
1913	u_int8_t reserved3[22];
1914
1915#define	SID_VENDOR_SPECIFIC_1_SIZE	160
1916	u_int8_t vendor_specific1[SID_VENDOR_SPECIFIC_1_SIZE];
1917};
1918
1919/*
1920 * This structure is more suited to initiator operation, because the
1921 * maximum number of supported pages is already allocated.
1922 */
1923struct scsi_vpd_supported_page_list
1924{
1925	u_int8_t device;
1926	u_int8_t page_code;
1927#define	SVPD_SUPPORTED_PAGE_LIST	0x00
1928#define	SVPD_SUPPORTED_PAGES_HDR_LEN	4
1929	u_int8_t reserved;
1930	u_int8_t length;	/* number of VPD entries */
1931#define	SVPD_SUPPORTED_PAGES_SIZE	251
1932	u_int8_t list[SVPD_SUPPORTED_PAGES_SIZE];
1933};
1934
1935/*
1936 * This structure is more suited to target operation, because the
1937 * number of supported pages is left to the user to allocate.
1938 */
1939struct scsi_vpd_supported_pages
1940{
1941	u_int8_t device;
1942	u_int8_t page_code;
1943	u_int8_t reserved;
1944#define	SVPD_SUPPORTED_PAGES	0x00
1945	u_int8_t length;
1946	u_int8_t page_list[0];
1947};
1948
1949
1950struct scsi_vpd_unit_serial_number
1951{
1952	u_int8_t device;
1953	u_int8_t page_code;
1954#define	SVPD_UNIT_SERIAL_NUMBER	0x80
1955	u_int8_t reserved;
1956	u_int8_t length; /* serial number length */
1957#define	SVPD_SERIAL_NUM_SIZE 251
1958	u_int8_t serial_num[SVPD_SERIAL_NUM_SIZE];
1959};
1960
1961struct scsi_vpd_device_id
1962{
1963	u_int8_t device;
1964	u_int8_t page_code;
1965#define	SVPD_DEVICE_ID			0x83
1966#define	SVPD_DEVICE_ID_MAX_SIZE		252
1967#define	SVPD_DEVICE_ID_HDR_LEN \
1968    __offsetof(struct scsi_vpd_device_id, desc_list)
1969	u_int8_t length[2];
1970	u_int8_t desc_list[];
1971};
1972
1973struct scsi_vpd_id_descriptor
1974{
1975	u_int8_t	proto_codeset;
1976	/*
1977	 * See the SCSI_PROTO definitions above for the protocols.
1978	 */
1979#define	SVPD_ID_PROTO_SHIFT	4
1980#define	SVPD_ID_CODESET_BINARY	0x01
1981#define	SVPD_ID_CODESET_ASCII	0x02
1982#define	SVPD_ID_CODESET_UTF8	0x03
1983#define	SVPD_ID_CODESET_MASK	0x0f
1984	u_int8_t	id_type;
1985#define	SVPD_ID_PIV		0x80
1986#define	SVPD_ID_ASSOC_LUN	0x00
1987#define	SVPD_ID_ASSOC_PORT	0x10
1988#define	SVPD_ID_ASSOC_TARGET	0x20
1989#define	SVPD_ID_ASSOC_MASK	0x30
1990#define	SVPD_ID_TYPE_VENDOR	0x00
1991#define	SVPD_ID_TYPE_T10	0x01
1992#define	SVPD_ID_TYPE_EUI64	0x02
1993#define	SVPD_ID_TYPE_NAA	0x03
1994#define	SVPD_ID_TYPE_RELTARG	0x04
1995#define	SVPD_ID_TYPE_TPORTGRP	0x05
1996#define	SVPD_ID_TYPE_LUNGRP	0x06
1997#define	SVPD_ID_TYPE_MD5_LUN_ID	0x07
1998#define	SVPD_ID_TYPE_SCSI_NAME	0x08
1999#define	SVPD_ID_TYPE_MASK	0x0f
2000	u_int8_t	reserved;
2001	u_int8_t	length;
2002#define	SVPD_DEVICE_ID_DESC_HDR_LEN \
2003    __offsetof(struct scsi_vpd_id_descriptor, identifier)
2004	u_int8_t	identifier[];
2005};
2006
2007struct scsi_vpd_id_t10
2008{
2009	u_int8_t	vendor[8];
2010	u_int8_t	vendor_spec_id[0];
2011};
2012
2013struct scsi_vpd_id_eui64
2014{
2015	u_int8_t	ieee_company_id[3];
2016	u_int8_t	extension_id[5];
2017};
2018
2019struct scsi_vpd_id_naa_basic
2020{
2021	uint8_t naa;
2022	/* big endian, packed:
2023	uint8_t	naa : 4;
2024	uint8_t naa_desig : 4;
2025	*/
2026#define	SVPD_ID_NAA_NAA_SHIFT		4
2027#define	SVPD_ID_NAA_IEEE_EXT		0x02
2028#define	SVPD_ID_NAA_LOCAL_REG		0x03
2029#define	SVPD_ID_NAA_IEEE_REG		0x05
2030#define	SVPD_ID_NAA_IEEE_REG_EXT	0x06
2031	uint8_t	naa_data[];
2032};
2033
2034struct scsi_vpd_id_naa_ieee_extended_id
2035{
2036	uint8_t naa;
2037	uint8_t vendor_specific_id_a;
2038	uint8_t ieee_company_id[3];
2039	uint8_t vendor_specific_id_b[4];
2040};
2041
2042struct scsi_vpd_id_naa_local_reg
2043{
2044	uint8_t naa;
2045	uint8_t local_value[7];
2046};
2047
2048struct scsi_vpd_id_naa_ieee_reg
2049{
2050	uint8_t naa;
2051	uint8_t reg_value[7];
2052	/* big endian, packed:
2053	uint8_t naa_basic : 4;
2054	uint8_t ieee_company_id_0 : 4;
2055	uint8_t ieee_company_id_1[2];
2056	uint8_t ieee_company_id_2 : 4;
2057	uint8_t vendor_specific_id_0 : 4;
2058	uint8_t vendor_specific_id_1[4];
2059	*/
2060};
2061
2062struct scsi_vpd_id_naa_ieee_reg_extended
2063{
2064	uint8_t naa;
2065	uint8_t reg_value[15];
2066	/* big endian, packed:
2067	uint8_t naa_basic : 4;
2068	uint8_t ieee_company_id_0 : 4;
2069	uint8_t ieee_company_id_1[2];
2070	uint8_t ieee_company_id_2 : 4;
2071	uint8_t vendor_specific_id_0 : 4;
2072	uint8_t vendor_specific_id_1[4];
2073	uint8_t vendor_specific_id_ext[8];
2074	*/
2075};
2076
2077struct scsi_vpd_id_rel_trgt_port_id
2078{
2079	uint8_t obsolete[2];
2080	uint8_t rel_trgt_port_id[2];
2081};
2082
2083struct scsi_vpd_id_trgt_port_grp_id
2084{
2085	uint8_t reserved[2];
2086	uint8_t trgt_port_grp[2];
2087};
2088
2089struct scsi_vpd_id_lun_grp_id
2090{
2091	uint8_t reserved[2];
2092	uint8_t log_unit_grp[2];
2093};
2094
2095struct scsi_vpd_id_md5_lun_id
2096{
2097	uint8_t lun_id[16];
2098};
2099
2100struct scsi_vpd_id_scsi_name
2101{
2102	uint8_t name_string[256];
2103};
2104
2105struct scsi_service_action_in
2106{
2107	uint8_t opcode;
2108	uint8_t service_action;
2109	uint8_t action_dependent[13];
2110	uint8_t control;
2111};
2112
2113struct scsi_diag_page {
2114	uint8_t page_code;
2115	uint8_t page_specific_flags;
2116	uint8_t length[2];
2117	uint8_t params[0];
2118};
2119
2120struct scsi_vpd_port_designation
2121{
2122	uint8_t reserved[2];
2123	uint8_t relative_port_id[2];
2124	uint8_t reserved2[2];
2125	uint8_t initiator_transportid_length[2];
2126	uint8_t initiator_transportid[0];
2127};
2128
2129struct scsi_vpd_port_designation_cont
2130{
2131	uint8_t reserved[2];
2132	uint8_t target_port_descriptors_length[2];
2133	struct scsi_vpd_id_descriptor target_port_descriptors[0];
2134};
2135
2136struct scsi_vpd_scsi_ports
2137{
2138	u_int8_t device;
2139	u_int8_t page_code;
2140#define	SVPD_SCSI_PORTS		0x88
2141	u_int8_t page_length[2];
2142	struct scsi_vpd_port_designation design[];
2143};
2144
2145/*
2146 * ATA Information VPD Page based on
2147 * T10/2126-D Revision 04
2148 */
2149#define SVPD_ATA_INFORMATION		0x89
2150
2151
2152struct scsi_vpd_tpc_descriptor
2153{
2154	uint8_t desc_type[2];
2155	uint8_t desc_length[2];
2156	uint8_t parameters[];
2157};
2158
2159struct scsi_vpd_tpc_descriptor_bdrl
2160{
2161	uint8_t desc_type[2];
2162#define	SVPD_TPC_BDRL			0x0000
2163	uint8_t desc_length[2];
2164	uint8_t vendor_specific[6];
2165	uint8_t maximum_ranges[2];
2166	uint8_t maximum_inactivity_timeout[4];
2167	uint8_t default_inactivity_timeout[4];
2168	uint8_t maximum_token_transfer_size[8];
2169	uint8_t optimal_transfer_count[8];
2170};
2171
2172struct scsi_vpd_tpc_descriptor_sc_descr
2173{
2174	uint8_t opcode;
2175	uint8_t sa_length;
2176	uint8_t supported_service_actions[0];
2177};
2178
2179struct scsi_vpd_tpc_descriptor_sc
2180{
2181	uint8_t desc_type[2];
2182#define	SVPD_TPC_SC			0x0001
2183	uint8_t desc_length[2];
2184	uint8_t list_length;
2185	struct scsi_vpd_tpc_descriptor_sc_descr descr[];
2186};
2187
2188struct scsi_vpd_tpc_descriptor_pd
2189{
2190	uint8_t desc_type[2];
2191#define	SVPD_TPC_PD			0x0004
2192	uint8_t desc_length[2];
2193	uint8_t reserved[4];
2194	uint8_t maximum_cscd_descriptor_count[2];
2195	uint8_t maximum_segment_descriptor_count[2];
2196	uint8_t maximum_descriptor_list_length[4];
2197	uint8_t maximum_inline_data_length[4];
2198	uint8_t reserved2[12];
2199};
2200
2201struct scsi_vpd_tpc_descriptor_sd
2202{
2203	uint8_t desc_type[2];
2204#define	SVPD_TPC_SD			0x0008
2205	uint8_t desc_length[2];
2206	uint8_t list_length;
2207	uint8_t supported_descriptor_codes[];
2208};
2209
2210struct scsi_vpd_tpc_descriptor_sdid
2211{
2212	uint8_t desc_type[2];
2213#define	SVPD_TPC_SDID			0x000C
2214	uint8_t desc_length[2];
2215	uint8_t list_length[2];
2216	uint8_t supported_descriptor_ids[];
2217};
2218
2219struct scsi_vpd_tpc_descriptor_rtf_block
2220{
2221	uint8_t type_format;
2222#define	SVPD_TPC_RTF_BLOCK			0x00
2223	uint8_t reserved;
2224	uint8_t desc_length[2];
2225	uint8_t reserved2[2];
2226	uint8_t optimal_length_granularity[2];
2227	uint8_t maximum_bytes[8];
2228	uint8_t optimal_bytes[8];
2229	uint8_t optimal_bytes_to_token_per_segment[8];
2230	uint8_t optimal_bytes_from_token_per_segment[8];
2231	uint8_t reserved3[8];
2232};
2233
2234struct scsi_vpd_tpc_descriptor_rtf
2235{
2236	uint8_t desc_type[2];
2237#define	SVPD_TPC_RTF			0x0106
2238	uint8_t desc_length[2];
2239	uint8_t remote_tokens;
2240	uint8_t reserved[11];
2241	uint8_t minimum_token_lifetime[4];
2242	uint8_t maximum_token_lifetime[4];
2243	uint8_t maximum_token_inactivity_timeout[4];
2244	uint8_t reserved2[18];
2245	uint8_t type_specific_features_length[2];
2246	uint8_t type_specific_features[0];
2247};
2248
2249struct scsi_vpd_tpc_descriptor_srtd
2250{
2251	uint8_t rod_type[4];
2252	uint8_t flags;
2253#define	SVPD_TPC_SRTD_TOUT		0x01
2254#define	SVPD_TPC_SRTD_TIN		0x02
2255#define	SVPD_TPC_SRTD_ECPY		0x80
2256	uint8_t reserved;
2257	uint8_t preference_indicator[2];
2258	uint8_t reserved2[56];
2259};
2260
2261struct scsi_vpd_tpc_descriptor_srt
2262{
2263	uint8_t desc_type[2];
2264#define	SVPD_TPC_SRT			0x0108
2265	uint8_t desc_length[2];
2266	uint8_t reserved[2];
2267	uint8_t rod_type_descriptors_length[2];
2268	uint8_t rod_type_descriptors[0];
2269};
2270
2271struct scsi_vpd_tpc_descriptor_gco
2272{
2273	uint8_t desc_type[2];
2274#define	SVPD_TPC_GCO			0x8001
2275	uint8_t desc_length[2];
2276	uint8_t total_concurrent_copies[4];
2277	uint8_t maximum_identified_concurrent_copies[4];
2278	uint8_t maximum_segment_length[4];
2279	uint8_t data_segment_granularity;
2280	uint8_t inline_data_granularity;
2281	uint8_t reserved[18];
2282};
2283
2284struct scsi_vpd_tpc
2285{
2286	uint8_t device;
2287	uint8_t page_code;
2288#define	SVPD_SCSI_TPC			0x8F
2289	uint8_t page_length[2];
2290	struct scsi_vpd_tpc_descriptor descr[];
2291};
2292
2293/*
2294 * Block Device Characteristics VPD Page based on
2295 * T10/1799-D Revision 31
2296 */
2297struct scsi_vpd_block_characteristics
2298{
2299	u_int8_t device;
2300	u_int8_t page_code;
2301#define SVPD_BDC			0xB1
2302	u_int8_t page_length[2];
2303	u_int8_t medium_rotation_rate[2];
2304#define SVPD_BDC_RATE_NOT_REPORTED	0x00
2305#define SVPD_BDC_RATE_NON_ROTATING	0x01
2306	u_int8_t reserved1;
2307	u_int8_t nominal_form_factor;
2308#define SVPD_BDC_FORM_NOT_REPORTED	0x00
2309#define SVPD_BDC_FORM_5_25INCH		0x01
2310#define SVPD_BDC_FORM_3_5INCH		0x02
2311#define SVPD_BDC_FORM_2_5INCH		0x03
2312#define SVPD_BDC_FORM_1_5INCH		0x04
2313#define SVPD_BDC_FORM_LESSTHAN_1_5INCH	0x05
2314	u_int8_t reserved2[56];
2315};
2316
2317/*
2318 * Block Device Characteristics VPD Page
2319 */
2320struct scsi_vpd_block_device_characteristics
2321{
2322	uint8_t device;
2323	uint8_t page_code;
2324#define	SVPD_BDC		0xB1
2325	uint8_t page_length[2];
2326	uint8_t medium_rotation_rate[2];
2327#define	SVPD_NOT_REPORTED	0x0000
2328#define	SVPD_NON_ROTATING	0x0001
2329	uint8_t product_type;
2330	uint8_t wab_wac_ff;
2331	uint8_t flags;
2332#define	SVPD_VBULS		0x01
2333#define	SVPD_FUAB		0x02
2334#define	SVPD_HAW_ZBC		0x10
2335	uint8_t reserved[55];
2336};
2337
2338/*
2339 * Logical Block Provisioning VPD Page based on
2340 * T10/1799-D Revision 31
2341 */
2342struct scsi_vpd_logical_block_prov
2343{
2344	u_int8_t device;
2345	u_int8_t page_code;
2346#define	SVPD_LBP		0xB2
2347	u_int8_t page_length[2];
2348#define SVPD_LBP_PL_BASIC	0x04
2349	u_int8_t threshold_exponent;
2350	u_int8_t flags;
2351#define SVPD_LBP_UNMAP		0x80
2352#define SVPD_LBP_WS16		0x40
2353#define SVPD_LBP_WS10		0x20
2354#define SVPD_LBP_RZ		0x04
2355#define SVPD_LBP_ANC_SUP	0x02
2356#define SVPD_LBP_DP		0x01
2357	u_int8_t prov_type;
2358#define SVPD_LBP_RESOURCE	0x01
2359#define SVPD_LBP_THIN		0x02
2360	u_int8_t reserved;
2361	/*
2362	 * Provisioning Group Descriptor can be here if SVPD_LBP_DP is set
2363	 * Its size can be determined from page_length - 4
2364	 */
2365};
2366
2367/*
2368 * Block Limits VDP Page based on
2369 * T10/1799-D Revision 31
2370 */
2371struct scsi_vpd_block_limits
2372{
2373	u_int8_t device;
2374	u_int8_t page_code;
2375#define	SVPD_BLOCK_LIMITS	0xB0
2376	u_int8_t page_length[2];
2377#define SVPD_BL_PL_BASIC	0x10
2378#define SVPD_BL_PL_TP		0x3C
2379	u_int8_t reserved1;
2380	u_int8_t max_cmp_write_len;
2381	u_int8_t opt_txfer_len_grain[2];
2382	u_int8_t max_txfer_len[4];
2383	u_int8_t opt_txfer_len[4];
2384	u_int8_t max_prefetch[4];
2385	u_int8_t max_unmap_lba_cnt[4];
2386	u_int8_t max_unmap_blk_cnt[4];
2387	u_int8_t opt_unmap_grain[4];
2388	u_int8_t unmap_grain_align[4];
2389	u_int8_t max_write_same_length[8];
2390	u_int8_t reserved2[20];
2391};
2392
2393struct scsi_read_capacity
2394{
2395	u_int8_t opcode;
2396	u_int8_t byte2;
2397#define	SRC_RELADR	0x01
2398	u_int8_t addr[4];
2399	u_int8_t unused[2];
2400	u_int8_t pmi;
2401#define	SRC_PMI		0x01
2402	u_int8_t control;
2403};
2404
2405struct scsi_read_capacity_16
2406{
2407	uint8_t opcode;
2408#define	SRC16_SERVICE_ACTION	0x10
2409	uint8_t service_action;
2410	uint8_t addr[8];
2411	uint8_t alloc_len[4];
2412#define	SRC16_PMI		0x01
2413#define	SRC16_RELADR		0x02
2414	uint8_t reladr;
2415	uint8_t control;
2416};
2417
2418struct scsi_read_capacity_data
2419{
2420	u_int8_t addr[4];
2421	u_int8_t length[4];
2422};
2423
2424struct scsi_read_capacity_data_long
2425{
2426	uint8_t addr[8];
2427	uint8_t length[4];
2428#define	SRC16_PROT_EN		0x01
2429#define	SRC16_P_TYPE		0x0e
2430#define	SRC16_PTYPE_1		0x00
2431#define	SRC16_PTYPE_2		0x02
2432#define	SRC16_PTYPE_3		0x04
2433	uint8_t prot;
2434#define	SRC16_LBPPBE		0x0f
2435#define	SRC16_PI_EXPONENT	0xf0
2436#define	SRC16_PI_EXPONENT_SHIFT	4
2437	uint8_t prot_lbppbe;
2438#define	SRC16_LALBA		0x3f
2439#define	SRC16_LBPRZ		0x40
2440#define	SRC16_LBPME		0x80
2441/*
2442 * Alternate versions of these macros that are intended for use on a 16-bit
2443 * version of the lalba_lbp field instead of the array of 2 8 bit numbers.
2444 */
2445#define	SRC16_LALBA_A		0x3fff
2446#define	SRC16_LBPRZ_A		0x4000
2447#define	SRC16_LBPME_A		0x8000
2448	uint8_t lalba_lbp[2];
2449	uint8_t	reserved[16];
2450};
2451
2452struct scsi_report_luns
2453{
2454	uint8_t opcode;
2455	uint8_t reserved1;
2456#define	RPL_REPORT_DEFAULT	0x00
2457#define	RPL_REPORT_WELLKNOWN	0x01
2458#define	RPL_REPORT_ALL		0x02
2459	uint8_t select_report;
2460	uint8_t reserved2[3];
2461	uint8_t length[4];
2462	uint8_t reserved3;
2463	uint8_t control;
2464};
2465
2466struct scsi_report_luns_lundata {
2467	uint8_t lundata[8];
2468#define	RPL_LUNDATA_PERIPH_BUS_MASK	0x3f
2469#define	RPL_LUNDATA_FLAT_LUN_MASK	0x3f
2470#define	RPL_LUNDATA_FLAT_LUN_BITS	0x06
2471#define	RPL_LUNDATA_LUN_TARG_MASK	0x3f
2472#define	RPL_LUNDATA_LUN_BUS_MASK	0xe0
2473#define	RPL_LUNDATA_LUN_LUN_MASK	0x1f
2474#define	RPL_LUNDATA_EXT_LEN_MASK	0x30
2475#define	RPL_LUNDATA_EXT_EAM_MASK	0x0f
2476#define	RPL_LUNDATA_EXT_EAM_WK		0x01
2477#define	RPL_LUNDATA_EXT_EAM_NOT_SPEC	0x0f
2478#define	RPL_LUNDATA_ATYP_MASK	0xc0	/* MBZ for type 0 lun */
2479#define	RPL_LUNDATA_ATYP_PERIPH	0x00
2480#define	RPL_LUNDATA_ATYP_FLAT	0x40
2481#define	RPL_LUNDATA_ATYP_LUN	0x80
2482#define	RPL_LUNDATA_ATYP_EXTLUN	0xc0
2483};
2484
2485struct scsi_report_luns_data {
2486	u_int8_t length[4];	/* length of LUN inventory, in bytes */
2487	u_int8_t reserved[4];	/* unused */
2488	/*
2489	 * LUN inventory- we only support the type zero form for now.
2490	 */
2491	struct scsi_report_luns_lundata luns[0];
2492};
2493
2494struct scsi_target_group
2495{
2496	uint8_t opcode;
2497	uint8_t service_action;
2498#define	STG_PDF_MASK		0xe0
2499#define	STG_PDF_LENGTH		0x00
2500#define	STG_PDF_EXTENDED	0x20
2501	uint8_t reserved1[4];
2502	uint8_t length[4];
2503	uint8_t reserved2;
2504	uint8_t control;
2505};
2506
2507struct scsi_target_port_descriptor {
2508	uint8_t	reserved[2];
2509	uint8_t	relative_target_port_identifier[2];
2510	uint8_t desc_list[];
2511};
2512
2513struct scsi_target_port_group_descriptor {
2514	uint8_t	pref_state;
2515#define	TPG_PRIMARY				0x80
2516#define	TPG_ASYMMETRIC_ACCESS_STATE_MASK	0xf
2517#define	TPG_ASYMMETRIC_ACCESS_OPTIMIZED		0x0
2518#define	TPG_ASYMMETRIC_ACCESS_NONOPTIMIZED	0x1
2519#define	TPG_ASYMMETRIC_ACCESS_STANDBY		0x2
2520#define	TPG_ASYMMETRIC_ACCESS_UNAVAILABLE	0x3
2521#define	TPG_ASYMMETRIC_ACCESS_LBA_DEPENDENT	0x4
2522#define	TPG_ASYMMETRIC_ACCESS_OFFLINE		0xE
2523#define	TPG_ASYMMETRIC_ACCESS_TRANSITIONING	0xF
2524	uint8_t support;
2525#define	TPG_AO_SUP	0x01
2526#define	TPG_AN_SUP	0x02
2527#define	TPG_S_SUP	0x04
2528#define	TPG_U_SUP	0x08
2529#define	TPG_LBD_SUP	0x10
2530#define	TPG_O_SUP	0x40
2531#define	TPG_T_SUP	0x80
2532	uint8_t target_port_group[2];
2533	uint8_t reserved;
2534	uint8_t status;
2535#define TPG_UNAVLBL      0
2536#define TPG_SET_BY_STPG  0x01
2537#define TPG_IMPLICIT     0x02
2538	uint8_t vendor_specific;
2539	uint8_t	target_port_count;
2540	struct scsi_target_port_descriptor descriptors[];
2541};
2542
2543struct scsi_target_group_data {
2544	uint8_t length[4];	/* length of returned data, in bytes */
2545	struct scsi_target_port_group_descriptor groups[];
2546};
2547
2548struct scsi_target_group_data_extended {
2549	uint8_t length[4];	/* length of returned data, in bytes */
2550	uint8_t format_type;	/* STG_PDF_LENGTH or STG_PDF_EXTENDED */
2551	uint8_t	implicit_transition_time;
2552	uint8_t reserved[2];
2553	struct scsi_target_port_group_descriptor groups[];
2554};
2555
2556
2557typedef enum {
2558	SSD_TYPE_NONE,
2559	SSD_TYPE_FIXED,
2560	SSD_TYPE_DESC
2561} scsi_sense_data_type;
2562
2563typedef enum {
2564	SSD_ELEM_NONE,
2565	SSD_ELEM_SKIP,
2566	SSD_ELEM_DESC,
2567	SSD_ELEM_SKS,
2568	SSD_ELEM_COMMAND,
2569	SSD_ELEM_INFO,
2570	SSD_ELEM_FRU,
2571	SSD_ELEM_STREAM,
2572	SSD_ELEM_MAX
2573} scsi_sense_elem_type;
2574
2575
2576struct scsi_sense_data
2577{
2578	uint8_t error_code;
2579	/*
2580	 * SPC-4 says that the maximum length of sense data is 252 bytes.
2581	 * So this structure is exactly 252 bytes log.
2582	 */
2583#define	SSD_FULL_SIZE 252
2584	uint8_t sense_buf[SSD_FULL_SIZE - 1];
2585	/*
2586	 * XXX KDM is this still a reasonable minimum size?
2587	 */
2588#define	SSD_MIN_SIZE 18
2589	/*
2590	 * Maximum value for the extra_len field in the sense data.
2591	 */
2592#define	SSD_EXTRA_MAX 244
2593};
2594
2595/*
2596 * Fixed format sense data.
2597 */
2598struct scsi_sense_data_fixed
2599{
2600	u_int8_t error_code;
2601#define	SSD_ERRCODE			0x7F
2602#define		SSD_CURRENT_ERROR	0x70
2603#define		SSD_DEFERRED_ERROR	0x71
2604#define	SSD_ERRCODE_VALID	0x80
2605	u_int8_t segment;
2606	u_int8_t flags;
2607#define	SSD_KEY				0x0F
2608#define		SSD_KEY_NO_SENSE	0x00
2609#define		SSD_KEY_RECOVERED_ERROR	0x01
2610#define		SSD_KEY_NOT_READY	0x02
2611#define		SSD_KEY_MEDIUM_ERROR	0x03
2612#define		SSD_KEY_HARDWARE_ERROR	0x04
2613#define		SSD_KEY_ILLEGAL_REQUEST	0x05
2614#define		SSD_KEY_UNIT_ATTENTION	0x06
2615#define		SSD_KEY_DATA_PROTECT	0x07
2616#define		SSD_KEY_BLANK_CHECK	0x08
2617#define		SSD_KEY_Vendor_Specific	0x09
2618#define		SSD_KEY_COPY_ABORTED	0x0a
2619#define		SSD_KEY_ABORTED_COMMAND	0x0b
2620#define		SSD_KEY_EQUAL		0x0c
2621#define		SSD_KEY_VOLUME_OVERFLOW	0x0d
2622#define		SSD_KEY_MISCOMPARE	0x0e
2623#define		SSD_KEY_COMPLETED	0x0f
2624#define	SSD_ILI		0x20
2625#define	SSD_EOM		0x40
2626#define	SSD_FILEMARK	0x80
2627	u_int8_t info[4];
2628	u_int8_t extra_len;
2629	u_int8_t cmd_spec_info[4];
2630	u_int8_t add_sense_code;
2631	u_int8_t add_sense_code_qual;
2632	u_int8_t fru;
2633	u_int8_t sense_key_spec[3];
2634#define	SSD_SCS_VALID		0x80
2635#define	SSD_FIELDPTR_CMD	0x40
2636#define	SSD_BITPTR_VALID	0x08
2637#define	SSD_BITPTR_VALUE	0x07
2638	u_int8_t extra_bytes[14];
2639#define	SSD_FIXED_IS_PRESENT(sense, length, field) 			\
2640	((length >= (offsetof(struct scsi_sense_data_fixed, field) +	\
2641	sizeof(sense->field))) ? 1 :0)
2642#define	SSD_FIXED_IS_FILLED(sense, field) 				\
2643	((((offsetof(struct scsi_sense_data_fixed, field) +		\
2644	sizeof(sense->field)) -						\
2645	(offsetof(struct scsi_sense_data_fixed, extra_len) +		\
2646	sizeof(sense->extra_len))) <= sense->extra_len) ? 1 : 0)
2647};
2648
2649/*
2650 * Descriptor format sense data definitions.
2651 * Introduced in SPC-3.
2652 */
2653struct scsi_sense_data_desc
2654{
2655	uint8_t	error_code;
2656#define	SSD_DESC_CURRENT_ERROR	0x72
2657#define	SSD_DESC_DEFERRED_ERROR	0x73
2658	uint8_t sense_key;
2659	uint8_t	add_sense_code;
2660	uint8_t	add_sense_code_qual;
2661	uint8_t	reserved[3];
2662	/*
2663	 * Note that SPC-4, section 4.5.2.1 says that the extra_len field
2664	 * must be less than or equal to 244.
2665	 */
2666	uint8_t	extra_len;
2667	uint8_t	sense_desc[0];
2668#define	SSD_DESC_IS_PRESENT(sense, length, field) 			\
2669	((length >= (offsetof(struct scsi_sense_data_desc, field) +	\
2670	sizeof(sense->field))) ? 1 :0)
2671};
2672
2673struct scsi_sense_desc_header
2674{
2675	uint8_t desc_type;
2676	uint8_t length;
2677};
2678/*
2679 * The information provide in the Information descriptor is device type or
2680 * command specific information, and defined in a command standard.
2681 *
2682 * Note that any changes to the field names or positions in this structure,
2683 * even reserved fields, should be accompanied by an examination of the
2684 * code in ctl_set_sense() that uses them.
2685 *
2686 * Maximum descriptors allowed: 1 (as of SPC-4)
2687 */
2688struct scsi_sense_info
2689{
2690	uint8_t	desc_type;
2691#define	SSD_DESC_INFO	0x00
2692	uint8_t	length;
2693	uint8_t	byte2;
2694#define	SSD_INFO_VALID	0x80
2695	uint8_t	reserved;
2696	uint8_t	info[8];
2697};
2698
2699/*
2700 * Command-specific information depends on the command for which the
2701 * reported condition occured.
2702 *
2703 * Note that any changes to the field names or positions in this structure,
2704 * even reserved fields, should be accompanied by an examination of the
2705 * code in ctl_set_sense() that uses them.
2706 *
2707 * Maximum descriptors allowed: 1 (as of SPC-4)
2708 */
2709struct scsi_sense_command
2710{
2711	uint8_t	desc_type;
2712#define	SSD_DESC_COMMAND	0x01
2713	uint8_t	length;
2714	uint8_t	reserved[2];
2715	uint8_t	command_info[8];
2716};
2717
2718/*
2719 * Sense key specific descriptor.  The sense key specific data format
2720 * depends on the sense key in question.
2721 *
2722 * Maximum descriptors allowed: 1 (as of SPC-4)
2723 */
2724struct scsi_sense_sks
2725{
2726	uint8_t	desc_type;
2727#define	SSD_DESC_SKS		0x02
2728	uint8_t	length;
2729	uint8_t reserved1[2];
2730	uint8_t	sense_key_spec[3];
2731#define	SSD_SKS_VALID		0x80
2732	uint8_t reserved2;
2733};
2734
2735/*
2736 * This is used for the Illegal Request sense key (0x05) only.
2737 */
2738struct scsi_sense_sks_field
2739{
2740	uint8_t	byte0;
2741#define	SSD_SKS_FIELD_VALID	0x80
2742#define	SSD_SKS_FIELD_CMD	0x40
2743#define	SSD_SKS_BPV		0x08
2744#define	SSD_SKS_BIT_VALUE	0x07
2745	uint8_t	field[2];
2746};
2747
2748
2749/*
2750 * This is used for the Hardware Error (0x04), Medium Error (0x03) and
2751 * Recovered Error (0x01) sense keys.
2752 */
2753struct scsi_sense_sks_retry
2754{
2755	uint8_t byte0;
2756#define	SSD_SKS_RETRY_VALID	0x80
2757	uint8_t actual_retry_count[2];
2758};
2759
2760/*
2761 * Used with the NO Sense (0x00) or Not Ready (0x02) sense keys.
2762 */
2763struct scsi_sense_sks_progress
2764{
2765	uint8_t byte0;
2766#define	SSD_SKS_PROGRESS_VALID	0x80
2767	uint8_t progress[2];
2768#define	SSD_SKS_PROGRESS_DENOM	0x10000
2769};
2770
2771/*
2772 * Used with the Copy Aborted (0x0a) sense key.
2773 */
2774struct scsi_sense_sks_segment
2775{
2776	uint8_t byte0;
2777#define	SSD_SKS_SEGMENT_VALID	0x80
2778#define	SSD_SKS_SEGMENT_SD	0x20
2779#define	SSD_SKS_SEGMENT_BPV	0x08
2780#define	SSD_SKS_SEGMENT_BITPTR	0x07
2781	uint8_t field[2];
2782};
2783
2784/*
2785 * Used with the Unit Attention (0x06) sense key.
2786 *
2787 * This is currently used to indicate that the unit attention condition
2788 * queue has overflowed (when the overflow bit is set).
2789 */
2790struct scsi_sense_sks_overflow
2791{
2792	uint8_t byte0;
2793#define	SSD_SKS_OVERFLOW_VALID	0x80
2794#define	SSD_SKS_OVERFLOW_SET	0x01
2795	uint8_t	reserved[2];
2796};
2797
2798/*
2799 * This specifies which component is associated with the sense data.  There
2800 * is no standard meaning for the fru value.
2801 *
2802 * Maximum descriptors allowed: 1 (as of SPC-4)
2803 */
2804struct scsi_sense_fru
2805{
2806	uint8_t	desc_type;
2807#define	SSD_DESC_FRU		0x03
2808	uint8_t	length;
2809	uint8_t reserved;
2810	uint8_t fru;
2811};
2812
2813/*
2814 * Used for Stream commands, defined in SSC-4.
2815 *
2816 * Maximum descriptors allowed: 1 (as of SPC-4)
2817 */
2818
2819struct scsi_sense_stream
2820{
2821	uint8_t	desc_type;
2822#define	SSD_DESC_STREAM		0x04
2823	uint8_t	length;
2824	uint8_t	reserved;
2825	uint8_t	byte3;
2826#define	SSD_DESC_STREAM_FM	0x80
2827#define	SSD_DESC_STREAM_EOM	0x40
2828#define	SSD_DESC_STREAM_ILI	0x20
2829};
2830
2831/*
2832 * Used for Block commands, defined in SBC-3.
2833 *
2834 * This is currently (as of SBC-3) only used for the Incorrect Length
2835 * Indication (ILI) bit, which says that the data length requested in the
2836 * READ LONG or WRITE LONG command did not match the length of the logical
2837 * block.
2838 *
2839 * Maximum descriptors allowed: 1 (as of SPC-4)
2840 */
2841struct scsi_sense_block
2842{
2843	uint8_t	desc_type;
2844#define	SSD_DESC_BLOCK		0x05
2845	uint8_t	length;
2846	uint8_t	reserved;
2847	uint8_t	byte3;
2848#define	SSD_DESC_BLOCK_ILI	0x20
2849};
2850
2851/*
2852 * Used for Object-Based Storage Devices (OSD-3).
2853 *
2854 * Maximum descriptors allowed: 1 (as of SPC-4)
2855 */
2856struct scsi_sense_osd_objid
2857{
2858	uint8_t	desc_type;
2859#define	SSD_DESC_OSD_OBJID	0x06
2860	uint8_t	length;
2861	uint8_t	reserved[6];
2862	/*
2863	 * XXX KDM provide the bit definitions here?  There are a lot of
2864	 * them, and we don't have an OSD driver yet.
2865	 */
2866	uint8_t	not_init_cmds[4];
2867	uint8_t	completed_cmds[4];
2868	uint8_t	partition_id[8];
2869	uint8_t	object_id[8];
2870};
2871
2872/*
2873 * Used for Object-Based Storage Devices (OSD-3).
2874 *
2875 * Maximum descriptors allowed: 1 (as of SPC-4)
2876 */
2877struct scsi_sense_osd_integrity
2878{
2879	uint8_t	desc_type;
2880#define	SSD_DESC_OSD_INTEGRITY	0x07
2881	uint8_t	length;
2882	uint8_t	integ_check_val[32];
2883};
2884
2885/*
2886 * Used for Object-Based Storage Devices (OSD-3).
2887 *
2888 * Maximum descriptors allowed: 1 (as of SPC-4)
2889 */
2890struct scsi_sense_osd_attr_id
2891{
2892	uint8_t	desc_type;
2893#define	SSD_DESC_OSD_ATTR_ID	0x08
2894	uint8_t	length;
2895	uint8_t	reserved[2];
2896	uint8_t	attr_desc[0];
2897};
2898
2899/*
2900 * Used with Sense keys No Sense (0x00) and Not Ready (0x02).
2901 *
2902 * Maximum descriptors allowed: 32 (as of SPC-4)
2903 */
2904struct scsi_sense_progress
2905{
2906	uint8_t	desc_type;
2907#define	SSD_DESC_PROGRESS	0x0a
2908	uint8_t	length;
2909	uint8_t	sense_key;
2910	uint8_t	add_sense_code;
2911	uint8_t	add_sense_code_qual;
2912	uint8_t reserved;
2913	uint8_t	progress[2];
2914};
2915
2916/*
2917 * This is typically forwarded as the result of an EXTENDED COPY command.
2918 *
2919 * Maximum descriptors allowed: 2 (as of SPC-4)
2920 */
2921struct scsi_sense_forwarded
2922{
2923	uint8_t	desc_type;
2924#define	SSD_DESC_FORWARDED	0x0c
2925	uint8_t	length;
2926	uint8_t	byte2;
2927#define	SSD_FORWARDED_FSDT	0x80
2928#define	SSD_FORWARDED_SDS_MASK	0x0f
2929#define	SSD_FORWARDED_SDS_UNK	0x00
2930#define	SSD_FORWARDED_SDS_EXSRC	0x01
2931#define	SSD_FORWARDED_SDS_EXDST	0x02
2932};
2933
2934/*
2935 * Vendor-specific sense descriptor.  The desc_type field will be in the
2936 * range bewteen MIN and MAX inclusive.
2937 */
2938struct scsi_sense_vendor
2939{
2940	uint8_t	desc_type;
2941#define	SSD_DESC_VENDOR_MIN	0x80
2942#define	SSD_DESC_VENDOR_MAX	0xff
2943	uint8_t length;
2944	uint8_t	data[0];
2945};
2946
2947struct scsi_mode_header_6
2948{
2949	u_int8_t data_length;	/* Sense data length */
2950	u_int8_t medium_type;
2951	u_int8_t dev_spec;
2952	u_int8_t blk_desc_len;
2953};
2954
2955struct scsi_mode_header_10
2956{
2957	u_int8_t data_length[2];/* Sense data length */
2958	u_int8_t medium_type;
2959	u_int8_t dev_spec;
2960	u_int8_t unused[2];
2961	u_int8_t blk_desc_len[2];
2962};
2963
2964struct scsi_mode_page_header
2965{
2966	u_int8_t page_code;
2967#define	SMPH_PS		0x80
2968#define	SMPH_SPF	0x40
2969#define	SMPH_PC_MASK	0x3f
2970	u_int8_t page_length;
2971};
2972
2973struct scsi_mode_page_header_sp
2974{
2975	uint8_t page_code;
2976	uint8_t subpage;
2977	uint8_t page_length[2];
2978};
2979
2980
2981struct scsi_mode_blk_desc
2982{
2983	u_int8_t density;
2984	u_int8_t nblocks[3];
2985	u_int8_t reserved;
2986	u_int8_t blklen[3];
2987};
2988
2989#define	SCSI_DEFAULT_DENSITY	0x00	/* use 'default' density */
2990#define	SCSI_SAME_DENSITY	0x7f	/* use 'same' density- >= SCSI-2 only */
2991
2992
2993/*
2994 * Status Byte
2995 */
2996#define	SCSI_STATUS_OK			0x00
2997#define	SCSI_STATUS_CHECK_COND		0x02
2998#define	SCSI_STATUS_COND_MET		0x04
2999#define	SCSI_STATUS_BUSY		0x08
3000#define	SCSI_STATUS_INTERMED		0x10
3001#define	SCSI_STATUS_INTERMED_COND_MET	0x14
3002#define	SCSI_STATUS_RESERV_CONFLICT	0x18
3003#define	SCSI_STATUS_CMD_TERMINATED	0x22	/* Obsolete in SAM-2 */
3004#define	SCSI_STATUS_QUEUE_FULL		0x28
3005#define	SCSI_STATUS_ACA_ACTIVE		0x30
3006#define	SCSI_STATUS_TASK_ABORTED	0x40
3007
3008struct scsi_inquiry_pattern {
3009	u_int8_t   type;
3010	u_int8_t   media_type;
3011#define	SIP_MEDIA_REMOVABLE	0x01
3012#define	SIP_MEDIA_FIXED		0x02
3013	const char *vendor;
3014	const char *product;
3015	const char *revision;
3016};
3017
3018struct scsi_static_inquiry_pattern {
3019	u_int8_t   type;
3020	u_int8_t   media_type;
3021	char       vendor[SID_VENDOR_SIZE+1];
3022	char       product[SID_PRODUCT_SIZE+1];
3023	char       revision[SID_REVISION_SIZE+1];
3024};
3025
3026struct scsi_sense_quirk_entry {
3027	struct scsi_inquiry_pattern	inq_pat;
3028	int				num_sense_keys;
3029	int				num_ascs;
3030	struct sense_key_table_entry	*sense_key_info;
3031	struct asc_table_entry		*asc_info;
3032};
3033
3034struct sense_key_table_entry {
3035	u_int8_t    sense_key;
3036	u_int32_t   action;
3037	const char *desc;
3038};
3039
3040struct asc_table_entry {
3041	u_int8_t    asc;
3042	u_int8_t    ascq;
3043	u_int32_t   action;
3044	const char *desc;
3045};
3046
3047struct op_table_entry {
3048	u_int8_t    opcode;
3049	u_int32_t   opmask;
3050	const char  *desc;
3051};
3052
3053struct scsi_op_quirk_entry {
3054	struct scsi_inquiry_pattern	inq_pat;
3055	int				num_ops;
3056	struct op_table_entry		*op_table;
3057};
3058
3059typedef enum {
3060	SSS_FLAG_NONE		= 0x00,
3061	SSS_FLAG_PRINT_COMMAND	= 0x01
3062} scsi_sense_string_flags;
3063
3064struct scsi_nv {
3065	const char *name;
3066	uint64_t value;
3067};
3068
3069typedef enum {
3070	SCSI_NV_FOUND,
3071	SCSI_NV_AMBIGUOUS,
3072	SCSI_NV_NOT_FOUND
3073} scsi_nv_status;
3074
3075typedef enum {
3076	SCSI_NV_FLAG_NONE	= 0x00,
3077	SCSI_NV_FLAG_IG_CASE	= 0x01	/* Case insensitive comparison */
3078} scsi_nv_flags;
3079
3080struct ccb_scsiio;
3081struct cam_periph;
3082union  ccb;
3083#ifndef _KERNEL
3084struct cam_device;
3085#endif
3086
3087extern const char *scsi_sense_key_text[];
3088
3089struct sbuf;
3090
3091__BEGIN_DECLS
3092void scsi_sense_desc(int sense_key, int asc, int ascq,
3093		     struct scsi_inquiry_data *inq_data,
3094		     const char **sense_key_desc, const char **asc_desc);
3095scsi_sense_action scsi_error_action(struct ccb_scsiio* csio,
3096				    struct scsi_inquiry_data *inq_data,
3097				    u_int32_t sense_flags);
3098const char *	scsi_status_string(struct ccb_scsiio *csio);
3099
3100void scsi_desc_iterate(struct scsi_sense_data_desc *sense, u_int sense_len,
3101		       int (*iter_func)(struct scsi_sense_data_desc *sense,
3102					u_int, struct scsi_sense_desc_header *,
3103					void *), void *arg);
3104uint8_t *scsi_find_desc(struct scsi_sense_data_desc *sense, u_int sense_len,
3105			uint8_t desc_type);
3106void scsi_set_sense_data(struct scsi_sense_data *sense_data,
3107			 scsi_sense_data_type sense_format, int current_error,
3108			 int sense_key, int asc, int ascq, ...) ;
3109void scsi_set_sense_data_va(struct scsi_sense_data *sense_data,
3110			    scsi_sense_data_type sense_format,
3111			    int current_error, int sense_key, int asc,
3112			    int ascq, va_list ap);
3113int scsi_get_sense_info(struct scsi_sense_data *sense_data, u_int sense_len,
3114			uint8_t info_type, uint64_t *info,
3115			int64_t *signed_info);
3116int scsi_get_sks(struct scsi_sense_data *sense_data, u_int sense_len,
3117		 uint8_t *sks);
3118int scsi_get_block_info(struct scsi_sense_data *sense_data, u_int sense_len,
3119			struct scsi_inquiry_data *inq_data,
3120			uint8_t *block_bits);
3121int scsi_get_stream_info(struct scsi_sense_data *sense_data, u_int sense_len,
3122			 struct scsi_inquiry_data *inq_data,
3123			 uint8_t *stream_bits);
3124void scsi_info_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len,
3125		    struct scsi_inquiry_data *inq_data, uint64_t info);
3126void scsi_command_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len,
3127		       struct scsi_inquiry_data *inq_data, uint64_t csi);
3128void scsi_progress_sbuf(struct sbuf *sb, uint16_t progress);
3129int scsi_sks_sbuf(struct sbuf *sb, int sense_key, uint8_t *sks);
3130void scsi_fru_sbuf(struct sbuf *sb, uint64_t fru);
3131void scsi_stream_sbuf(struct sbuf *sb, uint8_t stream_bits, uint64_t info);
3132void scsi_block_sbuf(struct sbuf *sb, uint8_t block_bits, uint64_t info);
3133void scsi_sense_info_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3134			  u_int sense_len, uint8_t *cdb, int cdb_len,
3135			  struct scsi_inquiry_data *inq_data,
3136			  struct scsi_sense_desc_header *header);
3137
3138void scsi_sense_command_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3139			     u_int sense_len, uint8_t *cdb, int cdb_len,
3140			     struct scsi_inquiry_data *inq_data,
3141			     struct scsi_sense_desc_header *header);
3142void scsi_sense_sks_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3143			 u_int sense_len, uint8_t *cdb, int cdb_len,
3144			 struct scsi_inquiry_data *inq_data,
3145			 struct scsi_sense_desc_header *header);
3146void scsi_sense_fru_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3147			 u_int sense_len, uint8_t *cdb, int cdb_len,
3148			 struct scsi_inquiry_data *inq_data,
3149			 struct scsi_sense_desc_header *header);
3150void scsi_sense_stream_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3151			    u_int sense_len, uint8_t *cdb, int cdb_len,
3152			    struct scsi_inquiry_data *inq_data,
3153			    struct scsi_sense_desc_header *header);
3154void scsi_sense_block_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3155			   u_int sense_len, uint8_t *cdb, int cdb_len,
3156			   struct scsi_inquiry_data *inq_data,
3157			   struct scsi_sense_desc_header *header);
3158void scsi_sense_progress_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3159			      u_int sense_len, uint8_t *cdb, int cdb_len,
3160			      struct scsi_inquiry_data *inq_data,
3161			      struct scsi_sense_desc_header *header);
3162void scsi_sense_generic_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3163			     u_int sense_len, uint8_t *cdb, int cdb_len,
3164			     struct scsi_inquiry_data *inq_data,
3165			     struct scsi_sense_desc_header *header);
3166void scsi_sense_desc_sbuf(struct sbuf *sb, struct scsi_sense_data *sense,
3167			  u_int sense_len, uint8_t *cdb, int cdb_len,
3168			  struct scsi_inquiry_data *inq_data,
3169			  struct scsi_sense_desc_header *header);
3170scsi_sense_data_type scsi_sense_type(struct scsi_sense_data *sense_data);
3171
3172void scsi_sense_only_sbuf(struct scsi_sense_data *sense, u_int sense_len,
3173			  struct sbuf *sb, char *path_str,
3174			  struct scsi_inquiry_data *inq_data, uint8_t *cdb,
3175			  int cdb_len);
3176
3177#ifdef _KERNEL
3178int		scsi_command_string(struct ccb_scsiio *csio, struct sbuf *sb);
3179int		scsi_sense_sbuf(struct ccb_scsiio *csio, struct sbuf *sb,
3180				scsi_sense_string_flags flags);
3181char *		scsi_sense_string(struct ccb_scsiio *csio,
3182				  char *str, int str_len);
3183void		scsi_sense_print(struct ccb_scsiio *csio);
3184int 		scsi_vpd_supported_page(struct cam_periph *periph,
3185					uint8_t page_id);
3186#else /* _KERNEL */
3187int		scsi_command_string(struct cam_device *device,
3188				    struct ccb_scsiio *csio, struct sbuf *sb);
3189int		scsi_sense_sbuf(struct cam_device *device,
3190				struct ccb_scsiio *csio, struct sbuf *sb,
3191				scsi_sense_string_flags flags);
3192char *		scsi_sense_string(struct cam_device *device,
3193				  struct ccb_scsiio *csio,
3194				  char *str, int str_len);
3195void		scsi_sense_print(struct cam_device *device,
3196				 struct ccb_scsiio *csio, FILE *ofile);
3197#endif /* _KERNEL */
3198
3199const char *	scsi_op_desc(u_int16_t opcode,
3200			     struct scsi_inquiry_data *inq_data);
3201char *		scsi_cdb_string(u_int8_t *cdb_ptr, char *cdb_string,
3202				size_t len);
3203
3204void		scsi_print_inquiry(struct scsi_inquiry_data *inq_data);
3205void		scsi_print_inquiry_short(struct scsi_inquiry_data *inq_data);
3206
3207u_int		scsi_calc_syncsrate(u_int period_factor);
3208u_int		scsi_calc_syncparam(u_int period);
3209
3210typedef int	(*scsi_devid_checkfn_t)(uint8_t *);
3211int		scsi_devid_is_naa_ieee_reg(uint8_t *bufp);
3212int		scsi_devid_is_sas_target(uint8_t *bufp);
3213int		scsi_devid_is_lun_eui64(uint8_t *bufp);
3214int		scsi_devid_is_lun_naa(uint8_t *bufp);
3215int		scsi_devid_is_lun_name(uint8_t *bufp);
3216int		scsi_devid_is_lun_t10(uint8_t *bufp);
3217struct scsi_vpd_id_descriptor *
3218		scsi_get_devid(struct scsi_vpd_device_id *id, uint32_t len,
3219			       scsi_devid_checkfn_t ck_fn);
3220struct scsi_vpd_id_descriptor *
3221		scsi_get_devid_desc(struct scsi_vpd_id_descriptor *desc, uint32_t len,
3222			       scsi_devid_checkfn_t ck_fn);
3223
3224int		scsi_transportid_sbuf(struct sbuf *sb,
3225				      struct scsi_transportid_header *hdr,
3226				      uint32_t valid_len);
3227
3228const char *	scsi_nv_to_str(struct scsi_nv *table, int num_table_entries,
3229			       uint64_t value);
3230
3231scsi_nv_status	scsi_get_nv(struct scsi_nv *table, int num_table_entries,
3232			    char *name, int *table_entry, scsi_nv_flags flags);
3233
3234int	scsi_parse_transportid_64bit(int proto_id, char *id_str,
3235				     struct scsi_transportid_header **hdr,
3236				     unsigned int *alloc_len,
3237#ifdef _KERNEL
3238				     struct malloc_type *type, int flags,
3239#endif
3240				     char *error_str, int error_str_len);
3241
3242int	scsi_parse_transportid_spi(char *id_str,
3243				   struct scsi_transportid_header **hdr,
3244				   unsigned int *alloc_len,
3245#ifdef _KERNEL
3246				   struct malloc_type *type, int flags,
3247#endif
3248				   char *error_str, int error_str_len);
3249
3250int	scsi_parse_transportid_rdma(char *id_str,
3251				    struct scsi_transportid_header **hdr,
3252				    unsigned int *alloc_len,
3253#ifdef _KERNEL
3254				    struct malloc_type *type, int flags,
3255#endif
3256				    char *error_str, int error_str_len);
3257
3258int	scsi_parse_transportid_iscsi(char *id_str,
3259				     struct scsi_transportid_header **hdr,
3260				     unsigned int *alloc_len,
3261#ifdef _KERNEL
3262				     struct malloc_type *type, int flags,
3263#endif
3264				     char *error_str,int error_str_len);
3265
3266int	scsi_parse_transportid_sop(char *id_str,
3267				   struct scsi_transportid_header **hdr,
3268				   unsigned int *alloc_len,
3269#ifdef _KERNEL
3270				   struct malloc_type *type, int flags,
3271#endif
3272				   char *error_str,int error_str_len);
3273
3274int	scsi_parse_transportid(char *transportid_str,
3275			       struct scsi_transportid_header **hdr,
3276			       unsigned int *alloc_len,
3277#ifdef _KERNEL
3278			       struct malloc_type *type, int flags,
3279#endif
3280			       char *error_str, int error_str_len);
3281
3282void		scsi_test_unit_ready(struct ccb_scsiio *csio, u_int32_t retries,
3283				     void (*cbfcnp)(struct cam_periph *,
3284						    union ccb *),
3285				     u_int8_t tag_action,
3286				     u_int8_t sense_len, u_int32_t timeout);
3287
3288void		scsi_request_sense(struct ccb_scsiio *csio, u_int32_t retries,
3289				   void (*cbfcnp)(struct cam_periph *,
3290						  union ccb *),
3291				   void *data_ptr, u_int8_t dxfer_len,
3292				   u_int8_t tag_action, u_int8_t sense_len,
3293				   u_int32_t timeout);
3294
3295void		scsi_inquiry(struct ccb_scsiio *csio, u_int32_t retries,
3296			     void (*cbfcnp)(struct cam_periph *, union ccb *),
3297			     u_int8_t tag_action, u_int8_t *inq_buf,
3298			     u_int32_t inq_len, int evpd, u_int8_t page_code,
3299			     u_int8_t sense_len, u_int32_t timeout);
3300
3301void		scsi_mode_sense(struct ccb_scsiio *csio, u_int32_t retries,
3302				void (*cbfcnp)(struct cam_periph *,
3303					       union ccb *),
3304				u_int8_t tag_action, int dbd,
3305				u_int8_t page_code, u_int8_t page,
3306				u_int8_t *param_buf, u_int32_t param_len,
3307				u_int8_t sense_len, u_int32_t timeout);
3308
3309void		scsi_mode_sense_len(struct ccb_scsiio *csio, u_int32_t retries,
3310				    void (*cbfcnp)(struct cam_periph *,
3311						   union ccb *),
3312				    u_int8_t tag_action, int dbd,
3313				    u_int8_t page_code, u_int8_t page,
3314				    u_int8_t *param_buf, u_int32_t param_len,
3315				    int minimum_cmd_size, u_int8_t sense_len,
3316				    u_int32_t timeout);
3317
3318void		scsi_mode_select(struct ccb_scsiio *csio, u_int32_t retries,
3319				 void (*cbfcnp)(struct cam_periph *,
3320						union ccb *),
3321				 u_int8_t tag_action, int scsi_page_fmt,
3322				 int save_pages, u_int8_t *param_buf,
3323				 u_int32_t param_len, u_int8_t sense_len,
3324				 u_int32_t timeout);
3325
3326void		scsi_mode_select_len(struct ccb_scsiio *csio, u_int32_t retries,
3327				     void (*cbfcnp)(struct cam_periph *,
3328						    union ccb *),
3329				     u_int8_t tag_action, int scsi_page_fmt,
3330				     int save_pages, u_int8_t *param_buf,
3331				     u_int32_t param_len, int minimum_cmd_size,
3332				     u_int8_t sense_len, u_int32_t timeout);
3333
3334void		scsi_log_sense(struct ccb_scsiio *csio, u_int32_t retries,
3335			       void (*cbfcnp)(struct cam_periph *, union ccb *),
3336			       u_int8_t tag_action, u_int8_t page_code,
3337			       u_int8_t page, int save_pages, int ppc,
3338			       u_int32_t paramptr, u_int8_t *param_buf,
3339			       u_int32_t param_len, u_int8_t sense_len,
3340			       u_int32_t timeout);
3341
3342void		scsi_log_select(struct ccb_scsiio *csio, u_int32_t retries,
3343				void (*cbfcnp)(struct cam_periph *,
3344				union ccb *), u_int8_t tag_action,
3345				u_int8_t page_code, int save_pages,
3346				int pc_reset, u_int8_t *param_buf,
3347				u_int32_t param_len, u_int8_t sense_len,
3348				u_int32_t timeout);
3349
3350void		scsi_prevent(struct ccb_scsiio *csio, u_int32_t retries,
3351			     void (*cbfcnp)(struct cam_periph *, union ccb *),
3352			     u_int8_t tag_action, u_int8_t action,
3353			     u_int8_t sense_len, u_int32_t timeout);
3354
3355void		scsi_read_capacity(struct ccb_scsiio *csio, u_int32_t retries,
3356				   void (*cbfcnp)(struct cam_periph *,
3357				   union ccb *), u_int8_t tag_action,
3358				   struct scsi_read_capacity_data *,
3359				   u_int8_t sense_len, u_int32_t timeout);
3360void		scsi_read_capacity_16(struct ccb_scsiio *csio, uint32_t retries,
3361				      void (*cbfcnp)(struct cam_periph *,
3362				      union ccb *), uint8_t tag_action,
3363				      uint64_t lba, int reladr, int pmi,
3364				      uint8_t *rcap_buf, int rcap_buf_len,
3365				      uint8_t sense_len, uint32_t timeout);
3366
3367void		scsi_report_luns(struct ccb_scsiio *csio, u_int32_t retries,
3368				 void (*cbfcnp)(struct cam_periph *,
3369				 union ccb *), u_int8_t tag_action,
3370				 u_int8_t select_report,
3371				 struct scsi_report_luns_data *rpl_buf,
3372				 u_int32_t alloc_len, u_int8_t sense_len,
3373				 u_int32_t timeout);
3374
3375void		scsi_report_target_group(struct ccb_scsiio *csio, u_int32_t retries,
3376				 void (*cbfcnp)(struct cam_periph *,
3377				 union ccb *), u_int8_t tag_action,
3378				 u_int8_t pdf,
3379				 void *buf,
3380				 u_int32_t alloc_len, u_int8_t sense_len,
3381				 u_int32_t timeout);
3382
3383void		scsi_set_target_group(struct ccb_scsiio *csio, u_int32_t retries,
3384				 void (*cbfcnp)(struct cam_periph *,
3385				 union ccb *), u_int8_t tag_action, void *buf,
3386				 u_int32_t alloc_len, u_int8_t sense_len,
3387				 u_int32_t timeout);
3388
3389void		scsi_synchronize_cache(struct ccb_scsiio *csio,
3390				       u_int32_t retries,
3391				       void (*cbfcnp)(struct cam_periph *,
3392				       union ccb *), u_int8_t tag_action,
3393				       u_int32_t begin_lba, u_int16_t lb_count,
3394				       u_int8_t sense_len, u_int32_t timeout);
3395
3396void scsi_receive_diagnostic_results(struct ccb_scsiio *csio, u_int32_t retries,
3397				     void (*cbfcnp)(struct cam_periph *,
3398						    union ccb*),
3399				     uint8_t tag_action, int pcv,
3400				     uint8_t page_code, uint8_t *data_ptr,
3401				     uint16_t allocation_length,
3402				     uint8_t sense_len, uint32_t timeout);
3403
3404void scsi_send_diagnostic(struct ccb_scsiio *csio, u_int32_t retries,
3405			  void (*cbfcnp)(struct cam_periph *, union ccb *),
3406			  uint8_t tag_action, int unit_offline,
3407			  int device_offline, int self_test, int page_format,
3408			  int self_test_code, uint8_t *data_ptr,
3409			  uint16_t param_list_length, uint8_t sense_len,
3410			  uint32_t timeout);
3411
3412void scsi_read_buffer(struct ccb_scsiio *csio, u_int32_t retries,
3413			void (*cbfcnp)(struct cam_periph *, union ccb*),
3414			uint8_t tag_action, int mode,
3415			uint8_t buffer_id, u_int32_t offset,
3416			uint8_t *data_ptr, uint32_t allocation_length,
3417			uint8_t sense_len, uint32_t timeout);
3418
3419void scsi_write_buffer(struct ccb_scsiio *csio, u_int32_t retries,
3420			void (*cbfcnp)(struct cam_periph *, union ccb *),
3421			uint8_t tag_action, int mode,
3422			uint8_t buffer_id, u_int32_t offset,
3423			uint8_t *data_ptr, uint32_t param_list_length,
3424			uint8_t sense_len, uint32_t timeout);
3425
3426#define	SCSI_RW_READ	0x0001
3427#define	SCSI_RW_WRITE	0x0002
3428#define	SCSI_RW_DIRMASK	0x0003
3429#define	SCSI_RW_BIO	0x1000
3430void scsi_read_write(struct ccb_scsiio *csio, u_int32_t retries,
3431		     void (*cbfcnp)(struct cam_periph *, union ccb *),
3432		     u_int8_t tag_action, int readop, u_int8_t byte2,
3433		     int minimum_cmd_size, u_int64_t lba,
3434		     u_int32_t block_count, u_int8_t *data_ptr,
3435		     u_int32_t dxfer_len, u_int8_t sense_len,
3436		     u_int32_t timeout);
3437
3438void scsi_write_same(struct ccb_scsiio *csio, u_int32_t retries,
3439		     void (*cbfcnp)(struct cam_periph *, union ccb *),
3440		     u_int8_t tag_action, u_int8_t byte2,
3441		     int minimum_cmd_size, u_int64_t lba,
3442		     u_int32_t block_count, u_int8_t *data_ptr,
3443		     u_int32_t dxfer_len, u_int8_t sense_len,
3444		     u_int32_t timeout);
3445
3446void scsi_ata_identify(struct ccb_scsiio *csio, u_int32_t retries,
3447		       void (*cbfcnp)(struct cam_periph *, union ccb *),
3448		       u_int8_t tag_action, u_int8_t *data_ptr,
3449		       u_int16_t dxfer_len, u_int8_t sense_len,
3450		       u_int32_t timeout);
3451
3452void scsi_ata_trim(struct ccb_scsiio *csio, u_int32_t retries,
3453	           void (*cbfcnp)(struct cam_periph *, union ccb *),
3454	           u_int8_t tag_action, u_int16_t block_count,
3455	           u_int8_t *data_ptr, u_int16_t dxfer_len,
3456	           u_int8_t sense_len, u_int32_t timeout);
3457
3458void scsi_ata_pass_16(struct ccb_scsiio *csio, u_int32_t retries,
3459		      void (*cbfcnp)(struct cam_periph *, union ccb *),
3460		      u_int32_t flags, u_int8_t tag_action,
3461		      u_int8_t protocol, u_int8_t ata_flags, u_int16_t features,
3462		      u_int16_t sector_count, uint64_t lba, u_int8_t command,
3463		      u_int8_t control, u_int8_t *data_ptr, u_int16_t dxfer_len,
3464		      u_int8_t sense_len, u_int32_t timeout);
3465
3466void scsi_unmap(struct ccb_scsiio *csio, u_int32_t retries,
3467		void (*cbfcnp)(struct cam_periph *, union ccb *),
3468		u_int8_t tag_action, u_int8_t byte2,
3469		u_int8_t *data_ptr, u_int16_t dxfer_len,
3470		u_int8_t sense_len, u_int32_t timeout);
3471
3472void scsi_start_stop(struct ccb_scsiio *csio, u_int32_t retries,
3473		     void (*cbfcnp)(struct cam_periph *, union ccb *),
3474		     u_int8_t tag_action, int start, int load_eject,
3475		     int immediate, u_int8_t sense_len, u_int32_t timeout);
3476
3477void scsi_persistent_reserve_in(struct ccb_scsiio *csio, uint32_t retries,
3478				void (*cbfcnp)(struct cam_periph *,union ccb *),
3479				uint8_t tag_action, int service_action,
3480				uint8_t *data_ptr, uint32_t dxfer_len,
3481				int sense_len, int timeout);
3482
3483void scsi_persistent_reserve_out(struct ccb_scsiio *csio, uint32_t retries,
3484				 void (*cbfcnp)(struct cam_periph *,
3485				       union ccb *),
3486				 uint8_t tag_action, int service_action,
3487				 int scope, int res_type, uint8_t *data_ptr,
3488				 uint32_t dxfer_len, int sense_len,
3489				 int timeout);
3490
3491int		scsi_inquiry_match(caddr_t inqbuffer, caddr_t table_entry);
3492int		scsi_static_inquiry_match(caddr_t inqbuffer,
3493					  caddr_t table_entry);
3494int		scsi_devid_match(uint8_t *rhs, size_t rhs_len,
3495				 uint8_t *lhs, size_t lhs_len);
3496
3497void scsi_extract_sense(struct scsi_sense_data *sense, int *error_code,
3498			int *sense_key, int *asc, int *ascq);
3499int scsi_extract_sense_ccb(union ccb *ccb, int *error_code, int *sense_key,
3500			   int *asc, int *ascq);
3501void scsi_extract_sense_len(struct scsi_sense_data *sense,
3502			    u_int sense_len, int *error_code, int *sense_key,
3503			    int *asc, int *ascq, int show_errors);
3504int scsi_get_sense_key(struct scsi_sense_data *sense, u_int sense_len,
3505		       int show_errors);
3506int scsi_get_asc(struct scsi_sense_data *sense, u_int sense_len,
3507		 int show_errors);
3508int scsi_get_ascq(struct scsi_sense_data *sense, u_int sense_len,
3509		  int show_errors);
3510static __inline void scsi_ulto2b(u_int32_t val, u_int8_t *bytes);
3511static __inline void scsi_ulto3b(u_int32_t val, u_int8_t *bytes);
3512static __inline void scsi_ulto4b(u_int32_t val, u_int8_t *bytes);
3513static __inline void scsi_u64to8b(u_int64_t val, u_int8_t *bytes);
3514static __inline uint32_t scsi_2btoul(const uint8_t *bytes);
3515static __inline uint32_t scsi_3btoul(const uint8_t *bytes);
3516static __inline int32_t scsi_3btol(const uint8_t *bytes);
3517static __inline uint32_t scsi_4btoul(const uint8_t *bytes);
3518static __inline uint64_t scsi_8btou64(const uint8_t *bytes);
3519static __inline void *find_mode_page_6(struct scsi_mode_header_6 *mode_header);
3520static __inline void *find_mode_page_10(struct scsi_mode_header_10 *mode_header);
3521
3522static __inline void
3523scsi_ulto2b(u_int32_t val, u_int8_t *bytes)
3524{
3525
3526	bytes[0] = (val >> 8) & 0xff;
3527	bytes[1] = val & 0xff;
3528}
3529
3530static __inline void
3531scsi_ulto3b(u_int32_t val, u_int8_t *bytes)
3532{
3533
3534	bytes[0] = (val >> 16) & 0xff;
3535	bytes[1] = (val >> 8) & 0xff;
3536	bytes[2] = val & 0xff;
3537}
3538
3539static __inline void
3540scsi_ulto4b(u_int32_t val, u_int8_t *bytes)
3541{
3542
3543	bytes[0] = (val >> 24) & 0xff;
3544	bytes[1] = (val >> 16) & 0xff;
3545	bytes[2] = (val >> 8) & 0xff;
3546	bytes[3] = val & 0xff;
3547}
3548
3549static __inline void
3550scsi_u64to8b(u_int64_t val, u_int8_t *bytes)
3551{
3552
3553	bytes[0] = (val >> 56) & 0xff;
3554	bytes[1] = (val >> 48) & 0xff;
3555	bytes[2] = (val >> 40) & 0xff;
3556	bytes[3] = (val >> 32) & 0xff;
3557	bytes[4] = (val >> 24) & 0xff;
3558	bytes[5] = (val >> 16) & 0xff;
3559	bytes[6] = (val >> 8) & 0xff;
3560	bytes[7] = val & 0xff;
3561}
3562
3563static __inline uint32_t
3564scsi_2btoul(const uint8_t *bytes)
3565{
3566	uint32_t rv;
3567
3568	rv = (bytes[0] << 8) |
3569	     bytes[1];
3570	return (rv);
3571}
3572
3573static __inline uint32_t
3574scsi_3btoul(const uint8_t *bytes)
3575{
3576	uint32_t rv;
3577
3578	rv = (bytes[0] << 16) |
3579	     (bytes[1] << 8) |
3580	     bytes[2];
3581	return (rv);
3582}
3583
3584static __inline int32_t
3585scsi_3btol(const uint8_t *bytes)
3586{
3587	uint32_t rc = scsi_3btoul(bytes);
3588
3589	if (rc & 0x00800000)
3590		rc |= 0xff000000;
3591
3592	return (int32_t) rc;
3593}
3594
3595static __inline uint32_t
3596scsi_4btoul(const uint8_t *bytes)
3597{
3598	uint32_t rv;
3599
3600	rv = (bytes[0] << 24) |
3601	     (bytes[1] << 16) |
3602	     (bytes[2] << 8) |
3603	     bytes[3];
3604	return (rv);
3605}
3606
3607static __inline uint64_t
3608scsi_8btou64(const uint8_t *bytes)
3609{
3610        uint64_t rv;
3611
3612	rv = (((uint64_t)bytes[0]) << 56) |
3613	     (((uint64_t)bytes[1]) << 48) |
3614	     (((uint64_t)bytes[2]) << 40) |
3615	     (((uint64_t)bytes[3]) << 32) |
3616	     (((uint64_t)bytes[4]) << 24) |
3617	     (((uint64_t)bytes[5]) << 16) |
3618	     (((uint64_t)bytes[6]) << 8) |
3619	     bytes[7];
3620	return (rv);
3621}
3622
3623/*
3624 * Given the pointer to a returned mode sense buffer, return a pointer to
3625 * the start of the first mode page.
3626 */
3627static __inline void *
3628find_mode_page_6(struct scsi_mode_header_6 *mode_header)
3629{
3630	void *page_start;
3631
3632	page_start = (void *)((u_int8_t *)&mode_header[1] +
3633			      mode_header->blk_desc_len);
3634
3635	return(page_start);
3636}
3637
3638static __inline void *
3639find_mode_page_10(struct scsi_mode_header_10 *mode_header)
3640{
3641	void *page_start;
3642
3643	page_start = (void *)((u_int8_t *)&mode_header[1] +
3644			       scsi_2btoul(mode_header->blk_desc_len));
3645
3646	return(page_start);
3647}
3648
3649__END_DECLS
3650
3651#endif /*_SCSI_SCSI_ALL_H*/
3652