xref: /titanic_41/usr/src/uts/common/sys/scsi/targets/sddef.h (revision 6f8d59d8fcaf391990ca04c7bdcf65ab23320fe0)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 
26 #ifndef	_SYS_SCSI_TARGETS_SDDEF_H
27 #define	_SYS_SCSI_TARGETS_SDDEF_H
28 
29 #include <sys/dktp/fdisk.h>
30 #include <sys/note.h>
31 #include <sys/mhd.h>
32 #include <sys/cmlb.h>
33 
34 #ifdef	__cplusplus
35 extern "C" {
36 #endif
37 
38 
39 #if defined(_KERNEL) || defined(_KMEMUSER)
40 
41 
42 #define	SD_SUCCESS		0
43 #define	SD_FAILURE		(-1)
44 
45 #if defined(TRUE)
46 #undef TRUE
47 #endif
48 
49 #if defined(FALSE)
50 #undef FALSE
51 #endif
52 
53 #define	TRUE			1
54 #define	FALSE			0
55 
56 #if defined(VERBOSE)
57 #undef VERBOSE
58 #endif
59 
60 #if defined(SILENT)
61 #undef SILENT
62 #endif
63 
64 
65 /*
66  *  Fault Injection Flag for Inclusion of Code
67  *
68  *  This should only be defined when SDDEBUG is defined
69  * #if DEBUG || lint
70  * #define	SD_FAULT_INJECTION
71  * #endif
72  */
73 
74 #if DEBUG || lint
75 #define	SD_FAULT_INJECTION
76 #endif
77 #define	VERBOSE			1
78 #define	SILENT			0
79 
80 /*
81  * Structures for recording whether a device is fully open or closed.
82  * Assumptions:
83  *
84  *	+ There are only 8 (sparc) or 16 (x86) disk slices possible.
85  *	+ BLK, MNT, CHR, SWP don't change in some future release!
86  */
87 
88 #if defined(_SUNOS_VTOC_8)
89 
90 #define	SDUNIT_SHIFT	3
91 #define	SDPART_MASK	7
92 #define	NSDMAP		NDKMAP
93 
94 #elif defined(_SUNOS_VTOC_16)
95 
96 #define	SDUNIT_SHIFT	6
97 #define	SDPART_MASK	63
98 #define	NSDMAP		(NDKMAP + FD_NUMPART + 1)
99 
100 #else
101 #error "No VTOC format defined."
102 #endif
103 
104 
105 #define	SDUNIT(dev)	(getminor((dev)) >> SDUNIT_SHIFT)
106 #define	SDPART(dev)	(getminor((dev)) &  SDPART_MASK)
107 
108 /*
109  * maximum number of partitions the driver keeps track of; with
110  * EFI this can be larger than the number of partitions accessible
111  * through the minor nodes.  It won't be used for keeping track
112  * of open counts, partition kstats, etc.
113  */
114 #define	MAXPART		(NSDMAP + 1)
115 
116 /*
117  * Macro to retrieve the DDI instance number from the given buf struct.
118  * The instance number is encoded in the minor device number.
119  */
120 #define	SD_GET_INSTANCE_FROM_BUF(bp)					\
121 	(getminor((bp)->b_edev) >> SDUNIT_SHIFT)
122 
123 
124 
125 struct ocinfo {
126 	/*
127 	 * Types BLK, MNT, CHR, SWP,
128 	 * assumed to be types 0-3.
129 	 */
130 	uint64_t  lyr_open[NSDMAP];
131 	uint64_t  reg_open[OTYPCNT - 1];
132 };
133 
134 #define	OCSIZE  sizeof (struct ocinfo)
135 
136 union ocmap {
137 	uchar_t chkd[OCSIZE];
138 	struct ocinfo rinfo;
139 };
140 
141 #define	lyropen rinfo.lyr_open
142 #define	regopen rinfo.reg_open
143 
144 
145 #define	SD_CDB_GROUP0		0
146 #define	SD_CDB_GROUP1		1
147 #define	SD_CDB_GROUP5		2
148 #define	SD_CDB_GROUP4		3
149 
150 struct sd_cdbinfo {
151 	uchar_t	 sc_grpcode;	/* CDB group code */
152 	uchar_t  sc_grpmask;	/* CDB group code mask (for cmd opcode) */
153 	uint64_t sc_maxlba;	/* Maximum logical block addr. supported */
154 	uint32_t sc_maxlen;	/* Maximum transfer length supported */
155 };
156 
157 
158 
159 /*
160  * The following declaration are for Non-512 byte block support for the
161  * removable devices. (ex - DVD RAM, MO).
162  * wm_state: This is an enumeration for the different states for
163  * manipalating write range list during the read-modify-write-operation.
164  */
165 typedef enum {
166 	SD_WM_CHK_LIST,		/* Check list for overlapping writes */
167 	SD_WM_WAIT_MAP,		/* Wait for an overlapping I/O to complete */
168 	SD_WM_LOCK_RANGE,	/* Lock the range of lba to be written */
169 	SD_WM_DONE		/* I/O complete */
170 } wm_state;
171 
172 /*
173  * sd_w_map: Every write I/O will get one w_map allocated for it which will tell
174  * the range on the media which is being written for that request.
175  */
176 struct sd_w_map {
177 	uint_t		wm_start;	/* Write start location */
178 	uint_t		wm_end;		/* Write end location */
179 	ushort_t	wm_flags;	/* State of the wmap */
180 	ushort_t	wm_wanted_count; /* # of threads waiting for region */
181 	void		*wm_private;	/* Used to store bp->b_private */
182 	struct buf	*wm_bufp;	/* to store buf pointer */
183 	struct sd_w_map	*wm_next;	/* Forward pointed to sd_w_map */
184 	struct sd_w_map	*wm_prev;	/* Back pointer to sd_w_map */
185 	kcondvar_t	wm_avail;	/* Sleep on this, while not available */
186 };
187 
188 _NOTE(MUTEX_PROTECTS_DATA(scsi_device::sd_mutex, sd_w_map::wm_flags))
189 
190 
191 /*
192  * This is the struct for the layer-private data area for the
193  * mapblocksize layer.
194  */
195 
196 struct sd_mapblocksize_info {
197 	void		*mbs_oprivate;	/* saved value of xb_private */
198 	struct buf	*mbs_orig_bp;	/* ptr to original bp */
199 	struct sd_w_map	*mbs_wmp;	/* ptr to write-map struct for RMW */
200 	ssize_t		mbs_copy_offset;
201 	int		mbs_layer_index;	/* chain index for RMW */
202 };
203 
204 _NOTE(SCHEME_PROTECTS_DATA("unshared data", sd_mapblocksize_info))
205 
206 
207 /*
208  * sd_lun: The main data structure for a scsi logical unit.
209  * Stored as the softstate structure for each device.
210  */
211 
212 struct sd_lun {
213 
214 	/* Back ptr to the SCSA scsi_device struct for this LUN */
215 	struct scsi_device	*un_sd;
216 
217 	/*
218 	 * Support for Auto-Request sense capability
219 	 */
220 	struct buf	*un_rqs_bp;	/* ptr to request sense bp */
221 	struct scsi_pkt	*un_rqs_pktp;	/* ptr to request sense scsi_pkt */
222 	int	un_sense_isbusy;	/* Busy flag for RQS buf */
223 
224 	/*
225 	 * These specify the layering chains to use with this instance. These
226 	 * are initialized according to the values in the sd_chain_index_map[]
227 	 * array. See the description of sd_chain_index_map[] for details.
228 	 */
229 	int un_buf_chain_type;
230 	int un_uscsi_chain_type;
231 	int un_direct_chain_type;
232 	int un_priority_chain_type;
233 
234 	/* Head & tail ptrs to the queue of bufs awaiting transport */
235 	struct buf	*un_waitq_headp;
236 	struct buf	*un_waitq_tailp;
237 
238 	/* Ptr to the buf currently being retried (NULL if none) */
239 	struct buf	*un_retry_bp;
240 
241 	/* This tracks the last kstat update for the un_retry_bp buf */
242 	void		(*un_retry_statp)(kstat_io_t *);
243 
244 	void		*un_xbuf_attr;	/* xbuf attribute struct */
245 
246 
247 	/* System logical block size, in bytes. (defaults to DEV_BSIZE.) */
248 	uint32_t	un_sys_blocksize;
249 
250 	/* The size of a logical block on the target, in bytes. */
251 	uint32_t	un_tgt_blocksize;
252 
253 	/*
254 	 * The number of logical blocks on the target. This is adjusted
255 	 * to be in terms of the block size specified by un_sys_blocksize
256 	 * (ie, the system block size).
257 	 */
258 	uint64_t	un_blockcount;
259 
260 	/*
261 	 * Various configuration data
262 	 */
263 	uchar_t	un_ctype;		/* Controller type */
264 	char 	*un_node_type;		/* minor node type */
265 	uchar_t	un_interconnect_type;	/* Interconnect for underlying HBA */
266 
267 	uint_t	un_notready_retry_count; /* Per disk notready retry count */
268 	uint_t	un_busy_retry_count;	/* Per disk BUSY retry count */
269 
270 	uint_t	un_retry_count;		/* Per disk retry count */
271 	uint_t	un_victim_retry_count;	/* Per disk victim retry count */
272 
273 	/* (4356701, 4367306) */
274 	uint_t	un_reset_retry_count; /* max io retries before issuing reset */
275 	ushort_t un_reserve_release_time; /* reservation release timeout */
276 
277 	uchar_t	un_reservation_type;	/* SCSI-3 or SCSI-2 */
278 	uint_t	un_max_xfer_size;	/* Maximum DMA transfer size */
279 	int	un_partial_dma_supported;
280 	int	un_buf_breakup_supported;
281 
282 	int	un_mincdb;		/* Smallest CDB to use */
283 	int	un_maxcdb;		/* Largest CDB to use */
284 	int	un_max_hba_cdb;		/* Largest CDB supported by HBA */
285 	int	un_status_len;
286 	int	un_pkt_flags;
287 
288 	/*
289 	 * Note: un_uscsi_timeout is a "mirror" of un_cmd_timeout, adjusted
290 	 * for ISCD().  Any updates to un_cmd_timeout MUST be reflected
291 	 * in un_uscsi_timeout as well!
292 	 */
293 	ushort_t un_cmd_timeout;	/* Timeout for completion */
294 	ushort_t un_uscsi_timeout;	/* Timeout for USCSI completion */
295 	ushort_t un_busy_timeout;	/* Timeout for busy retry */
296 
297 	/*
298 	 * Info on current states, statuses, etc. (Updated frequently)
299 	 */
300 	uchar_t	un_state;		/* current state */
301 	uchar_t	un_last_state;		/* last state */
302 	uchar_t	un_last_pkt_reason;	/* used to suppress multiple msgs */
303 	int	un_tagflags;		/* Pkt Flags for Tagged Queueing  */
304 	short	un_resvd_status;	/* Reservation Status */
305 	ulong_t	un_detach_count;	/* !0 if executing detach routine */
306 	ulong_t	un_layer_count;		/* Current total # of layered opens */
307 	ulong_t un_opens_in_progress;	/* Current # of threads in sdopen */
308 
309 	ksema_t	un_semoclose;		/* serialize opens/closes */
310 
311 	/*
312 	 * Control & status info for command throttling
313 	 */
314 	long	un_ncmds_in_driver;	/* number of cmds in driver */
315 	short	un_ncmds_in_transport;	/* number of cmds in transport */
316 	short	un_throttle;		/* max #cmds allowed in transport */
317 	short	un_saved_throttle;	/* saved value of un_throttle */
318 	short	un_busy_throttle;	/* saved un_throttle for BUSY */
319 	short	un_min_throttle;	/* min value of un_throttle */
320 	timeout_id_t	un_reset_throttle_timeid; /* timeout(9F) handle */
321 
322 	/*
323 	 * Multi-host (clustering) support
324 	 */
325 	opaque_t	un_mhd_token;		/* scsi watch request */
326 	timeout_id_t	un_resvd_timeid;	/* for resvd recover */
327 
328 	/* Event callback resources (photon) */
329 	ddi_eventcookie_t un_insert_event;	/* insert event */
330 	ddi_callback_id_t un_insert_cb_id;	/* insert callback */
331 	ddi_eventcookie_t un_remove_event;	/* remove event */
332 	ddi_callback_id_t un_remove_cb_id;	/* remove callback */
333 
334 	uint_t		un_start_stop_cycle_page;	/* Saves start/stop */
335 							/* cycle page */
336 	timeout_id_t	un_dcvb_timeid;		/* dlyd cv broadcast */
337 
338 	/*
339 	 * Data structures for open counts, partition info, VTOC,
340 	 * stats, and other such bookkeeping info.
341 	 */
342 	union	ocmap	un_ocmap;		/* open partition map */
343 	struct	kstat	*un_pstats[NSDMAP];	/* partition statistics */
344 	struct	kstat	*un_stats;		/* disk statistics */
345 	kstat_t		*un_errstats;		/* for error statistics */
346 	uint64_t	un_exclopen;		/* exclusive open bitmask */
347 	ddi_devid_t	un_devid;		/* device id */
348 	uint_t		un_vpd_page_mask;	/* Supported VPD pages */
349 
350 	/*
351 	 * Bit fields for various configuration/state/status info.
352 	 * Comments indicate the condition if the value of the
353 	 * variable is TRUE (nonzero).
354 	 */
355 	uint32_t
356 	    un_f_arq_enabled		:1,	/* Auto request sense is */
357 						/* currently enabled */
358 	    un_f_blockcount_is_valid	:1,	/* The un_blockcount */
359 						/* value is currently valid */
360 	    un_f_tgt_blocksize_is_valid	:1,	/* The un_tgt_blocksize */
361 						/* value is currently valid */
362 	    un_f_allow_bus_device_reset	:1,	/* Driver may issue a BDR as */
363 						/* a part of error recovery. */
364 	    un_f_is_fibre		:1,	/* The device supports fibre */
365 						/* channel */
366 	    un_f_sync_cache_supported	:1,	/* sync cache cmd supported */
367 						/* supported */
368 	    un_f_format_in_progress	:1,	/* The device is currently */
369 						/* executing a FORMAT cmd. */
370 	    un_f_opt_queueing		:1,	/* Enable Command Queuing to */
371 						/* Host Adapter */
372 	    un_f_opt_fab_devid		:1,	/* Disk has no valid/unique */
373 						/* serial number.  */
374 	    un_f_opt_disable_cache	:1,	/* Read/Write disk cache is */
375 						/* disabled.  */
376 	    un_f_cfg_is_atapi		:1,	/* This is an ATAPI device.  */
377 	    un_f_write_cache_enabled	:1,	/* device return success on */
378 						/* writes before transfer to */
379 						/* physical media complete */
380 	    un_f_cfg_playmsf_bcd	:1,	/* Play Audio, BCD params. */
381 	    un_f_cfg_readsub_bcd	:1,	/* READ SUBCHANNEL BCD resp. */
382 	    un_f_cfg_read_toc_trk_bcd	:1,	/* track # is BCD */
383 	    un_f_cfg_read_toc_addr_bcd	:1,	/* address is BCD */
384 	    un_f_cfg_no_read_header	:1,	/* READ HEADER not supported */
385 	    un_f_cfg_read_cd_xd4	:1,	/* READ CD opcode is 0xd4 */
386 	    un_f_mmc_cap		:1,	/* Device is MMC compliant */
387 	    un_f_mmc_writable_media	:1,	/* writable media in device */
388 	    un_f_dvdram_writable_device	:1,	/* DVDRAM device is writable */
389 	    un_f_cfg_cdda		:1,	/* READ CDDA supported */
390 	    un_f_cfg_tur_check		:1,	/* verify un_ncmds before tur */
391 
392 	    un_f_use_adaptive_throttle	:1,	/* enable/disable adaptive */
393 						/* throttling */
394 	    un_f_pm_is_enabled		:1,	/* PM is enabled on this */
395 						/* instance */
396 	    un_f_watcht_stopped		:1,	/* media watch thread flag */
397 	    un_f_pkstats_enabled	:1,	/* Flag to determine if */
398 						/* partition kstats are */
399 						/* enabled. */
400 	    un_f_disksort_disabled	:1,	/* Flag to disable disksort */
401 	    un_f_lun_reset_enabled	:1,	/* Set if target supports */
402 						/* SCSI Logical Unit Reset */
403 	    un_f_doorlock_supported	:1,	/* Device supports Doorlock */
404 	    un_f_start_stop_supported	:1,	/* device has motor */
405 	    un_f_reserved1		:1;
406 
407 	uint32_t
408 	    un_f_mboot_supported	:1,	/* mboot supported */
409 	    un_f_is_hotpluggable	:1,	/* hotpluggable */
410 	    un_f_has_removable_media	:1,	/* has removable media */
411 	    un_f_non_devbsize_supported	:1,	/* non-512 blocksize */
412 	    un_f_devid_supported	:1,	/* device ID supported */
413 	    un_f_eject_media_supported	:1,	/* media can be ejected */
414 	    un_f_chk_wp_open		:1,	/* check if write-protected */
415 						/* when being opened */
416 	    un_f_descr_format_supported	:1,	/* support descriptor format */
417 						/* for sense data */
418 	    un_f_check_start_stop	:1,	/* needs to check if */
419 						/* START-STOP command is */
420 						/* supported by hardware */
421 						/* before issuing it */
422 	    un_f_monitor_media_state	:1,	/* need a watch thread to */
423 						/* monitor device state */
424 	    un_f_attach_spinup		:1,	/* spin up once the */
425 						/* device is attached */
426 	    un_f_log_sense_supported	:1,	/* support log sense */
427 	    un_f_pm_supported		:1, 	/* support power-management */
428 	    un_f_cfg_is_lsi		:1,	/* Is LSI device, */
429 						/* default to NO */
430 	    un_f_wcc_inprog		:1,	/* write cache change in */
431 						/* progress */
432 	    un_f_ejecting		:1,	/* media is ejecting */
433 	    un_f_suppress_cache_flush	:1,	/* supress flush on */
434 						/* write cache */
435 	    un_f_sync_nv_supported	:1,	/* SYNC_NV */
436 						/* bit is supported */
437 	    un_f_sync_cache_required	:1,	/* flag to check if */
438 						/* SYNC CACHE needs to be */
439 						/* sent in sdclose */
440 	    un_f_devid_transport_defined :1,	/* devid defined by transport */
441 	    un_f_reserved		:12;
442 
443 	/* Ptr to table of strings for ASC/ASCQ error message printing */
444 	struct scsi_asq_key_strings	*un_additional_codes;
445 
446 	/*
447 	 * Power Management support.
448 	 *
449 	 * un_pm_mutex protects, un_pm_count, un_pm_timeid, un_pm_busy,
450 	 * un_pm_busy_cv, and un_pm_idle_timeid.
451 	 * It's not required that SD_MUTEX be acquired before acquiring
452 	 * un_pm_mutex, however if they must both be held
453 	 * then acquire SD_MUTEX first.
454 	 *
455 	 * un_pm_count is used to indicate PM state as follows:
456 	 *	less than 0 the device is powered down,
457 	 *	transition from 0 ==> 1, mark the device as busy via DDI
458 	 *	transition from 1 ==> 0, mark the device as idle via DDI
459 	 */
460 	kmutex_t	un_pm_mutex;
461 	int		un_pm_count;		/* indicates pm state */
462 	timeout_id_t	un_pm_timeid;		/* timeout id for pm */
463 	uint_t		un_pm_busy;
464 	kcondvar_t	un_pm_busy_cv;
465 	short		un_power_level;		/* Power Level */
466 	uchar_t		un_save_state;
467 	kcondvar_t	un_suspend_cv;		/* power management */
468 	kcondvar_t	un_disk_busy_cv;	/* wait for IO completion */
469 
470 	/* Resources used for media change callback support */
471 	kcondvar_t	un_state_cv;		/* Cond Var on mediastate */
472 	enum dkio_state un_mediastate;		/* current media state */
473 	enum dkio_state un_specified_mediastate; /* expected state */
474 	opaque_t	un_swr_token;		/* scsi_watch request token */
475 
476 	/* Non-512 byte block support */
477 	struct kmem_cache *un_wm_cache;	/* fast alloc in non-512 write case */
478 	uint_t		un_rmw_count;	/* count of read-modify-writes */
479 	struct sd_w_map	*un_wm;		/* head of sd_w_map chain */
480 
481 	/* For timeout callback to issue a START STOP UNIT command */
482 	timeout_id_t	un_startstop_timeid;
483 
484 	/* Timeout callback handle for SD_PATH_DIRECT_PRIORITY cmd restarts */
485 	timeout_id_t	un_direct_priority_timeid;
486 
487 	/* TRAN_FATAL_ERROR count. Cleared by TRAN_ACCEPT from scsi_transport */
488 	ulong_t		un_tran_fatal_count;
489 
490 	timeout_id_t	un_retry_timeid;
491 
492 	time_t		un_pm_idle_time;
493 	timeout_id_t	un_pm_idle_timeid;
494 
495 	/*
496 	 * Count to determine if a Sonoma controller is in the process of
497 	 * failing over, and how many I/O's are failed with the 05/94/01
498 	 * sense code.
499 	 */
500 	uint_t		un_sonoma_failure_count;
501 
502 	/*
503 	 * Support for failfast operation.
504 	 */
505 	struct buf	*un_failfast_bp;
506 	struct buf	*un_failfast_headp;
507 	struct buf	*un_failfast_tailp;
508 	uint32_t	un_failfast_state;
509 	/* Callback routine active counter */
510 	short		un_in_callback;
511 
512 	kcondvar_t	un_wcc_cv;	/* synchronize changes to */
513 					/* un_f_write_cache_enabled */
514 
515 #ifdef SD_FAULT_INJECTION
516 	/* SD Fault Injection */
517 #define	SD_FI_MAX_BUF 65536
518 #define	SD_FI_MAX_ERROR 1024
519 	kmutex_t			un_fi_mutex;
520 	uint_t				sd_fi_buf_len;
521 	char				sd_fi_log[SD_FI_MAX_BUF];
522 	struct sd_fi_pkt	*sd_fi_fifo_pkt[SD_FI_MAX_ERROR];
523 	struct sd_fi_xb		*sd_fi_fifo_xb[SD_FI_MAX_ERROR];
524 	struct sd_fi_un		*sd_fi_fifo_un[SD_FI_MAX_ERROR];
525 	struct sd_fi_arq	*sd_fi_fifo_arq[SD_FI_MAX_ERROR];
526 	uint_t				sd_fi_fifo_start;
527 	uint_t				sd_fi_fifo_end;
528 	uint_t				sd_injection_mask;
529 
530 #endif
531 
532 	cmlb_handle_t	un_cmlbhandle;
533 
534 	/*
535 	 * Pointer to internal struct sd_fm_internal in which
536 	 * will pass necessary information for FMA ereport posting.
537 	 */
538 	void		*un_fm_private;
539 };
540 
541 #define	SD_IS_VALID_LABEL(un)  (cmlb_is_valid(un->un_cmlbhandle))
542 
543 /*
544  * Macros for conversions between "target" and "system" block sizes, and
545  * for conversion between block counts and byte counts.  As used here,
546  * "system" block size refers to the block size used by the kernel/
547  * filesystem (this includes the disk label). The "target" block size
548  * is the block size returned by the SCSI READ CAPACITY command.
549  *
550  * Note: These macros will round up to the next largest blocksize to accomodate
551  * the number of blocks specified.
552  */
553 
554 /* Convert a byte count to a number of target blocks */
555 #define	SD_BYTES2TGTBLOCKS(un, bytecount)				\
556 	((bytecount + (un->un_tgt_blocksize - 1))/un->un_tgt_blocksize)
557 
558 /* Convert a target block count to a number of bytes */
559 #define	SD_TGTBLOCKS2BYTES(un, blockcount)				\
560 	(blockcount * (un)->un_tgt_blocksize)
561 
562 /* Convert a byte count to a number of system blocks */
563 #define	SD_BYTES2SYSBLOCKS(un, bytecount)				\
564 	((bytecount + (un->un_sys_blocksize - 1))/un->un_sys_blocksize)
565 
566 /* Convert a system block count to a number of bytes */
567 #define	SD_SYSBLOCKS2BYTES(un, blockcount)				\
568 	(blockcount * (un)->un_sys_blocksize)
569 
570 /*
571  * Calculate the number of bytes needed to hold the requested number of bytes
572  * based upon the native target sector/block size
573  */
574 #define	SD_REQBYTES2TGTBYTES(un, bytecount)				\
575 	(SD_BYTES2TGTBLOCKS(un, bytecount) * (un)->un_tgt_blocksize)
576 
577 /*
578  * Calculate the byte offset from the beginning of the target block
579  * to the system block location.
580  */
581 #define	SD_TGTBYTEOFFSET(un, sysblk, tgtblk)				\
582 	(SD_SYSBLOCKS2BYTES(un, sysblk) - SD_TGTBLOCKS2BYTES(un, tgtblk))
583 
584 /*
585  * Calculate the target block location from the system block location
586  */
587 #define	SD_SYS2TGTBLOCK(un, blockcnt)					\
588 	((blockcnt * un->un_sys_blocksize) / un->un_tgt_blocksize)
589 
590 /*
591  * SD_DEFAULT_MAX_XFER_SIZE is the default value to bound the max xfer
592  * for physio, for devices without tagged queuing enabled.
593  * The default for devices with tagged queuing enabled is SD_MAX_XFER_SIZE
594  */
595 #if defined(__i386) || defined(__amd64)
596 #define	SD_DEFAULT_MAX_XFER_SIZE	(256 * 1024)
597 #endif
598 #define	SD_MAX_XFER_SIZE		(1024 * 1024)
599 
600 /*
601  * Warlock annotations
602  */
603 _NOTE(MUTEX_PROTECTS_DATA(scsi_device::sd_mutex, sd_lun))
604 _NOTE(READ_ONLY_DATA(sd_lun::un_sd))
605 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_reservation_type))
606 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_mincdb))
607 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_maxcdb))
608 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_max_hba_cdb))
609 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_status_len))
610 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_f_arq_enabled))
611 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_ctype))
612 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_cmlbhandle))
613 _NOTE(DATA_READABLE_WITHOUT_LOCK(sd_lun::un_fm_private))
614 
615 
616 _NOTE(SCHEME_PROTECTS_DATA("safe sharing",
617 	sd_lun::un_mhd_token
618 	sd_lun::un_state
619 	sd_lun::un_tagflags
620 	sd_lun::un_f_format_in_progress
621 	sd_lun::un_resvd_timeid
622 	sd_lun::un_reset_throttle_timeid
623 	sd_lun::un_startstop_timeid
624 	sd_lun::un_dcvb_timeid
625 	sd_lun::un_f_allow_bus_device_reset
626 	sd_lun::un_sys_blocksize
627 	sd_lun::un_tgt_blocksize
628 	sd_lun::un_additional_codes))
629 
630 _NOTE(SCHEME_PROTECTS_DATA("stable data",
631 	sd_lun::un_reserve_release_time
632 	sd_lun::un_max_xfer_size
633 	sd_lun::un_partial_dma_supported
634 	sd_lun::un_buf_breakup_supported
635 	sd_lun::un_f_is_fibre
636 	sd_lun::un_node_type
637 	sd_lun::un_buf_chain_type
638 	sd_lun::un_uscsi_chain_type
639 	sd_lun::un_direct_chain_type
640 	sd_lun::un_priority_chain_type
641 	sd_lun::un_xbuf_attr
642 	sd_lun::un_cmd_timeout
643 	sd_lun::un_pkt_flags))
644 
645 _NOTE(SCHEME_PROTECTS_DATA("Unshared data",
646 	block_descriptor
647 	buf
648 	cdrom_subchnl
649 	cdrom_tocentry
650 	cdrom_tochdr
651 	cdrom_read
652 	dk_cinfo
653 	dk_devid
654 	dk_label
655 	dk_map
656 	dk_temperature
657 	mhioc_inkeys
658 	mhioc_inresvs
659 	mode_caching
660 	mode_header
661 	mode_speed
662 	scsi_cdb
663 	scsi_arq_status
664 	scsi_extended_sense
665 	scsi_inquiry
666 	scsi_pkt
667 	uio
668 	uscsi_cmd))
669 
670 
671 _NOTE(SCHEME_PROTECTS_DATA("stable data", scsi_device dk_cinfo))
672 _NOTE(SCHEME_PROTECTS_DATA("unique per pkt", scsi_status scsi_cdb))
673 
674 _NOTE(MUTEX_PROTECTS_DATA(sd_lun::un_pm_mutex, sd_lun::un_pm_count
675 	sd_lun::un_pm_timeid sd_lun::un_pm_busy sd_lun::un_pm_busy_cv
676 	sd_lun::un_pm_idle_timeid))
677 
678 #ifdef SD_FAULT_INJECTION
679 _NOTE(MUTEX_PROTECTS_DATA(sd_lun::un_fi_mutex,
680 	sd_lun::sd_fi_buf_len sd_lun::sd_fi_log))
681 #endif
682 
683 /* _NOTE(LOCK_ORDER(sd_lun::un_sd.sd_mutex sd_lun::un_pm_mutex)) */
684 
685 
686 
687 /*
688  * Referenced for frequently-accessed members of the unit structure
689  */
690 #define	SD_SCSI_DEVP(un)	((un)->un_sd)
691 #define	SD_DEVINFO(un)		((un)->un_sd->sd_dev)
692 #define	SD_INQUIRY(un)		((un)->un_sd->sd_inq)
693 #define	SD_MUTEX(un)		(&((un)->un_sd->sd_mutex))
694 #define	SD_ADDRESS(un)		(&((un)->un_sd->sd_address))
695 #define	SD_GET_DEV(un)		(sd_make_device(SD_DEVINFO(un)))
696 #define	SD_FM_LOG(un)		(((struct sd_fm_internal *)\
697 				((un)->un_fm_private))->fm_log_level)
698 
699 
700 /*
701  * Values for un_ctype
702  */
703 #define	CTYPE_CDROM		0
704 #define	CTYPE_MD21		1	/* Obsolete! */
705 #define	CTYPE_CCS		2
706 #define	CTYPE_ROD		3
707 #define	CTYPE_PXRE		4	/* Obsolete! */
708 
709 #define	ISCD(un)		((un)->un_ctype == CTYPE_CDROM)
710 #define	ISROD(un)		((un)->un_ctype == CTYPE_ROD)
711 #define	ISPXRE(un)		((un)->un_ctype == CTYPE_PXRE)
712 
713 /*
714  * This macro checks the vendor of the device to see if it is LSI. Because
715  * LSI has some devices out there that return 'Symbios' or 'SYMBIOS', we
716  * need to check for those also.
717  *
718  * This is used in some vendor specific checks.
719  */
720 #define	SD_IS_LSI(un)	((un)->un_f_cfg_is_lsi == TRUE)
721 
722 /*
723  * Macros to check if the lun is a Sun T3 or a T4
724  */
725 #define	SD_IS_T3(un) \
726 	((bcmp(SD_INQUIRY(un)->inq_vid, "SUN", 3) == 0) && \
727 	(bcmp(SD_INQUIRY(un)->inq_pid, "T3", 2) == 0))
728 
729 #define	SD_IS_T4(un) \
730 	((bcmp(SD_INQUIRY(un)->inq_vid, "SUN", 3) == 0) && \
731 	(bcmp(SD_INQUIRY(un)->inq_pid, "T4", 2) == 0))
732 
733 /*
734  * Macros for non-512 byte writes to removable devices.
735  */
736 #define	NOT_DEVBSIZE(un)	\
737 	((un)->un_tgt_blocksize != (un)->un_sys_blocksize)
738 
739 /*
740  * Check that a write map, used for locking lba ranges for writes, is in
741  * the linked list.
742  */
743 #define	ONLIST(un, wmp)		\
744 	(((un)->un_wm == (wmp)) || ((wmp)->wm_prev != NULL))
745 
746 /*
747  * Free a write map which is on list. Basically make sure that nobody is
748  * sleeping on it before freeing it.
749  */
750 #define	FREE_ONLIST_WMAP(un, wmp)				\
751 	if (!(wmp)->wm_wanted_count) {				\
752 		sd_free_inlist_wmap((un), (wmp));		\
753 		(wmp) = NULL;					\
754 	}
755 
756 #define	CHK_N_FREEWMP(un, wmp)					\
757 	if (!ONLIST((un), (wmp))) {				\
758 		kmem_cache_free((un)->un_wm_cache, (wmp));	\
759 		(wmp) = NULL;					\
760 	} else {						\
761 		FREE_ONLIST_WMAP((un), (wmp));			\
762 	}
763 
764 /*
765  * Values used to in wm_flags field of sd_w_map.
766  */
767 #define	SD_WTYPE_SIMPLE	0x001	/* Write aligned at blksize boundary */
768 #define	SD_WTYPE_RMW	0x002	/* Write requires read-modify-write */
769 #define	SD_WM_BUSY		0x100	/* write-map is busy */
770 
771 
772 /* Device error kstats */
773 struct sd_errstats {
774 	struct kstat_named	sd_softerrs;
775 	struct kstat_named	sd_harderrs;
776 	struct kstat_named	sd_transerrs;
777 	struct kstat_named	sd_vid;
778 	struct kstat_named	sd_pid;
779 	struct kstat_named	sd_revision;
780 	struct kstat_named	sd_serial;
781 	struct kstat_named	sd_capacity;
782 	struct kstat_named	sd_rq_media_err;
783 	struct kstat_named	sd_rq_ntrdy_err;
784 	struct kstat_named	sd_rq_nodev_err;
785 	struct kstat_named	sd_rq_recov_err;
786 	struct kstat_named	sd_rq_illrq_err;
787 	struct kstat_named	sd_rq_pfa_err;
788 };
789 
790 
791 /*
792  * Structs and definitions for SCSI-3 Persistent Reservation
793  */
794 typedef struct sd_prin_readkeys {
795 	uint32_t	generation;
796 	uint32_t	len;
797 	mhioc_resv_key_t *keylist;
798 } sd_prin_readkeys_t;
799 
800 typedef struct sd_readresv_desc {
801 	mhioc_resv_key_t	resvkey;
802 	uint32_t		scope_specific_addr;
803 	uint8_t			reserved_1;
804 #if defined(_BIT_FIELDS_LTOH)
805 	uint8_t			type:4,
806 				scope:4;
807 #elif defined(_BIT_FIELDS_HTOL)
808 	uint8_t			scope:4,
809 				type:4;
810 #else
811 #error	One of _BIT_FIELDS_LTOH or _BIT_FIELDS_HTOL must be defined
812 #endif	/* _BIT_FIELDS_LTOH */
813 	uint8_t			reserved_2;
814 	uint8_t			reserved_3;
815 } sd_readresv_desc_t;
816 
817 typedef struct sd_prin_readresv {
818 	uint32_t		generation;
819 	uint32_t		len;
820 	sd_readresv_desc_t	*readresv_desc;
821 } sd_prin_readresv_t;
822 
823 typedef struct sd_prout {
824 	uchar_t		res_key[MHIOC_RESV_KEY_SIZE];
825 	uchar_t		service_key[MHIOC_RESV_KEY_SIZE];
826 	uint32_t	scope_address;
827 #if defined(_BIT_FIELDS_LTOH)
828 	uchar_t		aptpl:1,
829 			reserved:7;
830 #elif defined(_BIT_FIELDS_HTOL)
831 	uchar_t		reserved:7,
832 			aptpl:1;
833 #else
834 #error	One of _BIT_FIELDS_LTOH or _BIT_FIELDS_HTOL must be defined
835 #endif	/* _BIT_FIELDS_LTOH */
836 	uchar_t		reserved_1;
837 	uint16_t	ext_len;
838 } sd_prout_t;
839 
840 #define	SD_READ_KEYS			0x00
841 #define	SD_READ_RESV			0x01
842 
843 #define	SD_SCSI3_REGISTER		0x00
844 #define	SD_SCSI3_RESERVE		0x01
845 #define	SD_SCSI3_RELEASE		0x02
846 #define	SD_SCSI3_PREEMPTANDABORT	0x05
847 #define	SD_SCSI3_REGISTERANDIGNOREKEY	0x06
848 
849 /*
850  * Note: The default init of un_reservation_type is to the value of '0'
851  * (from the ddi_softs_state_zalloc) which means it is defaulting to SCSI-3
852  * reservation type. This is ok because during attach we use a SCSI-3
853  * PRIORITY RESERVE IN command to determine the reservation type, and set
854  * un_reservation_type for all cases.
855  */
856 #define	SD_SCSI3_RESERVATION		0x0
857 #define	SD_SCSI2_RESERVATION		0x1
858 #define	SCSI3_RESV_DESC_LEN		16
859 
860 /*
861  * Reservation Status's
862  */
863 #define	SD_RELEASE			0x0000
864 #define	SD_RESERVE			0x0001
865 #define	SD_TKOWN			0x0002
866 #define	SD_LOST_RESERVE			0x0004
867 #define	SD_FAILFAST			0x0080
868 #define	SD_WANT_RESERVE			0x0100
869 #define	SD_RESERVATION_CONFLICT		0x0200
870 #define	SD_PRIORITY_RESERVE		0x0400
871 
872 #define	SD_TARGET_IS_UNRESERVED		0
873 #define	SD_TARGET_IS_RESERVED		1
874 
875 /*
876  * Save page in mode_select
877  */
878 #define	SD_DONTSAVE_PAGE		0
879 #define	SD_SAVE_PAGE			1
880 
881 /*
882  * Delay before reclaiming reservation is 6 seconds, in units of micro seconds
883  */
884 #define	SD_REINSTATE_RESV_DELAY		6000000
885 
886 #define	SD_MODE2_BLKSIZE		2336	/* bytes */
887 
888 /*
889  * Resource type definitions for multi host control operations. Specifically,
890  * queue and request definitions for reservation request handling between the
891  * scsi facility callback function (sd_mhd_watch_cb) and the reservation
892  * reclaim thread (sd_resv_reclaim_thread)
893  */
894 struct sd_thr_request {
895 	dev_t	dev;
896 	struct	sd_thr_request	*sd_thr_req_next;
897 };
898 
899 struct sd_resv_reclaim_request {
900 	kthread_t		*srq_resv_reclaim_thread;
901 	struct	sd_thr_request	*srq_thr_req_head;
902 	struct	sd_thr_request	*srq_thr_cur_req;
903 	kcondvar_t		srq_inprocess_cv;
904 	kmutex_t		srq_resv_reclaim_mutex;
905 	kcondvar_t		srq_resv_reclaim_cv;
906 };
907 
908 _NOTE(MUTEX_PROTECTS_DATA(sd_resv_reclaim_request::srq_resv_reclaim_mutex,
909     sd_resv_reclaim_request))
910 _NOTE(SCHEME_PROTECTS_DATA("unshared data", sd_thr_request))
911 _NOTE(SCHEME_PROTECTS_DATA("Unshared data", sd_prout))
912 
913 
914 
915 /*
916  * Driver Logging Components
917  *
918  * These components cover the functional entry points and areas of the
919  * driver.  A component value is used for the entry point and utility
920  * functions used by the entry point. The common component value is used
921  * in those routines that are called from many areas of the driver.
922  *
923  * This can be done by adding the following two lines to /etc/system:
924  * set sd:sd_component_mask=0x00080000
925  * set sd:sd_level_mask=0x00000008
926  */
927 #define	SD_LOG_PROBE			0x00000001
928 #define	SD_LOG_ATTACH_DETACH		0x00000002
929 #define	SD_LOG_OPEN_CLOSE		0x00000004
930 #define	SD_LOG_READ_WRITE		0x00000008
931 #define	SD_LOG_POWER			0x00000010
932 #define	SD_LOG_IOCTL			0x00000020
933 #define	SD_LOG_IOCTL_MHD		0x00000040
934 #define	SD_LOG_IOCTL_RMMEDIA		0x00000080
935 #define	SD_LOG_IOCTL_DKIO		0x00000100
936 #define	SD_LOG_IO			0x00000200
937 #define	SD_LOG_IO_CORE			0x00000400
938 #define	SD_LOG_IO_DISKSORT		0x00000800
939 #define	SD_LOG_IO_PARTITION		0x00001000
940 #define	SD_LOG_IO_RMMEDIA		0x00002000
941 #define	SD_LOG_IO_CHKSUM		0x00004000
942 #define	SD_LOG_IO_SDIOCTL		0x00008000
943 #define	SD_LOG_IO_PM			0x00010000
944 #define	SD_LOG_ERROR			0x00020000
945 #define	SD_LOG_DUMP			0x00040000
946 #define	SD_LOG_COMMON			0x00080000
947 #define	SD_LOG_SDTEST			0x00100000
948 #define	SD_LOG_IOERR			0x00200000
949 #define	SD_LOG_IO_FAILFAST		0x00400000
950 
951 /* Driver Logging Levels */
952 #define	SD_LOGMASK_ERROR		0x00000001
953 #define	SD_LOGMASK_DUMP_MEM		0x00000002
954 #define	SD_LOGMASK_INFO			0x00000004
955 #define	SD_LOGMASK_TRACE		0x00000008
956 #define	SD_LOGMASK_DIAG			0x00000010
957 
958 /* Driver Logging Formats */
959 #define	SD_LOG_HEX			0x00000001
960 #define	SD_LOG_CHAR			0x00000002
961 
962 /*
963  * The following macros should be used to log driver debug information
964  * only. The output is filtered according to the component and level mask
965  * values. Non-debug information, such as driver warnings intended for
966  * the user should be logged via the scsi_log facility to ensure that
967  * they are not filtered.
968  */
969 #if DEBUG || lint
970 #define	SDDEBUG
971 
972 /* SD_ERROR is called to log driver error conditions */
973 #define	SD_ERROR	sd_log_err
974 
975 /* SD_TRACE is called to log driver trace conditions (function entry/exit) */
976 #define	SD_TRACE	sd_log_trace
977 
978 /* SD_INFO is called to log general purpose driver info */
979 #define	SD_INFO		sd_log_info
980 
981 /* SD_DUMP_MEMORY is called to dump a data buffer to the log */
982 #define	SD_DUMP_MEMORY	sd_dump_memory
983 
984 /* RESET/ABORTS testing ioctls */
985 #define	DKIOCRESET	(DKIOC|14)
986 #define	DKIOCABORT	(DKIOC|15)
987 
988 #ifdef SD_FAULT_INJECTION
989 /*
990  * sd_fi_pkt replicates the variables that are exposed through pkt
991  *
992  * sd_fi_xb replicates the variables that are exposed through xb
993  *
994  * sd_fi_un replicates the variables that are exposed through un
995  *
996  * sd_fi_arq replicates the variables that are
997  *           exposed for Auto-Reqeust-Sense
998  *
999  */
1000 struct sd_fi_pkt {
1001 	uint_t  pkt_flags;			/* flags */
1002 	uchar_t pkt_scbp;			/* pointer to status block */
1003 	uchar_t pkt_cdbp;			/* pointer to command block */
1004 	uint_t  pkt_state;			/* state of command */
1005 	uint_t  pkt_statistics;		/* statistics */
1006 	uchar_t pkt_reason;			/* reason completion called */
1007 };
1008 
1009 struct sd_fi_xb {
1010 	daddr_t xb_blkno;
1011 	ssize_t xb_dma_resid;
1012 	short	xb_retry_count;
1013 	short	xb_victim_retry_count;
1014 	uchar_t xb_sense_status;
1015 	uint_t  xb_sense_state;
1016 	ssize_t xb_sense_resid;
1017 	uchar_t xb_sense_data[SENSE_LENGTH];
1018 	uchar_t es_code;
1019 	uchar_t es_key;
1020 	uchar_t es_add_code;
1021 	uchar_t es_qual_code;
1022 };
1023 
1024 struct sd_fi_un {
1025 	uchar_t inq_rmb;
1026 	uchar_t un_ctype;
1027 	uint_t  un_notready_retry_count;
1028 	uint_t  un_reset_retry_count;
1029 	uchar_t un_reservation_type;
1030 	ushort_t un_notrdy_delay;
1031 	short   un_resvd_status;
1032 	uint32_t
1033 		un_f_arq_enabled,
1034 		un_f_allow_bus_device_reset,
1035 		un_f_opt_queueing;
1036 	timeout_id_t    un_restart_timeid;
1037 };
1038 
1039 struct sd_fi_arq {
1040 	struct scsi_status	sts_status;
1041 	struct scsi_status	sts_rqpkt_status;
1042 	uchar_t				sts_rqpkt_reason;
1043 	uchar_t				sts_rqpkt_resid;
1044 	uint_t				sts_rqpkt_state;
1045 	uint_t				sts_rqpkt_statistics;
1046 	struct scsi_extended_sense	sts_sensedata;
1047 };
1048 
1049 /*
1050  * Conditional set def
1051  */
1052 #define	SD_CONDSET(a, b, c, d)			\
1053 	{ \
1054 	a->c = ((fi_ ## b)->c);			\
1055 	SD_INFO(SD_LOG_IOERR, un,		\
1056 			"sd_fault_injection:"	\
1057 			"setting %s to %d\n", 	\
1058 			d, ((fi_ ## b)->c)); 	\
1059 	}
1060 
1061 /* SD FaultInjection ioctls */
1062 #define	SDIOC			('T'<<8)
1063 #define	SDIOCSTART		(SDIOC|1)
1064 #define	SDIOCSTOP		(SDIOC|2)
1065 #define	SDIOCINSERTPKT	(SDIOC|3)
1066 #define	SDIOCINSERTXB	(SDIOC|4)
1067 #define	SDIOCINSERTUN	(SDIOC|5)
1068 #define	SDIOCINSERTARQ	(SDIOC|6)
1069 #define	SDIOCPUSH		(SDIOC|7)
1070 #define	SDIOCRETRIEVE	(SDIOC|8)
1071 #define	SDIOCRUN		(SDIOC|9)
1072 #endif
1073 
1074 #else
1075 
1076 #undef	SDDEBUG
1077 #define	SD_ERROR	{ if (0) sd_log_err; }
1078 #define	SD_TRACE	{ if (0) sd_log_trace; }
1079 #define	SD_INFO		{ if (0) sd_log_info; }
1080 #define	SD_DUMP_MEMORY	{ if (0) sd_dump_memory; }
1081 #endif
1082 
1083 
1084 /*
1085  * Miscellaneous macros
1086  */
1087 
1088 #define	SD_USECTOHZ(x)			(drv_usectohz((x)*1000000))
1089 #define	SD_GET_PKT_STATUS(pktp)		((*(pktp)->pkt_scbp) & STATUS_MASK)
1090 
1091 #define	SD_BIOERROR(bp, errcode)					\
1092 	if ((bp)->b_resid == 0) {					\
1093 		(bp)->b_resid = (bp)->b_bcount;				\
1094 	}								\
1095 	if ((bp)->b_error == 0) {					\
1096 		bioerror(bp, errcode);					\
1097 	}								\
1098 	(bp)->b_flags |= B_ERROR;
1099 
1100 #define	SD_FILL_SCSI1_LUN_CDB(lunp, cdbp)				\
1101 	if (! (lunp)->un_f_is_fibre &&					\
1102 	    SD_INQUIRY((lunp))->inq_ansi == 0x01) {			\
1103 		int _lun = ddi_prop_get_int(DDI_DEV_T_ANY,		\
1104 		    SD_DEVINFO((lunp)), DDI_PROP_DONTPASS,		\
1105 		    SCSI_ADDR_PROP_LUN, 0);				\
1106 		if (_lun > 0) {						\
1107 			(cdbp)->scc_lun = _lun;				\
1108 		}							\
1109 	}
1110 
1111 #define	SD_FILL_SCSI1_LUN(lunp, pktp)					\
1112 	SD_FILL_SCSI1_LUN_CDB((lunp), (union scsi_cdb *)(pktp)->pkt_cdbp)
1113 
1114 /*
1115  * Disk driver states
1116  */
1117 
1118 #define	SD_STATE_NORMAL		0
1119 #define	SD_STATE_OFFLINE	1
1120 #define	SD_STATE_RWAIT		2
1121 #define	SD_STATE_DUMPING	3
1122 #define	SD_STATE_SUSPENDED	4
1123 #define	SD_STATE_PM_CHANGING	5
1124 
1125 /*
1126  * The table is to be interpreted as follows: The rows lists all the states
1127  * and each column is a state that a state in each row *can* reach. The entries
1128  * in the table list the event that cause that transition to take place.
1129  * For e.g.: To go from state RWAIT to SUSPENDED, event (d)-- which is the
1130  * invocation of DDI_SUSPEND-- has to take place. Note the same event could
1131  * cause the transition from one state to two different states. e.g., from
1132  * state SUSPENDED, when we get a DDI_RESUME, we just go back to the *last
1133  * state* whatever that might be. (NORMAL or OFFLINE).
1134  *
1135  *
1136  * State Transition Table:
1137  *
1138  *                    NORMAL  OFFLINE  RWAIT  DUMPING  SUSPENDED  PM_SUSPENDED
1139  *
1140  *   NORMAL              -      (a)      (b)     (c)      (d)       (h)
1141  *
1142  *   OFFLINE            (e)      -       (e)     (c)      (d)       NP
1143  *
1144  *   RWAIT              (f)     NP        -      (c)      (d)       (h)
1145  *
1146  *   DUMPING            NP      NP        NP      -        NP       NP
1147  *
1148  *   SUSPENDED          (g)     (g)       (b)     NP*      -        NP
1149  *
1150  *   PM_SUSPENDED       (i)     NP        (b)    (c)      (d)       -
1151  *
1152  *   NP :       Not Possible.
1153  *   (a):       Disk does not respond.
1154  *   (b):       Packet Allocation Fails
1155  *   (c):       Panic - Crash dump
1156  *   (d):       DDI_SUSPEND is called.
1157  *   (e):       Disk has a successful I/O completed.
1158  *   (f):       sdrunout() calls sdstart() which sets it NORMAL
1159  *   (g):       DDI_RESUME is called.
1160  *   (h):	Device threshold exceeded pm framework called power
1161  *		entry point or pm_lower_power called in detach.
1162  *   (i):	When new I/O come in.
1163  *    * :       When suspended, we dont change state during panic dump
1164  */
1165 
1166 
1167 #define	SD_MAX_THROTTLE		256
1168 #define	SD_MIN_THROTTLE		8
1169 /*
1170  * Lowest valid max. and min. throttle value.
1171  * This is set to 2 because if un_min_throttle were allowed to be 1 then
1172  * un_throttle would never get set to a value less than un_min_throttle
1173  * (0 is a special case) which means it would never get set back to
1174  * un_saved_throttle in routine sd_restore_throttle().
1175  */
1176 #define	SD_LOWEST_VALID_THROTTLE	2
1177 
1178 
1179 
1180 /* Return codes for sd_send_polled_cmd() and sd_scsi_poll() */
1181 #define	SD_CMD_SUCCESS			0
1182 #define	SD_CMD_FAILURE			1
1183 #define	SD_CMD_RESERVATION_CONFLICT	2
1184 #define	SD_CMD_ILLEGAL_REQUEST		3
1185 #define	SD_CMD_BECOMING_READY		4
1186 #define	SD_CMD_CHECK_CONDITION		5
1187 
1188 /* Return codes for sd_ready_and_valid */
1189 #define	SD_READY_VALID			0
1190 #define	SD_NOT_READY_VALID		1
1191 #define	SD_RESERVED_BY_OTHERS		2
1192 
1193 #define	SD_PATH_STANDARD		0
1194 #define	SD_PATH_DIRECT			1
1195 #define	SD_PATH_DIRECT_PRIORITY		2
1196 
1197 #define	SD_UNIT_ATTENTION_RETRY		40
1198 
1199 /*
1200  * The following three are bit flags passed into sd_send_scsi_TEST_UNIT_READY
1201  * to control specific behavior.
1202  */
1203 #define	SD_CHECK_FOR_MEDIA		0x01
1204 #define	SD_DONT_RETRY_TUR		0x02
1205 #define	SD_BYPASS_PM			0x04
1206 
1207 #define	SD_GROUP0_MAX_ADDRESS	(0x1fffff)
1208 #define	SD_GROUP0_MAXCOUNT	(0xff)
1209 #define	SD_GROUP1_MAX_ADDRESS	(0xffffffff)
1210 #define	SD_GROUP1_MAXCOUNT	(0xffff)
1211 
1212 #define	SD_BECOMING_ACTIVE	0x01
1213 #define	SD_REMOVAL_ALLOW	0
1214 #define	SD_REMOVAL_PREVENT	1
1215 
1216 #define	SD_GET_PKT_OPCODE(pktp)	\
1217 	(((union scsi_cdb *)((pktp)->pkt_cdbp))->cdb_un.cmd)
1218 
1219 
1220 #define	SD_NO_RETRY_ISSUED		0
1221 #define	SD_DELAYED_RETRY_ISSUED		1
1222 #define	SD_IMMEDIATE_RETRY_ISSUED	2
1223 
1224 #if defined(__i386) || defined(__amd64)
1225 #define	SD_UPDATE_B_RESID(bp, pktp)	\
1226 	((bp)->b_resid += (pktp)->pkt_resid + (SD_GET_XBUF(bp)->xb_dma_resid))
1227 #else
1228 #define	SD_UPDATE_B_RESID(bp, pktp)	\
1229 	((bp)->b_resid += (pktp)->pkt_resid)
1230 #endif
1231 
1232 
1233 #define	SD_RETRIES_MASK		0x00FF
1234 #define	SD_RETRIES_NOCHECK	0x0000
1235 #define	SD_RETRIES_STANDARD	0x0001
1236 #define	SD_RETRIES_VICTIM	0x0002
1237 #define	SD_RETRIES_BUSY		0x0003
1238 #define	SD_RETRIES_UA		0x0004
1239 #define	SD_RETRIES_ISOLATE	0x8000
1240 #define	SD_RETRIES_FAILFAST	0x4000
1241 
1242 #define	SD_UPDATE_RESERVATION_STATUS(un, pktp)				\
1243 if (((pktp)->pkt_reason == CMD_RESET) ||				\
1244 	((pktp)->pkt_statistics & (STAT_BUS_RESET | STAT_DEV_RESET))) { \
1245 	if (((un)->un_resvd_status & SD_RESERVE) == SD_RESERVE) {	\
1246 		(un)->un_resvd_status |=				\
1247 		    (SD_LOST_RESERVE | SD_WANT_RESERVE);		\
1248 	}								\
1249 }
1250 
1251 #define	SD_SENSE_DATA_IS_VALID		0
1252 #define	SD_SENSE_DATA_IS_INVALID	1
1253 
1254 /*
1255  * Delay (in seconds) before restoring the "throttle limit" back
1256  * to its maximum value.
1257  * 60 seconds is what we will wait for to reset the
1258  * throttle back to it SD_MAX_THROTTLE for TRAN_BUSY.
1259  * 10 seconds for STATUS_QFULL because QFULL will incrementally
1260  * increase the throttle limit until it reaches max value.
1261  */
1262 #define	SD_RESET_THROTTLE_TIMEOUT	60
1263 #define	SD_QFULL_THROTTLE_TIMEOUT	10
1264 
1265 #define	SD_THROTTLE_TRAN_BUSY		0
1266 #define	SD_THROTTLE_QFULL		1
1267 
1268 #define	SD_THROTTLE_RESET_INTERVAL	\
1269 	(sd_reset_throttle_timeout * drv_usectohz(1000000))
1270 
1271 #define	SD_QFULL_THROTTLE_RESET_INTERVAL	\
1272 	(sd_qfull_throttle_timeout * drv_usectohz(1000000))
1273 
1274 
1275 /*
1276  * xb_pkt_flags defines
1277  * SD_XB_DMA_FREED indicates the scsi_pkt has had its DMA resources freed
1278  * by a call to scsi_dmafree(9F). The resources must be reallocated before
1279  *   before a call to scsi_transport can be made again.
1280  * SD_XB_USCSICMD indicates the scsi request is a uscsi request
1281  * SD_XB_INITPKT_MASK: since this field is also used to store flags for
1282  *   a scsi_init_pkt(9F) call, we need a mask to make sure that we don't
1283  *   pass any unintended bits to scsi_init_pkt(9F) (ugly hack).
1284  */
1285 #define	SD_XB_DMA_FREED		0x20000000
1286 #define	SD_XB_USCSICMD		0x40000000
1287 #define	SD_XB_INITPKT_MASK	(PKT_CONSISTENT | PKT_DMA_PARTIAL)
1288 
1289 /*
1290  * Extension for the buf(9s) struct that we receive from a higher
1291  * layer. Located by b_private in the buf(9S).  (The previous contents
1292  * of b_private are saved & restored before calling biodone(9F).)
1293  */
1294 struct sd_xbuf {
1295 
1296 	struct sd_lun	*xb_un;		/* Ptr to associated sd_lun */
1297 	struct scsi_pkt	*xb_pktp;	/* Ptr to associated scsi_pkt */
1298 
1299 	/*
1300 	 * xb_pktinfo points to any optional data that may be needed
1301 	 * by the initpkt and/or destroypkt functions.  Typical
1302 	 * use might be to point to a struct uscsi_cmd.
1303 	 */
1304 	void	*xb_pktinfo;
1305 
1306 	/*
1307 	 * Layer-private data area. This may be used by any layer to store
1308 	 * layer-specific data on a per-IO basis. Typical usage is for an
1309 	 * iostart routine to save some info here for later use by its
1310 	 * partner iodone routine.  This area may be used to hold data or
1311 	 * a pointer to a data block that is allocated/freed by the layer's
1312 	 * iostart/iodone routines. Allocation & management policy for the
1313 	 * layer-private area is defined & implemented by each specific
1314 	 * layer as required.
1315 	 *
1316 	 * IMPORTANT: Since a higher layer may depend on the value in the
1317 	 * xb_private field, each layer must ensure that it returns the
1318 	 * buf/xbuf to the next higher layer (via SD_NEXT_IODONE()) with
1319 	 * the SAME VALUE in xb_private as when the buf/xbuf was first
1320 	 * received by the layer's iostart routine. Typically this is done
1321 	 * by the iostart routine saving the contents of xb_private into
1322 	 * a place in the layer-private data area, and the iodone routine
1323 	 * restoring the value of xb_private before deallocating the
1324 	 * layer-private data block and calling SD_NEXT_IODONE(). Of course,
1325 	 * if a layer never modifies xb_private in a buf/xbuf from a higher
1326 	 * layer, there will be no need to restore the value.
1327 	 *
1328 	 * Note that in the case where a layer _creates_ a buf/xbuf (such as
1329 	 * by calling sd_shadow_buf_alloc()) to pass to a lower layer, it is
1330 	 * not necessary to preserve the contents of xb_private as there is
1331 	 * no higher layer dependency on the value of xb_private. Such a
1332 	 * buf/xbuf must be deallocated by the layer that allocated it and
1333 	 * must *NEVER* be passed up to a higher layer.
1334 	 */
1335 	void	*xb_private;	/* Layer-private data block */
1336 
1337 	/*
1338 	 * We do not use the b_blkno provided in the buf(9S), as we need to
1339 	 * make adjustments to it in the driver, but it is not a field that
1340 	 * the driver owns or is free to modify.
1341 	 */
1342 	daddr_t	xb_blkno;		/* Absolute block # on target */
1343 	uint64_t xb_ena;		/* ena for a specific SCSI command */
1344 
1345 	int	xb_chain_iostart;	/* iostart side index */
1346 	int	xb_chain_iodone;	/* iodone side index */
1347 	int	xb_pkt_flags;		/* Flags for scsi_init_pkt() */
1348 	ssize_t	xb_dma_resid;
1349 	short	xb_retry_count;
1350 	short	xb_victim_retry_count;
1351 	short	xb_ua_retry_count;	/* unit_attention retry counter */
1352 	short	xb_nr_retry_count;	/* not ready retry counter */
1353 
1354 	/*
1355 	 * Various status and data used when a RQS command is run on
1356 	 * the behalf of this command.
1357 	 */
1358 	struct buf	*xb_sense_bp;	/* back ptr to buf, for RQS */
1359 	uint_t	xb_sense_state;		/* scsi_pkt state of RQS command */
1360 	ssize_t	xb_sense_resid;		/* residual of RQS command */
1361 	uchar_t	xb_sense_status;	/* scsi status byte of RQS command */
1362 	uchar_t	xb_sense_data[SENSE_LENGTH];	/* sense data from RQS cmd */
1363 	/*
1364 	 * Extra sense larger than SENSE_LENGTH will be allocated
1365 	 * right after xb_sense_data[SENSE_LENGTH]. Please do not
1366 	 * add any new field after it.
1367 	 */
1368 };
1369 
1370 _NOTE(SCHEME_PROTECTS_DATA("unique per pkt", sd_xbuf))
1371 
1372 #define	SD_PKT_ALLOC_SUCCESS			0
1373 #define	SD_PKT_ALLOC_FAILURE			1
1374 #define	SD_PKT_ALLOC_FAILURE_NO_DMA		2
1375 #define	SD_PKT_ALLOC_FAILURE_PKT_TOO_SMALL	3
1376 #define	SD_PKT_ALLOC_FAILURE_CDB_TOO_SMALL	4
1377 
1378 #define	SD_GET_XBUF(bp)		((struct sd_xbuf *)((bp)->b_private))
1379 #define	SD_GET_UN(bp)		((SD_GET_XBUF(bp))->xb_un)
1380 #define	SD_GET_PKTP(bp)		((SD_GET_XBUF(bp))->xb_pktp)
1381 #define	SD_GET_BLKNO(bp)	((SD_GET_XBUF(bp))->xb_blkno)
1382 
1383 /*
1384  * Special-purpose struct for sd_send_scsi_cmd() to pass command-specific
1385  * data through the layering chains to sd_initpkt_for_uscsi().
1386  */
1387 struct sd_uscsi_info {
1388 	int			ui_flags;
1389 	struct uscsi_cmd	*ui_cmdp;
1390 	/*
1391 	 * ui_dkc is used by sd_send_scsi_SYNCHRONIZE_CACHE() to allow
1392 	 * for async completion notification.
1393 	 */
1394 	struct dk_callback	ui_dkc;
1395 	/*
1396 	 * The following fields are to be used for FMA ereport generation.
1397 	 */
1398 	uchar_t			ui_pkt_reason;
1399 	uint32_t		ui_pkt_state;
1400 	uint32_t		ui_pkt_statistics;
1401 	uint64_t		ui_lba;
1402 	uint64_t		ui_ena;
1403 };
1404 
1405 _NOTE(SCHEME_PROTECTS_DATA("Unshared data", sd_uscsi_info))
1406 
1407 /*
1408  * This structure is used to issue 'internal' command sequences from the
1409  * driver's attach(9E)/open(9E)/etc entry points. It provides a common context
1410  * for issuing command sequences, with the ability to issue a command
1411  * and provide expected/unexpected assessment of results at any code
1412  * level within the sd_ssc_t scope and preserve the information needed
1413  * produce telemetry for the problem, when needed, from a single
1414  * outer-most-scope point.
1415  *
1416  * The sd_ssc_t abstraction should result in well-structured code where
1417  * the basic code structure is not jeprodized by future localized improvement.
1418  *
1419  *   o  Scope for a sequence of commands.
1420  *   o  Within a scoped sequence of commands, provides a single top-level
1421  *      location for initiating telementry generation from captured data.
1422  *   o  Provide a common place to capture command execution data and driver
1423  *      assessment information for delivery to telemetry generation point.
1424  *   o  Mechanism to get device-as-detector (dad) and transport telemetry
1425  *      information from interrupt context (sdintr) back to the internal
1426  *      command 'driver-assessment' code.
1427  *   o  Ability to record assessment, and return information back to
1428  *      top-level telemetry generation code when an unexpected condition
1429  *      occurs.
1430  *   o  For code paths were an command itself was successful but
1431  *      the data returned looks suspect, the ability to record
1432  *      'unexpected data' conditions.
1433  *   o  Record assessment of issuing the command and interpreting
1434  *      the returned data for consumption by top-level ereport telemetry
1435  *      generation code.
1436  *   o  All data required to produce telemetry available off single data
1437  *      structure.
1438  */
1439 typedef struct {
1440 	struct sd_lun		*ssc_un;
1441 	struct uscsi_cmd	*ssc_uscsi_cmd;
1442 	struct sd_uscsi_info	*ssc_uscsi_info;
1443 	int			ssc_flags; /* Bits for flags */
1444 	char			ssc_info[1024]; /* Buffer holding for info */
1445 } sd_ssc_t;
1446 
1447 _NOTE(SCHEME_PROTECTS_DATA("Unshared data", sd_ssc_t))
1448 
1449 /*
1450  * This struct switch different 'type-of-assessment'
1451  * as an input argument for sd_ssc_assessment
1452  *
1453  *
1454  * in sd_send_scsi_XXX or upper-level
1455  *
1456  * - SD_FMT_IGNORE
1457  *   when send uscsi command failed, and
1458  *   the following code check sense data properly.
1459  *   we use 'ignore' to let sd_ssc_assessment
1460  *   trust current and do not do additional
1461  *   checking for the uscsi command.
1462  *
1463  * - SD_FMT_IGNORE_COMPROMISE
1464  *   when send uscsi command failed, and
1465  *   the code does not check sense data or we don't
1466  *   think the checking is 100% coverage. We mark it
1467  *   as 'compromise' to indicate that we need to
1468  *   enhance current code in the future.
1469  *
1470  * - SD_FMT_STATUS_CHECK
1471  *   when send uscsi command failed and cause sd entries
1472  *   failed finally, we need to send out real reason against
1473  *   status of uscsi command no matter if there is sense back
1474  *   or not.
1475  *
1476  * - SD_FMT_STANDARD
1477  *   when send uscsi command succeeded, and
1478  *   the code does not check sense data, we need to check
1479  *   it to make sure there is no 'fault'.
1480  */
1481 enum sd_type_assessment {
1482 	SD_FMT_IGNORE = 0,
1483 	SD_FMT_IGNORE_COMPROMISE,
1484 	SD_FMT_STATUS_CHECK,
1485 	SD_FMT_STANDARD
1486 };
1487 
1488 /*
1489  * The following declaration are used as hints of severities when posting
1490  * SCSI FMA ereport.
1491  * - SD_FM_DRV_FATAL
1492  *   When posting ereport with SD_FM_DRV_FATAL, the payload
1493  *   "driver-assessment" will be "fail" or "fatal" depending on the
1494  *   sense-key value. If driver-assessment is "fail", it will be
1495  *   propagated to an upset, otherwise, a fault will be propagated.
1496  * - SD_FM_DRV_RETRY
1497  *   When posting ereport with SD_FM_DRV_RETRY, the payload
1498  *   "driver-assessment" will be "retry", and it will be propagated to an
1499  *   upset.
1500  * - SD_FM_DRV_RECOVERY
1501  *   When posting ereport with SD_FM_DRV_RECOVERY, the payload
1502  *   "driver-assessment" will be "recovered", and it will be propagated to
1503  *   an upset.
1504  * - SD_FM_DRV_NOTICE
1505  *   When posting ereport with SD_FM_DRV_NOTICE, the payload
1506  *   "driver-assessment" will be "info", and it will be propagated to an
1507  *   upset.
1508  */
1509 enum sd_driver_assessment {
1510 	SD_FM_DRV_FATAL = 0,
1511 	SD_FM_DRV_RETRY,
1512 	SD_FM_DRV_RECOVERY,
1513 	SD_FM_DRV_NOTICE
1514 };
1515 
1516 /*
1517  * The following structure is used as a buffer when posting SCSI FMA
1518  * ereport for raw i/o. It will be allocated per sd_lun when entering
1519  * sd_unit_attach and will be deallocated when entering sd_unit_detach.
1520  */
1521 struct sd_fm_internal {
1522 	sd_ssc_t fm_ssc;
1523 	struct uscsi_cmd fm_ucmd;
1524 	struct sd_uscsi_info fm_uinfo;
1525 	int fm_log_level;
1526 };
1527 
1528 /*
1529  * Bits in ssc_flags
1530  * sd_ssc_init will mark ssc_flags = SSC_FLAGS_UNKNOWN
1531  * sd_ssc_send will mark ssc_flags = SSC_FLAGS_CMD_ISSUED &
1532  *                                   SSC_FLAGS_NEED_ASSESSMENT
1533  * sd_ssc_assessment will clear SSC_FLAGS_CMD_ISSUED and
1534  * SSC_FLAGS_NEED_ASSESSMENT bits of ssc_flags.
1535  * SSC_FLAGS_CMD_ISSUED is to indicate whether the SCSI command has been
1536  * sent out.
1537  * SSC_FLAGS_NEED_ASSESSMENT is to guarantee we will not miss any
1538  * assessment point.
1539  */
1540 #define		SSC_FLAGS_UNKNOWN		0x00000000
1541 #define		SSC_FLAGS_CMD_ISSUED		0x00000001
1542 #define		SSC_FLAGS_NEED_ASSESSMENT	0x00000002
1543 #define		SSC_FLAGS_TRAN_ABORT		0x00000004
1544 
1545 /*
1546  * The following bits in ssc_flags are for detecting unexpected data.
1547  */
1548 #define		SSC_FLAGS_INVALID_PKT_REASON	0x00000010
1549 #define		SSC_FLAGS_INVALID_STATUS	0x00000020
1550 #define		SSC_FLAGS_INVALID_SENSE		0x00000040
1551 #define		SSC_FLAGS_INVALID_DATA		0x00000080
1552 
1553 /*
1554  * The following are the values available for sd_fm_internal::fm_log_level.
1555  * SD_FM_LOG_NSUP	The driver will log things in traditional way as if
1556  * 			the SCSI FMA feature is unavailable.
1557  * SD_FM_LOG_SILENT	The driver will not print out syslog for FMA error
1558  * 			telemetry, all the error telemetries will go into
1559  * 			FMA error log.
1560  * SD_FM_LOG_EREPORT	The driver will both print the FMA error telemetry
1561  * 			and post the error report, but the traditional
1562  * 			syslog for error telemetry will be suppressed.
1563  */
1564 #define		SD_FM_LOG_NSUP		0
1565 #define		SD_FM_LOG_SILENT	1
1566 #define		SD_FM_LOG_EREPORT	2
1567 
1568 /*
1569  * Macros and definitions for driver kstats and errstats
1570  *
1571  * Some third-party layered drivers (they know who they are) do not maintain
1572  * their open/close counts correctly which causes our kstat reporting to get
1573  * messed up & results in panics. These macros will update the driver kstats
1574  * only if the counts are valid.
1575  */
1576 #define	SD_UPDATE_COMMON_KSTATS(kstat_function, kstatp)			\
1577 	if ((kstat_function)  == kstat_runq_exit ||			\
1578 	    ((kstat_function) == kstat_runq_back_to_waitq)) { 		\
1579 		if (((kstat_io_t *)(kstatp))->rcnt) {			\
1580 			kstat_function((kstatp));			\
1581 		} else {						\
1582 			cmn_err(CE_WARN,				\
1583 		"kstat rcnt == 0 when exiting runq, please check\n");	\
1584 		}							\
1585 	} else if ((kstat_function) == kstat_waitq_exit ||		\
1586 	    ((kstat_function) == kstat_waitq_to_runq)) {		\
1587 		if (((kstat_io_t *)(kstatp))->wcnt) {			\
1588 			kstat_function(kstatp);				\
1589 		} else {						\
1590 			cmn_err(CE_WARN,				\
1591 		"kstat wcnt == 0 when exiting waitq, please check\n");	\
1592 		}							\
1593 	} else {							\
1594 		kstat_function(kstatp);					\
1595 	}
1596 
1597 #define	SD_UPDATE_KSTATS(un, kstat_function, bp)			\
1598 	ASSERT(SD_GET_XBUF(bp) != NULL);				\
1599 	if (SD_IS_BUFIO(SD_GET_XBUF(bp))) {				\
1600 		struct kstat *pksp =					\
1601 			(un)->un_pstats[SDPART((bp)->b_edev)];		\
1602 		ASSERT(mutex_owned(SD_MUTEX(un)));			\
1603 		if ((un)->un_stats != NULL) {				\
1604 			kstat_io_t *kip = KSTAT_IO_PTR((un)->un_stats);	\
1605 			SD_UPDATE_COMMON_KSTATS(kstat_function, kip);	\
1606 		}							\
1607 		if (pksp != NULL) {					\
1608 			kstat_io_t *kip = KSTAT_IO_PTR(pksp);		\
1609 			SD_UPDATE_COMMON_KSTATS(kstat_function, kip);	\
1610 		}							\
1611 	}
1612 
1613 #define	SD_UPDATE_ERRSTATS(un, x)					\
1614 	if ((un)->un_errstats != NULL) {				\
1615 		struct sd_errstats *stp;				\
1616 		ASSERT(mutex_owned(SD_MUTEX(un)));			\
1617 		stp = (struct sd_errstats *)(un)->un_errstats->ks_data;	\
1618 		stp->x.value.ui32++;					\
1619 	}
1620 
1621 #define	SD_UPDATE_RDWR_STATS(un, bp)					\
1622 	if ((un)->un_stats != NULL) {					\
1623 		kstat_io_t *kip = KSTAT_IO_PTR((un)->un_stats);		\
1624 		size_t n_done = (bp)->b_bcount - (bp)->b_resid;		\
1625 		if ((bp)->b_flags & B_READ) {				\
1626 			kip->reads++;					\
1627 			kip->nread += n_done;				\
1628 		} else {						\
1629 			kip->writes++;					\
1630 			kip->nwritten += n_done;			\
1631 		}							\
1632 	}
1633 
1634 #define	SD_UPDATE_PARTITION_STATS(un, bp)				\
1635 {									\
1636 	struct kstat *pksp = (un)->un_pstats[SDPART((bp)->b_edev)];	\
1637 	if (pksp != NULL) {						\
1638 		kstat_io_t *kip = KSTAT_IO_PTR(pksp);			\
1639 		size_t n_done = (bp)->b_bcount - (bp)->b_resid;		\
1640 		if ((bp)->b_flags & B_READ) {				\
1641 			kip->reads++;					\
1642 			kip->nread += n_done;				\
1643 		} else {						\
1644 			kip->writes++;					\
1645 			kip->nwritten += n_done;			\
1646 		}							\
1647 	}								\
1648 }
1649 
1650 
1651 #endif	/* defined(_KERNEL) || defined(_KMEMUSER) */
1652 
1653 
1654 /*
1655  * 60 seconds is a *very* reasonable amount of time for most slow CD
1656  * operations.
1657  */
1658 #define	SD_IO_TIME			60
1659 
1660 /*
1661  * 2 hours is an excessively reasonable amount of time for format operations.
1662  */
1663 #define	SD_FMT_TIME			(120 * 60)
1664 
1665 /*
1666  * 5 seconds is what we'll wait if we get a Busy Status back
1667  */
1668 #define	SD_BSY_TIMEOUT			(drv_usectohz(5 * 1000000))
1669 
1670 /*
1671  * 100 msec. is what we'll wait if we get Unit Attention.
1672  */
1673 #define	SD_UA_RETRY_DELAY		(drv_usectohz((clock_t)100000))
1674 
1675 /*
1676  * 100 msec. is what we'll wait for restarted commands.
1677  */
1678 #define	SD_RESTART_TIMEOUT		(drv_usectohz((clock_t)100000))
1679 
1680 /*
1681  * 100 msec. is what we'll wait for certain retries for fibre channel
1682  * targets, 0 msec for parallel SCSI.
1683  */
1684 #if defined(__fibre)
1685 #define	SD_RETRY_DELAY			(drv_usectohz(100000))
1686 #else
1687 #define	SD_RETRY_DELAY			((clock_t)0)
1688 #endif
1689 
1690 /*
1691  * 60 seconds is what we will wait for to reset the
1692  * throttle back to it SD_MAX_THROTTLE.
1693  */
1694 #define	SD_RESET_THROTTLE_TIMEOUT	60
1695 
1696 /*
1697  * Number of times we'll retry a normal operation.
1698  *
1699  * This includes retries due to transport failure
1700  * (need to distinguish between Target and Transport failure)
1701  *
1702  */
1703 #if defined(__fibre)
1704 #define	SD_RETRY_COUNT			3
1705 #else
1706 #define	SD_RETRY_COUNT			5
1707 #endif
1708 
1709 /*
1710  * Number of times we will retry for unit attention.
1711  */
1712 #define	SD_UA_RETRY_COUNT		600
1713 
1714 #define	SD_VICTIM_RETRY_COUNT(un)	(un->un_victim_retry_count)
1715 #define	CD_NOT_READY_RETRY_COUNT(un)	(un->un_retry_count * 2)
1716 #define	DISK_NOT_READY_RETRY_COUNT(un)	(un->un_retry_count / 2)
1717 
1718 
1719 /*
1720  * Maximum number of units we can support
1721  * (controlled by room in minor device byte)
1722  *
1723  * Note: this value is out of date.
1724  */
1725 #define	SD_MAXUNIT			32
1726 
1727 /*
1728  * 30 seconds is what we will wait for the IO to finish
1729  * before we fail the DDI_SUSPEND
1730  */
1731 #define	SD_WAIT_CMDS_COMPLETE		30
1732 
1733 /*
1734  * Prevent/allow media removal flags
1735  */
1736 #define	SD_REMOVAL_ALLOW		0
1737 #define	SD_REMOVAL_PREVENT		1
1738 
1739 
1740 /*
1741  * Drive Types (and characteristics)
1742  */
1743 #define	VIDMAX				8
1744 #define	PIDMAX				16
1745 
1746 
1747 /*
1748  * The following #defines and type definitions for the property
1749  * processing component of the sd driver.
1750  */
1751 
1752 
1753 /* Miscellaneous Definitions */
1754 #define	SD_CONF_VERSION_1		1
1755 #define	SD_CONF_NOT_USED		32
1756 
1757 /*
1758  * Return values from "pm-capable" property
1759  */
1760 #define	SD_PM_CAPABLE_UNDEFINED		-1
1761 #define	SD_PM_CAPABLE_FALSE		0
1762 #define	SD_PM_CAPABLE_TRUE		1
1763 
1764 /*
1765  * Property data values used in static configuration table
1766  * These are all based on device characteristics.
1767  * For fibre channel devices, the throttle value is usually
1768  * derived from the devices cmd Q depth divided by the number
1769  * of supported initiators.
1770  */
1771 #define	ELITE_THROTTLE_VALUE		10
1772 #define	SEAGATE_THROTTLE_VALUE		15
1773 #define	IBM_THROTTLE_VALUE		15
1774 #define	ST31200N_THROTTLE_VALUE		8
1775 #define	FUJITSU_THROTTLE_VALUE		15
1776 #define	SYMBIOS_THROTTLE_VALUE		16
1777 #define	SYMBIOS_NOTREADY_RETRIES	24
1778 #define	LSI_THROTTLE_VALUE		16
1779 #define	LSI_NOTREADY_RETRIES		24
1780 #define	LSI_OEM_NOTREADY_RETRIES	36
1781 #define	PURPLE_THROTTLE_VALUE		64
1782 #define	PURPLE_BUSY_RETRIES		60
1783 #define	PURPLE_RESET_RETRY_COUNT	36
1784 #define	PURPLE_RESERVE_RELEASE_TIME	60
1785 #define	SVE_BUSY_RETRIES		60
1786 #define	SVE_RESET_RETRY_COUNT		36
1787 #define	SVE_RESERVE_RELEASE_TIME	60
1788 #define	SVE_THROTTLE_VALUE		10
1789 #define	SVE_MIN_THROTTLE_VALUE		2
1790 #define	SVE_DISKSORT_DISABLED_FLAG	1
1791 #define	MASERATI_DISKSORT_DISABLED_FLAG	1
1792 #define	MASERATI_LUN_RESET_ENABLED_FLAG	1
1793 #define	PIRUS_THROTTLE_VALUE		64
1794 #define	PIRUS_NRR_COUNT			60
1795 #define	PIRUS_BUSY_RETRIES		60
1796 #define	PIRUS_RESET_RETRY_COUNT		36
1797 #define	PIRUS_MIN_THROTTLE_VALUE	16
1798 #define	PIRUS_DISKSORT_DISABLED_FLAG	0
1799 #define	PIRUS_LUN_RESET_ENABLED_FLAG	1
1800 
1801 /*
1802  * Driver Property Bit Flag definitions
1803  *
1804  * Unfortunately, for historical reasons, the bit-flag definitions are
1805  * different on SPARC, INTEL, & FIBRE platforms.
1806  */
1807 
1808 /*
1809  * Bit flag telling driver to set throttle from sd.conf sd-config-list
1810  * and driver table.
1811  *
1812  * The max throttle (q-depth) property implementation is for support of
1813  * fibre channel devices that can drop an i/o request when a queue fills
1814  * up. The number of commands sent to the disk from this driver is
1815  * regulated such that queue overflows are avoided.
1816  */
1817 #define	SD_CONF_SET_THROTTLE		0
1818 #define	SD_CONF_BSET_THROTTLE		(1 << SD_CONF_SET_THROTTLE)
1819 
1820 /*
1821  * Bit flag telling driver to set the controller type from sd.conf
1822  * sd-config-list and driver table.
1823  */
1824 #if defined(__i386) || defined(__amd64)
1825 #define	SD_CONF_SET_CTYPE		1
1826 #elif defined(__fibre)
1827 #define	SD_CONF_SET_CTYPE		5
1828 #else
1829 #define	SD_CONF_SET_CTYPE		1
1830 #endif
1831 #define	SD_CONF_BSET_CTYPE		(1 << SD_CONF_SET_CTYPE)
1832 
1833 /*
1834  * Bit flag telling driver to set the not ready retry count for a device from
1835  * sd.conf sd-config-list and driver table.
1836  */
1837 #if defined(__i386) || defined(__amd64)
1838 #define	SD_CONF_SET_NOTREADY_RETRIES	10
1839 #elif defined(__fibre)
1840 #define	SD_CONF_SET_NOTREADY_RETRIES	1
1841 #else
1842 #define	SD_CONF_SET_NOTREADY_RETRIES	2
1843 #endif
1844 #define	SD_CONF_BSET_NRR_COUNT		(1 << SD_CONF_SET_NOTREADY_RETRIES)
1845 
1846 /*
1847  * Bit flag telling driver to set SCSI status BUSY Retries from sd.conf
1848  * sd-config-list and driver table.
1849  */
1850 #if defined(__i386) || defined(__amd64)
1851 #define	SD_CONF_SET_BUSY_RETRIES 	11
1852 #elif defined(__fibre)
1853 #define	SD_CONF_SET_BUSY_RETRIES 	2
1854 #else
1855 #define	SD_CONF_SET_BUSY_RETRIES 	5
1856 #endif
1857 #define	SD_CONF_BSET_BSY_RETRY_COUNT	(1 << SD_CONF_SET_BUSY_RETRIES)
1858 
1859 /*
1860  * Bit flag telling driver that device does not have a valid/unique serial
1861  * number.
1862  */
1863 #if defined(__i386) || defined(__amd64)
1864 #define	SD_CONF_SET_FAB_DEVID		2
1865 #else
1866 #define	SD_CONF_SET_FAB_DEVID		3
1867 #endif
1868 #define	SD_CONF_BSET_FAB_DEVID   	(1 << SD_CONF_SET_FAB_DEVID)
1869 
1870 /*
1871  * Bit flag telling driver to disable all caching for disk device.
1872  */
1873 #if defined(__i386) || defined(__amd64)
1874 #define	SD_CONF_SET_NOCACHE		3
1875 #else
1876 #define	SD_CONF_SET_NOCACHE		4
1877 #endif
1878 #define	SD_CONF_BSET_NOCACHE		(1 << SD_CONF_SET_NOCACHE)
1879 
1880 /*
1881  * Bit flag telling driver that the PLAY AUDIO command requires parms in BCD
1882  * format rather than binary.
1883  */
1884 #if defined(__i386) || defined(__amd64)
1885 #define	SD_CONF_SET_PLAYMSF_BCD		4
1886 #else
1887 #define	SD_CONF_SET_PLAYMSF_BCD		6
1888 #endif
1889 #define	SD_CONF_BSET_PLAYMSF_BCD    	(1 << SD_CONF_SET_PLAYMSF_BCD)
1890 
1891 /*
1892  * Bit flag telling driver that the response from the READ SUBCHANNEL command
1893  * has BCD fields rather than binary.
1894  */
1895 #if defined(__i386) || defined(__amd64)
1896 #define	SD_CONF_SET_READSUB_BCD		5
1897 #else
1898 #define	SD_CONF_SET_READSUB_BCD		7
1899 #endif
1900 #define	SD_CONF_BSET_READSUB_BCD	(1 << SD_CONF_SET_READSUB_BCD)
1901 
1902 /*
1903  * Bit in flags telling driver that the track number fields in the READ TOC
1904  * request and respone are in BCD rather than binary.
1905  */
1906 #if defined(__i386) || defined(__amd64)
1907 #define	SD_CONF_SET_READ_TOC_TRK_BCD	6
1908 #else
1909 #define	SD_CONF_SET_READ_TOC_TRK_BCD	8
1910 #endif
1911 #define	SD_CONF_BSET_READ_TOC_TRK_BCD	(1 << SD_CONF_SET_READ_TOC_TRK_BCD)
1912 
1913 /*
1914  * Bit flag telling driver that the address fields in the READ TOC request and
1915  * respone are in BCD rather than binary.
1916  */
1917 #if defined(__i386) || defined(__amd64)
1918 #define	SD_CONF_SET_READ_TOC_ADDR_BCD	7
1919 #else
1920 #define	SD_CONF_SET_READ_TOC_ADDR_BCD	9
1921 #endif
1922 #define	SD_CONF_BSET_READ_TOC_ADDR_BCD	(1 << SD_CONF_SET_READ_TOC_ADDR_BCD)
1923 
1924 /*
1925  * Bit flag telling the driver that the device doesn't support the READ HEADER
1926  * command.
1927  */
1928 #if defined(__i386) || defined(__amd64)
1929 #define	SD_CONF_SET_NO_READ_HEADER	8
1930 #else
1931 #define	SD_CONF_SET_NO_READ_HEADER	10
1932 #endif
1933 #define	SD_CONF_BSET_NO_READ_HEADER 	(1 << SD_CONF_SET_NO_READ_HEADER)
1934 
1935 /*
1936  * Bit flag telling the driver that for the READ CD command the device uses
1937  * opcode 0xd4 rather than 0xbe.
1938  */
1939 #if defined(__i386) || defined(__amd64)
1940 #define	SD_CONF_SET_READ_CD_XD4		9
1941 #else
1942 #define	SD_CONF_SET_READ_CD_XD4 	11
1943 #endif
1944 #define	SD_CONF_BSET_READ_CD_XD4	(1 << SD_CONF_SET_READ_CD_XD4)
1945 
1946 /*
1947  * Bit flag telling the driver to set SCSI status Reset Retries
1948  * (un_reset_retry_count) from sd.conf sd-config-list and driver table (4356701)
1949  */
1950 #define	SD_CONF_SET_RST_RETRIES		12
1951 #define	SD_CONF_BSET_RST_RETRIES	(1 << SD_CONF_SET_RST_RETRIES)
1952 
1953 /*
1954  * Bit flag telling the driver to set the reservation release timeout value
1955  * from sd.conf sd-config-list and driver table. (4367306)
1956  */
1957 #define	SD_CONF_SET_RSV_REL_TIME	13
1958 #define	SD_CONF_BSET_RSV_REL_TIME	(1 << SD_CONF_SET_RSV_REL_TIME)
1959 
1960 /*
1961  * Bit flag telling the driver to verify that no commands are pending for a
1962  * device before issuing a Test Unit Ready. This is a fw workaround for Seagate
1963  * eliteI drives. (4392016)
1964  */
1965 #define	SD_CONF_SET_TUR_CHECK		14
1966 #define	SD_CONF_BSET_TUR_CHECK		(1 << SD_CONF_SET_TUR_CHECK)
1967 
1968 /*
1969  * Bit in flags telling driver to set min. throttle from ssd.conf
1970  * ssd-config-list and driver table.
1971  */
1972 #define	SD_CONF_SET_MIN_THROTTLE	15
1973 #define	SD_CONF_BSET_MIN_THROTTLE	(1 << SD_CONF_SET_MIN_THROTTLE)
1974 
1975 /*
1976  * Bit in flags telling driver to set disksort disable flag from ssd.conf
1977  * ssd-config-list and driver table.
1978  */
1979 #define	SD_CONF_SET_DISKSORT_DISABLED	16
1980 #define	SD_CONF_BSET_DISKSORT_DISABLED	(1 << SD_CONF_SET_DISKSORT_DISABLED)
1981 
1982 /*
1983  * Bit in flags telling driver to set LUN Reset enable flag from [s]sd.conf
1984  * [s]sd-config-list and driver table.
1985  */
1986 #define	SD_CONF_SET_LUN_RESET_ENABLED	17
1987 #define	SD_CONF_BSET_LUN_RESET_ENABLED	(1 << SD_CONF_SET_LUN_RESET_ENABLED)
1988 
1989 /*
1990  * Bit in flags telling driver that the write cache on the device is
1991  * non-volatile.
1992  */
1993 #define	SD_CONF_SET_CACHE_IS_NV	18
1994 #define	SD_CONF_BSET_CACHE_IS_NV	(1 << SD_CONF_SET_CACHE_IS_NV)
1995 
1996 /*
1997  * This is the number of items currently settable in the sd.conf
1998  * sd-config-list.  The mask value is defined for parameter checking. The
1999  * item count and mask should be updated when new properties are added.
2000  */
2001 #define	SD_CONF_MAX_ITEMS		19
2002 #define	SD_CONF_BIT_MASK		0x0007FFFF
2003 
2004 typedef struct {
2005 	int sdt_throttle;
2006 	int sdt_ctype;
2007 	int sdt_not_rdy_retries;
2008 	int sdt_busy_retries;
2009 	int sdt_reset_retries;
2010 	int sdt_reserv_rel_time;
2011 	int sdt_min_throttle;
2012 	int sdt_disk_sort_dis;
2013 	int sdt_lun_reset_enable;
2014 	int sdt_suppress_cache_flush;
2015 } sd_tunables;
2016 
2017 /* Type definition for static configuration table entries */
2018 typedef struct sd_disk_config {
2019 	char	device_id[25];
2020 	uint_t	flags;
2021 	sd_tunables *properties;
2022 } sd_disk_config_t;
2023 
2024 /*
2025  * byte 4 options for 1bh command
2026  */
2027 #define	SD_TARGET_STOP			0x00
2028 #define	SD_TARGET_START			0x01
2029 #define	SD_TARGET_EJECT			0x02
2030 #define	SD_TARGET_CLOSE			0x03
2031 
2032 
2033 #define	SD_MODE_SENSE_PAGE3_CODE	0x03
2034 #define	SD_MODE_SENSE_PAGE4_CODE	0x04
2035 
2036 #define	SD_MODE_SENSE_PAGE3_LENGTH					\
2037 	(sizeof (struct mode_format) + MODE_PARAM_LENGTH)
2038 #define	SD_MODE_SENSE_PAGE4_LENGTH					\
2039 	(sizeof (struct mode_geometry) + MODE_PARAM_LENGTH)
2040 
2041 /*
2042  * These command codes need to be moved to sys/scsi/generic/commands.h
2043  */
2044 
2045 /* Both versions of the Read CD command */
2046 
2047 /* the official SCMD_READ_CD now comes from cdio.h */
2048 #define	SCMD_READ_CDD4		0xd4	/* the one used by some first */
2049 					/* generation ATAPI CD drives */
2050 
2051 /* expected sector type filter values for Play and Read CD CDBs */
2052 #define	CDROM_SECTOR_TYPE_CDDA		(1<<2)	/* IEC 908:1987 (CDDA) */
2053 #define	CDROM_SECTOR_TYPE_MODE1		(2<<2)	/* Yellow book 2048 bytes */
2054 #define	CDROM_SECTOR_TYPE_MODE2		(3<<2)	/* Yellow book 2335 bytes */
2055 #define	CDROM_SECTOR_TYPE_MODE2_FORM1	(4<<2)	/* 2048 bytes */
2056 #define	CDROM_SECTOR_TYPE_MODE2_FORM2	(5<<2)	/* 2324 bytes */
2057 
2058 /* READ CD filter bits (cdb[9]) */
2059 #define	CDROM_READ_CD_SYNC	0x80	/* read sync field */
2060 #define	CDROM_READ_CD_HDR	0x20	/* read four byte header */
2061 #define	CDROM_READ_CD_SUBHDR	0x40	/* read sub-header */
2062 #define	CDROM_READ_CD_ALLHDRS	0x60	/* read header and sub-header */
2063 #define	CDROM_READ_CD_USERDATA	0x10	/* read user data */
2064 #define	CDROM_READ_CD_EDC_ECC	0x08	/* read EDC and ECC field */
2065 #define	CDROM_READ_CD_C2	0x02	/* read C2 error data */
2066 #define	CDROM_READ_CD_C2_BEB	0x04	/* read C2 and Block Error Bits */
2067 
2068 
2069 /*
2070  * These belong in sys/scsi/generic/mode.h
2071  */
2072 
2073 /*
2074  * Mode Sense/Select Header response for Group 2 CDB.
2075  */
2076 
2077 struct mode_header_grp2 {
2078 	uchar_t length_msb;		/* MSB - number of bytes following */
2079 	uchar_t length_lsb;
2080 	uchar_t medium_type;		/* device specific */
2081 	uchar_t device_specific;	/* device specfic parameters */
2082 	uchar_t resv[2];		/* reserved */
2083 	uchar_t bdesc_length_hi;	/* length of block descriptor(s) */
2084 					/* (if any) */
2085 	uchar_t bdesc_length_lo;
2086 };
2087 
2088 _NOTE(SCHEME_PROTECTS_DATA("Unshared data", mode_header_grp2))
2089 
2090 /*
2091  * Length of the Mode Parameter Header for the Group 2 Mode Select command
2092  */
2093 #define	MODE_HEADER_LENGTH_GRP2	(sizeof (struct mode_header_grp2))
2094 #define	MODE_PARAM_LENGTH_GRP2 (MODE_HEADER_LENGTH_GRP2 + MODE_BLK_DESC_LENGTH)
2095 
2096 /*
2097  * Mode Page 1 - Error Recovery Page
2098  */
2099 #define	MODEPAGE_ERR_RECOVER		1
2100 
2101 /*
2102  * The following buffer length define is 8 bytes for the Group 2 mode page
2103  * header, 8 bytes for the block descriptor and 26 bytes for the cdrom
2104  * capabilities page (per MMC-2)
2105  */
2106 #define	MODEPAGE_CDROM_CAP		0x2A
2107 #define	MODEPAGE_CDROM_CAP_LEN		26
2108 #define	BUFLEN_MODE_CDROM_CAP		(MODEPAGE_CDROM_CAP_LEN + \
2109 	MODE_HEADER_LENGTH_GRP2 + MODE_BLK_DESC_LENGTH)
2110 
2111 
2112 /*
2113  * Power management defines
2114  */
2115 #define	SD_SPINDLE_UNINIT	(-1)
2116 #define	SD_SPINDLE_OFF		0
2117 #define	SD_SPINDLE_ON		1
2118 #define	SD_PM_NOT_SUPPORTED	2
2119 
2120 
2121 /*
2122  * No Need to resume if already in PM_SUSPEND state because the thread
2123  * was suspended in sdpower. It will be resumed when sdpower is invoked to make
2124  * the device active.
2125  * When the thread is suspended, the watch thread is terminated and
2126  * the token is NULLed so check for this condition.
2127  * If there's a thread that can be resumed, ie. token is not NULL, then
2128  * it can be resumed.
2129  */
2130 #define	SD_OK_TO_RESUME_SCSI_WATCHER(un)	(un->un_swr_token != NULL)
2131 /*
2132  * No Need to resume if already in PM_SUSPEND state because the thread
2133  * was suspended in sdpower. It will be resumed when sdpower is invoked to make
2134  * the device active.
2135  * When the thread is suspended, the watch thread is terminated and
2136  * the token is NULLed so check for this condition.
2137  */
2138 #define	SD_OK_TO_SUSPEND_SCSI_WATCHER(un)	(un->un_swr_token != NULL)
2139 #define	SD_DEVICE_IS_IN_LOW_POWER(un)		((un->un_f_pm_is_enabled) && \
2140 						    (un->un_pm_count < 0))
2141 /*
2142  * Could move this define to some thing like log sense.h in SCSA headers
2143  * But for now let it live here.
2144  */
2145 #define	START_STOP_CYCLE_COUNTER_PAGE_SIZE	0x28
2146 #define	START_STOP_CYCLE_PAGE			0x0E
2147 #define	START_STOP_CYCLE_VU_PAGE		0x31
2148 
2149 /* CD-ROM Error Recovery Parameters page (0x01) */
2150 #define	MODEPAGE_ERR_RECOV	0x1
2151 #define	BUFLEN_CHG_BLK_MODE	MODE_HEADER_LENGTH + MODE_BLK_DESC_LENGTH
2152 
2153 /*
2154  * Vendor Specific (Toshiba) CD-ROM Speed page (0x31)
2155  *
2156  * The following buffer length define is 4 bytes for the Group 0 mode page
2157  * header, 8 bytes for the block descriptor and 4 bytes for the mode speed page.
2158  */
2159 #define	MODEPAGE_CDROM_SPEED_LEN	4
2160 #define	BUFLEN_MODE_CDROM_SPEED		MODEPAGE_CDROM_SPEED_LEN +\
2161 					MODE_HEADER_LENGTH +\
2162 					MODE_BLK_DESC_LENGTH
2163 #define	SD_SPEED_1X			176
2164 
2165 /* CD-ROM Audio Control Parameters page (0x0E) */
2166 #define	MODEPAGE_AUDIO_CTRL		0x0E
2167 #define	MODEPAGE_AUDIO_CTRL_LEN		16
2168 
2169 /* CD-ROM Sony Read Offset Defines */
2170 #define	SONY_SESSION_OFFSET_LEN		12
2171 #define	SONY_SESSION_OFFSET_KEY		0x40
2172 #define	SONY_SESSION_OFFSET_VALID	0x0a
2173 
2174 /*
2175  * CD-ROM Write Protect Defines
2176  *
2177  * Bit 7 of the device specific field of the mode page header is the write
2178  * protect bit.
2179  */
2180 #define	WRITE_PROTECT 0x80
2181 
2182 /*
2183  * Define for the length of a profile header returned in response to the
2184  * GET CONFIGURATION command
2185  */
2186 #define	SD_PROFILE_HEADER_LEN		8	/* bytes */
2187 
2188 /*
2189  * Define the length of the data in response to the GET CONFIGURATION
2190  * command.  The 3rd byte of the feature descriptor contains the
2191  * current feature field that is of interest.  This field begins
2192  * after the feature header which is 8 bytes.  This variable length
2193  * was increased in size from 11 to 24 because some devices became
2194  * unresponsive with the smaller size.
2195  */
2196 #define	SD_CURRENT_FEATURE_LEN		24	/* bytes */
2197 
2198 /*
2199  * Feature codes associated with GET CONFIGURATION command for supported
2200  * devices.
2201  */
2202 #define	RANDOM_WRITABLE			0x20
2203 #define	HARDWARE_DEFECT_MANAGEMENT	0x24
2204 
2205 /*
2206  * Could move this define to some thing like log sense.h in SCSA headers
2207  * But for now let it live here.
2208  */
2209 #define	TEMPERATURE_PAGE			0x0D
2210 #define	TEMPERATURE_PAGE_SIZE			16	/* bytes */
2211 
2212 /* delay time used for sd_media_watch_cb delayed cv broadcast */
2213 #define	MEDIA_ACCESS_DELAY 2000000
2214 
2215 
2216 /* SCSI power on or bus device reset additional sense code */
2217 #define	SD_SCSI_RESET_SENSE_CODE	0x29
2218 
2219 /*
2220  * These defines are for the Vital Product Data Pages in the inquiry command.
2221  * They are the bits in the un_vpd_page mask, telling the supported pages.
2222  */
2223 #define	SD_VPD_SUPPORTED_PG	0x01	/* 0x00 - Supported VPD pages */
2224 #define	SD_VPD_UNIT_SERIAL_PG	0x02	/* 0x80 - Unit Serial Number */
2225 #define	SD_VPD_OPERATING_PG	0x04	/* 0x81 - Implemented Op Defs */
2226 #define	SD_VPD_ASCII_OP_PG	0x08	/* 0x82 - ASCII Op Defs */
2227 #define	SD_VPD_DEVID_WWN_PG	0x10	/* 0x83 - Device Identification */
2228 #define	SD_VPD_EXTENDED_DATA_PG	0x80	/* 0x86 - Extended data about the lun */
2229 
2230 /*
2231  * Non-volatile cache support
2232  *
2233  * Bit 1 of the byte 6 in the Extended INQUIRY data VPD page
2234  * is NV_SUP bit: An NV_SUP bit set to one indicates that
2235  * the device server supports a non-volatile cache.  An
2236  * NV_SUP bit set to zero indicates that the device
2237  * server may or may not support a non-volatile cache.
2238  *
2239  * Bit 2 of the byte 1 in the SYNC CACHE command is SYNC_NV
2240  * bit: The SYNC_NV bit specifies whether the device server
2241  * is required to synchronize volatile and non-volatile
2242  * caches.
2243  */
2244 #define	SD_VPD_NV_SUP	0x02
2245 #define	SD_SYNC_NV_BIT 0x04
2246 
2247 /*
2248  * Addition from sddef.intel.h
2249  */
2250 #if defined(__i386) || defined(__amd64)
2251 
2252 #define	P0_RAW_DISK	(NDKMAP)
2253 #define	FDISK_P1	(NDKMAP+1)
2254 #define	FDISK_P2	(NDKMAP+2)
2255 #define	FDISK_P3	(NDKMAP+3)
2256 #define	FDISK_P4	(NDKMAP+4)
2257 
2258 #endif	/* __i386 || __amd64 */
2259 
2260 #ifdef	__cplusplus
2261 }
2262 #endif
2263 
2264 
2265 #endif	/* _SYS_SCSI_TARGETS_SDDEF_H */
2266