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