/*
- * Copyright (c) 1998-2002 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 1998-2014 Apple Computer, Inc. All rights reserved.
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
*
- * @APPLE_LICENSE_HEADER_START@
- *
- * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved.
- *
* This file contains Original Code and/or Modifications of Original Code
* as defined in and that are subject to the Apple Public Source License
* Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
- *
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
+ *
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ *
* The Original Code and all software distributed under the License are
* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
* Please see the License for the specific language governing rights and
* limitations under the License.
- *
- * @APPLE_LICENSE_HEADER_END@
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
-#ifndef _SYS_DISK_H_
-#define _SYS_DISK_H_
+#ifndef _SYS_DISK_H_
+#define _SYS_DISK_H_
+#include <stdint.h>
#include <sys/ioctl.h>
-#include <sys/types.h>
+
+#ifdef XNU_KERNEL_PRIVATE
+#include <mach/boolean.h>
+#endif /* XNU_KERNEL_PRIVATE */
/*
* Definitions
*
- * ioctl description
- * -------------------------------- --------------------------------------------
- * DKIOCEJECT eject media
- * DKIOCSYNCHRONIZECACHE flush media
- *
- * DKIOCFORMAT format media
- * DKIOCGETFORMATCAPACITIES get media's formattable capacities
- *
- * DKIOCGETBLOCKSIZE get media's block size
- * DKIOCGETBLOCKCOUNT get media's block count
- * DKIOCGETFIRMWAREPATH get media's firmware path
- *
- * DKIOCISFORMATTED is media formatted?
- * DKIOCISWRITABLE is media writable?
- *
- * DKIOCGETMAXBLOCKCOUNTREAD get maximum block count for reads
- * DKIOCGETMAXBLOCKCOUNTWRITE get maximum block count for writes
- * DKIOCGETMAXBYTECOUNTREAD get maximum byte count for reads
- * DKIOCGETMAXBYTECOUNTWRITE get maximum byte count for writes
- * DKIOCGETMAXSEGMENTCOUNTREAD get maximum segment count for reads
- * DKIOCGETMAXSEGMENTCOUNTWRITE get maximum segment count for writes
- * DKIOCGETMAXSEGMENTBYTECOUNTREAD get maximum segment byte count for reads
- * DKIOCGETMAXSEGMENTBYTECOUNTWRITE get maximum segment byte count for writes
+ * ioctl description
+ * ------------------------------------- ---------------------------------------
+ * DKIOCEJECT eject media
+ * DKIOCSYNCHRONIZE flush media
+ *
+ * DKIOCFORMAT format media
+ * DKIOCGETFORMATCAPACITIES get media's formattable capacities
+ *
+ * DKIOCGETBLOCKSIZE get media's block size
+ * DKIOCGETBLOCKCOUNT get media's block count
+ * DKIOCGETFIRMWAREPATH get media's firmware path
+ *
+ * DKIOCISFORMATTED is media formatted?
+ * DKIOCISWRITABLE is media writable?
+ *
+ * DKIOCREQUESTIDLE idle media
+ * DKIOCUNMAP delete unused data
+ *
+ * DKIOCGETLOCATION get device's physical location
+ *
+ * DKIOCGETMAXBLOCKCOUNTREAD get maximum block count for reads
+ * DKIOCGETMAXBLOCKCOUNTWRITE get maximum block count for writes
+ * DKIOCGETMAXBYTECOUNTREAD get maximum byte count for reads
+ * DKIOCGETMAXBYTECOUNTWRITE get maximum byte count for writes
+ *
+ * DKIOCGETMAXSEGMENTCOUNTREAD get maximum segment count for reads
+ * DKIOCGETMAXSEGMENTCOUNTWRITE get maximum segment count for writes
+ * DKIOCGETMAXSEGMENTBYTECOUNTREAD get maximum segment byte count for reads
+ * DKIOCGETMAXSEGMENTBYTECOUNTWRITE get maximum segment byte count for writes
+ *
+ * DKIOCGETMINSEGMENTALIGNMENTBYTECOUNT get minimum segment alignment in bytes
+ * DKIOCGETMAXSEGMENTADDRESSABLEBITCOUNT get maximum segment width in bits
+ *
+ * DKIOCGETFEATURES get device's feature set
+ * DKIOCGETPHYSICALBLOCKSIZE get device's block size
+ * DKIOCGETCOMMANDPOOLSIZE get device's queue depth
+ *
+ * DKIOCGETPROVISIONSTATUS get device's block provision status
+ * DKIOCGETIOMINSATURATIONBYTECOUNT get minimum byte count to saturate storage bandwidth
+ *
+ * DKIOCGETERRORDESCRIPTION get description of any drive error
+ *
+ * DKIOCGETMAXSWAPWRITE get maximum swap file write per day in bytes
*/
-typedef struct
-{
- char path[128];
+#define DK_FEATURE_BARRIER 0x00000002
+#define DK_FEATURE_PRIORITY 0x00000004
+#define DK_FEATURE_UNMAP 0x00000010
+
+#define DK_SYNCHRONIZE_OPTION_BARRIER 0x00000002
+
+typedef struct{
+ uint64_t offset;
+ uint64_t length;
+} dk_extent_t;
+
+typedef struct{
+ char path[128];
} dk_firmware_path_t;
-typedef struct
-{
- u_int64_t blockCount;
- u_int32_t blockSize;
+typedef struct{
+ uint64_t blockCount;
+ uint32_t blockSize;
- u_int8_t reserved0096[4]; /* reserved, clear to zero */
+ uint8_t reserved0096[4]; /* reserved, clear to zero */
} dk_format_capacity_t;
-typedef struct
-{
- dk_format_capacity_t * capacities;
- u_int32_t capacitiesCount; /* use zero to probe count */
+typedef struct{
+ dk_format_capacity_t * capacities;
+ uint32_t capacitiesCount; /* use zero to probe count */
- u_int8_t reserved0064[8]; /* reserved, clear to zero */
+#ifdef __LP64__
+ uint8_t reserved0096[4]; /* reserved, clear to zero */
+#else /* !__LP64__ */
+ uint8_t reserved0064[8]; /* reserved, clear to zero */
+#endif /* !__LP64__ */
} dk_format_capacities_t;
-#define DKIOCEJECT _IO('d', 21)
-#define DKIOCSYNCHRONIZECACHE _IO('d', 22)
+typedef struct{
+ uint64_t offset;
+ uint64_t length;
+
+ uint32_t options;
+
+ uint8_t reserved0160[4]; /* reserved, clear to zero */
+} dk_synchronize_t;
+
+typedef struct{
+ dk_extent_t * extents;
+ uint32_t extentsCount;
+
+ uint32_t options;
+
+#ifndef __LP64__
+ uint8_t reserved0096[4]; /* reserved, clear to zero */
+#endif /* !__LP64__ */
+} dk_unmap_t;
+
+typedef struct{
+ uint64_t flags;
+ uint64_t hotfile_size; /* in bytes */
+ uint64_t hibernate_minsize;
+ uint64_t swapfile_pinning;
+
+ uint64_t padding[4];
+} dk_corestorage_info_t;
-#define DKIOCFORMAT _IOW('d', 26, dk_format_capacity_t)
-#define DKIOCGETFORMATCAPACITIES _IOWR('d', 26, dk_format_capacities_t)
+#define DK_CORESTORAGE_PIN_YOUR_METADATA 0x00000001
+#define DK_CORESTORAGE_ENABLE_HOTFILES 0x00000002
+#define DK_CORESTORAGE_PIN_YOUR_SWAPFILE 0x00000004
-#define DKIOCGETBLOCKSIZE _IOR('d', 24, u_int32_t)
-#define DKIOCGETBLOCKCOUNT _IOR('d', 25, u_int64_t)
-#define DKIOCGETFIRMWAREPATH _IOR('d', 28, dk_firmware_path_t)
+#define DK_PROVISION_TYPE_MAPPED 0x00
+#define DK_PROVISION_TYPE_DEALLOCATED 0x01
+#define DK_PROVISION_TYPE_ANCHORED 0x02
-#define DKIOCISFORMATTED _IOR('d', 23, u_int32_t)
-#define DKIOCISWRITABLE _IOR('d', 29, u_int32_t)
+typedef struct{
+ uint64_t offset;
+ uint64_t length;
+ uint8_t provisionType;
+ uint8_t reserved[7];
+} dk_provision_extent_t;
-#define DKIOCGETMAXBLOCKCOUNTREAD _IOR('d', 64, u_int64_t)
-#define DKIOCGETMAXBLOCKCOUNTWRITE _IOR('d', 65, u_int64_t)
-#define DKIOCGETMAXBYTECOUNTREAD _IOR('d', 70, u_int64_t)
-#define DKIOCGETMAXBYTECOUNTWRITE _IOR('d', 71, u_int64_t)
-#define DKIOCGETMAXSEGMENTCOUNTREAD _IOR('d', 66, u_int64_t)
-#define DKIOCGETMAXSEGMENTCOUNTWRITE _IOR('d', 67, u_int64_t)
-#define DKIOCGETMAXSEGMENTBYTECOUNTREAD _IOR('d', 68, u_int64_t)
-#define DKIOCGETMAXSEGMENTBYTECOUNTWRITE _IOR('d', 69, u_int64_t)
+typedef struct{
+ uint64_t offset; /* input: logical byte offset */
+ uint64_t length; /* input: byte length, 0 for whole length */
+ uint64_t options; /* reserved, clear to zero */
+ uint32_t reserved; /* not used */
+ uint32_t extentsCount; /* input/output: count for extents */
+ dk_provision_extent_t * extents; /* output: provision extents */
+} dk_provision_status_t;
+
+typedef struct{
+ uint64_t options; /* reserved, clear to zero */
+ uint64_t reserved; /* reserved, clear to zero */
+ uint64_t description_size;
+ char * description;
+} dk_error_description_t;
+
+#define DK_LOCATION_INTERNAL 0x00000000
+#define DK_LOCATION_EXTERNAL 0x00000001
#ifdef KERNEL
-#define DKIOCGETISVIRTUAL _IOR('d', 72, u_int32_t)
-#define DKIOCGETBLOCKCOUNT32 _IOR('d', 25, u_int32_t)
-#define DKIOCSETBLOCKSIZE _IOW('d', 24, u_int32_t)
-#define DKIOCGETBSDUNIT _IOR('d', 27, u_int32_t)
+#ifdef PRIVATE
+
+/* Definitions of option bits for dk_unmap_t */
+#define _DK_UNMAP_INITIALIZE 0x00000100
+
+#endif /* PRIVATE */
#endif /* KERNEL */
-#endif /* _SYS_DISK_H_ */
+#define DKIOCEJECT _IO('d', 21)
+#define DKIOCSYNCHRONIZE _IOW('d', 22, dk_synchronize_t)
+
+#define DKIOCFORMAT _IOW('d', 26, dk_format_capacity_t)
+#define DKIOCGETFORMATCAPACITIES _IOWR('d', 26, dk_format_capacities_t)
+
+#define DKIOCGETBLOCKSIZE _IOR('d', 24, uint32_t)
+#define DKIOCGETBLOCKCOUNT _IOR('d', 25, uint64_t)
+#define DKIOCGETFIRMWAREPATH _IOR('d', 28, dk_firmware_path_t)
+
+#define DKIOCISFORMATTED _IOR('d', 23, uint32_t)
+#define DKIOCISWRITABLE _IOR('d', 29, uint32_t)
+
+#define DKIOCREQUESTIDLE _IO('d', 30)
+#define DKIOCUNMAP _IOW('d', 31, dk_unmap_t)
+#define DKIOCCORESTORAGE _IOR('d', 32, dk_corestorage_info_t)
+
+#define DKIOCGETLOCATION _IOR('d', 33, uint64_t)
+
+#define DKIOCGETMAXBLOCKCOUNTREAD _IOR('d', 64, uint64_t)
+#define DKIOCGETMAXBLOCKCOUNTWRITE _IOR('d', 65, uint64_t)
+#define DKIOCGETMAXBYTECOUNTREAD _IOR('d', 70, uint64_t)
+#define DKIOCGETMAXBYTECOUNTWRITE _IOR('d', 71, uint64_t)
+
+#define DKIOCGETMAXSEGMENTCOUNTREAD _IOR('d', 66, uint64_t)
+#define DKIOCGETMAXSEGMENTCOUNTWRITE _IOR('d', 67, uint64_t)
+#define DKIOCGETMAXSEGMENTBYTECOUNTREAD _IOR('d', 68, uint64_t)
+#define DKIOCGETMAXSEGMENTBYTECOUNTWRITE _IOR('d', 69, uint64_t)
+
+#define DKIOCGETMINSEGMENTALIGNMENTBYTECOUNT _IOR('d', 74, uint64_t)
+#define DKIOCGETMAXSEGMENTADDRESSABLEBITCOUNT _IOR('d', 75, uint64_t)
+
+#define DKIOCGETFEATURES _IOR('d', 76, uint32_t)
+#define DKIOCGETPHYSICALBLOCKSIZE _IOR('d', 77, uint32_t)
+#define DKIOCGETCOMMANDPOOLSIZE _IOR('d', 78, uint32_t)
+
+#define DKIOCGETPROVISIONSTATUS _IOWR('d', 79, dk_provision_status_t)
+
+#define DKIOCGETERRORDESCRIPTION _IOR('d', 80, dk_error_description_t)
+
+#define DKIOCSYNCHRONIZECACHE _IO('d', 22)
+
+#ifdef KERNEL
+#define DK_FEATURE_FORCE_UNIT_ACCESS 0x00000001
+
+#define DK_ENCRYPTION_TYPE_AES_CBC 1
+#define DK_ENCRYPTION_TYPE_AES_XEX 2
+#define DK_ENCRYPTION_TYPE_AES_XTS 3
+
+#define DK_TIER_MASK 0xC0
+#define DK_TIER_SHIFT 6
+
+#define DK_TIER_TO_PRIORITY(tier) (((tier) << DK_TIER_SHIFT) | ~DK_TIER_MASK)
+#define DK_PRIORITY_TO_TIER(priority) ((priority) >> DK_TIER_SHIFT)
+
+typedef struct{
+ uint64_t offset;
+ uint64_t length;
+
+ uint8_t reserved0128[12]; /* reserved, clear to zero */
+
+ dev_t dev;
+} dk_physical_extent_t;
+
+typedef struct{
+ dk_extent_t * extents;
+ uint32_t extentsCount;
+
+ uint8_t tier;
+
+#ifdef __LP64__
+ uint8_t reserved0104[3]; /* reserved, clear to zero */
+#else /* !__LP64__ */
+ uint8_t reserved0072[7]; /* reserved, clear to zero */
+#endif /* !__LP64__ */
+} dk_set_tier_t;
+
+#define DKIOCSETBLOCKSIZE _IOW('d', 24, uint32_t)
+#define DKIOCGETBSDUNIT _IOR('d', 27, uint32_t)
+#define DKIOCISSOLIDSTATE _IOR('d', 79, uint32_t)
+#define DKIOCISVIRTUAL _IOR('d', 72, uint32_t)
+#define DKIOCGETBASE _IOR('d', 73, uint64_t)
+#define DKIOCGETTHROTTLEMASK _IOR('d', 80, uint64_t)
+#define DKIOCLOCKPHYSICALEXTENTS _IO('d', 81)
+#define DKIOCGETPHYSICALEXTENT _IOWR('d', 82, dk_physical_extent_t)
+#define DKIOCUNLOCKPHYSICALEXTENTS _IO('d', 83)
+#define DKIOCSETTIER _IOW('d', 85, dk_set_tier_t)
+#define DKIOCGETENCRYPTIONTYPE _IOR('d', 86, uint32_t)
+#define DKIOCISLOWPOWERMODE _IOR('d', 87, uint32_t)
+#define DKIOCGETIOMINSATURATIONBYTECOUNT _IOR('d', 88, uint32_t)
+
+#ifdef XNU_KERNEL_PRIVATE
+typedef struct{
+ boolean_t mi_mdev; /* Is this a memdev device? */
+ boolean_t mi_phys; /* Physical memory? */
+ uint32_t mi_base; /* Base page number of the device? */
+ uint64_t mi_size; /* Size of the device (in ) */
+} dk_memdev_info_t;
+
+typedef dk_memdev_info_t memdev_info_t;
+
+#define DKIOCGETMEMDEVINFO _IOR('d', 90, dk_memdev_info_t)
+#endif /* XNU_KERNEL_PRIVATE */
+#ifdef PRIVATE
+typedef struct _dk_cs_pin {
+ dk_extent_t cp_extent;
+ int64_t cp_flags;
+} _dk_cs_pin_t;
+/* The following are modifiers to _DKIOCCSPINEXTENT/cp_flags operation */
+#define _DKIOCCSPINTOFASTMEDIA (0) /* Pin extent to the fast (SSD) media */
+#define _DKIOCCSPINFORHIBERNATION (1 << 0) /* Pin of hibernation file, content not preserved */
+#define _DKIOCCSPINDISCARDBLACKLIST (1 << 1) /* Hibernation complete/error, stop blacklisting */
+#define _DKIOCCSPINTOSLOWMEDIA (1 << 2) /* Pin extent to the slow (HDD) media */
+#define _DKIOCCSTEMPORARYPIN (1 << 3) /* Relocate, but do not pin, to indicated media */
+#define _DKIOCCSHIBERNATEIMGSIZE (1 << 4) /* Anticipate/Max size of the upcoming hibernate */
+#define _DKIOCCSPINFORSWAPFILE (1 << 5) /* Pin of swap file, content not preserved */
+
+#define _DKIOCCSSETLVNAME _IOW('d', 198, char[256])
+#define _DKIOCCSPINEXTENT _IOW('d', 199, _dk_cs_pin_t)
+#define _DKIOCCSUNPINEXTENT _IOW('d', 200, _dk_cs_pin_t)
+#define _DKIOCGETMIGRATIONUNITBYTESIZE _IOR('d', 201, uint32_t)
+
+typedef struct _dk_cs_map {
+ dk_extent_t cm_extent;
+ uint64_t cm_bytes_mapped;
+} _dk_cs_map_t;
+
+typedef struct _dk_cs_unmap {
+ dk_extent_t *extents;
+ uint32_t extentsCount;
+ uint32_t options;
+} _dk_cs_unmap_t;
+
+#define _DKIOCCSMAP _IOWR('d', 202, _dk_cs_map_t)
+// No longer used: _DKIOCCSSETFSVNODE (203) & _DKIOCCSGETFREEBYTES (204)
+#define _DKIOCCSUNMAP _IOWR('d', 205, _dk_cs_unmap_t)
+
+typedef enum {
+ DK_APFS_ONE_DEVICE = 1,
+ DK_APFS_FUSION
+} dk_apfs_flavour_t;
+
+#define DKIOCGETAPFSFLAVOUR _IOR('d', 91, dk_apfs_flavour_t)
+
+// Extent's offset and length returned in bytes
+typedef struct dk_apfs_wbc_range {
+ dev_t dev; // Physical device for extents
+ uint32_t count; // Number of extents
+ dk_extent_t extents[2]; // Addresses are relative to device we return
+} dk_apfs_wbc_range_t;
+
+#define DKIOCAPFSGETWBCRANGE _IOR('d', 92, dk_apfs_wbc_range_t)
+#define DKIOCAPFSRELEASEWBCRANGE _IO('d', 93)
+
+#define DKIOCGETMAXSWAPWRITE _IOR('d', 94, uint64_t)
+
+#endif /* PRIVATE */
+#endif /* KERNEL */
+
+#ifdef PRIVATE
+#if (TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR)
+#define _DKIOCSETSTATIC _IO('d', 84)
+#endif /* (TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR) */
+#endif /* PRIVATE */
+
+#endif /* _SYS_DISK_H_ */
projects / apple / xnu.git / blobdiff