]>
Commit | Line | Data |
---|---|---|
9bccf70c | 1 | /* |
fe8ab488 | 2 | * Copyright (c) 1998-2014 Apple Computer, Inc. All rights reserved. |
9bccf70c | 3 | * |
2d21ac55 | 4 | * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ |
9bccf70c | 5 | * |
2d21ac55 A |
6 | * This file contains Original Code and/or Modifications of Original Code |
7 | * as defined in and that are subject to the Apple Public Source License | |
8 | * Version 2.0 (the 'License'). You may not use this file except in | |
9 | * compliance with the License. The rights granted to you under the License | |
10 | * may not be used to create, or enable the creation or redistribution of, | |
11 | * unlawful or unlicensed copies of an Apple operating system, or to | |
12 | * circumvent, violate, or enable the circumvention or violation of, any | |
13 | * terms of an Apple operating system software license agreement. | |
8f6c56a5 | 14 | * |
2d21ac55 A |
15 | * Please obtain a copy of the License at |
16 | * http://www.opensource.apple.com/apsl/ and read it before using this file. | |
17 | * | |
18 | * The Original Code and all software distributed under the License are | |
19 | * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER | |
8f6c56a5 A |
20 | * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, |
21 | * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, | |
2d21ac55 A |
22 | * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. |
23 | * Please see the License for the specific language governing rights and | |
24 | * limitations under the License. | |
8f6c56a5 | 25 | * |
2d21ac55 | 26 | * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ |
9bccf70c A |
27 | */ |
28 | ||
29 | #ifndef _SYS_DISK_H_ | |
30 | #define _SYS_DISK_H_ | |
31 | ||
2d21ac55 | 32 | #include <stdint.h> |
9bccf70c | 33 | #include <sys/ioctl.h> |
9bccf70c | 34 | |
39236c6e A |
35 | #ifdef XNU_KERNEL_PRIVATE |
36 | #include <mach/boolean.h> | |
37 | #endif /* XNU_KERNEL_PRIVATE */ | |
38 | ||
55e303ae A |
39 | /* |
40 | * Definitions | |
41 | * | |
0c530ab8 A |
42 | * ioctl description |
43 | * ------------------------------------- --------------------------------------- | |
44 | * DKIOCEJECT eject media | |
3e170ce0 | 45 | * DKIOCSYNCHRONIZE flush media |
5d5c5d0d | 46 | * |
0c530ab8 A |
47 | * DKIOCFORMAT format media |
48 | * DKIOCGETFORMATCAPACITIES get media's formattable capacities | |
5d5c5d0d | 49 | * |
0c530ab8 A |
50 | * DKIOCGETBLOCKSIZE get media's block size |
51 | * DKIOCGETBLOCKCOUNT get media's block count | |
52 | * DKIOCGETFIRMWAREPATH get media's firmware path | |
4452a7af | 53 | * |
0c530ab8 A |
54 | * DKIOCISFORMATTED is media formatted? |
55 | * DKIOCISWRITABLE is media writable? | |
4452a7af | 56 | * |
c910b4d9 | 57 | * DKIOCREQUESTIDLE idle media |
060df5ea | 58 | * DKIOCUNMAP delete unused data |
593a1d5f | 59 | * |
0c530ab8 A |
60 | * DKIOCGETMAXBLOCKCOUNTREAD get maximum block count for reads |
61 | * DKIOCGETMAXBLOCKCOUNTWRITE get maximum block count for writes | |
62 | * DKIOCGETMAXBYTECOUNTREAD get maximum byte count for reads | |
63 | * DKIOCGETMAXBYTECOUNTWRITE get maximum byte count for writes | |
64 | * | |
65 | * DKIOCGETMAXSEGMENTCOUNTREAD get maximum segment count for reads | |
66 | * DKIOCGETMAXSEGMENTCOUNTWRITE get maximum segment count for writes | |
67 | * DKIOCGETMAXSEGMENTBYTECOUNTREAD get maximum segment byte count for reads | |
68 | * DKIOCGETMAXSEGMENTBYTECOUNTWRITE get maximum segment byte count for writes | |
69 | * | |
70 | * DKIOCGETMINSEGMENTALIGNMENTBYTECOUNT get minimum segment alignment in bytes | |
71 | * DKIOCGETMAXSEGMENTADDRESSABLEBITCOUNT get maximum segment width in bits | |
593a1d5f | 72 | * |
060df5ea | 73 | * DKIOCGETFEATURES get device's feature set |
593a1d5f | 74 | * DKIOCGETPHYSICALBLOCKSIZE get device's block size |
b0d623f7 | 75 | * DKIOCGETCOMMANDPOOLSIZE get device's queue depth |
39037602 A |
76 | * |
77 | * DKIOCGETPROVISIONSTATUS get device's block provision status | |
78 | * DKIOCGETIOMINSATURATIONBYTECOUNT get minimum byte count to saturate storage bandwidth | |
55e303ae A |
79 | */ |
80 | ||
3e170ce0 | 81 | #define DK_FEATURE_BARRIER 0x00000002 |
fe8ab488 | 82 | #define DK_FEATURE_PRIORITY 0x00000004 |
060df5ea A |
83 | #define DK_FEATURE_UNMAP 0x00000010 |
84 | ||
3e170ce0 A |
85 | #define DK_SYNCHRONIZE_OPTION_BARRIER 0x00000002 |
86 | ||
9bccf70c A |
87 | typedef struct |
88 | { | |
593a1d5f A |
89 | uint64_t offset; |
90 | uint64_t length; | |
060df5ea | 91 | } dk_extent_t; |
593a1d5f A |
92 | |
93 | typedef struct | |
94 | { | |
95 | char path[128]; | |
9bccf70c A |
96 | } dk_firmware_path_t; |
97 | ||
55e303ae A |
98 | typedef struct |
99 | { | |
2d21ac55 A |
100 | uint64_t blockCount; |
101 | uint32_t blockSize; | |
55e303ae | 102 | |
2d21ac55 | 103 | uint8_t reserved0096[4]; /* reserved, clear to zero */ |
55e303ae A |
104 | } dk_format_capacity_t; |
105 | ||
106 | typedef struct | |
107 | { | |
108 | dk_format_capacity_t * capacities; | |
2d21ac55 | 109 | uint32_t capacitiesCount; /* use zero to probe count */ |
55e303ae | 110 | |
2d21ac55 A |
111 | #ifdef __LP64__ |
112 | uint8_t reserved0096[4]; /* reserved, clear to zero */ | |
113 | #else /* !__LP64__ */ | |
114 | uint8_t reserved0064[8]; /* reserved, clear to zero */ | |
115 | #endif /* !__LP64__ */ | |
55e303ae A |
116 | } dk_format_capacities_t; |
117 | ||
3e170ce0 A |
118 | typedef struct |
119 | { | |
120 | uint64_t offset; | |
121 | uint64_t length; | |
122 | ||
123 | uint32_t options; | |
124 | ||
125 | uint8_t reserved0160[4]; /* reserved, clear to zero */ | |
126 | } dk_synchronize_t; | |
127 | ||
060df5ea A |
128 | typedef struct |
129 | { | |
130 | dk_extent_t * extents; | |
131 | uint32_t extentsCount; | |
132 | ||
fe8ab488 A |
133 | uint32_t options; |
134 | ||
135 | #ifndef __LP64__ | |
060df5ea | 136 | uint8_t reserved0096[4]; /* reserved, clear to zero */ |
060df5ea A |
137 | #endif /* !__LP64__ */ |
138 | } dk_unmap_t; | |
139 | ||
fe8ab488 | 140 | |
3e170ce0 A |
141 | typedef struct |
142 | { | |
143 | uint64_t flags; | |
144 | uint64_t hotfile_size; /* in bytes */ | |
145 | uint64_t hibernate_minsize; | |
146 | uint64_t swapfile_pinning; | |
147 | ||
148 | uint64_t padding[4]; | |
149 | } dk_corestorage_info_t; | |
150 | ||
151 | #define DK_CORESTORAGE_PIN_YOUR_METADATA 0x00000001 | |
152 | #define DK_CORESTORAGE_ENABLE_HOTFILES 0x00000002 | |
153 | #define DK_CORESTORAGE_PIN_YOUR_SWAPFILE 0x00000004 | |
154 | ||
39037602 A |
155 | #define DK_PROVISION_TYPE_MAPPED 0x00 |
156 | #define DK_PROVISION_TYPE_DEALLOCATED 0x01 | |
157 | #define DK_PROVISION_TYPE_ANCHORED 0x02 | |
158 | ||
159 | typedef struct | |
160 | { | |
161 | uint64_t offset; | |
162 | uint64_t length; | |
163 | uint8_t provisionType; | |
164 | uint8_t reserved[7]; | |
165 | } dk_provision_extent_t; | |
166 | ||
167 | typedef struct | |
168 | { | |
169 | uint64_t offset; /* input: logical byte offset */ | |
170 | uint64_t length; /* input: byte length, 0 for whole length */ | |
171 | uint64_t options; /* reserved, clear to zero */ | |
172 | uint32_t reserved; /* not used */ | |
173 | uint32_t extentsCount; /* input/output: count for extents */ | |
174 | dk_provision_extent_t * extents; /* output: provision extents */ | |
175 | } dk_provision_status_t; | |
3e170ce0 | 176 | |
fe8ab488 A |
177 | #ifdef KERNEL |
178 | #ifdef PRIVATE | |
179 | ||
180 | /* Definitions of option bits for dk_unmap_t */ | |
181 | #define _DK_UNMAP_INITIALIZE 0x00000100 | |
182 | ||
183 | #endif /* PRIVATE */ | |
184 | #endif /* KERNEL */ | |
185 | ||
0c530ab8 | 186 | #define DKIOCEJECT _IO('d', 21) |
3e170ce0 | 187 | #define DKIOCSYNCHRONIZE _IOW('d', 22, dk_synchronize_t) |
0c530ab8 A |
188 | |
189 | #define DKIOCFORMAT _IOW('d', 26, dk_format_capacity_t) | |
190 | #define DKIOCGETFORMATCAPACITIES _IOWR('d', 26, dk_format_capacities_t) | |
91447636 | 191 | |
2d21ac55 A |
192 | #define DKIOCGETBLOCKSIZE _IOR('d', 24, uint32_t) |
193 | #define DKIOCGETBLOCKCOUNT _IOR('d', 25, uint64_t) | |
0c530ab8 | 194 | #define DKIOCGETFIRMWAREPATH _IOR('d', 28, dk_firmware_path_t) |
55e303ae | 195 | |
2d21ac55 A |
196 | #define DKIOCISFORMATTED _IOR('d', 23, uint32_t) |
197 | #define DKIOCISWRITABLE _IOR('d', 29, uint32_t) | |
9bccf70c | 198 | |
c910b4d9 | 199 | #define DKIOCREQUESTIDLE _IO('d', 30) |
060df5ea | 200 | #define DKIOCUNMAP _IOW('d', 31, dk_unmap_t) |
3e170ce0 | 201 | #define DKIOCCORESTORAGE _IOR('d', 32, dk_corestorage_info_t) |
593a1d5f | 202 | |
2d21ac55 A |
203 | #define DKIOCGETMAXBLOCKCOUNTREAD _IOR('d', 64, uint64_t) |
204 | #define DKIOCGETMAXBLOCKCOUNTWRITE _IOR('d', 65, uint64_t) | |
205 | #define DKIOCGETMAXBYTECOUNTREAD _IOR('d', 70, uint64_t) | |
206 | #define DKIOCGETMAXBYTECOUNTWRITE _IOR('d', 71, uint64_t) | |
9bccf70c | 207 | |
2d21ac55 A |
208 | #define DKIOCGETMAXSEGMENTCOUNTREAD _IOR('d', 66, uint64_t) |
209 | #define DKIOCGETMAXSEGMENTCOUNTWRITE _IOR('d', 67, uint64_t) | |
210 | #define DKIOCGETMAXSEGMENTBYTECOUNTREAD _IOR('d', 68, uint64_t) | |
211 | #define DKIOCGETMAXSEGMENTBYTECOUNTWRITE _IOR('d', 69, uint64_t) | |
9bccf70c | 212 | |
2d21ac55 A |
213 | #define DKIOCGETMINSEGMENTALIGNMENTBYTECOUNT _IOR('d', 74, uint64_t) |
214 | #define DKIOCGETMAXSEGMENTADDRESSABLEBITCOUNT _IOR('d', 75, uint64_t) | |
9bccf70c | 215 | |
060df5ea | 216 | #define DKIOCGETFEATURES _IOR('d', 76, uint32_t) |
593a1d5f | 217 | #define DKIOCGETPHYSICALBLOCKSIZE _IOR('d', 77, uint32_t) |
b0d623f7 | 218 | #define DKIOCGETCOMMANDPOOLSIZE _IOR('d', 78, uint32_t) |
593a1d5f | 219 | |
39037602 A |
220 | #define DKIOCGETPROVISIONSTATUS _IOWR('d', 79, dk_provision_status_t) |
221 | ||
3e170ce0 A |
222 | #define DKIOCSYNCHRONIZECACHE _IO('d', 22) |
223 | ||
9bccf70c | 224 | #ifdef KERNEL |
2d21ac55 | 225 | #define DK_FEATURE_FORCE_UNIT_ACCESS 0x00000001 |
6d2010ae | 226 | |
fe8ab488 A |
227 | #define DK_ENCRYPTION_TYPE_AES_CBC 1 |
228 | #define DK_ENCRYPTION_TYPE_AES_XEX 2 | |
229 | #define DK_ENCRYPTION_TYPE_AES_XTS 3 | |
230 | ||
231 | #define DK_TIER_MASK 0xC0 | |
232 | #define DK_TIER_SHIFT 6 | |
233 | ||
234 | #define DK_TIER_TO_PRIORITY(tier) (((tier) << DK_TIER_SHIFT) | ~DK_TIER_MASK) | |
235 | #define DK_PRIORITY_TO_TIER(priority) ((priority) >> DK_TIER_SHIFT) | |
236 | ||
6d2010ae A |
237 | typedef struct |
238 | { | |
239 | uint64_t offset; | |
240 | uint64_t length; | |
241 | ||
242 | uint8_t reserved0128[12]; /* reserved, clear to zero */ | |
243 | ||
244 | dev_t dev; | |
245 | } dk_physical_extent_t; | |
246 | ||
fe8ab488 A |
247 | typedef struct |
248 | { | |
249 | dk_extent_t * extents; | |
250 | uint32_t extentsCount; | |
251 | ||
252 | uint8_t tier; | |
253 | ||
254 | #ifdef __LP64__ | |
255 | uint8_t reserved0104[3]; /* reserved, clear to zero */ | |
256 | #else /* !__LP64__ */ | |
257 | uint8_t reserved0072[7]; /* reserved, clear to zero */ | |
258 | #endif /* !__LP64__ */ | |
259 | } dk_set_tier_t; | |
260 | ||
2d21ac55 A |
261 | #define DKIOCSETBLOCKSIZE _IOW('d', 24, uint32_t) |
262 | #define DKIOCGETBSDUNIT _IOR('d', 27, uint32_t) | |
6d2010ae | 263 | #define DKIOCISSOLIDSTATE _IOR('d', 79, uint32_t) |
2d21ac55 A |
264 | #define DKIOCISVIRTUAL _IOR('d', 72, uint32_t) |
265 | #define DKIOCGETBASE _IOR('d', 73, uint64_t) | |
6d2010ae A |
266 | #define DKIOCGETTHROTTLEMASK _IOR('d', 80, uint64_t) |
267 | #define DKIOCLOCKPHYSICALEXTENTS _IO('d', 81) | |
268 | #define DKIOCGETPHYSICALEXTENT _IOWR('d', 82, dk_physical_extent_t) | |
269 | #define DKIOCUNLOCKPHYSICALEXTENTS _IO('d', 83) | |
fe8ab488 A |
270 | #define DKIOCSETTIER _IOW('d', 85, dk_set_tier_t) |
271 | #define DKIOCGETENCRYPTIONTYPE _IOR('d', 86, uint32_t) | |
272 | #define DKIOCISLOWPOWERMODE _IOR('d', 87, uint32_t) | |
39037602 | 273 | #define DKIOCGETIOMINSATURATIONBYTECOUNT _IOR('d', 88, uint32_t) |
39236c6e A |
274 | |
275 | #ifdef XNU_KERNEL_PRIVATE | |
276 | typedef struct | |
277 | { | |
278 | boolean_t mi_mdev; /* Is this a memdev device? */ | |
279 | boolean_t mi_phys; /* Physical memory? */ | |
280 | uint32_t mi_base; /* Base page number of the device? */ | |
281 | uint64_t mi_size; /* Size of the device (in ) */ | |
282 | } dk_memdev_info_t; | |
283 | ||
284 | typedef dk_memdev_info_t memdev_info_t; | |
285 | ||
286 | #define DKIOCGETMEMDEVINFO _IOR('d', 90, dk_memdev_info_t) | |
287 | #endif /* XNU_KERNEL_PRIVATE */ | |
7ddcb079 | 288 | #ifdef PRIVATE |
316670eb A |
289 | typedef struct _dk_cs_pin { |
290 | dk_extent_t cp_extent; | |
291 | int64_t cp_flags; | |
292 | } _dk_cs_pin_t; | |
3e170ce0 A |
293 | /* The following are modifiers to _DKIOCCSPINEXTENT/cp_flags operation */ |
294 | #define _DKIOCCSPINTOFASTMEDIA (0) /* Pin extent to the fast (SSD) media */ | |
295 | #define _DKIOCCSPINFORHIBERNATION (1 << 0) /* Pin of hibernation file, content not preserved */ | |
296 | #define _DKIOCCSPINDISCARDBLACKLIST (1 << 1) /* Hibernation complete/error, stop blacklisting */ | |
297 | #define _DKIOCCSPINTOSLOWMEDIA (1 << 2) /* Pin extent to the slow (HDD) media */ | |
298 | #define _DKIOCCSTEMPORARYPIN (1 << 3) /* Relocate, but do not pin, to indicated media */ | |
299 | #define _DKIOCCSHIBERNATEIMGSIZE (1 << 4) /* Anticipate/Max size of the upcoming hibernate */ | |
300 | #define _DKIOCCSPINFORSWAPFILE (1 << 5) /* Pin of swap file, content not preserved */ | |
301 | ||
302 | #define _DKIOCCSSETLVNAME _IOW('d', 198, char[256]) | |
316670eb A |
303 | #define _DKIOCCSPINEXTENT _IOW('d', 199, _dk_cs_pin_t) |
304 | #define _DKIOCCSUNPINEXTENT _IOW('d', 200, _dk_cs_pin_t) | |
305 | #define _DKIOCGETMIGRATIONUNITBYTESIZE _IOR('d', 201, uint32_t) | |
fe8ab488 | 306 | |
39236c6e A |
307 | typedef struct _dk_cs_map { |
308 | dk_extent_t cm_extent; | |
309 | uint64_t cm_bytes_mapped; | |
310 | } _dk_cs_map_t; | |
fe8ab488 A |
311 | |
312 | typedef struct _dk_cs_unmap { | |
313 | dk_extent_t *extents; | |
314 | uint32_t extentsCount; | |
315 | uint32_t options; | |
316 | } _dk_cs_unmap_t; | |
317 | ||
39236c6e | 318 | #define _DKIOCCSMAP _IOWR('d', 202, _dk_cs_map_t) |
3e170ce0 | 319 | // No longer used: _DKIOCCSSETFSVNODE (203) & _DKIOCCSGETFREEBYTES (204) |
fe8ab488 | 320 | #define _DKIOCCSUNMAP _IOWR('d', 205, _dk_cs_unmap_t) |
7ddcb079 | 321 | #endif /* PRIVATE */ |
9bccf70c A |
322 | #endif /* KERNEL */ |
323 | ||
316670eb | 324 | #ifdef PRIVATE |
316670eb A |
325 | #endif /* PRIVATE */ |
326 | ||
9bccf70c | 327 | #endif /* _SYS_DISK_H_ */ |