/*

 * CDDL HEADER START

 *

 * The contents of this file are subject to the terms of the

 * Common Development and Distribution License (the "License").

 * You may not use this file except in compliance with the License.

 *

 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE

 * or http://www.opensolaris.org/os/licensing.

 * See the License for the specific language governing permissions

 * and limitations under the License.

 *

 * When distributing Covered Code, include this CDDL HEADER in each

 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.

 * If applicable, add the following below this CDDL HEADER, with the

 * fields enclosed by brackets "[]" replaced with your own identifying

 * information: Portions Copyright [yyyy] [name of copyright owner]

 *

 * CDDL HEADER END

 */

/*

 * Copyright (c) 1982, 2010, Oracle and/or its affiliates. All rights reserved.

 */

#ifndef _SYS_DKIO_H

#define	_SYS_DKIO_H

#include <sys/dklabel.h>	/* Needed for NDKMAP define */

#ifdef	__cplusplus

extern "C" {

#endif

/*

 * Structures and definitions for disk io control commands

 */

/*

 * Structures used as data by ioctl calls.

 */

#define	DK_DEVLEN	16		/* device name max length, including */

					/* unit # & NULL (ie - "xyc1") */

/*

 * Used for controller info

 */

struct dk_cinfo {

	char	dki_cname[DK_DEVLEN];	/* controller name (no unit #) */

	ushort_t dki_ctype;		/* controller type */

	ushort_t dki_flags;		/* flags */

	ushort_t dki_cnum;		/* controller number */

	uint_t	dki_addr;		/* controller address */

	uint_t	dki_space;		/* controller bus type */

	uint_t	dki_prio;		/* interrupt priority */

	uint_t	dki_vec;		/* interrupt vector */

	char	dki_dname[DK_DEVLEN];	/* drive name (no unit #) */

	uint_t	dki_unit;		/* unit number */

	uint_t	dki_slave;		/* slave number */

	ushort_t dki_partition;		/* partition number */

	ushort_t dki_maxtransfer;	/* max. transfer size in DEV_BSIZE */

};

/*

 * Controller types

 */

#define	DKC_UNKNOWN	0

#define	DKC_CDROM	1	/* CD-ROM, SCSI or otherwise */

#define	DKC_WDC2880	2

#define	DKC_XXX_0	3	/* unassigned */

#define	DKC_XXX_1	4	/* unassigned */

#define	DKC_DSD5215	5

#define	DKC_ACB4000	7

#define	DKC_MD21	8

#define	DKC_XXX_2	9	/* unassigned */

#define	DKC_NCRFLOPPY	10

#define	DKC_SMSFLOPPY	12

#define	DKC_SCSI_CCS	13	/* SCSI CCS compatible */

#define	DKC_INTEL82072	14	/* native floppy chip */

#define	DKC_MD		16	/* meta-disk (virtual-disk) driver */

#define	DKC_INTEL82077	19	/* 82077 floppy disk controller */

#define	DKC_DIRECT	20	/* Intel direct attached device i.e. IDE */

#define	DKC_PCMCIA_MEM	21	/* PCMCIA memory disk-like type (Obsolete) */

#define	DKC_PCMCIA_ATA	22	/* PCMCIA AT Attached type */

#define	DKC_VBD		23	/* virtual block device */

#define	DKC_BLKDEV	24	/* generic block device (see blkdev(7d)) */

/*

 * Sun reserves up through 1023

 */

#define	DKC_CUSTOMER_BASE	1024

/*

 * Flags

 */

#define	DKI_BAD144	0x01	/* use DEC std 144 bad sector fwding */

#define	DKI_MAPTRK	0x02	/* controller does track mapping */

#define	DKI_FMTTRK	0x04	/* formats only full track at a time */

#define	DKI_FMTVOL	0x08	/* formats only full volume at a time */

#define	DKI_FMTCYL	0x10	/* formats only full cylinders at a time */

#define	DKI_HEXUNIT	0x20	/* unit number is printed as 3 hex digits */

#define	DKI_PCMCIA_PFD	0x40	/* PCMCIA pseudo-floppy memory card */

/*

 * Used for all partitions

 */

struct dk_allmap {

	struct dk_map	dka_map[NDKMAP];

};

#if defined(_SYSCALL32)

struct dk_allmap32 {

	struct dk_map32	dka_map[NDKMAP];

};

#endif /* _SYSCALL32 */

/*

 * Definition of a disk's geometry

 */

struct dk_geom {

	unsigned short	dkg_ncyl;	/* # of data cylinders */

	unsigned short	dkg_acyl;	/* # of alternate cylinders */

	unsigned short	dkg_bcyl;	/* cyl offset (for fixed head area) */

	unsigned short	dkg_nhead;	/* # of heads */

	unsigned short	dkg_obs1;	/* obsolete */

	unsigned short	dkg_nsect;	/* # of data sectors per track */

	unsigned short	dkg_intrlv;	/* interleave factor */

	unsigned short	dkg_obs2;	/* obsolete */

	unsigned short	dkg_obs3;	/* obsolete */

	unsigned short	dkg_apc;	/* alternates per cyl (SCSI only) */

	unsigned short	dkg_rpm;	/* revolutions per minute */

	unsigned short	dkg_pcyl;	/* # of physical cylinders */

	unsigned short	dkg_write_reinstruct;	/* # sectors to skip, writes */

	unsigned short	dkg_read_reinstruct;	/* # sectors to skip, reads */

	unsigned short	dkg_extra[7];	/* for compatible expansion */

};

/*

 * These defines are for historic compatibility with old drivers.

 */

#define	dkg_bhead	dkg_obs1	/* used to be head offset */

#define	dkg_gap1	dkg_obs2	/* used to be gap1 */

#define	dkg_gap2	dkg_obs3	/* used to be gap2 */

/*

 * Disk io control commands

 * Warning: some other ioctls with the DIOC prefix exist elsewhere.

 * The Generic DKIOC numbers are from	0   -  50.

 *	The Floppy Driver uses		51  - 100.

 *	The Hard Disk (except SCSI)	101 - 106.	(these are obsolete)

 *	The CDROM Driver		151 - 200.

 *	The USCSI ioctl			201 - 250.

 */

#define	DKIOC		(0x04 << 8)

/*

 * The following ioctls are generic in nature and need to be

 * suported as appropriate by all disk drivers

 */

#define	DKIOCGGEOM	(DKIOC|1)		/* Get geometry */

#define	DKIOCINFO	(DKIOC|3)		/* Get info */

#define	DKIOCEJECT	(DKIOC|6)		/* Generic 'eject' */

#define	DKIOCGVTOC	(DKIOC|11)		/* Get VTOC */

#define	DKIOCSVTOC	(DKIOC|12)		/* Set VTOC & Write to Disk */

#define	DKIOCGEXTVTOC	(DKIOC|23)	/* Get extended VTOC */

#define	DKIOCSEXTVTOC	(DKIOC|24)	/* Set extended VTOC, Write to Disk */

/*

 * Disk Cache Controls.  These ioctls should be supported by

 * all disk drivers.

 *

 * DKIOCFLUSHWRITECACHE when used from user-mode ignores the ioctl

 * argument, but it should be passed as NULL to allow for future

 * reinterpretation.  From user-mode, this ioctl request is synchronous.

 *

 * When invoked from within the kernel, the arg can be NULL to indicate

 * a synchronous request or can be the address of a struct dk_callback

 * to request an asynchronous callback when the flush request is complete.

 * In this case, the flag to the ioctl must include FKIOCTL and the

 * dkc_callback field of the pointed to struct must be non-null or the

 * request is made synchronously.

 *

 * In the callback case: if the ioctl returns 0, a callback WILL be performed.

 * If the ioctl returns non-zero, a callback will NOT be performed.

 * NOTE: In some cases, the callback may be done BEFORE the ioctl call

 * returns.  The caller's locking strategy should be prepared for this case.

 */

#define	DKIOCFLUSHWRITECACHE	(DKIOC|34)	/* flush cache to phys medium */

struct dk_callback {

	void (*dkc_callback)(void *dkc_cookie, int error);

	void *dkc_cookie;

	int dkc_flag;

};

/* bit flag definitions for dkc_flag */

#define	FLUSH_VOLATILE		0x1	/* Bit 0: if set, only flush */

					/* volatile cache; otherwise, flush */

					/* volatile and non-volatile cache */

#define	DKIOCGETWCE		(DKIOC|36)	/* Get current write cache */

						/* enablement status */

#define	DKIOCSETWCE		(DKIOC|37)	/* Enable/Disable write cache */

/*

 * The following ioctls are used by Sun drivers to communicate

 * with their associated format routines. Support of these ioctls

 * is not required of foreign drivers

 */

#define	DKIOCSGEOM	(DKIOC|2)		/* Set geometry */

#define	DKIOCSAPART	(DKIOC|4)		/* Set all partitions */

#define	DKIOCGAPART	(DKIOC|5)		/* Get all partitions */

#define	DKIOCG_PHYGEOM	(DKIOC|32)		/* get physical geometry */

#define	DKIOCG_VIRTGEOM	(DKIOC|33)		/* get virtual geometry */

/*

 * The following ioctl's are removable media support

 */

#define	DKIOCLOCK	(DKIOC|7)	/* Generic 'lock' */

#define	DKIOCUNLOCK	(DKIOC|8)	/* Generic 'unlock' */

#define	DKIOCSTATE	(DKIOC|13)	/* Inquire insert/eject state */

#define	DKIOCREMOVABLE	(DKIOC|16)	/* is media removable */

/*

 * ioctl for hotpluggable devices

 */

#define	DKIOCHOTPLUGGABLE	(DKIOC|35)	/* is hotpluggable */

#if defined(__i386) || defined(__amd64)

/* ioctl to write extended partition structure into the disk */

#define	DKIOCSETEXTPART	(DKIOC|46)

#endif

/*

 * Ioctl to force driver to re-read the alternate partition and rebuild

 * the internal defect map.

 */

#define	DKIOCADDBAD	(DKIOC|20)	/* Re-read the alternate map (IDE) */

#define	DKIOCGETDEF	(DKIOC|21)	/* read defect list (IDE)	   */

/*

 * Used by applications to get disk defect information from IDE

 * drives.

 */

#ifdef _SYSCALL32

struct defect_header32 {

	int		head;

	caddr32_t	buffer;

};

#endif /* _SYSCALL32 */

struct defect_header {

	int		head;

	caddr_t		buffer;

};

#define	DKIOCPARTINFO	(DKIOC|22)	/* Get partition or slice parameters */

#define	DKIOCEXTPARTINFO (DKIOC|19)	/* Get extended partition or slice */

					/* parameters */

/*

 * Used by applications to get partition or slice information

 */

#ifdef _SYSCALL32

struct part_info32 {

	daddr32_t	p_start;

	int		p_length;

};

#endif /* _SYSCALL32 */

struct part_info {

	daddr_t		p_start;

	int		p_length;

};

struct extpart_info {

	diskaddr_t	p_start;

	diskaddr_t	p_length;

};

/* The following ioctls are for Optical Memory Device */

#define	DKIOC_EBP_ENABLE  (DKIOC|40)	/* enable by pass erase on write */

#define	DKIOC_EBP_DISABLE (DKIOC|41)	/* disable by pass erase on write */

/*

 * This state enum is the argument passed to the DKIOCSTATE ioctl.

 */

enum dkio_state { DKIO_NONE, DKIO_EJECTED, DKIO_INSERTED, DKIO_DEV_GONE };

#define	DKIOCGMEDIAINFO	(DKIOC|42)	/* get information about the media */

/*

 * ioctls to read/write mboot info.

 */

#define	DKIOCGMBOOT	(DKIOC|43)	/* get mboot info */

#define	DKIOCSMBOOT	(DKIOC|44)	/* set mboot info */

/*

 * ioctl to get the device temperature.

 */

#define	DKIOCGTEMPERATURE	(DKIOC|45)	/* get temperature */

/*

 * ioctl to get the media info including physical block size

 */

#define	DKIOCGMEDIAINFOEXT	(DKIOC|48)

/*

 * ioctl to determine whether media is write-protected

 */

#define	DKIOCREADONLY	(DKIOC|49)

/*

 * Used for providing the temperature.

 */

struct	dk_temperature	{

	uint_t		dkt_flags;	/* Flags */

	short		dkt_cur_temp;	/* Current disk temperature */

	short		dkt_ref_temp;	/* reference disk temperature */

};

#define	DKT_BYPASS_PM		0x1

#define	DKT_INVALID_TEMP	0xFFFF

/*

 * Used for Media info or the current profile info

 */

struct dk_minfo {

	uint_t		dki_media_type;	/* Media type or profile info */

	uint_t		dki_lbsize;	/* Logical blocksize of media */

	diskaddr_t	dki_capacity;	/* Capacity as # of dki_lbsize blks */

};

/*

 * Used for Media info or the current profile info

 * including physical block size if supported.

 */

struct dk_minfo_ext {

	uint_t		dki_media_type;	/* Media type or profile info */

	uint_t		dki_lbsize;	/* Logical blocksize of media */

	diskaddr_t	dki_capacity;	/* Capacity as # of dki_lbsize blks */

	uint_t		dki_pbsize;	/* Physical blocksize of media */

};

/*

 * Media types or profiles known

 */

#define	DK_UNKNOWN		0x00	/* Media inserted - type unknown */

/*

 * SFF 8090 Specification Version 3, media types 0x01 - 0xfffe are retained to

 * maintain compatibility with SFF8090.  The following define the

 * optical media type.

 */

#define	DK_REMOVABLE_DISK	0x02 /* Removable Disk */

#define	DK_MO_ERASABLE		0x03 /* MO Erasable */

#define	DK_MO_WRITEONCE		0x04 /* MO Write once */

#define	DK_AS_MO		0x05 /* AS MO */

#define	DK_CDROM		0x08 /* CDROM */

#define	DK_CDR			0x09 /* CD-R */

#define	DK_CDRW			0x0A /* CD-RW */

#define	DK_DVDROM		0x10 /* DVD-ROM */

#define	DK_DVDR			0x11 /* DVD-R */

#define	DK_DVDRAM		0x12 /* DVD_RAM or DVD-RW */

/*

 * Media types for other rewritable magnetic media

 */

#define	DK_FIXED_DISK		0x10001	/* Fixed disk SCSI or otherwise */

#define	DK_FLOPPY		0x10002 /* Floppy media */

#define	DK_ZIP			0x10003 /* IOMEGA ZIP media */

#define	DK_JAZ			0x10004 /* IOMEGA JAZ media */

#define	DKIOCSETEFI	(DKIOC|17)		/* Set EFI info */

#define	DKIOCGETEFI	(DKIOC|18)		/* Get EFI info */

#define	DKIOCPARTITION	(DKIOC|9)		/* Get partition info */

/*

 * Ioctls to get/set volume capabilities related to Logical Volume Managers.

 * They include the ability to get/set capabilities and to issue a read to a

 * specific underlying device of a replicated device.

 */

#define	DKIOCGETVOLCAP	(DKIOC | 25)	/* Get volume capabilities */

#define	DKIOCSETVOLCAP	(DKIOC | 26)	/* Set volume capabilities */

#define	DKIOCDMR	(DKIOC | 27)	/* Issue a directed read */

#define	DKIOCDUMPINIT	(DKIOC | 28)	/* Dumpify a zvol */

#define	DKIOCDUMPFINI	(DKIOC | 29)	/* Un-Dumpify a zvol */

typedef uint_t volcapinfo_t;

typedef uint_t volcapset_t;

#define	DKV_ABR_CAP 0x00000001		/* Support Appl.Based Recovery */

#define	DKV_DMR_CAP 0x00000002		/* Support Directed  Mirror Read */

typedef struct volcap {

	volcapinfo_t vc_info;	/* Capabilities available */

	volcapset_t vc_set;	/* Capabilities set */

} volcap_t;

#define	VOL_SIDENAME 256

typedef struct vol_directed_rd {

	int		vdr_flags;

	offset_t	vdr_offset;

	size_t		vdr_nbytes;

	size_t		vdr_bytesread;

	void		*vdr_data;

	int		vdr_side;

	char		vdr_side_name[VOL_SIDENAME];

} vol_directed_rd_t;

#define	DKV_SIDE_INIT		(-1)

#define	DKV_DMR_NEXT_SIDE	0x00000001

#define	DKV_DMR_DONE		0x00000002

#define	DKV_DMR_ERROR		0x00000004

#define	DKV_DMR_SUCCESS		0x00000008

#define	DKV_DMR_SHORT		0x00000010

#ifdef _MULTI_DATAMODEL

#if _LONG_LONG_ALIGNMENT == 8 && _LONG_LONG_ALIGNMENT_32 == 4

#pragma pack(4)

#endif

typedef struct vol_directed_rd32 {

	int32_t		vdr_flags;

	offset_t	vdr_offset;	/* 64-bit element on 32-bit alignment */

	size32_t	vdr_nbytes;

	size32_t	vdr_bytesread;

	caddr32_t	vdr_data;

	int32_t		vdr_side;

	char		vdr_side_name[VOL_SIDENAME];

} vol_directed_rd32_t;

#if _LONG_LONG_ALIGNMENT == 8 && _LONG_LONG_ALIGNMENT_32 == 4

#pragma pack()

#endif

#endif	/* _MULTI_DATAMODEL */

/*

 * The ioctl is used to fetch disk's device type, vendor ID,

 * model number/product ID, firmware revision and serial number together.

 *

 * Currently there are two device types - DKD_ATA_TYPE which means the

 * disk is driven by cmdk/ata or dad/uata driver, and DKD_SCSI_TYPE

 * which means the disk is driven by sd/scsi hba driver.

 */

#define	DKIOC_GETDISKID	(DKIOC|46)

/* These two labels are for dkd_dtype of dk_disk_id_t */

#define	DKD_ATA_TYPE	0x01 /* ATA disk or legacy mode SATA disk */

#define	DKD_SCSI_TYPE	0x02 /* SCSI disk or native mode SATA disk */

#define	DKD_ATA_MODEL	40	/* model number length */

#define	DKD_ATA_FWVER	8	/* firmware revision length */

#define	DKD_ATA_SERIAL	20	/* serial number length */

#define	DKD_SCSI_VENDOR	8	/* vendor ID length */

#define	DKD_SCSI_PRODUCT 16	/* product ID length */

#define	DKD_SCSI_REVLEVEL 4	/* revision level length */

#define	DKD_SCSI_SERIAL 12	/* serial number length */

/*

 * The argument type for DKIOC_GETDISKID ioctl.

 */

typedef struct dk_disk_id {

	uint_t	dkd_dtype;

	union {

		struct {

			char dkd_amodel[DKD_ATA_MODEL];		/* 40 bytes */

			char dkd_afwver[DKD_ATA_FWVER];		/* 8 bytes */

			char dkd_aserial[DKD_ATA_SERIAL];	/* 20 bytes */

		} ata_disk_id;

		struct {

			char dkd_svendor[DKD_SCSI_VENDOR];	/* 8 bytes */

			char dkd_sproduct[DKD_SCSI_PRODUCT];	/* 16 bytes */

			char dkd_sfwver[DKD_SCSI_REVLEVEL];	/* 4 bytes */

			char dkd_sserial[DKD_SCSI_SERIAL];	/* 12 bytes */

		} scsi_disk_id;

	} disk_id;

} dk_disk_id_t;

/*

 * The ioctl is used to update the firmware of device.

 */

#define	DKIOC_UPDATEFW		(DKIOC|47)

/* The argument type for DKIOC_UPDATEFW ioctl */

typedef struct dk_updatefw {

	caddr_t		dku_ptrbuf;	/* pointer to firmware buf */

	uint_t		dku_size;	/* firmware buf length */

	uint8_t		dku_type;	/* firmware update type */

} dk_updatefw_t;

#ifdef _SYSCALL32

typedef struct dk_updatefw_32 {

	caddr32_t	dku_ptrbuf;	/* pointer to firmware buf */

	uint_t		dku_size;	/* firmware buf length */

	uint8_t		dku_type;	/* firmware update type */

} dk_updatefw_32_t;

#endif /* _SYSCALL32 */

/*

 * firmware update type - temporary or permanent use