Chameleon Applications Commit Details - 302 - Chameleon related Applications (system preferences panels, helper applications)

Date:

2011-05-30 19:50:46 (12 years 10 months ago)

Author:

ErmaC

Commit:

302

Parents:

301

Message:

Last mqin trunk change. update the buildpkg: now the fdisk440 will be included into the pkg from the sym/i386 folder. Add a dmg folder into pakage folder.

Changes:

D	/branches/iFabio/Chameleon/package/fdisk440
A	/branches/iFabio/Chameleon/i386/util/fdisk/opendev.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/cmd.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/auto.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/cmd.h
A	/branches/iFabio/Chameleon/package/dmg
A	/branches/iFabio/Chameleon/i386/util/fdisk/auto.h
A	/branches/iFabio/Chameleon/i386/util/fdisk
A	/branches/iFabio/Chameleon/i386/util/fdisk/getrawpartition.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/Cconfig
A	/branches/iFabio/Chameleon/i386/util/fdisk/misc.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/fdisk.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/misc.h
A	/branches/iFabio/Chameleon/i386/util/fdisk/part.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/part.h
A	/branches/iFabio/Chameleon/i386/util/fdisk/user.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/mbr.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/mbrcode.h
A	/branches/iFabio/Chameleon/i386/util/fdisk/util.h
A	/branches/iFabio/Chameleon/i386/util/fdisk/user.h
A	/branches/iFabio/Chameleon/i386/util/fdisk/fdisk.8
A	/branches/iFabio/Chameleon/i386/util/fdisk/mbr.h
A	/branches/iFabio/Chameleon/i386/util/fdisk/disk.c
A	/branches/iFabio/Chameleon/i386/util/fdisk/Makefile
A	/branches/iFabio/Chameleon/i386/util/fdisk/disk.h
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOMedia.h
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOApplePartitionScheme.h
M	/branches/iFabio/Chameleon/i386/libsaio/console.c
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOBlockStorageDriver.h
M	/branches/iFabio/Chameleon/i386/libsaio/ati.c
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOBlockStorageDevice.h
M	/branches/iFabio/Chameleon/Makefile
M	/branches/iFabio/Chameleon/i386/modules/Makefile
M	/branches/iFabio/Chameleon/i386/util/Cconfig
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOStorage.h
M	/branches/iFabio/Chameleon/i386/libsaio/cpu.c
M	/branches/iFabio/Chameleon/i386/boot2/Makefile
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOFDiskPartitionScheme.h
M	/branches/iFabio/Chameleon/package/buildpkg
M	/branches/iFabio/Chameleon/package/slimpkg
M	/branches/iFabio/Chameleon/i386/boot2/boot.c
M	/branches/iFabio/Chameleon/i386/include/IOKit/IOLib.h
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOCDBlockStorageDriver.h
M	/branches/iFabio/Chameleon/Chameleon.xcodeproj/project.pbxproj
M	/branches/iFabio/Chameleon/i386/include/architecture/byte_order.h
M	/branches/iFabio/Chameleon/i386/util/Makefile
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOCDBlockStorageDevice.h
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOGUIDPartitionScheme.h
M	/branches/iFabio/Chameleon/i386/include/IOKit/storage/IOMediaBSDClient.h
M	/branches/iFabio/Chameleon/i386/modules/MakeInc.dir

File differences

-539
540 540
541 541
542
542 543
543 544
544 545
... ...
1100 1101
1101 1102
1102 1103
1103 
1104 1104
1105 1105
1106 1106
... ...
1164 1164
1165 1165
1166 1166
1167 
1168 
1167
1168
1169 1169
1170 
1170
1171 1171
1172 1172
1173 1173
1174 1174
1175 1175
1176 
1176
1177 1177
1178 1178
1179 1179
1180 
1180
1181 1181
1182 1182
1183 1183
1184 1184
1185 
1185
1186 1186
1187 1187
1188 1188
... ...
1226 1226
1227 1227
1228 1228
1229 
1230 
1231 
1229
1230
1231
1232 1232
1233 1233
1234 1234
+␉uint8_t␉␉␉␉␉*rom;␊
␉uint32_t␉␉␉␉rom_size;␊
␉uint32_t␉␉␉␉vram_size;␊
␉const char␉␉␉␉*cfg_name;␊
␉uint8_t␉␉␉␉␉ports;␊
␉uint32_t␉␉␉␉flags;␊
␉bool␉␉␉␉␉posted;␊

␊
static bool init_card(pci_dt_t *pci_dev)␊
{␊
␉const char *fb_name;␊
␉char name[24];␊
␉char name_parent[24];␊
␉int i;␊

␊
␉atN = 0;␊
␊
␉fb_name = getStringForKey(kAtiConfig, &bootInfo->bootConfig);␊
␉if (!fb_name)␊
␉card->cfg_name = getStringForKey(kAtiConfig, &bootInfo->bootConfig);␊
␉if (!card->cfg_name)␊
␉{␊
␉␉fb_name = card_configs[card->info->cfg_name].name;␊
␉␉card->cfg_name = card_configs[card->info->cfg_name].name;␊
␉␉card->ports = card_configs[card->info->cfg_name].ports;␊
␉}␊
␉else␊
␉{␊
␉␉for (i = 0; i < kCfgEnd; i++)␊
␉␉␉if (strcmp(fb_name, card_configs[i].name) == 0)␊
␉␉␉if (strcmp(card->cfg_name, card_configs[i].name) == 0)␊
␉␉␉␉card->ports = card_configs[i].ports;␊
␉}␊
␊
␉sprintf(name, "ATY,%s", fb_name);␊
␉sprintf(name, "ATY,%s", card->cfg_name);␊
␉aty_name.type = kStr;␊
␉aty_name.size = strlen(name) + 1;␊
␉aty_name.data = (uint8_t *)name;␊
␊
␉sprintf(name_parent, "ATY,%sParent", fb_name);␊
␉sprintf(name_parent, "ATY,%sParent", card->cfg_name);␊
␉aty_nameparent.type = kStr;␊
␉aty_nameparent.size = strlen(name_parent) + 1;␊
␉aty_nameparent.data = (uint8_t *)name_parent;␊

␉stringlength = string->length;␊
␉/* ------------------------------------------------- */␊
␊
␉verbose("ATI %s %s %dMB (%s) [%04x:%04x] (subsys [%04x:%04x]):: %s\n",␊
␉␉␉chip_family_name[card->info->chip_family], card->info->model_name,␊
␉␉␉(uint32_t)(card->vram_size / (1024 * 1024)), card_configs[card->info->cfg_name].name,␊
␉verbose("ATI %s %s %dMB (%s) [%04x:%04x] (subsys [%04x:%04x]):: %s\n",  ␊
␉␉␉chip_family_name[card->info->chip_family], card->info->model_name, ␊
␉␉␉(uint32_t)(card->vram_size / (1024 * 1024)), card->cfg_name, ␊
␉␉␉ati_dev->vendor_id, ati_dev->device_id,␊
␉␉␉ati_dev->subsys_id.subsys.vendor_id, ati_dev->subsys_id.subsys.device_id,␊
␉␉␉devicepath);␊
 ...
 ...
 ...
 ␉uint8_t␉␉␉␉␉*rom;␊
 ␉uint32_t␉␉␉␉rom_size;␊
 ␉uint32_t␉␉␉␉vram_size;␊
+␉const char␉␉␉␉*cfg_name;␊
 ␉uint8_t␉␉␉␉␉ports;␊
 ␉uint32_t␉␉␉␉flags;␊
 ␉bool␉␉␉␉␉posted;␊
 ␊
 static bool init_card(pci_dt_t *pci_dev)␊
 {␊
-␉const char *fb_name;␊
 ␉char name[24];␊
 ␉char name_parent[24];␊
 ␉int i;␊
 ␊
 ␉atN = 0;␊
 ␊
-␉fb_name = getStringForKey(kAtiConfig, &bootInfo->bootConfig);␊
-␉if (!fb_name)␊
+␉card->cfg_name = getStringForKey(kAtiConfig, &bootInfo->bootConfig);␊
+␉if (!card->cfg_name)␊
 ␉{␊
-␉␉fb_name = card_configs[card->info->cfg_name].name;␊
+␉␉card->cfg_name = card_configs[card->info->cfg_name].name;␊
 ␉␉card->ports = card_configs[card->info->cfg_name].ports;␊
 ␉}␊
 ␉else␊
 ␉{␊
 ␉␉for (i = 0; i < kCfgEnd; i++)␊
-␉␉␉if (strcmp(fb_name, card_configs[i].name) == 0)␊
+␉␉␉if (strcmp(card->cfg_name, card_configs[i].name) == 0)␊
 ␉␉␉␉card->ports = card_configs[i].ports;␊
 ␉}␊
 ␊
-␉sprintf(name, "ATY,%s", fb_name);␊
+␉sprintf(name, "ATY,%s", card->cfg_name);␊
 ␉aty_name.type = kStr;␊
 ␉aty_name.size = strlen(name) + 1;␊
 ␉aty_name.data = (uint8_t *)name;␊
 ␊
-␉sprintf(name_parent, "ATY,%sParent", fb_name);␊
+␉sprintf(name_parent, "ATY,%sParent", card->cfg_name);␊
 ␉aty_nameparent.type = kStr;␊
 ␉aty_nameparent.size = strlen(name_parent) + 1;␊
 ␉aty_nameparent.data = (uint8_t *)name_parent;␊
 ␉stringlength = string->length;␊
 ␉/* ------------------------------------------------- */␊
 ␊
-␉verbose("ATI %s %s %dMB (%s) [%04x:%04x] (subsys [%04x:%04x]):: %s\n",␊
-␉␉␉chip_family_name[card->info->chip_family], card->info->model_name,␊
-␉␉␉(uint32_t)(card->vram_size / (1024 * 1024)), card_configs[card->info->cfg_name].name,␊
+␉verbose("ATI %s %s %dMB (%s) [%04x:%04x] (subsys [%04x:%04x]):: %s\n",  ␊
+␉␉␉chip_family_name[card->info->chip_family], card->info->model_name, ␊
+␉␉␉(uint32_t)(card->vram_size / (1024 * 1024)), card->cfg_name, ␊
 ␉␉␉ati_dev->vendor_id, ati_dev->device_id,␊
 ␉␉␉ati_dev->subsys_id.subsys.vendor_id, ati_dev->subsys_id.subsys.device_id,␊
 ␉␉␉devicepath);␊

-138
139 139
140 140
141 
141
142 142
143 143
144 144
+    ␊
    if (p->CPU.Vendor == 0x756E6547 /* Intel */ && ␊
        p->CPU.Family == 0x06 && ␊
        p->CPU.Model >= CPUID_MODEL_PENRYN && ␊
        p->CPU.Model >= CPUID_MODEL_NEHALEM && ␊
        p->CPU.Model != CPUID_MODEL_ATOM        // MSR is *NOT* available on the Intel Atom CPU␊
        ){␊
        msr = rdmsr64(MSR_CORE_THREAD_COUNT);␉␉␉␉␉␉␉␉␉// Undocumented MSR in Nehalem and newer CPUs␊
     ␊
     if (p->CPU.Vendor == 0x756E6547 /* Intel */ && ␊
         p->CPU.Family == 0x06 && ␊
-        p->CPU.Model >= CPUID_MODEL_PENRYN && ␊
+        p->CPU.Model >= CPUID_MODEL_NEHALEM && ␊
         p->CPU.Model != CPUID_MODEL_ATOM        // MSR is *NOT* available on the Intel Atom CPU␊
         ){␊
         msr = rdmsr64(MSR_CORE_THREAD_COUNT);␉␉␉␉␉␉␉␉␉// Undocumented MSR in Nehalem and newer CPUs␊

-212
213 213
214 214
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 
434 
435 
436 
437 
438 
439 
440 
441 
442 
443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 
475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
485 
486 
487 
488 
489 
490 
491 
492 
493 
494 
495 
496 
497 
498 
499 
500 
501 
502 
503 
504 
505 
506 
507 
508 
509 
510 
511 
512 
513 
514 
515 
516 
517 
518 
519 
520 
521 
522 
523 
524 
525 
526 
527 
528 
529 
530 
531 
532 
533 
534 
535 
536 
537 
538 
539 
540 
541 
542 
543 
544 
545 
546 
547 
548 
549 
550 
551 
552 
553 
554 
555 
556 
557 
558 
559 
560 215
561 216
562 217
+    void *                    parameter;␊
};␊
␊
/*!␊
 * @class IOStorage␊
 * @abstract␊
 * The common base class for mass storage objects.␊
 * @discussion␊
 * The IOStorage class is the common base class for mass storage objects.  It is␊
 * an abstract class that defines the open/close/read/write APIs that need to be␊
 * implemented in a given subclass.  Synchronous versions of the read/write APIs␊
 * are provided here -- they are coded in such a way as to wrap the asynchronous␊
 * versions implemented in the subclass.␊
 */␊
␊
class IOStorage : public IOService␊
{␊
    OSDeclareAbstractStructors(IOStorage);␊
␊
protected:␊
␊
    struct ExpansionData { /* */ };␊
    ExpansionData * _expansionData;␊
␊
    /*!␊
     * @function handleOpen␊
     * @discussion␊
     * The handleOpen method grants or denies permission to access this object␊
     * to an interested client.  The argument is an IOStorageAccess value that␊
     * specifies the level of access desired -- reader or reader-writer.␊
     *␊
     * This method can be invoked to upgrade or downgrade the access level for␊
     * an existing client as well.  The previous access level will prevail for␊
     * upgrades that fail, of course.   A downgrade should never fail.  If the␊
     * new access level should be the same as the old for a given client, this␊
     * method will do nothing and return success.  In all cases, one, singular␊
     * close-per-client is expected for all opens-per-client received.␊
     * @param client␊
     * Client requesting the open.␊
     * @param options␊
     * Options for the open.  Set to zero.␊
     * @param access␊
     * Access level for the open.  Set to kIOStorageAccessReader or␊
     * kIOStorageAccessReaderWriter.␊
     * @result␊
     * Returns true if the open was successful, false otherwise.␊
     */␊
␊
    virtual bool handleOpen(IOService *  client,␊
                            IOOptionBits options,␊
                            void *       access) = 0;␊
␊
    /*!␊
     * @function handleIsOpen␊
     * @discussion␊
     * The handleIsOpen method determines whether the specified client, or any␊
     * client if none is specified, presently has an open on this object.␊
     * @param client␊
     * Client to check the open state of.  Set to zero to check the open state␊
     * of all clients.␊
     * @result␊
     * Returns true if the client was (or clients were) open, false otherwise.␊
     */␊
␊
    virtual bool handleIsOpen(const IOService * client) const = 0;␊
␊
    /*!␊
     * @function handleClose␊
     * @discussion␊
     * The handleClose method closes the client's access to this object.␊
     * @param client␊
     * Client requesting the close.␊
     * @param options␊
     * Options for the close.  Set to zero.␊
     */␊
␊
    virtual void handleClose(IOService * client, IOOptionBits options) = 0;␊
␊
public:␊
␊
#ifndef __LP64__␊
    /*␊
     * Initialize this object's minimal state.␊
     */␊
␊
    virtual bool init(OSDictionary * properties = 0);␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function complete␊
     * @discussion␊
     * Invokes the specified completion action of the read/write request.  If␊
     * the completion action is unspecified, no action is taken.  This method␊
     * serves simply as a convenience to storage subclass developers.␊
     * @param completion␊
     * Completion information for the data transfer.␊
     * @param status␊
     * Status of the data transfer.␊
     * @param actualByteCount␊
     * Actual number of bytes transferred in the data transfer.␊
     */␊
␊
    static void complete(IOStorageCompletion * completion,␊
                         IOReturn              status,␊
                         UInt64                actualByteCount = 0);␊
␊
#ifndef __LP64__␊
    static void complete(IOStorageCompletion completion,␊
                         IOReturn            status,␊
                         UInt64              actualByteCount = 0); /* DEPRECATED */␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function open␊
     * @discussion␊
     * Ask the storage object for permission to access its contents; the method␊
     * is equivalent to IOService::open(), but with the correct parameter types.␊
     *␊
     * This method may also be invoked to upgrade or downgrade the access of an␊
     * existing open (if it fails, the existing open prevails).␊
     * @param client␊
     * Client requesting the open.␊
     * @param options␊
     * Options for the open.  Set to zero.␊
     * @param access␊
     * Access level for the open.  Set to kIOStorageAccessReader or␊
     * kIOStorageAccessReaderWriter.␊
     * @result␊
     * Returns true if the open was successful, false otherwise.␊
     */␊
␊
    virtual bool open(IOService *     client,␊
                      IOOptionBits    options,␊
                      IOStorageAccess access);␊
␊
#ifndef __LP64__␊
    virtual void read(IOService *          client,␊
                      UInt64               byteStart,␊
                      IOMemoryDescriptor * buffer,␊
                      IOStorageCompletion  completion) __attribute__ ((deprecated));␊
␊
    virtual void write(IOService *          client,␊
                       UInt64               byteStart,␊
                       IOMemoryDescriptor * buffer,␊
                       IOStorageCompletion  completion) __attribute__ ((deprecated));␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function read␊
     * @discussion␊
     * Read data from the storage object at the specified byte offset into the␊
     * specified buffer, synchronously.   When the read completes, this method␊
     * will return to the caller.  The actual byte count field is optional.␊
     * @param client␊
     * Client requesting the read.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.␊
     * @param actualByteCount␊
     * Returns the actual number of bytes transferred in the data transfer.␊
     * @result␊
     * Returns the status of the data transfer.␊
     */␊
␊
#ifdef __LP64__␊
    virtual IOReturn read(IOService *           client,␊
                          UInt64                byteStart,␊
                          IOMemoryDescriptor *  buffer,␊
                          IOStorageAttributes * attributes      = 0,␊
                          UInt64 *              actualByteCount = 0);␊
#else /* !__LP64__ */␊
    virtual IOReturn read(IOService *           client,␊
                          UInt64                byteStart,␊
                          IOMemoryDescriptor *  buffer,␊
                          UInt64 *              actualByteCount = 0);␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function write␊
     * @discussion␊
     * Write data into the storage object at the specified byte offset from the␊
     * specified buffer, synchronously.   When the write completes, this method␊
     * will return to the caller.  The actual byte count field is optional.␊
     * @param client␊
     * Client requesting the write.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.␊
     * @param actualByteCount␊
     * Returns the actual number of bytes transferred in the data transfer.␊
     * @result␊
     * Returns the status of the data transfer.␊
     */␊
␊
#ifdef __LP64__␊
    virtual IOReturn write(IOService *           client,␊
                           UInt64                byteStart,␊
                           IOMemoryDescriptor *  buffer,␊
                           IOStorageAttributes * attributes      = 0,␊
                           UInt64 *              actualByteCount = 0);␊
#else /* !__LP64__ */␊
    virtual IOReturn write(IOService *           client,␊
                           UInt64                byteStart,␊
                           IOMemoryDescriptor *  buffer,␊
                           UInt64 *              actualByteCount = 0);␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function synchronizeCache␊
     * @discussion␊
     * Flush the cached data in the storage object, if any, synchronously.␊
     * @param client␊
     * Client requesting the cache synchronization.␊
     * @result␊
     * Returns the status of the cache synchronization.␊
     */␊
␊
    virtual IOReturn synchronizeCache(IOService * client) = 0;␊
␊
    /*!␊
     * @function read␊
     * @discussion␊
     * Read data from the storage object at the specified byte offset into the␊
     * specified buffer, asynchronously.   When the read completes, the caller␊
     * will be notified via the specified completion action.␊
     *␊
     * The buffer will be retained for the duration of the read.␊
     * @param client␊
     * Client requesting the read.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     */␊
␊
#ifdef __LP64__␊
    virtual void read(IOService *           client,␊
                      UInt64                byteStart,␊
                      IOMemoryDescriptor *  buffer,␊
                      IOStorageAttributes * attributes,␊
                      IOStorageCompletion * completion) = 0;␊
#else /* !__LP64__ */␊
    virtual void read(IOService *           client,␊
                      UInt64                byteStart,␊
                      IOMemoryDescriptor *  buffer,␊
                      IOStorageAttributes * attributes,␊
                      IOStorageCompletion * completion); /* 10.5.0 */␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function write␊
     * @discussion␊
     * Write data into the storage object at the specified byte offset from the␊
     * specified buffer, asynchronously.   When the write completes, the caller␊
     * will be notified via the specified completion action.␊
     *␊
     * The buffer will be retained for the duration of the write.␊
     * @param client␊
     * Client requesting the write.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     */␊
␊
#ifdef __LP64__␊
    virtual void write(IOService *           client,␊
                       UInt64                byteStart,␊
                       IOMemoryDescriptor *  buffer,␊
                       IOStorageAttributes * attributes,␊
                       IOStorageCompletion * completion) = 0;␊
#else /* !__LP64__ */␊
    virtual void write(IOService *           client,␊
                       UInt64                byteStart,␊
                       IOMemoryDescriptor *  buffer,␊
                       IOStorageAttributes * attributes,␊
                       IOStorageCompletion * completion); /* 10.5.0 */␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function discard␊
     * @discussion␊
     * Delete unused data from the storage object at the specified byte offset,␊
     * synchronously.␊
     * @param client␊
     * Client requesting the operation.␊
     * @param byteStart␊
     * Starting byte offset for the operation.␊
     * @param byteCount␊
     * Size of the operation.␊
     * @result␊
     * Returns the status of the operation.␊
     */␊
␊
    virtual IOReturn discard(IOService * client,␊
                             UInt64      byteStart,␊
                             UInt64      byteCount); /* 10.6.0 */␊
␊
#ifdef __LP64__␊
    OSMetaClassDeclareReservedUnused(IOStorage,  0);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  1);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  2);␊
#else /* !__LP64__ */␊
    OSMetaClassDeclareReservedUsed(IOStorage,  0);␊
    OSMetaClassDeclareReservedUsed(IOStorage,  1);␊
    OSMetaClassDeclareReservedUsed(IOStorage,  2);␊
#endif /* !__LP64__ */␊
    OSMetaClassDeclareReservedUnused(IOStorage,  3);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  4);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  5);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  6);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  7);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  8);␊
    OSMetaClassDeclareReservedUnused(IOStorage,  9);␊
    OSMetaClassDeclareReservedUnused(IOStorage, 10);␊
    OSMetaClassDeclareReservedUnused(IOStorage, 11);␊
    OSMetaClassDeclareReservedUnused(IOStorage, 12);␊
    OSMetaClassDeclareReservedUnused(IOStorage, 13);␊
    OSMetaClassDeclareReservedUnused(IOStorage, 14);␊
    OSMetaClassDeclareReservedUnused(IOStorage, 15);␊
};␊
␊
#endif /* __cplusplus */␊
#endif /* KERNEL */␊
#endif /* !_IOSTORAGE_H */␊
     void *                    parameter;␊
 };␊
 ␊
-/*!␊
- * @class IOStorage␊
- * @abstract␊
- * The common base class for mass storage objects.␊
- * @discussion␊
- * The IOStorage class is the common base class for mass storage objects.  It is␊
- * an abstract class that defines the open/close/read/write APIs that need to be␊
- * implemented in a given subclass.  Synchronous versions of the read/write APIs␊
- * are provided here -- they are coded in such a way as to wrap the asynchronous␊
- * versions implemented in the subclass.␊
- */␊
-␊
-class IOStorage : public IOService␊
-{␊
-    OSDeclareAbstractStructors(IOStorage);␊
-␊
-protected:␊
-␊
-    struct ExpansionData { /* */ };␊
-    ExpansionData * _expansionData;␊
-␊
-    /*!␊
-     * @function handleOpen␊
-     * @discussion␊
-     * The handleOpen method grants or denies permission to access this object␊
-     * to an interested client.  The argument is an IOStorageAccess value that␊
-     * specifies the level of access desired -- reader or reader-writer.␊
-     *␊
-     * This method can be invoked to upgrade or downgrade the access level for␊
-     * an existing client as well.  The previous access level will prevail for␊
-     * upgrades that fail, of course.   A downgrade should never fail.  If the␊
-     * new access level should be the same as the old for a given client, this␊
-     * method will do nothing and return success.  In all cases, one, singular␊
-     * close-per-client is expected for all opens-per-client received.␊
-     * @param client␊
-     * Client requesting the open.␊
-     * @param options␊
-     * Options for the open.  Set to zero.␊
-     * @param access␊
-     * Access level for the open.  Set to kIOStorageAccessReader or␊
-     * kIOStorageAccessReaderWriter.␊
-     * @result␊
-     * Returns true if the open was successful, false otherwise.␊
-     */␊
-␊
-    virtual bool handleOpen(IOService *  client,␊
-                            IOOptionBits options,␊
-                            void *       access) = 0;␊
-␊
-    /*!␊
-     * @function handleIsOpen␊
-     * @discussion␊
-     * The handleIsOpen method determines whether the specified client, or any␊
-     * client if none is specified, presently has an open on this object.␊
-     * @param client␊
-     * Client to check the open state of.  Set to zero to check the open state␊
-     * of all clients.␊
-     * @result␊
-     * Returns true if the client was (or clients were) open, false otherwise.␊
-     */␊
-␊
-    virtual bool handleIsOpen(const IOService * client) const = 0;␊
-␊
-    /*!␊
-     * @function handleClose␊
-     * @discussion␊
-     * The handleClose method closes the client's access to this object.␊
-     * @param client␊
-     * Client requesting the close.␊
-     * @param options␊
-     * Options for the close.  Set to zero.␊
-     */␊
-␊
-    virtual void handleClose(IOService * client, IOOptionBits options) = 0;␊
-␊
-public:␊
-␊
-#ifndef __LP64__␊
-    /*␊
-     * Initialize this object's minimal state.␊
-     */␊
-␊
-    virtual bool init(OSDictionary * properties = 0);␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function complete␊
-     * @discussion␊
-     * Invokes the specified completion action of the read/write request.  If␊
-     * the completion action is unspecified, no action is taken.  This method␊
-     * serves simply as a convenience to storage subclass developers.␊
-     * @param completion␊
-     * Completion information for the data transfer.␊
-     * @param status␊
-     * Status of the data transfer.␊
-     * @param actualByteCount␊
-     * Actual number of bytes transferred in the data transfer.␊
-     */␊
-␊
-    static void complete(IOStorageCompletion * completion,␊
-                         IOReturn              status,␊
-                         UInt64                actualByteCount = 0);␊
-␊
-#ifndef __LP64__␊
-    static void complete(IOStorageCompletion completion,␊
-                         IOReturn            status,␊
-                         UInt64              actualByteCount = 0); /* DEPRECATED */␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function open␊
-     * @discussion␊
-     * Ask the storage object for permission to access its contents; the method␊
-     * is equivalent to IOService::open(), but with the correct parameter types.␊
-     *␊
-     * This method may also be invoked to upgrade or downgrade the access of an␊
-     * existing open (if it fails, the existing open prevails).␊
-     * @param client␊
-     * Client requesting the open.␊
-     * @param options␊
-     * Options for the open.  Set to zero.␊
-     * @param access␊
-     * Access level for the open.  Set to kIOStorageAccessReader or␊
-     * kIOStorageAccessReaderWriter.␊
-     * @result␊
-     * Returns true if the open was successful, false otherwise.␊
-     */␊
-␊
-    virtual bool open(IOService *     client,␊
-                      IOOptionBits    options,␊
-                      IOStorageAccess access);␊
-␊
-#ifndef __LP64__␊
-    virtual void read(IOService *          client,␊
-                      UInt64               byteStart,␊
-                      IOMemoryDescriptor * buffer,␊
-                      IOStorageCompletion  completion) __attribute__ ((deprecated));␊
-␊
-    virtual void write(IOService *          client,␊
-                       UInt64               byteStart,␊
-                       IOMemoryDescriptor * buffer,␊
-                       IOStorageCompletion  completion) __attribute__ ((deprecated));␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function read␊
-     * @discussion␊
-     * Read data from the storage object at the specified byte offset into the␊
-     * specified buffer, synchronously.   When the read completes, this method␊
-     * will return to the caller.  The actual byte count field is optional.␊
-     * @param client␊
-     * Client requesting the read.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.␊
-     * @param actualByteCount␊
-     * Returns the actual number of bytes transferred in the data transfer.␊
-     * @result␊
-     * Returns the status of the data transfer.␊
-     */␊
-␊
-#ifdef __LP64__␊
-    virtual IOReturn read(IOService *           client,␊
-                          UInt64                byteStart,␊
-                          IOMemoryDescriptor *  buffer,␊
-                          IOStorageAttributes * attributes      = 0,␊
-                          UInt64 *              actualByteCount = 0);␊
-#else /* !__LP64__ */␊
-    virtual IOReturn read(IOService *           client,␊
-                          UInt64                byteStart,␊
-                          IOMemoryDescriptor *  buffer,␊
-                          UInt64 *              actualByteCount = 0);␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function write␊
-     * @discussion␊
-     * Write data into the storage object at the specified byte offset from the␊
-     * specified buffer, synchronously.   When the write completes, this method␊
-     * will return to the caller.  The actual byte count field is optional.␊
-     * @param client␊
-     * Client requesting the write.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.␊
-     * @param actualByteCount␊
-     * Returns the actual number of bytes transferred in the data transfer.␊
-     * @result␊
-     * Returns the status of the data transfer.␊
-     */␊
-␊
-#ifdef __LP64__␊
-    virtual IOReturn write(IOService *           client,␊
-                           UInt64                byteStart,␊
-                           IOMemoryDescriptor *  buffer,␊
-                           IOStorageAttributes * attributes      = 0,␊
-                           UInt64 *              actualByteCount = 0);␊
-#else /* !__LP64__ */␊
-    virtual IOReturn write(IOService *           client,␊
-                           UInt64                byteStart,␊
-                           IOMemoryDescriptor *  buffer,␊
-                           UInt64 *              actualByteCount = 0);␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function synchronizeCache␊
-     * @discussion␊
-     * Flush the cached data in the storage object, if any, synchronously.␊
-     * @param client␊
-     * Client requesting the cache synchronization.␊
-     * @result␊
-     * Returns the status of the cache synchronization.␊
-     */␊
-␊
-    virtual IOReturn synchronizeCache(IOService * client) = 0;␊
-␊
-    /*!␊
-     * @function read␊
-     * @discussion␊
-     * Read data from the storage object at the specified byte offset into the␊
-     * specified buffer, asynchronously.   When the read completes, the caller␊
-     * will be notified via the specified completion action.␊
-     *␊
-     * The buffer will be retained for the duration of the read.␊
-     * @param client␊
-     * Client requesting the read.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     */␊
-␊
-#ifdef __LP64__␊
-    virtual void read(IOService *           client,␊
-                      UInt64                byteStart,␊
-                      IOMemoryDescriptor *  buffer,␊
-                      IOStorageAttributes * attributes,␊
-                      IOStorageCompletion * completion) = 0;␊
-#else /* !__LP64__ */␊
-    virtual void read(IOService *           client,␊
-                      UInt64                byteStart,␊
-                      IOMemoryDescriptor *  buffer,␊
-                      IOStorageAttributes * attributes,␊
-                      IOStorageCompletion * completion); /* 10.5.0 */␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function write␊
-     * @discussion␊
-     * Write data into the storage object at the specified byte offset from the␊
-     * specified buffer, asynchronously.   When the write completes, the caller␊
-     * will be notified via the specified completion action.␊
-     *␊
-     * The buffer will be retained for the duration of the write.␊
-     * @param client␊
-     * Client requesting the write.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     */␊
-␊
-#ifdef __LP64__␊
-    virtual void write(IOService *           client,␊
-                       UInt64                byteStart,␊
-                       IOMemoryDescriptor *  buffer,␊
-                       IOStorageAttributes * attributes,␊
-                       IOStorageCompletion * completion) = 0;␊
-#else /* !__LP64__ */␊
-    virtual void write(IOService *           client,␊
-                       UInt64                byteStart,␊
-                       IOMemoryDescriptor *  buffer,␊
-                       IOStorageAttributes * attributes,␊
-                       IOStorageCompletion * completion); /* 10.5.0 */␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function discard␊
-     * @discussion␊
-     * Delete unused data from the storage object at the specified byte offset,␊
-     * synchronously.␊
-     * @param client␊
-     * Client requesting the operation.␊
-     * @param byteStart␊
-     * Starting byte offset for the operation.␊
-     * @param byteCount␊
-     * Size of the operation.␊
-     * @result␊
-     * Returns the status of the operation.␊
-     */␊
-␊
-    virtual IOReturn discard(IOService * client,␊
-                             UInt64      byteStart,␊
-                             UInt64      byteCount); /* 10.6.0 */␊
-␊
-#ifdef __LP64__␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  0);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  1);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  2);␊
-#else /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUsed(IOStorage,  0);␊
-    OSMetaClassDeclareReservedUsed(IOStorage,  1);␊
-    OSMetaClassDeclareReservedUsed(IOStorage,  2);␊
-#endif /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  3);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  4);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  5);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  6);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  7);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  8);␊
-    OSMetaClassDeclareReservedUnused(IOStorage,  9);␊
-    OSMetaClassDeclareReservedUnused(IOStorage, 10);␊
-    OSMetaClassDeclareReservedUnused(IOStorage, 11);␊
-    OSMetaClassDeclareReservedUnused(IOStorage, 12);␊
-    OSMetaClassDeclareReservedUnused(IOStorage, 13);␊
-    OSMetaClassDeclareReservedUnused(IOStorage, 14);␊
-    OSMetaClassDeclareReservedUnused(IOStorage, 15);␊
-};␊
-␊
 #endif /* __cplusplus */␊
 #endif /* KERNEL */␊
 #endif /* !_IOSTORAGE_H */␊

-87
88 88
89 89
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 90
+␊
#pragma pack(pop)                        /* (reset to default struct packing) */␊
␊
#ifdef KERNEL␊
#ifdef __cplusplus␊
␊
/*␊
 * Kernel␊
 */␊
␊
#include <IOKit/storage/IOPartitionScheme.h>␊
␊
/*␊
 * Class␊
 */␊
␊
class IOGUIDPartitionScheme : public IOPartitionScheme␊
{␊
    OSDeclareDefaultStructors(IOGUIDPartitionScheme);␊
␊
protected:␊
␊
    struct ExpansionData { /* */ };␊
    ExpansionData * _expansionData;␊
␊
    OSSet * _partitions;    /* (set of media objects representing partitions) */␊
␊
    /*␊
     * Free all of this object's outstanding resources.␊
     */␊
␊
    virtual void free(void);␊
␊
    /*␊
     * Scan the provider media for a GUID partition map.    Returns the set␊
     * of media objects representing each of the partitions (the retain for␊
     * the set is passed to the caller), or null should no partition map be␊
     * found.  The default probe score can be adjusted up or down, based on␊
     * the confidence of the scan.␊
     */␊
␊
    virtual OSSet * scan(SInt32 * score);␊
␊
    /*␊
     * Ask whether the given partition is used.␊
     */␊
␊
    virtual bool isPartitionUsed(gpt_ent * partition);␊
␊
    /*␊
     * Ask whether the given partition appears to be corrupt. A partition that␊
     * is corrupt will cause the failure of the GUID partition map recognition␊
     * altogether.␊
     */␊
␊
    virtual bool isPartitionCorrupt( gpt_ent * partition,␊
                                     UInt32    partitionID );␊
␊
    /*␊
     * Ask whether the given partition appears to be invalid.  A partition that␊
     * is invalid will cause it to be skipped in the scan, but will not cause a␊
     * failure of the GUID partition map recognition.␊
     */␊
␊
    virtual bool isPartitionInvalid( gpt_ent * partition,␊
                                     UInt32    partitionID );␊
␊
    /*␊
     * Instantiate a new media object to represent the given partition.␊
     */␊
␊
    virtual IOMedia * instantiateMediaObject( gpt_ent * partition,␊
                                              UInt32    partitionID );␊
␊
    /*␊
     * Allocate a new media object (called from instantiateMediaObject).␊
     */␊
␊
    virtual IOMedia * instantiateDesiredMediaObject( gpt_ent * partition,␊
                                                     UInt32    partitionID );␊
␊
#ifndef __LP64__␊
    /*␊
     * Attach the given media object to the device tree plane.␊
     */␊
␊
    virtual bool attachMediaObjectToDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
␊
    /*␊
     * Detach the given media object from the device tree plane.␊
     */␊
␊
    virtual void detachMediaObjectFromDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
#endif /* !__LP64__ */␊
␊
public:␊
␊
    /*␊
     * Initialize this object's minimal state.␊
     */␊
␊
    virtual bool init(OSDictionary * properties = 0);␊
␊
    /*␊
     * Determine whether the provider media contains a GUID partition map.␊
     */␊
␊
    virtual IOService * probe(IOService * provider, SInt32 * score);␊
␊
    /*␊
     * Publish the new media objects which represent our partitions.␊
     */␊
␊
    virtual bool start(IOService * provider);␊
␊
    /*␊
     * Clean up after the media objects we published before terminating.␊
     */␊
␊
    virtual void stop(IOService * provider);␊
␊
    /*␊
     * Request that the provider media be re-scanned for partitions.␊
     */␊
␊
    virtual IOReturn requestProbe(IOOptionBits options);␊
␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  0);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  1);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  2);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  3);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  4);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  5);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  6);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  7);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  8);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  9);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 10);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 11);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 12);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 13);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 14);␊
    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 15);␊
};␊
␊
#endif /* __cplusplus */␊
#endif /* KERNEL */␊
#endif /* !_IOGUIDPARTITIONSCHEME_H */␊
 ␊
 #pragma pack(pop)                        /* (reset to default struct packing) */␊
 ␊
-#ifdef KERNEL␊
-#ifdef __cplusplus␊
-␊
-/*␊
- * Kernel␊
- */␊
-␊
-#include <IOKit/storage/IOPartitionScheme.h>␊
-␊
-/*␊
- * Class␊
- */␊
-␊
-class IOGUIDPartitionScheme : public IOPartitionScheme␊
-{␊
-    OSDeclareDefaultStructors(IOGUIDPartitionScheme);␊
-␊
-protected:␊
-␊
-    struct ExpansionData { /* */ };␊
-    ExpansionData * _expansionData;␊
-␊
-    OSSet * _partitions;    /* (set of media objects representing partitions) */␊
-␊
-    /*␊
-     * Free all of this object's outstanding resources.␊
-     */␊
-␊
-    virtual void free(void);␊
-␊
-    /*␊
-     * Scan the provider media for a GUID partition map.    Returns the set␊
-     * of media objects representing each of the partitions (the retain for␊
-     * the set is passed to the caller), or null should no partition map be␊
-     * found.  The default probe score can be adjusted up or down, based on␊
-     * the confidence of the scan.␊
-     */␊
-␊
-    virtual OSSet * scan(SInt32 * score);␊
-␊
-    /*␊
-     * Ask whether the given partition is used.␊
-     */␊
-␊
-    virtual bool isPartitionUsed(gpt_ent * partition);␊
-␊
-    /*␊
-     * Ask whether the given partition appears to be corrupt. A partition that␊
-     * is corrupt will cause the failure of the GUID partition map recognition␊
-     * altogether.␊
-     */␊
-␊
-    virtual bool isPartitionCorrupt( gpt_ent * partition,␊
-                                     UInt32    partitionID );␊
-␊
-    /*␊
-     * Ask whether the given partition appears to be invalid.  A partition that␊
-     * is invalid will cause it to be skipped in the scan, but will not cause a␊
-     * failure of the GUID partition map recognition.␊
-     */␊
-␊
-    virtual bool isPartitionInvalid( gpt_ent * partition,␊
-                                     UInt32    partitionID );␊
-␊
-    /*␊
-     * Instantiate a new media object to represent the given partition.␊
-     */␊
-␊
-    virtual IOMedia * instantiateMediaObject( gpt_ent * partition,␊
-                                              UInt32    partitionID );␊
-␊
-    /*␊
-     * Allocate a new media object (called from instantiateMediaObject).␊
-     */␊
-␊
-    virtual IOMedia * instantiateDesiredMediaObject( gpt_ent * partition,␊
-                                                     UInt32    partitionID );␊
-␊
-#ifndef __LP64__␊
-    /*␊
-     * Attach the given media object to the device tree plane.␊
-     */␊
-␊
-    virtual bool attachMediaObjectToDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
-␊
-    /*␊
-     * Detach the given media object from the device tree plane.␊
-     */␊
-␊
-    virtual void detachMediaObjectFromDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
-#endif /* !__LP64__ */␊
-␊
-public:␊
-␊
-    /*␊
-     * Initialize this object's minimal state.␊
-     */␊
-␊
-    virtual bool init(OSDictionary * properties = 0);␊
-␊
-    /*␊
-     * Determine whether the provider media contains a GUID partition map.␊
-     */␊
-␊
-    virtual IOService * probe(IOService * provider, SInt32 * score);␊
-␊
-    /*␊
-     * Publish the new media objects which represent our partitions.␊
-     */␊
-␊
-    virtual bool start(IOService * provider);␊
-␊
-    /*␊
-     * Clean up after the media objects we published before terminating.␊
-     */␊
-␊
-    virtual void stop(IOService * provider);␊
-␊
-    /*␊
-     * Request that the provider media be re-scanned for partitions.␊
-     */␊
-␊
-    virtual IOReturn requestProbe(IOOptionBits options);␊
-␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  0);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  1);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  2);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  3);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  4);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  5);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  6);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  7);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  8);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme,  9);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 10);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 11);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 12);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 13);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 14);␊
-    OSMetaClassDeclareReservedUnused(IOGUIDPartitionScheme, 15);␊
-};␊
-␊
-#endif /* __cplusplus */␊
-#endif /* KERNEL */␊
 #endif /* !_IOGUIDPARTITIONSCHEME_H */␊

-102
103 103
104 104
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 105
+␊
#pragma pack(pop)                        /* (reset to default struct packing) */␊
␊
#ifdef KERNEL␊
#ifdef __cplusplus␊
␊
/*␊
 * Kernel␊
 */␊
␊
#include <IOKit/storage/IOPartitionScheme.h>␊
␊
/*␊
 * Class␊
 */␊
␊
class IOFDiskPartitionScheme : public IOPartitionScheme␊
{␊
    OSDeclareDefaultStructors(IOFDiskPartitionScheme);␊
␊
protected:␊
␊
    struct ExpansionData { /* */ };␊
    ExpansionData * _expansionData;␊
␊
    OSSet * _partitions;    /* (set of media objects representing partitions) */␊
␊
    /*␊
     * Free all of this object's outstanding resources.␊
     */␊
␊
    virtual void free(void);␊
␊
    /*␊
     * Scan the provider media for an FDisk partition map.  Returns the set␊
     * of media objects representing each of the partitions (the retain for␊
     * the set is passed to the caller), or null should no partition map be␊
     * found.  The default probe score can be adjusted up or down, based on␊
     * the confidence of the scan.␊
     */␊
␊
    virtual OSSet * scan(SInt32 * score);␊
␊
    /*␊
     * Ask whether the given partition is extended.␊
     */␊
␊
    virtual bool isPartitionExtended(fdisk_part * partition);␊
␊
    /*␊
     * Ask whether the given partition is used.␊
     */␊
␊
    virtual bool isPartitionUsed(fdisk_part * partition);␊
␊
    /*␊
     * Ask whether the given partition appears to be corrupt.  A partition that␊
     * is corrupt will cause the failure of the FDisk partition map recognition␊
     * altogether.␊
     */␊
␊
    virtual bool isPartitionCorrupt( fdisk_part * partition,␊
                                     UInt32       partitionID,␊
                                     UInt32       fdiskBlock );␊
␊
    /*␊
     * Ask whether the given partition appears to be invalid.  A partition that␊
     * is invalid will cause it to be skipped in the scan, but will not cause a␊
     * failure of the FDisk partition map recognition.␊
     */␊
␊
    virtual bool isPartitionInvalid( fdisk_part * partition,␊
                                     UInt32       partitionID,␊
                                     UInt32       fdiskBlock );␊
␊
    /*␊
     * Instantiate a new media object to represent the given partition.␊
     */␊
␊
    virtual IOMedia * instantiateMediaObject( fdisk_part * partition,␊
                                              UInt32       partitionID,␊
                                              UInt32       fdiskBlock );␊
␊
    /*␊
     * Allocate a new media object (called from instantiateMediaObject).␊
     */␊
␊
    virtual IOMedia * instantiateDesiredMediaObject( fdisk_part * partition,␊
                                                     UInt32       partitionID,␊
                                                     UInt32       fdiskBlock );␊
␊
#ifndef __LP64__␊
    /*␊
     * Attach the given media object to the device tree plane.␊
     */␊
␊
    virtual bool attachMediaObjectToDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
␊
    /*␊
     * Detach the given media object from the device tree plane.␊
     */␊
␊
    virtual void detachMediaObjectFromDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
#endif /* !__LP64__ */␊
␊
public:␊
␊
    /*␊
     * Initialize this object's minimal state.␊
     */␊
␊
    virtual bool init(OSDictionary * properties = 0);␊
␊
    /*␊
     * Determine whether the provider media contains an FDisk partition map.␊
     */␊
␊
    virtual IOService * probe(IOService * provider, SInt32 * score);␊
␊
    /*␊
     * Publish the new media objects which represent our partitions.␊
     */␊
␊
    virtual bool start(IOService * provider);␊
␊
    /*␊
     * Clean up after the media objects we published before terminating.␊
     */␊
␊
    virtual void stop(IOService * provider);␊
␊
    /*␊
     * Request that the provider media be re-scanned for partitions.␊
     */␊
␊
    virtual IOReturn requestProbe(IOOptionBits options);␊
␊
#ifdef __LP64__␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  0);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  1);␊
#else /* !__LP64__ */␊
    OSMetaClassDeclareReservedUsed(IOFDiskPartitionScheme,  0);␊
    OSMetaClassDeclareReservedUsed(IOFDiskPartitionScheme,  1);␊
#endif /* !__LP64__ */␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  2);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  3);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  4);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  5);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  6);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  7);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  8);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  9);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 10);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 11);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 12);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 13);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 14);␊
    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 15);␊
};␊
␊
#endif /* __cplusplus */␊
#endif /* KERNEL */␊
#endif /* !_IOFDISKPARTITIONSCHEME_H */␊
 ␊
 #pragma pack(pop)                        /* (reset to default struct packing) */␊
 ␊
-#ifdef KERNEL␊
-#ifdef __cplusplus␊
-␊
-/*␊
- * Kernel␊
- */␊
-␊
-#include <IOKit/storage/IOPartitionScheme.h>␊
-␊
-/*␊
- * Class␊
- */␊
-␊
-class IOFDiskPartitionScheme : public IOPartitionScheme␊
-{␊
-    OSDeclareDefaultStructors(IOFDiskPartitionScheme);␊
-␊
-protected:␊
-␊
-    struct ExpansionData { /* */ };␊
-    ExpansionData * _expansionData;␊
-␊
-    OSSet * _partitions;    /* (set of media objects representing partitions) */␊
-␊
-    /*␊
-     * Free all of this object's outstanding resources.␊
-     */␊
-␊
-    virtual void free(void);␊
-␊
-    /*␊
-     * Scan the provider media for an FDisk partition map.  Returns the set␊
-     * of media objects representing each of the partitions (the retain for␊
-     * the set is passed to the caller), or null should no partition map be␊
-     * found.  The default probe score can be adjusted up or down, based on␊
-     * the confidence of the scan.␊
-     */␊
-␊
-    virtual OSSet * scan(SInt32 * score);␊
-␊
-    /*␊
-     * Ask whether the given partition is extended.␊
-     */␊
-␊
-    virtual bool isPartitionExtended(fdisk_part * partition);␊
-␊
-    /*␊
-     * Ask whether the given partition is used.␊
-     */␊
-␊
-    virtual bool isPartitionUsed(fdisk_part * partition);␊
-␊
-    /*␊
-     * Ask whether the given partition appears to be corrupt.  A partition that␊
-     * is corrupt will cause the failure of the FDisk partition map recognition␊
-     * altogether.␊
-     */␊
-␊
-    virtual bool isPartitionCorrupt( fdisk_part * partition,␊
-                                     UInt32       partitionID,␊
-                                     UInt32       fdiskBlock );␊
-␊
-    /*␊
-     * Ask whether the given partition appears to be invalid.  A partition that␊
-     * is invalid will cause it to be skipped in the scan, but will not cause a␊
-     * failure of the FDisk partition map recognition.␊
-     */␊
-␊
-    virtual bool isPartitionInvalid( fdisk_part * partition,␊
-                                     UInt32       partitionID,␊
-                                     UInt32       fdiskBlock );␊
-␊
-    /*␊
-     * Instantiate a new media object to represent the given partition.␊
-     */␊
-␊
-    virtual IOMedia * instantiateMediaObject( fdisk_part * partition,␊
-                                              UInt32       partitionID,␊
-                                              UInt32       fdiskBlock );␊
-␊
-    /*␊
-     * Allocate a new media object (called from instantiateMediaObject).␊
-     */␊
-␊
-    virtual IOMedia * instantiateDesiredMediaObject( fdisk_part * partition,␊
-                                                     UInt32       partitionID,␊
-                                                     UInt32       fdiskBlock );␊
-␊
-#ifndef __LP64__␊
-    /*␊
-     * Attach the given media object to the device tree plane.␊
-     */␊
-␊
-    virtual bool attachMediaObjectToDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
-␊
-    /*␊
-     * Detach the given media object from the device tree plane.␊
-     */␊
-␊
-    virtual void detachMediaObjectFromDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
-#endif /* !__LP64__ */␊
-␊
-public:␊
-␊
-    /*␊
-     * Initialize this object's minimal state.␊
-     */␊
-␊
-    virtual bool init(OSDictionary * properties = 0);␊
-␊
-    /*␊
-     * Determine whether the provider media contains an FDisk partition map.␊
-     */␊
-␊
-    virtual IOService * probe(IOService * provider, SInt32 * score);␊
-␊
-    /*␊
-     * Publish the new media objects which represent our partitions.␊
-     */␊
-␊
-    virtual bool start(IOService * provider);␊
-␊
-    /*␊
-     * Clean up after the media objects we published before terminating.␊
-     */␊
-␊
-    virtual void stop(IOService * provider);␊
-␊
-    /*␊
-     * Request that the provider media be re-scanned for partitions.␊
-     */␊
-␊
-    virtual IOReturn requestProbe(IOOptionBits options);␊
-␊
-#ifdef __LP64__␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  0);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  1);␊
-#else /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUsed(IOFDiskPartitionScheme,  0);␊
-    OSMetaClassDeclareReservedUsed(IOFDiskPartitionScheme,  1);␊
-#endif /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  2);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  3);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  4);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  5);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  6);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  7);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  8);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme,  9);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 10);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 11);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 12);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 13);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 14);␊
-    OSMetaClassDeclareReservedUnused(IOFDiskPartitionScheme, 15);␊
-};␊
-␊
-#endif /* __cplusplus */␊
-#endif /* KERNEL */␊
 #endif /* !_IOFDISKPARTITIONSCHEME_H */␊

-228
229 229
230 230
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 
434 
435 
436 
437 
438 
439 
440 
441 
442 
443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 
475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
485 
486 
487 
488 
489 
490 
491 
492 
493 
494 
495 
496 
497 
498 
499 
500 
501 
502 
503 
504 
505 
506 
507 
508 
509 
510 
511 
512 
513 
514 
515 
516 
517 
518 
519 
520 
521 
522 
523 
524 
525 
526 
527 
528 
529 
530 
531 
532 
533 
534 
535 
536 
537 
538 
539 
540 
541 
542 
543 
544 
545 
546 
547 
548 
549 
550 
551 
552 
553 
554 
555 
556 
557 
558 
559 
560 
561 
562 
563 
564 
565 
566 
567 
568 
569 
570 
571 
572 
573 
574 
575 
576 
577 
578 
579 
580 
581 
582 
583 
584 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 
595 
596 
597 
598 
599 
600 
601 
602 
603 
604 
605 
606 
607 
608 
609 
610 
611 
612 
613 
614 
615 
616 
617 
618 
619 
620 
621 
622 
623 
624 
625 
626 
627 
628 
629 
630 
631 
632 
633 
634 
635 
636 
637 
638 
639 
640 
641 
642 
643 
644 
645 
646 
647 
648 
649 
650 
651 
652 
653 
654 
655 
656 
657 
658 
659 
660 
661 
662 
663 
664 
665 
666 
667 
668 231
+␊
typedef UInt32 IOMediaAttributeMask;␊
␊
#ifdef KERNEL␊
#ifdef __cplusplus␊
␊
/*␊
 * Kernel␊
 */␊
␊
#include <IOKit/storage/IOStorage.h>␊
␊
/*!␊
 * @class IOMedia␊
 * @abstract␊
 * A random-access disk device abstraction.␊
 * @discussion␊
 * The IOMedia class is a random-access disk device abstraction.   It provides a␊
 * consistent interface for both real and virtual disk devices, for subdivisions␊
 * of disks such as partitions, for supersets of disks such as RAID volumes, and␊
 * so on.   It extends the IOStorage class by implementing the appropriate open,␊
 * close, read, write, and matching semantics for media objects.  The properties␊
 * it has reflect the properties of real disk devices,  such as ejectability and␊
 * writability.␊
 *␊
 * The read and write interfaces support byte-level access to the storage space,␊
 * with the appropriate deblocking handled by the block storage driver, however,␊
 * a typical client will want to get the natural block size in order to optimize␊
 * access to the real disk device.  A read or write is accepted so long as the␊
 * client's access is valid, the media is formatted and the transfer is within␊
 * the bounds of the media.  An optional non-zero base (offset) is then applied␊
 * before the read or write is passed to provider object.␊
 */␊
␊
class IOMedia : public IOStorage␊
{␊
    OSDeclareDefaultStructors(IOMedia)␊
␊
protected:␊
␊
    struct ExpansionData { /* */ };␊
    ExpansionData * _expansionData;␊
␊
    UInt32          _attributes;␊
␊
    bool            _isWhole;␊
    bool            _isWritable;␊
␊
    UInt64          _mediaBase;  /* (relative to the storage object below us) */␊
    UInt64          _mediaSize;␊
␊
    IOStorageAccess _openLevel;␊
    OSDictionary *  _openClients;␊
␊
    UInt32          _reserved0320;␊
␊
    UInt64          _preferredBlockSize;␊
␊
    /*␊
     * Free all of this object's outstanding resources.␊
     */␊
␊
    virtual void free();␊
␊
    /*!␊
     * @function handleOpen␊
     * @discussion␊
     * The handleOpen method grants or denies permission to access this object␊
     * to an interested client.  The argument is an IOStorageAccess value that␊
     * specifies the level of access desired -- reader or reader-writer.␊
     *␊
     * This method can be invoked to upgrade or downgrade the access level for␊
     * an existing client as well.  The previous access level will prevail for␊
     * upgrades that fail, of course.   A downgrade should never fail.  If the␊
     * new access level should be the same as the old for a given client, this␊
     * method will do nothing and return success.  In all cases, one, singular␊
     * close-per-client is expected for all opens-per-client received.␊
     *␊
     * This implementation replaces the IOService definition of handleOpen().␊
     * @param client␊
     * Client requesting the open.␊
     * @param options␊
     * Options for the open.  Set to zero.␊
     * @param access␊
     * Access level for the open.  Set to kIOStorageAccessReader or␊
     * kIOStorageAccessReaderWriter.␊
     * @result␊
     * Returns true if the open was successful, false otherwise.␊
     */␊
␊
    virtual bool handleOpen(IOService *  client,␊
                            IOOptionBits options,␊
                            void *       access);␊
␊
    /*!␊
     * @function handleIsOpen␊
     * @discussion␊
     * The handleIsOpen method determines whether the specified client, or any␊
     * client if none is specified, presently has an open on this object.␊
     *␊
     * This implementation replaces the IOService definition of handleIsOpen().␊
     * @param client␊
     * Client to check the open state of.  Set to zero to check the open state␊
     * of all clients.␊
     * @result␊
     * Returns true if the client was (or clients were) open, false otherwise.␊
     */␊
␊
    virtual bool handleIsOpen(const IOService * client) const;␊
␊
    /*!␊
     * @function handleClose␊
     * @discussion␊
     * The handleClose method closes the client's access to this object.␊
     *␊
     * This implementation replaces the IOService definition of handleClose().␊
     * @param client␊
     * Client requesting the close.␊
     * @param options␊
     * Options for the close.  Set to zero.␊
     */␊
␊
    virtual void handleClose(IOService * client, IOOptionBits options);␊
␊
public:␊
␊
    using IOStorage::read;␊
    using IOStorage::write;␊
␊
#ifndef __LP64__␊
    virtual bool init(UInt64         base,␊
                      UInt64         size,␊
                      UInt64         preferredBlockSize,␊
                      bool           isEjectable,␊
                      bool           isWhole,␊
                      bool           isWritable,␊
                      const char *   contentHint = 0,␊
                      OSDictionary * properties  = 0) __attribute__ ((deprecated));␊
#endif /* !__LP64__ */␊
␊
    /*␊
     * This method is called for each client interested in the services we␊
     * provide.  The superclass links us as a parent to this client in the␊
     * I/O Kit registry on success.␊
     */␊
␊
    virtual bool attachToChild(IORegistryEntry *       client,␊
                               const IORegistryPlane * plane);␊
␊
    /*␊
     * This method is called for each client that loses interest in the␊
     * services we provide.  The superclass unlinks us from this client␊
     * in the I/O Kit registry on success.␊
     */␊
␊
    virtual void detachFromChild(IORegistryEntry *       client,␊
                                 const IORegistryPlane * plane);␊
␊
    /*␊
     * Obtain this object's provider.  We override the superclass's method to␊
     * return a more specific subclass of OSObject -- IOStorage.  This method␊
     * serves simply as a convenience to subclass developers.␊
     */␊
␊
    virtual IOStorage * getProvider() const;␊
␊
    /*␊
     * Compare the properties in the supplied table to this object's properties.␊
     */␊
␊
    virtual bool matchPropertyTable(OSDictionary * table, SInt32 * score);␊
␊
    /*!␊
     * @function read␊
     * @discussion␊
     * Read data from the storage object at the specified byte offset into the␊
     * specified buffer, asynchronously.   When the read completes, the caller␊
     * will be notified via the specified completion action.␊
     *␊
     * The buffer will be retained for the duration of the read.␊
     * @param client␊
     * Client requesting the read.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     */␊
␊
    virtual void read(IOService *           client,␊
                      UInt64                byteStart,␊
                      IOMemoryDescriptor *  buffer,␊
                      IOStorageAttributes * attributes,␊
                      IOStorageCompletion * completion);␊
␊
    /*!␊
     * @function write␊
     * @discussion␊
     * Write data into the storage object at the specified byte offset from the␊
     * specified buffer, asynchronously.   When the write completes, the caller␊
     * will be notified via the specified completion action.␊
     *␊
     * The buffer will be retained for the duration of the write.␊
     * @param client␊
     * Client requesting the write.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     */␊
␊
    virtual void write(IOService *           client,␊
                       UInt64                byteStart,␊
                       IOMemoryDescriptor *  buffer,␊
                       IOStorageAttributes * attributes,␊
                       IOStorageCompletion * completion);␊
␊
    /*!␊
     * @function synchronizeCache␊
     * @discussion␊
     * Flush the cached data in the storage object, if any, synchronously.␊
     * @param client␊
     * Client requesting the cache synchronization.␊
     * @result␊
     * Returns the status of the cache synchronization.␊
     */␊
␊
    virtual IOReturn synchronizeCache(IOService * client);␊
␊
    /*!␊
     * @function discard␊
     * @discussion␊
     * Delete unused data from the storage object at the specified byte offset,␊
     * synchronously.␊
     * @param client␊
     * Client requesting the operation.␊
     * @param byteStart␊
     * Starting byte offset for the operation.␊
     * @param byteCount␊
     * Size of the operation.␊
     * @result␊
     * Returns the status of the operation.␊
     */␊
␊
    virtual IOReturn discard(IOService * client,␊
                             UInt64      byteStart,␊
                             UInt64      byteCount);␊
␊
    /*!␊
     * @function getPreferredBlockSize␊
     * @discussion␊
     * Ask the media object for its natural block size.  This information␊
     * is useful to clients that want to optimize access to the media.␊
     * @result␊
     * Natural block size, in bytes.␊
     */␊
␊
    virtual UInt64 getPreferredBlockSize() const;␊
␊
    /*!␊
     * @function getSize␊
     * @discussion␊
     * Ask the media object for its total length in bytes.␊
     * @result␊
     * Media size, in bytes.␊
     */␊
␊
    virtual UInt64 getSize() const;␊
␊
    /*!␊
     * @function getBase␊
     * @discussion␊
     * Ask the media object for its byte offset relative to its provider media␊
     * object below it in the storage hierarchy.␊
     * Media offset, in bytes.␊
     */␊
␊
    virtual UInt64 getBase() const;␊
␊
    /*!␊
     * @function isEjectable␊
     * @discussion␊
     * Ask the media object whether it is ejectable.␊
     * @result␊
     * Returns true if the media is ejectable, false otherwise.␊
     */␊
␊
    virtual bool isEjectable() const;␊
␊
    /*!␊
     * @function isFormatted␊
     * @discussion␊
     * Ask the media object whether it is formatted.␊
     * @result␊
     * Returns true if the media is formatted, false otherwise.␊
     */␊
␊
    virtual bool isFormatted() const;␊
␊
    /*!␊
     * @function isWhole␊
     * @discussion␊
     * Ask the media object whether it represents the whole disk.␊
     * @result␊
     * Returns true if the media represents the whole disk, false otherwise.␊
     */␊
␊
    virtual bool isWhole() const;␊
␊
    /*!␊
     * @function isWritable␊
     * @discussion␊
     * Ask the media object whether it is writable.␊
     * @result␊
     * Returns true if the media is writable, false otherwise.␊
     */␊
␊
    virtual bool isWritable() const;␊
␊
    /*!␊
     * @function getContent␊
     * @discussion␊
     * Ask the media object for a description of its contents.  The description␊
     * is the same as the hint at the time of the object's creation,  but it is␊
     * possible that the description has been overridden by a client (which has probed␊
     * the media and identified the content correctly) of the media object.  It␊
     * is more accurate than the hint for this reason.  The string is formed in␊
     * the likeness of Apple's "Apple_HFS" strings or in the likeness of a UUID.␊
     *␊
     * The content description can be overridden by any client that matches onto␊
     * this media object with a match category of kIOStorageCategory.  The media␊
     * object checks for a kIOMediaContentMaskKey property in the client, and if␊
     * it finds one, it copies it into kIOMediaContentKey property.␊
     * @result␊
     * Description of media's contents.␊
     */␊
␊
    virtual const char * getContent() const;␊
␊
    /*!␊
     * @function getContentHint␊
     * @discussion␊
     * Ask the media object for a hint of its contents.  The hint is set at the␊
     * time of the object's creation, should the creator have a clue as to what␊
     * it may contain.  The hint string does not change for the lifetime of the␊
     * object and is also formed in the likeness of Apple's "Apple_HFS" strings␊
     * or in the likeness of a UUID.␊
     * @result␊
     * Hint of media's contents.␊
     */␊
␊
    virtual const char * getContentHint() const;␊
␊
    /*!␊
     * @function init␊
     * @discussion␊
     * Initialize this object's minimal state.␊
     * @param base␊
     * Media offset, in bytes.␊
     * @param size␊
     * Media size, in bytes.␊
     * @param preferredBlockSize␊
     * Natural block size, in bytes.␊
     * @param attributes␊
     * Media attributes, such as ejectability and removability.  See␊
     * IOMediaAttributeMask.␊
     * @param isWhole␊
     * Indicates whether the media represents the whole disk.␊
     * @param isWritable␊
     * Indicates whether the media is writable.␊
     * @param contentHint␊
     * Hint of media's contents (optional).  See getContentHint().␊
     * @param properties␊
     * Substitute property table for this object (optional).␊
     * @result␊
     * Returns true on success, false otherwise.␊
     */␊
␊
    virtual bool init(UInt64               base,␊
                      UInt64               size,␊
                      UInt64               preferredBlockSize,␊
                      IOMediaAttributeMask attributes,␊
                      bool                 isWhole,␊
                      bool                 isWritable,␊
                      const char *         contentHint = 0,␊
                      OSDictionary *       properties  = 0); /* 10.2.0 */␊
␊
    /*!␊
     * @function getAttributes␊
     * @discussion␊
     * Ask the media object for its attributes.␊
     * @result␊
     * Media attributes, such as ejectability and removability.  See␊
     * IOMediaAttributeMask.␊
     */␊
␊
    virtual IOMediaAttributeMask getAttributes() const; /* 10.2.0 */␊
␊
#ifdef __LP64__␊
    OSMetaClassDeclareReservedUnused(IOMedia,  0);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  1);␊
#else /* !__LP64__ */␊
    OSMetaClassDeclareReservedUsed(IOMedia,  0);␊
    OSMetaClassDeclareReservedUsed(IOMedia,  1);␊
#endif /* !__LP64__ */␊
    OSMetaClassDeclareReservedUnused(IOMedia,  2);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  3);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  4);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  5);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  6);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  7);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  8);␊
    OSMetaClassDeclareReservedUnused(IOMedia,  9);␊
    OSMetaClassDeclareReservedUnused(IOMedia, 10);␊
    OSMetaClassDeclareReservedUnused(IOMedia, 11);␊
    OSMetaClassDeclareReservedUnused(IOMedia, 12);␊
    OSMetaClassDeclareReservedUnused(IOMedia, 13);␊
    OSMetaClassDeclareReservedUnused(IOMedia, 14);␊
    OSMetaClassDeclareReservedUnused(IOMedia, 15);␊
};␊
␊
#endif /* __cplusplus */␊
#endif /* KERNEL */␊
#endif /* !_IOMEDIA_H */␊
 ␊
 typedef UInt32 IOMediaAttributeMask;␊
 ␊
-#ifdef KERNEL␊
-#ifdef __cplusplus␊
-␊
-/*␊
- * Kernel␊
- */␊
-␊
-#include <IOKit/storage/IOStorage.h>␊
-␊
-/*!␊
- * @class IOMedia␊
- * @abstract␊
- * A random-access disk device abstraction.␊
- * @discussion␊
- * The IOMedia class is a random-access disk device abstraction.   It provides a␊
- * consistent interface for both real and virtual disk devices, for subdivisions␊
- * of disks such as partitions, for supersets of disks such as RAID volumes, and␊
- * so on.   It extends the IOStorage class by implementing the appropriate open,␊
- * close, read, write, and matching semantics for media objects.  The properties␊
- * it has reflect the properties of real disk devices,  such as ejectability and␊
- * writability.␊
- *␊
- * The read and write interfaces support byte-level access to the storage space,␊
- * with the appropriate deblocking handled by the block storage driver, however,␊
- * a typical client will want to get the natural block size in order to optimize␊
- * access to the real disk device.  A read or write is accepted so long as the␊
- * client's access is valid, the media is formatted and the transfer is within␊
- * the bounds of the media.  An optional non-zero base (offset) is then applied␊
- * before the read or write is passed to provider object.␊
- */␊
-␊
-class IOMedia : public IOStorage␊
-{␊
-    OSDeclareDefaultStructors(IOMedia)␊
-␊
-protected:␊
-␊
-    struct ExpansionData { /* */ };␊
-    ExpansionData * _expansionData;␊
-␊
-    UInt32          _attributes;␊
-␊
-    bool            _isWhole;␊
-    bool            _isWritable;␊
-␊
-    UInt64          _mediaBase;  /* (relative to the storage object below us) */␊
-    UInt64          _mediaSize;␊
-␊
-    IOStorageAccess _openLevel;␊
-    OSDictionary *  _openClients;␊
-␊
-    UInt32          _reserved0320;␊
-␊
-    UInt64          _preferredBlockSize;␊
-␊
-    /*␊
-     * Free all of this object's outstanding resources.␊
-     */␊
-␊
-    virtual void free();␊
-␊
-    /*!␊
-     * @function handleOpen␊
-     * @discussion␊
-     * The handleOpen method grants or denies permission to access this object␊
-     * to an interested client.  The argument is an IOStorageAccess value that␊
-     * specifies the level of access desired -- reader or reader-writer.␊
-     *␊
-     * This method can be invoked to upgrade or downgrade the access level for␊
-     * an existing client as well.  The previous access level will prevail for␊
-     * upgrades that fail, of course.   A downgrade should never fail.  If the␊
-     * new access level should be the same as the old for a given client, this␊
-     * method will do nothing and return success.  In all cases, one, singular␊
-     * close-per-client is expected for all opens-per-client received.␊
-     *␊
-     * This implementation replaces the IOService definition of handleOpen().␊
-     * @param client␊
-     * Client requesting the open.␊
-     * @param options␊
-     * Options for the open.  Set to zero.␊
-     * @param access␊
-     * Access level for the open.  Set to kIOStorageAccessReader or␊
-     * kIOStorageAccessReaderWriter.␊
-     * @result␊
-     * Returns true if the open was successful, false otherwise.␊
-     */␊
-␊
-    virtual bool handleOpen(IOService *  client,␊
-                            IOOptionBits options,␊
-                            void *       access);␊
-␊
-    /*!␊
-     * @function handleIsOpen␊
-     * @discussion␊
-     * The handleIsOpen method determines whether the specified client, or any␊
-     * client if none is specified, presently has an open on this object.␊
-     *␊
-     * This implementation replaces the IOService definition of handleIsOpen().␊
-     * @param client␊
-     * Client to check the open state of.  Set to zero to check the open state␊
-     * of all clients.␊
-     * @result␊
-     * Returns true if the client was (or clients were) open, false otherwise.␊
-     */␊
-␊
-    virtual bool handleIsOpen(const IOService * client) const;␊
-␊
-    /*!␊
-     * @function handleClose␊
-     * @discussion␊
-     * The handleClose method closes the client's access to this object.␊
-     *␊
-     * This implementation replaces the IOService definition of handleClose().␊
-     * @param client␊
-     * Client requesting the close.␊
-     * @param options␊
-     * Options for the close.  Set to zero.␊
-     */␊
-␊
-    virtual void handleClose(IOService * client, IOOptionBits options);␊
-␊
-public:␊
-␊
-    using IOStorage::read;␊
-    using IOStorage::write;␊
-␊
-#ifndef __LP64__␊
-    virtual bool init(UInt64         base,␊
-                      UInt64         size,␊
-                      UInt64         preferredBlockSize,␊
-                      bool           isEjectable,␊
-                      bool           isWhole,␊
-                      bool           isWritable,␊
-                      const char *   contentHint = 0,␊
-                      OSDictionary * properties  = 0) __attribute__ ((deprecated));␊
-#endif /* !__LP64__ */␊
-␊
-    /*␊
-     * This method is called for each client interested in the services we␊
-     * provide.  The superclass links us as a parent to this client in the␊
-     * I/O Kit registry on success.␊
-     */␊
-␊
-    virtual bool attachToChild(IORegistryEntry *       client,␊
-                               const IORegistryPlane * plane);␊
-␊
-    /*␊
-     * This method is called for each client that loses interest in the␊
-     * services we provide.  The superclass unlinks us from this client␊
-     * in the I/O Kit registry on success.␊
-     */␊
-␊
-    virtual void detachFromChild(IORegistryEntry *       client,␊
-                                 const IORegistryPlane * plane);␊
-␊
-    /*␊
-     * Obtain this object's provider.  We override the superclass's method to␊
-     * return a more specific subclass of OSObject -- IOStorage.  This method␊
-     * serves simply as a convenience to subclass developers.␊
-     */␊
-␊
-    virtual IOStorage * getProvider() const;␊
-␊
-    /*␊
-     * Compare the properties in the supplied table to this object's properties.␊
-     */␊
-␊
-    virtual bool matchPropertyTable(OSDictionary * table, SInt32 * score);␊
-␊
-    /*!␊
-     * @function read␊
-     * @discussion␊
-     * Read data from the storage object at the specified byte offset into the␊
-     * specified buffer, asynchronously.   When the read completes, the caller␊
-     * will be notified via the specified completion action.␊
-     *␊
-     * The buffer will be retained for the duration of the read.␊
-     * @param client␊
-     * Client requesting the read.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     */␊
-␊
-    virtual void read(IOService *           client,␊
-                      UInt64                byteStart,␊
-                      IOMemoryDescriptor *  buffer,␊
-                      IOStorageAttributes * attributes,␊
-                      IOStorageCompletion * completion);␊
-␊
-    /*!␊
-     * @function write␊
-     * @discussion␊
-     * Write data into the storage object at the specified byte offset from the␊
-     * specified buffer, asynchronously.   When the write completes, the caller␊
-     * will be notified via the specified completion action.␊
-     *␊
-     * The buffer will be retained for the duration of the write.␊
-     * @param client␊
-     * Client requesting the write.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     */␊
-␊
-    virtual void write(IOService *           client,␊
-                       UInt64                byteStart,␊
-                       IOMemoryDescriptor *  buffer,␊
-                       IOStorageAttributes * attributes,␊
-                       IOStorageCompletion * completion);␊
-␊
-    /*!␊
-     * @function synchronizeCache␊
-     * @discussion␊
-     * Flush the cached data in the storage object, if any, synchronously.␊
-     * @param client␊
-     * Client requesting the cache synchronization.␊
-     * @result␊
-     * Returns the status of the cache synchronization.␊
-     */␊
-␊
-    virtual IOReturn synchronizeCache(IOService * client);␊
-␊
-    /*!␊
-     * @function discard␊
-     * @discussion␊
-     * Delete unused data from the storage object at the specified byte offset,␊
-     * synchronously.␊
-     * @param client␊
-     * Client requesting the operation.␊
-     * @param byteStart␊
-     * Starting byte offset for the operation.␊
-     * @param byteCount␊
-     * Size of the operation.␊
-     * @result␊
-     * Returns the status of the operation.␊
-     */␊
-␊
-    virtual IOReturn discard(IOService * client,␊
-                             UInt64      byteStart,␊
-                             UInt64      byteCount);␊
-␊
-    /*!␊
-     * @function getPreferredBlockSize␊
-     * @discussion␊
-     * Ask the media object for its natural block size.  This information␊
-     * is useful to clients that want to optimize access to the media.␊
-     * @result␊
-     * Natural block size, in bytes.␊
-     */␊
-␊
-    virtual UInt64 getPreferredBlockSize() const;␊
-␊
-    /*!␊
-     * @function getSize␊
-     * @discussion␊
-     * Ask the media object for its total length in bytes.␊
-     * @result␊
-     * Media size, in bytes.␊
-     */␊
-␊
-    virtual UInt64 getSize() const;␊
-␊
-    /*!␊
-     * @function getBase␊
-     * @discussion␊
-     * Ask the media object for its byte offset relative to its provider media␊
-     * object below it in the storage hierarchy.␊
-     * Media offset, in bytes.␊
-     */␊
-␊
-    virtual UInt64 getBase() const;␊
-␊
-    /*!␊
-     * @function isEjectable␊
-     * @discussion␊
-     * Ask the media object whether it is ejectable.␊
-     * @result␊
-     * Returns true if the media is ejectable, false otherwise.␊
-     */␊
-␊
-    virtual bool isEjectable() const;␊
-␊
-    /*!␊
-     * @function isFormatted␊
-     * @discussion␊
-     * Ask the media object whether it is formatted.␊
-     * @result␊
-     * Returns true if the media is formatted, false otherwise.␊
-     */␊
-␊
-    virtual bool isFormatted() const;␊
-␊
-    /*!␊
-     * @function isWhole␊
-     * @discussion␊
-     * Ask the media object whether it represents the whole disk.␊
-     * @result␊
-     * Returns true if the media represents the whole disk, false otherwise.␊
-     */␊
-␊
-    virtual bool isWhole() const;␊
-␊
-    /*!␊
-     * @function isWritable␊
-     * @discussion␊
-     * Ask the media object whether it is writable.␊
-     * @result␊
-     * Returns true if the media is writable, false otherwise.␊
-     */␊
-␊
-    virtual bool isWritable() const;␊
-␊
-    /*!␊
-     * @function getContent␊
-     * @discussion␊
-     * Ask the media object for a description of its contents.  The description␊
-     * is the same as the hint at the time of the object's creation,  but it is␊
-     * possible that the description has been overridden by a client (which has probed␊
-     * the media and identified the content correctly) of the media object.  It␊
-     * is more accurate than the hint for this reason.  The string is formed in␊
-     * the likeness of Apple's "Apple_HFS" strings or in the likeness of a UUID.␊
-     *␊
-     * The content description can be overridden by any client that matches onto␊
-     * this media object with a match category of kIOStorageCategory.  The media␊
-     * object checks for a kIOMediaContentMaskKey property in the client, and if␊
-     * it finds one, it copies it into kIOMediaContentKey property.␊
-     * @result␊
-     * Description of media's contents.␊
-     */␊
-␊
-    virtual const char * getContent() const;␊
-␊
-    /*!␊
-     * @function getContentHint␊
-     * @discussion␊
-     * Ask the media object for a hint of its contents.  The hint is set at the␊
-     * time of the object's creation, should the creator have a clue as to what␊
-     * it may contain.  The hint string does not change for the lifetime of the␊
-     * object and is also formed in the likeness of Apple's "Apple_HFS" strings␊
-     * or in the likeness of a UUID.␊
-     * @result␊
-     * Hint of media's contents.␊
-     */␊
-␊
-    virtual const char * getContentHint() const;␊
-␊
-    /*!␊
-     * @function init␊
-     * @discussion␊
-     * Initialize this object's minimal state.␊
-     * @param base␊
-     * Media offset, in bytes.␊
-     * @param size␊
-     * Media size, in bytes.␊
-     * @param preferredBlockSize␊
-     * Natural block size, in bytes.␊
-     * @param attributes␊
-     * Media attributes, such as ejectability and removability.  See␊
-     * IOMediaAttributeMask.␊
-     * @param isWhole␊
-     * Indicates whether the media represents the whole disk.␊
-     * @param isWritable␊
-     * Indicates whether the media is writable.␊
-     * @param contentHint␊
-     * Hint of media's contents (optional).  See getContentHint().␊
-     * @param properties␊
-     * Substitute property table for this object (optional).␊
-     * @result␊
-     * Returns true on success, false otherwise.␊
-     */␊
-␊
-    virtual bool init(UInt64               base,␊
-                      UInt64               size,␊
-                      UInt64               preferredBlockSize,␊
-                      IOMediaAttributeMask attributes,␊
-                      bool                 isWhole,␊
-                      bool                 isWritable,␊
-                      const char *         contentHint = 0,␊
-                      OSDictionary *       properties  = 0); /* 10.2.0 */␊
-␊
-    /*!␊
-     * @function getAttributes␊
-     * @discussion␊
-     * Ask the media object for its attributes.␊
-     * @result␊
-     * Media attributes, such as ejectability and removability.  See␊
-     * IOMediaAttributeMask.␊
-     */␊
-␊
-    virtual IOMediaAttributeMask getAttributes() const; /* 10.2.0 */␊
-␊
-#ifdef __LP64__␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  0);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  1);␊
-#else /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUsed(IOMedia,  0);␊
-    OSMetaClassDeclareReservedUsed(IOMedia,  1);␊
-#endif /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  2);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  3);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  4);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  5);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  6);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  7);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  8);␊
-    OSMetaClassDeclareReservedUnused(IOMedia,  9);␊
-    OSMetaClassDeclareReservedUnused(IOMedia, 10);␊
-    OSMetaClassDeclareReservedUnused(IOMedia, 11);␊
-    OSMetaClassDeclareReservedUnused(IOMedia, 12);␊
-    OSMetaClassDeclareReservedUnused(IOMedia, 13);␊
-    OSMetaClassDeclareReservedUnused(IOMedia, 14);␊
-    OSMetaClassDeclareReservedUnused(IOMedia, 15);␊
-};␊
-␊
-#endif /* __cplusplus */␊
-#endif /* KERNEL */␊
 #endif /* !_IOMEDIA_H */␊

-119
120 120
121 121
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 122
+␊
#pragma pack(pop)                        /* (reset to default struct packing) */␊
␊
#ifdef KERNEL␊
#ifdef __cplusplus␊
␊
/*␊
 * Kernel␊
 */␊
␊
#include <IOKit/storage/IOPartitionScheme.h>␊
␊
/*␊
 * Class␊
 */␊
␊
class IOApplePartitionScheme : public IOPartitionScheme␊
{␊
    OSDeclareDefaultStructors(IOApplePartitionScheme);␊
␊
protected:␊
␊
    struct ExpansionData { /* */ };␊
    ExpansionData * _expansionData;␊
␊
    OSSet * _partitions;    /* (set of media objects representing partitions) */␊
␊
    /*␊
     * Free all of this object's outstanding resources.␊
     */␊
␊
    virtual void free(void);␊
␊
    /*␊
     * Scan the provider media for an Apple partition map.  Returns the set␊
     * of media objects representing each of the partitions (the retain for␊
     * the set is passed to the caller), or null should no partition map be␊
     * found.  The default probe score can be adjusted up or down, based on␊
     * the confidence of the scan.␊
     */␊
␊
    virtual OSSet * scan(SInt32 * score);␊
␊
    /*␊
     * Ask whether the given partition appears to be corrupt.  A partition that␊
     * is corrupt will cause the failure of the Apple partition map recognition␊
     * altogether.␊
     */␊
␊
    virtual bool isPartitionCorrupt( dpme * partition,␊
                                     UInt32 partitionID,␊
                                     UInt32 partitionBlockSize );␊
␊
    /*␊
     * Ask whether the given partition appears to be invalid.  A partition that␊
     * is invalid will cause it to be skipped in the scan, but will not cause a␊
     * failure of the Apple partition map recognition.␊
     */␊
␊
    virtual bool isPartitionInvalid( dpme * partition,␊
                                     UInt32 partitionID,␊
                                     UInt32 partitionBlockSize );␊
␊
    /*␊
     * Instantiate a new media object to represent the given partition.␊
     */␊
␊
    virtual IOMedia * instantiateMediaObject( dpme * partition,␊
                                              UInt32 partitionID,␊
                                              UInt32 partitionBlockSize );␊
␊
    /*␊
     * Allocate a new media object (called from instantiateMediaObject).␊
     */␊
␊
    virtual IOMedia * instantiateDesiredMediaObject(␊
                                                    dpme * partition,␊
                                                    UInt32 partitionID,␊
                                                    UInt32 partitionBlockSize );␊
␊
#ifndef __LP64__␊
    /*␊
     * Attach the given media object to the device tree plane.␊
     */␊
␊
    virtual bool attachMediaObjectToDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
␊
    /*␊
     * Detach the given media object from the device tree plane.␊
     */␊
␊
    virtual void detachMediaObjectFromDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
#endif /* !__LP64__ */␊
␊
public:␊
␊
    /*␊
     * Initialize this object's minimal state.␊
     */␊
␊
    virtual bool init(OSDictionary * properties = 0);␊
␊
    /*␊
     * Determine whether the provider media contains an Apple partition map.␊
     */␊
␊
    virtual IOService * probe(IOService * provider, SInt32 * score);␊
␊
    /*␊
     * Publish the new media objects which represent our partitions.␊
     */␊
␊
    virtual bool start(IOService * provider);␊
␊
    /*␊
     * Clean up after the media objects we published before terminating.␊
     */␊
␊
    virtual void stop(IOService * provider);␊
␊
    /*␊
     * Request that the provider media be re-scanned for partitions.␊
     */␊
␊
    virtual IOReturn requestProbe(IOOptionBits options);␊
␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  0);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  1);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  2);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  3);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  4);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  5);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  6);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  7);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  8);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  9);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 10);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 11);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 12);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 13);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 14);␊
    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 15);␊
};␊
␊
#endif /* __cplusplus */␊
#endif /* KERNEL */␊
#endif /* !_IOAPPLEPARTITIONSCHEME_H */␊
 ␊
 #pragma pack(pop)                        /* (reset to default struct packing) */␊
 ␊
-#ifdef KERNEL␊
-#ifdef __cplusplus␊
-␊
-/*␊
- * Kernel␊
- */␊
-␊
-#include <IOKit/storage/IOPartitionScheme.h>␊
-␊
-/*␊
- * Class␊
- */␊
-␊
-class IOApplePartitionScheme : public IOPartitionScheme␊
-{␊
-    OSDeclareDefaultStructors(IOApplePartitionScheme);␊
-␊
-protected:␊
-␊
-    struct ExpansionData { /* */ };␊
-    ExpansionData * _expansionData;␊
-␊
-    OSSet * _partitions;    /* (set of media objects representing partitions) */␊
-␊
-    /*␊
-     * Free all of this object's outstanding resources.␊
-     */␊
-␊
-    virtual void free(void);␊
-␊
-    /*␊
-     * Scan the provider media for an Apple partition map.  Returns the set␊
-     * of media objects representing each of the partitions (the retain for␊
-     * the set is passed to the caller), or null should no partition map be␊
-     * found.  The default probe score can be adjusted up or down, based on␊
-     * the confidence of the scan.␊
-     */␊
-␊
-    virtual OSSet * scan(SInt32 * score);␊
-␊
-    /*␊
-     * Ask whether the given partition appears to be corrupt.  A partition that␊
-     * is corrupt will cause the failure of the Apple partition map recognition␊
-     * altogether.␊
-     */␊
-␊
-    virtual bool isPartitionCorrupt( dpme * partition,␊
-                                     UInt32 partitionID,␊
-                                     UInt32 partitionBlockSize );␊
-␊
-    /*␊
-     * Ask whether the given partition appears to be invalid.  A partition that␊
-     * is invalid will cause it to be skipped in the scan, but will not cause a␊
-     * failure of the Apple partition map recognition.␊
-     */␊
-␊
-    virtual bool isPartitionInvalid( dpme * partition,␊
-                                     UInt32 partitionID,␊
-                                     UInt32 partitionBlockSize );␊
-␊
-    /*␊
-     * Instantiate a new media object to represent the given partition.␊
-     */␊
-␊
-    virtual IOMedia * instantiateMediaObject( dpme * partition,␊
-                                              UInt32 partitionID,␊
-                                              UInt32 partitionBlockSize );␊
-␊
-    /*␊
-     * Allocate a new media object (called from instantiateMediaObject).␊
-     */␊
-␊
-    virtual IOMedia * instantiateDesiredMediaObject(␊
-                                                    dpme * partition,␊
-                                                    UInt32 partitionID,␊
-                                                    UInt32 partitionBlockSize );␊
-␊
-#ifndef __LP64__␊
-    /*␊
-     * Attach the given media object to the device tree plane.␊
-     */␊
-␊
-    virtual bool attachMediaObjectToDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
-␊
-    /*␊
-     * Detach the given media object from the device tree plane.␊
-     */␊
-␊
-    virtual void detachMediaObjectFromDeviceTree(IOMedia * media) __attribute__ ((deprecated));␊
-#endif /* !__LP64__ */␊
-␊
-public:␊
-␊
-    /*␊
-     * Initialize this object's minimal state.␊
-     */␊
-␊
-    virtual bool init(OSDictionary * properties = 0);␊
-␊
-    /*␊
-     * Determine whether the provider media contains an Apple partition map.␊
-     */␊
-␊
-    virtual IOService * probe(IOService * provider, SInt32 * score);␊
-␊
-    /*␊
-     * Publish the new media objects which represent our partitions.␊
-     */␊
-␊
-    virtual bool start(IOService * provider);␊
-␊
-    /*␊
-     * Clean up after the media objects we published before terminating.␊
-     */␊
-␊
-    virtual void stop(IOService * provider);␊
-␊
-    /*␊
-     * Request that the provider media be re-scanned for partitions.␊
-     */␊
-␊
-    virtual IOReturn requestProbe(IOOptionBits options);␊
-␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  0);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  1);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  2);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  3);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  4);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  5);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  6);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  7);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  8);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme,  9);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 10);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 11);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 12);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 13);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 14);␊
-    OSMetaClassDeclareReservedUnused(IOApplePartitionScheme, 15);␊
-};␊
-␊
-#endif /* __cplusplus */␊
-#endif /* KERNEL */␊
 #endif /* !_IOAPPLEPARTITIONSCHEME_H */␊

-242
243 243
244 244
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 
434 
435 
436 
437 
438 
439 
440 
441 
442 
443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 
475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
485 
486 
487 
488 
489 
490 
491 
492 
493 
494 
495 
496 
497 
498 
499 
500 
501 
502 
503 
504 
505 
506 
507 
508 
509 
510 
511 
512 
513 
514 
515 
516 
517 
518 
519 
520 
521 
522 
523 
524 
525 
526 
527 
528 
529 
530 
531 
532 
533 
534 
535 
536 
537 
538 
539 
540 
541 
542 
543 
544 
545 
546 
547 
548 
549 
550 
551 
552 
553 
554 
555 
556 
557 
558 
559 
560 
561 
562 
563 
564 
565 
566 
567 
568 
569 
570 
571 
572 
573 
574 
575 
576 
577 
578 
579 
580 
581 
582 
583 
584 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 
595 
596 
597 
598 
599 
600 
601 
602 
603 
604 
605 
606 
607 
608 
609 
610 
611 
612 
613 
614 
615 
616 
617 
618 
619 
620 
621 
622 
623 
624 
625 
626 
627 
628 
629 
630 
631 
632 
633 
634 
635 
636 
637 
638 
639 
640 
641 
642 
643 
644 
645 
646 
647 
648 
649 
650 
651 
652 
653 
654 
655 
656 
657 
658 
659 
660 
661 
662 
663 
664 
665 
666 
667 
668 
669 
670 
671 
672 
673 
674 
675 
676 
677 
678 
679 
680 
681 
682 
683 
684 
685 
686 
687 
688 
689 
690 
691 
692 
693 
694 
695 
696 
697 
698 
699 
700 
701 
702 
703 
704 
705 
706 
707 
708 
709 
710 
711 
712 
713 
714 
715 
716 
717 
718 
719 
720 
721 
722 
723 
724 
725 
726 
727 
728 
729 
730 
731 
732 
733 
734 
735 
736 
737 
738 
739 
740 
741 
742 
743 
744 
745 
746 
747 
748 
749 
750 
751 
752 
753 
754 
755 
756 
757 
758 
759 
760 
761 
762 
763 
764 
765 
766 
767 
768 
769 
770 
771 
772 
773 
774 
775 
776 
777 
778 
779 
780 
781 
782 
783 
784 
785 
786 
787 
788 
789 
790 
791 
792 
793 
794 
795 
796 
797 
798 
799 
800 
801 
802 
803 
804 
805 
806 
807 
808 
809 
810 
811 
812 
813 
814 
815 
816 
817 
818 
819 
820 
821 
822 
823 
824 
825 
826 
827 
828 
829 
830 
831 
832 
833 
834 
835 
836 
837 
838 
839 
840 
841 
842 
843 
844 
845 
846 
847 
848 
849 
850 
851 
852 
853 
854 
855 
856 
857 
858 
859 
860 
861 
862 
863 
864 
865 
866 
867 
868 
869 
870 
871 
872 
873 
874 
875 
876 
877 
878 
879 
880 
881 
882 
883 
884 
885 
886 
887 
888 
889 
890 
891 
892 
893 
894 
895 
896 
897 
898 
899 
900 
901 
902 
903 
904 
905 
906 
907 
908 
909 
910 
911 
912 
913 
914 
915 
916 
917 
918 
919 
920 
921 
922 
923 
924 
925 
926 
927 
928 
929 
930 
931 
932 
933 
934 
935 
936 
937 
938 
939 
940 
941 
942 
943 
944 
945 
946 
947 
948 
949 
950 
951 
952 
953 
954 
955 
956 
957 
958 
959 
960 
961 
962 
963 
964 
965 
966 
967 
968 
969 
970 
971 
972 
973 
974 
975 
976 
977 
978 
979 
980 
981 
982 
983 
984 
985 
986 
987 
988 
989 
990 
991 
992 
993 
994 
995 
996 
997 
998 
999 
1000 
1001 
1002 
1003 
1004 
1005 
1006 
1007 
1008 
1009 
1010 
1011 
1012 
1013 
1014 
1015 
1016 
1017 
1018 
1019 
1020 
1021 
1022 
1023 
1024 
1025 
1026 
1027 
1028 
1029 
1030 
1031 
1032 
1033 
1034 
1035 
1036 
1037 
1038 
1039 
1040 
1041 
1042 
1043 
1044 
1045 
1046 
1047 
1048 
1049 
1050 
1051 
1052 
1053 
1054 
1055 
1056 
1057 
1058 
1059 
1060 
1061 
1062 
1063 
1064 
1065 
1066 
1067 
1068 
1069 
1070 
1071 
1072 
1073 
1074 
1075 
1076 
1077 
1078 
1079 
1080 
1081 
1082 
1083 
1084 
1085 
1086 
1087 
1088 
1089 
1090 
1091 
1092 
1093 
1094 
1095 
1096 
1097 
1098 
1099 
1100 
1101 
1102 
1103 
1104 
1105 
1106 
1107 
1108 
1109 
1110 
1111 
1112 
1113 
1114 
1115 
1116 
1117 
1118 
1119 
1120 
1121 
1122 
1123 
1124 
1125 
1126 
1127 
1128 
1129 
1130 
1131 
1132 
1133 
1134 
1135 
1136 
1137 
1138 
1139 
1140 
1141 
1142 
1143 
1144 
1145 
1146 
1147 
1148 
1149 
1150 
1151 
1152 
1153 
1154 
1155 
1156 
1157 
1158 
1159 
1160 
1161 
1162 
1163 
1164 
1165 
1166 
1167 
1168 
1169 
1170 
1171 
1172 
1173 
1174 
1175 
1176 
1177 
1178 
1179 
1180 
1181 
1182 
1183 
1184 
1185 
1186 
1187 
1188 
1189 
1190 
1191 
1192 
1193 
1194 
1195 
1196 
1197 
1198 
1199 
1200 
1201 
1202 
1203 
1204 
1205 
1206 
1207 
1208 
1209 
1210 
1211 
1212 
1213 
1214 
1215 
1216 
1217 
1218 
1219 
1220 
1221 
1222 
1223 
1224 
1225 
1226 
1227 
1228 
1229 
1230 
1231 
1232 
1233 
1234 
1235 
1236 
1237 
1238 
1239 
1240 
1241 
1242 
1243 
1244 
1245 
1246 
1247 
1248 
1249 
1250 
1251 
1252 
1253 
1254 
1255 
1256 
1257 
1258 
1259 
1260 
1261 
1262 
1263 
1264 
1265 
1266 
1267 
1268 
1269 
1270 
1271 
1272 
1273 
1274 
1275 
1276 
1277 
1278 
1279 
1280 
1281 
1282 
1283 
1284 
1285 
1286 
1287 
1288 
1289 
1290 
1291 
1292 
1293 
1294 
1295 
1296 
1297 
1298 
1299 
1300 
1301 
1302 
1303 
1304 
1305 
1306 
1307 
1308 
1309 
1310 
1311 
1312 
1313 
1314 
1315 
1316 
1317 
1318 
1319 
1320 
1321 
1322 
1323 
1324 
1325 
1326 
1327 
1328 
1329 
1330 
1331 
1332 
1333 
1334 
1335 
1336 
1337 
1338 
1339 
1340 
1341 
1342 
1343 
1344 
1345 
1346 
1347 
1348 
1349 
1350 
1351 
1352 
1353 
1354 
1355 
1356 
1357 
1358 
1359 
1360 
1361 
1362 
1363 
1364 
1365 
1366 
1367 
1368 
1369 
1370 
1371 
1372 
1373 
1374 
1375 
1376 
1377 
1378 
1379 
1380 
1381 
1382 
1383 
1384 
1385 
1386 
1387 
1388 
1389 
1390 
1391 
1392 
1393 
1394 
1395 
1396 
1397 
1398 
1399 
1400 
1401 
1402 
1403 
1404 
1405 
1406 
1407 
1408 
1409 
1410 
1411 
1412 
1413 
1414 
1415 
1416 
1417 
1418 
1419 
1420 
1421 
1422 
1423 
1424 
1425 
1426 
1427 
1428 
1429 
1430 
1431 
1432 
1433 
1434 
1435 
1436 
1437 
1438 
1439 
1440 
1441 
1442 
1443 
1444 
1445 
1446 
1447 
1448 
1449 
1450 
1451 
1452 
1453 
1454 
1455 
1456 
1457 
1458 
1459 
1460 
1461 
1462 
1463 
1464 
1465 
1466 
1467 
1468 
1469 
1470 
1471 
1472 
1473 
1474 
1475 
1476 
1477 
1478 
1479 
1480 
1481 
1482 
1483 
1484 
1485 
1486 
1487 
1488 
1489 
1490 
1491 
1492 
1493 
1494 
1495 
1496 
1497 
1498 
1499 
1500 
1501 
1502 
1503 
1504 
1505 
1506 
1507 
1508 
1509 
1510 
1511 
1512 
1513 
1514 
1515 
1516 
1517 
1518 
1519 
1520 
1521 
1522 
1523 
1524 
1525 
1526 
1527 
1528 
1529 
1530 
1531 
1532 
1533 
1534 
1535 
1536 
1537 
1538 
1539 
1540 
1541 
1542 
1543 
1544 
1545 
1546 
1547 
1548 
1549 
1550 
1551 
1552 
1553 
1554 
1555 
1556 
1557 
1558 
1559 
1560 
1561 
1562 
1563 
1564 
1565 
1566 
1567 
1568 
1569 
1570 
1571 245
+␊
typedef UInt32 IOMediaState;␊
␊
#ifdef KERNEL␊
#ifdef __cplusplus␊
␊
/*␊
 * Kernel␊
 */␊
␊
#include <IOKit/storage/IOBlockStorageDevice.h>␊
#include <IOKit/storage/IOMedia.h>␊
#include <IOKit/storage/IOStorage.h>␊
#include <kern/thread_call.h>␊
␊
/*!␊
 * @class IOBlockStorageDriver␊
 * @abstract␊
 * The common base class for generic block storage drivers.␊
 * @discussion␊
 * The IOBlockStorageDriver class is the common base class for generic block␊
 * storage drivers.  It matches and communicates via an IOBlockStorageDevice␊
 * interface, and connects to the remainder of the storage framework via the␊
 * IOStorage protocol. It extends the IOStorage protocol by implementing the␊
 * appropriate open and close semantics, deblocking for unaligned transfers,␊
 * polling for ejectable media, locking and ejection policies, media object␊
 * creation and tear-down, and statistics gathering and reporting.␊
 *␊
 * Block storage drivers are split into two parts: the generic driver handles␊
 * all generic device issues, independent of the lower-level transport␊
 * mechanism (e.g. SCSI, ATA, USB, FireWire). All storage operations␊
 * at the generic driver level are translated into a series of generic␊
 * device operations. These operations are passed via the IOBlockStorageDevice␊
 * nub to a transport driver, which implements the appropriate␊
 * transport-dependent protocol to execute these operations.␊
 *␊
 * To determine the write-protect state of a device (or media), for␊
 * example, the generic driver would issue a call to the␊
 * Transport Driver's reportWriteProtection method. If this were a SCSI␊
 * device, its transport driver would issue a Mode Sense command to␊
 * extract the write-protection status bit. The transport driver then␊
 * reports true or false to the generic driver.␊
 * ␊
 * The generic driver therefore has no knowledge of, or involvement␊
 * with, the actual commands and mechanisms used to communicate with␊
 * the device. It is expected that the generic driver will rarely, if␊
 * ever, need to be subclassed to handle device idiosyncrasies; rather,␊
 * the transport driver should be changed via overrides.␊
 * ␊
 * A generic driver could be subclassed to create a different type of␊
 * generic device. The generic driver IOCDBlockStorageDriver class is␊
 * a subclass of IOBlockStorageDriver, adding CD functions.␊
 */␊
␊
class IOBlockStorageDriver : public IOStorage␊
{␊
    OSDeclareDefaultStructors(IOBlockStorageDriver);␊
␊
public:␊
␊
    /*!␊
     * @enum Statistics␊
     * @abstract␊
     * Indices for the different statistics that getStatistics() can report.␊
     * @constant kStatisticsReads Number of read operations thus far.␊
     * @constant kStatisticsBytesRead Number of bytes read thus far.␊
     * @constant kStatisticsTotalReadTime Nanoseconds spent performing reads thus far.␊
     * @constant kStatisticsLatentReadTime Nanoseconds of latency during reads thus far.␊
     * @constant kStatisticsReadRetries Number of read retries thus far.␊
     * @constant kStatisticsReadErrors Number of read errors thus far.␊
     * @constant kStatisticsWrites Number of write operations thus far.␊
     * @constant kStatisticsSingleBlockWrites Number of write operations for a single block thus far.␊
     * @constant kStatisticsBytesWritten Number of bytes written thus far.␊
     * @constant kStatisticsTotalWriteTime Nanoseconds spent performing writes thus far.␊
     * @constant kStatisticsLatentWriteTime Nanoseconds of latency during writes thus far.␊
     * @constant kStatisticsWriteRetries Number of write retries thus far.␊
     * @constant kStatisticsWriteErrors Number of write errors thus far.␊
     */␊
␊
    enum Statistics␊
    {␊
        kStatisticsReads,␊
        kStatisticsBytesRead,␊
        kStatisticsTotalReadTime,␊
        kStatisticsLatentReadTime,␊
        kStatisticsReadRetries,␊
        kStatisticsReadErrors,␊
␊
        kStatisticsWrites,␊
        kStatisticsSingleBlockWrites,␊
        kStatisticsBytesWritten,␊
        kStatisticsTotalWriteTime,␊
        kStatisticsLatentWriteTime,␊
        kStatisticsWriteRetries,␊
        kStatisticsWriteErrors␊
    };␊
␊
    static const UInt32 kStatisticsCount = kStatisticsWriteErrors + 1;␊
␊
protected:␊
␊
    struct Context;␊
␊
    struct ExpansionData␊
    {␊
        bool           mediaDirtied;␊
        UInt64         maxReadBlockTransfer;␊
        UInt64         maxWriteBlockTransfer;␊
        IONotifier *   powerEventNotifier;␊
        UInt32         deblockRequestWriteLockCount;␊
        UInt64         maxReadSegmentTransfer;␊
        UInt64         maxWriteSegmentTransfer;␊
        UInt64         maxReadSegmentByteTransfer;␊
        UInt64         maxWriteSegmentByteTransfer;␊
        UInt64         minSegmentAlignmentByteTransfer;␊
        UInt64         maxSegmentWidthByteTransfer;␊
        Context *      contexts;␊
        IOSimpleLock * contextsLock;␊
        UInt32         contextsCount;␊
        UInt32         contextsMaxCount;␊
    };␊
    ExpansionData * _expansionData;␊
␊
    #define _mediaDirtied                    \␊
              IOBlockStorageDriver::_expansionData->mediaDirtied␊
    #define _maxReadBlockTransfer            \␊
              IOBlockStorageDriver::_expansionData->maxReadBlockTransfer␊
    #define _maxWriteBlockTransfer           \␊
              IOBlockStorageDriver::_expansionData->maxWriteBlockTransfer␊
    #define _powerEventNotifier              \␊
              IOBlockStorageDriver::_expansionData->powerEventNotifier␊
    #define _deblockRequestWriteLockCount    \␊
              IOBlockStorageDriver::_expansionData->deblockRequestWriteLockCount␊
    #define _maxReadSegmentTransfer          \␊
              IOBlockStorageDriver::_expansionData->maxReadSegmentTransfer␊
    #define _maxWriteSegmentTransfer         \␊
              IOBlockStorageDriver::_expansionData->maxWriteSegmentTransfer␊
    #define _maxReadSegmentByteTransfer      \␊
              IOBlockStorageDriver::_expansionData->maxReadSegmentByteTransfer␊
    #define _maxWriteSegmentByteTransfer     \␊
              IOBlockStorageDriver::_expansionData->maxWriteSegmentByteTransfer␊
    #define _minSegmentAlignmentByteTransfer \␊
              IOBlockStorageDriver::_expansionData->minSegmentAlignmentByteTransfer␊
    #define _maxSegmentWidthByteTransfer     \␊
              IOBlockStorageDriver::_expansionData->maxSegmentWidthByteTransfer␊
    #define _contexts                        \␊
              IOBlockStorageDriver::_expansionData->contexts␊
    #define _contextsLock                    \␊
              IOBlockStorageDriver::_expansionData->contextsLock␊
    #define _contextsCount                   \␊
              IOBlockStorageDriver::_expansionData->contextsCount␊
    #define _contextsMaxCount                \␊
              IOBlockStorageDriver::_expansionData->contextsMaxCount␊
␊
    OSSet *         _openClients;␊
    OSNumber *      _statistics[kStatisticsCount];␊
␊
    /*␊
     * @struct Context␊
     * @discussion␊
     * Context structure for a read/write operation.  It describes the block size,␊
     * and where applicable, a block type and block sub-type, for a data transfer,␊
     * as well as the completion information for the original request.  Note that␊
     * the block type field is unused in the IOBlockStorageDriver class.␊
     * @field block.size␊
     * Block size for the operation.␊
     * @field block.type␊
     * Block type for the operation.  Unused in IOBlockStorageDriver.  The default␊
     * value for this field is IOBlockStorageDriver::kBlockTypeStandard.␊
     * @field block.typeSub␊
     * Block sub-type for the operation.  It's definition depends on block.type.␊
     * Unused in IOBlockStorageDriver.␊
     * @field request.byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param request.buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param request.attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.␊
     * @param request.completion␊
     * Completion routine to call once the data transfer is complete.␊
     */␊
␊
    struct Context␊
    {␊
#ifdef __LP64__␊
        struct␊
        {␊
            UInt64               byteStart;␊
            IOMemoryDescriptor * buffer;␊
            IOStorageAttributes  attributes;␊
            IOStorageCompletion  completion;␊
        } request;␊
␊
        struct␊
        {␊
            UInt32               size;␊
            UInt8                type;␊
            UInt8                typeSub[3];␊
        } block;␊
␊
        AbsoluteTime timeStart;␊
␊
        UInt64 reserved0704;␊
        UInt64 reserved0768;␊
        UInt64 reserved0832;␊
        UInt64 reserved0896;␊
#else /* !__LP64__ */␊
        struct␊
        {␊
            UInt32               size;␊
            UInt8                type;␊
            UInt8                typeSub[3];␊
        } block;␊
␊
        struct␊
        {␊
            UInt64               byteStart;␊
            IOMemoryDescriptor * buffer;␊
            IOStorageCompletion  completion;␊
        } original;␊
␊
        AbsoluteTime timeStart;␊
␊
        struct␊
        {␊
            IOStorageAttributes  attributes;␊
        } request;␊
␊
        UInt32 reserved0448;␊
#endif /* !__LP64__ */␊
␊
        Context * next;␊
    };␊
␊
    static const UInt8 kBlockTypeStandard = 0x00;␊
␊
    /*␊
     * Free all of this object's outstanding resources.␊
     *␊
     * This method's implementation is not typically overridden.␊
     */␊
␊
    void free();␊
␊
    /*!␊
     * @function handleOpen␊
     * @discussion␊
     * The handleOpen method grants or denies permission to access this object␊
     * to an interested client.  The argument is an IOStorageAccess value that␊
     * specifies the level of access desired -- reader or reader-writer.␊
     *␊
     * This method can be invoked to upgrade or downgrade the access level for␊
     * an existing client as well.  The previous access level will prevail for␊
     * upgrades that fail, of course.   A downgrade should never fail.  If the␊
     * new access level should be the same as the old for a given client, this␊
     * method will do nothing and return success.  In all cases, one, singular␊
     * close-per-client is expected for all opens-per-client received.␊
     *␊
     * This implementation replaces the IOService definition of handleIsOpen().␊
     * @param client␊
     * Client requesting the open.␊
     * @param options␊
     * Options for the open.  Set to zero.␊
     * @param access␊
     * Access level for the open.  Set to kIOStorageAccessReader or␊
     * kIOStorageAccessReaderWriter.␊
     * @result␊
     * Returns true if the open was successful, false otherwise.␊
     */␊
␊
    virtual bool handleOpen(IOService *  client,␊
                            IOOptionBits options,␊
                            void *       access);␊
␊
    /*!␊
     * @function handleIsOpen␊
     * @discussion␊
     * The handleIsOpen method determines whether the specified client, or any␊
     * client if none is specified, presently has an open on this object.␊
     *␊
     * This implementation replaces the IOService definition of handleIsOpen().␊
     * @param client␊
     * Client to check the open state of.  Set to zero to check the open state␊
     * of all clients.␊
     * @result␊
     * Returns true if the client was (or clients were) open, false otherwise.␊
     */␊
␊
    virtual bool handleIsOpen(const IOService * client) const;␊
␊
    /*!␊
     * @function handleClose␊
     * @discussion␊
     * The handleClose method closes the client's access to this object.␊
     *␊
     * This implementation replaces the IOService definition of handleIsOpen().␊
     * @param client␊
     * Client requesting the close.␊
     * @param options␊
     * Options for the close.  Set to zero.␊
     */␊
␊
    virtual void handleClose(IOService * client, IOOptionBits options);␊
␊
    /*!␊
     * @function addToBytesTransferred␊
     * @discussion␊
     * Update the total number of bytes transferred, the total transfer time,␊
     * and the total latency time -- used for statistics.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param bytesTransferred␊
     * Number of bytes transferred in this operation.␊
     * @param totalTime␊
     * Nanoseconds spent performing this operation.␊
     * @param latentTime␊
     * Nanoseconds of latency during this operation.␊
     * @param isWrite␊
     * Indicates whether this operation was a write, otherwise is was a read.␊
     */␊
␊
    virtual void addToBytesTransferred(UInt64 bytesTransferred,␊
                                       UInt64 totalTime,␊
                                       UInt64 latentTime,␊
                                       bool   isWrite);␊
␊
    /*!␊
     * @function incrementErrors␊
     * @discussion␊
     * Update the total error count -- used for statistics.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param isWrite␊
     * Indicates whether this operation was a write, otherwise is was a read.␊
     */␊
␊
    virtual void incrementErrors(bool isWrite);␊
␊
    /*!␊
     * @function incrementRetries␊
     * @discussion␊
     * Update the total retry count -- used for statistics.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param isWrite␊
     * Indicates whether this operation was a write, otherwise is was a read.␊
     */␊
␊
    virtual void incrementRetries(bool isWrite);␊
␊
    /*!␊
     * @function allocateContext␊
     * @discussion␊
     * Allocate a context structure for a read/write operation.␊
     * @result␊
     * Context structure.␊
     */␊
␊
    virtual Context * allocateContext();␊
␊
    /*!␊
     * @function deleteContext␊
     * @discussion␊
     * Delete a context structure from a read/write operation.␊
     * @param context␊
     * Context structure to be deleted.␊
     */␊
␊
    virtual void deleteContext(Context * context);␊
␊
#ifndef __LP64__␊
    virtual void prepareRequest(UInt64               byteStart,␊
                                IOMemoryDescriptor * buffer,␊
                                IOStorageCompletion  completion) __attribute__ ((deprecated));␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function deblockRequest␊
     * @discussion␊
     * The deblockRequest method checks to see if the incoming request rests␊
     * on the media's block boundaries, and if not, deblocks it.  Deblocking␊
     * involves rounding out the request to the nearest block boundaries and␊
     * transferring the excess bytes into a scratch buffer.␊
     *␊
     * This method is part of a sequence of methods invoked for each read/write␊
     * request.  The first is prepareRequest, which allocates and prepares some␊
     * context for the transfer; the second is deblockRequest, which aligns the␊
     * transfer at the media's block boundaries; third is breakUpRequest, which␊
     * breaks up the transfer into multiple sub-transfers when certain hardware␊
     * constraints are exceeded; fourth is executeRequest, which implements the␊
     * actual transfer from the block storage device.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param context␊
     * Additional context information for the data transfer (e.g. block size).␊
     */␊
␊
#ifdef __LP64__␊
    virtual void deblockRequest(UInt64                byteStart,␊
                                IOMemoryDescriptor *  buffer,␊
                                IOStorageAttributes * attributes,␊
                                IOStorageCompletion * completion,␊
                                Context *             context);␊
#else /* !__LP64__ */␊
    virtual void deblockRequest(UInt64                byteStart,␊
                                IOMemoryDescriptor *  buffer,␊
                                IOStorageCompletion   completion,␊
                                Context *             context);␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function executeRequest␊
     * @discussion␊
     * Execute an asynchronous storage request.  The request is guaranteed to be␊
     * block-aligned.␊
     *␊
     * This method is part of a sequence of methods invoked for each read/write␊
     * request.  The first is prepareRequest, which allocates and prepares some␊
     * context for the transfer; the second is deblockRequest, which aligns the␊
     * transfer at the media's block boundaries; third is breakUpRequest, which␊
     * breaks up the transfer into multiple sub-transfers when certain hardware␊
     * constraints are exceeded; fourth is executeRequest, which implements the␊
     * actual transfer from the block storage device.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param context␊
     * Additional context information for the data transfer (e.g. block size).␊
     */␊
␊
#ifdef __LP64__␊
    virtual void executeRequest(UInt64                byteStart,␊
                                IOMemoryDescriptor *  buffer,␊
                                IOStorageAttributes * attributes,␊
                                IOStorageCompletion * completion,␊
                                Context *             context);␊
#else /* !__LP64__ */␊
    virtual void executeRequest(UInt64                byteStart,␊
                                IOMemoryDescriptor *  buffer,␊
                                IOStorageCompletion   completion,␊
                                Context *             context);␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function handleStart␊
     * @discussion␊
     * Prepare the block storage driver for operation.␊
     *␊
     * This is where a media object needs to be created for fixed media, and␊
     * optionally for removable media.␊
     *␊
     * Note that this method is called from within the start() routine;␊
     * if this method returns successfully,  it should be prepared to accept␊
     * any of IOBlockStorageDriver's APIs.␊
     * @param provider␊
     * This object's provider.␊
     * @result␊
     * Returns true on success, false otherwise.␊
     */␊
␊
    virtual bool handleStart(IOService * provider);␊
␊
    /*!␊
     * @function handleYield␊
     * @discussion␊
     * Stop the block storage driver.␊
     *␊
     * This method is called as a result of a kIOMessageServiceIsRequestingClose␊
     * provider message.  The argument is passed in as-is from the message.  The␊
     * options are unused.␊
     *␊
     * This is where the driver should clean up its state in preparation for␊
     * removal from the system.␊
     *␊
     * Note that this method is called from within the yield() routine.␊
     *␊
     * This method is called with the arbitration lock held.␊
     * @param provider␊
     * This object's provider.␊
     */␊
␊
    virtual bool handleYield(IOService *  provider,␊
                             IOOptionBits options  = 0,␊
                             void *       argument = 0);␊
␊
␊
    /*!␊
     * @function getMediaBlockSize␊
     * @discussion␊
     * Ask the driver about the media's natural block size.␊
     * @result␊
     * Natural block size, in bytes.␊
     */␊
␊
    virtual UInt64 getMediaBlockSize() const;␊
␊
public:␊
␊
    using IOStorage::read;␊
    using IOStorage::write;␊
␊
    /*␊
     * Initialize this object's minimal state.␊
     *␊
     * This method's implementation is not typically overridden.␊
     */␊
␊
    virtual bool init(OSDictionary * properties = 0);␊
␊
    /*␊
     * This method is called once we have been attached to the provider object.␊
     *␊
     * This method's implementation is not typically overridden.␊
     */␊
␊
    virtual bool start(IOService * provider);␊
␊
    /*␊
     * This method is called before we are detached from the provider object.␊
     *␊
     * This method's implementation is not typically overridden.␊
     */␊
␊
    virtual void stop(IOService * provider);␊
␊
    /*␊
     * This method is called as a result of a kIOMessageServiceIsRequestingClose␊
     * provider message.  The argument is passed in as-is from the message.  The␊
     * options are unused.␊
     *␊
     * This method's implementation is not typically overridden.␊
     */␊
␊
    virtual bool yield(IOService *  provider,␊
                       IOOptionBits options  = 0,␊
                       void *       argument = 0);␊
␊
    /*!␊
     * @function read␊
     * @discussion␊
     * The read method is the receiving end for all read requests from the␊
     * storage framework (through the media object created by this driver).␊
     *␊
     * This method initiates a sequence of methods (stages) for each read/write␊
     * request.  The first is prepareRequest, which allocates and prepares some␊
     * context for the transfer; the second is deblockRequest, which aligns the␊
     * transfer at the media's block boundaries; third is breakUpRequest, which␊
     * breaks up the transfer into multiple sub-transfers when certain hardware␊
     * constraints are exceeded; fourth is executeRequest, which implements the␊
     * actual transfer from the block storage device.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param client␊
     * Client requesting the read.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     */␊
␊
    virtual void read(IOService *           client,␊
                      UInt64                byteStart,␊
                      IOMemoryDescriptor *  buffer,␊
                      IOStorageAttributes * attributes,␊
                      IOStorageCompletion * completion);␊
␊
    /*!␊
     * @function write␊
     * @discussion␊
     * The write method is the receiving end for all write requests from the␊
     * storage framework (through the media object created by this driver).␊
     *␊
     * This method initiates a sequence of methods (stages) for each read/write␊
     * request.  The first is prepareRequest, which allocates and prepares some␊
     * context for the transfer; the second is deblockRequest, which aligns the␊
     * transfer at the media's block boundaries; third is breakUpRequest, which␊
     * breaks up the transfer into multiple sub-transfers when certain hardware␊
     * constraints are exceeded; fourth is executeRequest, which implements the␊
     * actual transfer from the block storage device.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param client␊
     * Client requesting the write.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     */␊
␊
    virtual void write(IOService *           client,␊
                       UInt64                byteStart,␊
                       IOMemoryDescriptor *  buffer,␊
                       IOStorageAttributes * attributes,␊
                       IOStorageCompletion * completion);␊
␊
    /*!␊
     * @function synchronizeCache␊
     * @discussion␊
     * Flush the cached data in the storage object, if any, synchronously.␊
     * @param client␊
     * Client requesting the cache synchronization.␊
     * @result␊
     * Returns the status of the cache synchronization.␊
     */␊
␊
    virtual IOReturn synchronizeCache(IOService * client);␊
␊
    /*!␊
     * @function discard␊
     * @discussion␊
     * Delete unused data from the storage object at the specified byte offset,␊
     * synchronously.␊
     * @param client␊
     * Client requesting the operation.␊
     * @param byteStart␊
     * Starting byte offset for the operation.␊
     * @param byteCount␊
     * Size of the operation.␊
     * @result␊
     * Returns the status of the operation.␊
     */␊
␊
    virtual IOReturn discard(IOService * client,␊
                             UInt64      byteStart,␊
                             UInt64      byteCount);␊
␊
    /*!␊
     * @function ejectMedia␊
     * @discussion␊
     * Eject the media from the device.  The driver is responsible for tearing␊
     * down the media object it created before proceeding with the eject.   If␊
     * the tear-down fails, an error should be returned.␊
     * @result␊
     * An IOReturn code.␊
     */␊
␊
    virtual IOReturn ejectMedia();␊
␊
    /*!␊
     * @function formatMedia␊
     * @discussion␊
     * Format the media with the specified byte capacity.  The driver is␊
     * responsible for tearing down the media object and recreating it.␊
     * @param byteCapacity␊
     * Number of bytes to format media to.␊
     * @result␊
     * An IOReturn code.␊
     */␊
␊
    virtual IOReturn formatMedia(UInt64 byteCapacity);␊
␊
    /*!␊
     * @function lockMedia␊
     * @discussion␊
     * Lock or unlock the ejectable media in the device, that is, prevent␊
     * it from manual ejection or allow its manual ejection.␊
     * @param lock␊
     * Pass true to lock the media, otherwise pass false to unlock the media.␊
     * @result␊
     * An IOReturn code.␊
     */␊
␊
    virtual IOReturn lockMedia(bool lock);␊
␊
    /*!␊
     * @function pollMedia␊
     * @discussion␊
     * Poll for the presence of media in the device.  The driver is responsible␊
     * for tearing down the media object it created should the media have been␊
     * removed since the last poll, and vice-versa, creating the media object␊
     * should new media have arrived since the last poll.␊
     * @result␊
     * An IOReturn code.␊
     */␊
␊
    virtual IOReturn pollMedia();␊
␊
    /*!␊
     * @function isMediaEjectable␊
     * @discussion␊
     * Ask the driver whether the media is ejectable.␊
     * @result␊
     * Returns true if the media is ejectable, false otherwise.␊
     */␊
␊
    virtual bool isMediaEjectable() const;␊
␊
#ifdef __LP64__␊
    /*!␊
     * @function isMediaRemovable␊
     * @discussion␊
     * Ask the driver whether the media is ejectable.␊
     * @result␊
     * Returns true if the media is ejectable, false otherwise.␊
     */␊
␊
    virtual bool isMediaRemovable() const;␊
#endif /* __LP64__ */␊
␊
    /*!␊
     * @function isMediaPollExpensive␊
     * @discussion␊
     * Ask the driver whether a pollMedia() would be an expensive operation,␊
     * that is, one that requires the device to spin up or delay for a while.␊
     * @result␊
     * Returns true if polling the media is expensive, false otherwise.␊
     */␊
␊
    virtual bool isMediaPollExpensive() const;␊
␊
    /*!␊
     * @function isMediaPollRequired␊
     * @discussion␊
     * Ask the driver whether the block storage device requires polling,  which is␊
     * typically required for devices without the ability to asynchronously detect␊
     * the arrival or departure of the media.␊
     * @result␊
     * Returns true if polling the media is required, false otherwise.␊
     */␊
␊
    virtual bool isMediaPollRequired() const;␊
␊
    virtual bool isMediaWritable() const;␊
␊
    /*!␊
     * @function getMediaState␊
     * @discussion␊
     * Ask the driver about the media's current state.␊
     * @result␊
     * An IOMediaState value.␊
     */␊
␊
    virtual IOMediaState getMediaState() const;␊
␊
    /*!␊
     * @function getFormatCapacities␊
     * @discussion␊
     * Ask the driver to report the feasible formatting capacities for the␊
     * inserted media (in bytes).  This routine fills the caller's buffer,␊
     * up to the maximum count specified if the real number of capacities␊
     * would overflow the buffer.   The return value indicates the actual␊
     * number of capacities copied to the buffer.␊
     *␊
     * If the capacities buffer is not supplied or if the maximum count is␊
     * zero, the routine returns the proposed count of capacities instead.␊
     * @param capacities␊
     * Buffer that will receive the UInt64 capacity values.␊
     * @param capacitiesMaxCount␊
     * Maximum number of capacity values that can be held in the buffer.␊
     * @result␊
     * Actual number of capacity values copied to the buffer, or if no buffer␊
     * is given, the total number of capacity values available.␊
     */␊
␊
    virtual UInt32 getFormatCapacities(UInt64 * capacities,␊
                                       UInt32   capacitiesMaxCount) const;␊
␊
    /*!␊
     * @function getStatistics␊
     * @discussion␊
     * Ask the driver to report its operating statistics.␊
     *␊
     * The statistics are each indexed by IOBlockStorageDriver::Statistics␊
     * indices.  This routine fills the caller's buffer, up to the maximum␊
     * count specified if the real number of statistics would overflow the␊
     * buffer.  The return value indicates the actual number of statistics␊
     * copied to the buffer.␊
     *␊
     * If the statistics buffer is not supplied or if the maximum count is␊
     * zero, the routine returns the proposed count of statistics instead.␊
     * @param statistics␊
     * Buffer that will receive the UInt64 statistic values.␊
     * @param statisticsMaxCount␊
     * Maximum number of statistic values that can be held in the buffer.␊
     * @result␊
     * Actual number of statistic values copied to the buffer, or if no buffer␊
     * is given, the total number of statistic values available.␊
     */␊
␊
    virtual UInt32 getStatistics(UInt64 * statistics,␊
                                 UInt32   statisticsMaxCount) const;␊
␊
    /*!␊
     * @function getStatistic␊
     * @discussion␊
     * Ask the driver to report one of its operating statistics.␊
     * @param statistic␊
     * Statistic index (an IOBlockStorageDriver::Statistics index).␊
     * @result␊
     * Statistic value.␊
     */␊
␊
    virtual UInt64 getStatistic(Statistics statistic) const;␊
␊
    /*␊
     * Generic entry point for calls from the provider.  A return value of␊
     * kIOReturnSuccess indicates that the message was received, and where␊
     * applicable, that it was successful.␊
     */␊
␊
    virtual IOReturn message(UInt32 type, IOService * provider, void * argument);␊
␊
    /*␊
     * Obtain this object's provider.  We override the superclass's method to␊
     * return a more specific subclass of IOService -- IOBlockStorageDevice.  ␊
     * This method serves simply as a convenience to subclass developers.␊
     */␊
␊
    virtual IOBlockStorageDevice * getProvider() const;␊
␊
protected:␊
␊
    IOLock *      _deblockRequestWriteLock;␊
    thread_call_t _pollerCall;␊
␊
    /*␊
     * This is the completion routine for the broken up breaker sub-requests.␊
     * It verifies the success of the just-completed stage,  transitions to␊
     * the next stage, then builds and issues a transfer for the next stage.␊
     */␊
␊
    static void breakUpRequestCompletion(void *   target,␊
                                         void *   parameter,␊
                                         IOReturn status,␊
                                         UInt64   actualByteCount);␊
␊
    /*␊
     * This is the completion routine for the aligned deblocker sub-requests.␊
     * It verifies the success of the just-completed stage,  transitions to␊
     * the next stage, then builds and issues a transfer for the next stage.␊
     */␊
␊
    static void deblockRequestCompletion(void *   target,␊
                                         void *   parameter,␊
                                         IOReturn status,␊
                                         UInt64   actualByteCount);␊
␊
    /*␊
     * This is the completion routine for the prepared request.  It updates␊
     * the driver's statistics, performs some clean up work, then calls the␊
     * original request's completion routine.␊
     */␊
␊
    static void prepareRequestCompletion(void *   target,␊
                                         void *   parameter,␊
                                         IOReturn status,␊
                                         UInt64   actualByteCount);␊
␊
    /*␊
     * Schedule the poller mechanism.␊
     */␊
␊
    virtual void schedulePoller();␊
␊
    /*␊
     * Unschedule the poller mechanism.␊
     */␊
␊
    virtual void unschedulePoller();␊
␊
    /*␊
     * This method is the timeout handler for the poller mechanism.  It polls␊
     * for media and reschedules another timeout if there are still no opens.␊
     */␊
␊
    static void poller(void *, void *);␊
␊
    /*␊
     * This method is the power event handler for restarts and shutdowns.␊
     */␊
␊
    static IOReturn handlePowerEvent(void *      target,␊
                                     void *      parameter,␊
                                     UInt32      messageType,␊
                                     IOService * provider,␊
                                     void *      messageArgument,␊
                                     vm_size_t   messageArgumentSize);␊
␊
protected:␊
␊
    /* Device info: */␊
␊
    /*!␊
     * @var _removable␊
     * True if the media is removable; False if it is fixed (not removable).␊
     */␊
    bool␉␉_removable;␊
␊
    /*!␊
     * @var _ejectable␊
     * True if the media is ejectable under software control.␊
     */␊
    bool␉␉_ejectable;␉␉/* software-ejectable */␊
␊
    /*!␊
     * @var _lockable␊
     * True if the media can be locked in the device under software control.␊
     */␊
    bool␉␉_lockable;␉␉/* software lockable in device */␊
    /*!␊
     * @var _pollIsRequired␊
     * True if we must poll to detect media insertion or removal.␊
     */␊
    bool␉␉_pollIsRequired;␊
    /*!␊
     * @var _pollIsExpensive␊
     * True if polling is expensive; False if not.␊
     */␊
    bool␉␉_pollIsExpensive;␊
␊
    /* Media info and states: */␊
␊
    /*!␊
     * @var _mediaObject␊
     * A pointer to the media object we have instantiated (if any).␊
     */␊
    IOMedia *␉␉_mediaObject;␊
    /*!␊
     * @var _mediaType␊
     * Type of the media (can be used to differentiate between the␊
     * different types of CD media, DVD media, etc).␊
     */␊
    UInt32␉␉_mediaType;␊
    /*!␊
     * @var _mediaPresent␊
     * True if media is present in the device; False if not.␊
     */␊
    bool␉␉_mediaPresent;␉␉/* media is present and ready */␊
    /*!␊
     * @var _writeProtected␊
     * True if the media is write-protected; False if not.␊
     */␊
    bool␉␉_writeProtected;␊
    ␊
private:␊
␊
    /*!␊
     * @var _mediaStateLock␊
     * A lock used to protect during media checks.␊
     */␊
    IOLock *␉␉_mediaStateLock;␊
␊
protected:␊
␊
    /*!␊
     * @var _mediaBlockSize␊
     * The block size of the media, in bytes.␊
     */␊
    UInt64␉␉_mediaBlockSize;␊
    /*!␊
     * @var _maxBlockNumber␊
     * The maximum allowable block number for the media, zero-based.␊
     */␊
    UInt64␉␉_maxBlockNumber;␊
␊
    /*!␊
     * @var _maxReadByteTransfer␊
     * The maximum byte transfer allowed for read operations.␊
     */␊
    UInt64␉␉_maxReadByteTransfer;␊
␊
    /*!␊
     * @var _maxWriteByteTransfer␊
     * The maximum byte transfer allowed for write operations.␊
     */␊
    UInt64␉␉_maxWriteByteTransfer;␊
␊
    /*!␊
     * @function acceptNewMedia␊
     * @abstract␊
     * React to new media insertion.␊
     * @discussion␊
     * This method logs the media block size and block count, then calls␊
     * instantiateMediaObject to get a media object instantiated. The␊
     * media object is then attached above us and registered.␊
     * ␊
     * This method can be overridden to control what happens when new media␊
     * is inserted. The default implementation deals with one IOMedia object.␊
     */␊
    virtual IOReturn␉acceptNewMedia(void);␊
    ␊
    /*!␊
     * @function constrainByteCount␊
     * @abstract␊
     * Constrain the byte count for this IO to device limits.␊
     * @discussion␊
     * This function should be called prior to each read or write operation, so that␊
     * the driver can constrain the requested byte count, as necessary, to meet␊
     * current device limits. Such limits could be imposed by the device depending␊
     * on operating modes, media types, or transport protocol (e.g. ATA, SCSI).␊
     * ␊
     * At present, this method is not used.␊
     * @param requestedCount␊
     * The requested byte count for the next read or write operation.␊
     * @param isWrite␊
     * True if the operation will be a write; False if the operation will be a read.␊
     */␊
    virtual UInt64␉constrainByteCount(UInt64 requestedCount,bool isWrite);␊
␊
    /*!␊
     * @function decommissionMedia␊
     * @abstract␊
     * Decommission an existing piece of media that has gone away.␊
     * @discussion␊
     * This method wraps a call to terminate, to tear down the stack and␊
     * the IOMedia object for the media. If "forcible" is true, the media␊
     * object will be forgotten, and initMediaState will be called. A␊
     * forcible decommission would occur when an unrecoverable error␊
     * happens during tear-down (e.g. perhaps a client is still open), but␊
     * we must still forget about the media.␊
     * @param forcible␊
     * True to force forgetting of the media object even if terminate reports␊
     * that there was an active client.␊
     */␊
    virtual IOReturn␉decommissionMedia(bool forcible);␊
␊
    /*!␊
     * @function instantiateDesiredMediaObject␊
     * @abstract␊
     * Create an IOMedia object for media.␊
     * @discussion␊
     * This method creates the exact type of IOMedia object desired. It is called by␊
     * instantiateMediaObject. A subclass may override this one-line method to change␊
     * the type of media object actually instantiated.␊
     */␊
    virtual IOMedia *␉instantiateDesiredMediaObject(void);␊
␊
    /*!␊
     * @function instantiateMediaObject␊
     * @abstract␊
     * Create an IOMedia object for media.␊
     * @discussion␊
     * This method creates an IOMedia object from the supplied parameters. It is a␊
     * convenience method to wrap the handful of steps to do the job.␊
     * @param base␊
     * Byte number of beginning of active data area of the media. Usually zero.␊
     * @param byteSize␊
     * Size of the data area of the media, in bytes.␊
     * @param blockSize␊
     * Block size of the media, in bytes.␊
     * @param mediaName␊
     * Name of the IOMedia object.␊
     * @result␊
     * A pointer to the created IOMedia object, or a null on error.␊
     */␊
    virtual IOMedia *␉instantiateMediaObject(UInt64 base,UInt64 byteSize,␊
                                            UInt32 blockSize,char *mediaName);␊
␊
    /*!␊
     * @function recordMediaParameters␊
     * @abstract␊
     * Obtain media-related parameters on media insertion.␊
     * @discussion␊
     * This method obtains media-related parameters via calls to the␊
     * Transport Driver's reportBlockSize, reportMaxValidBlock,␊
     * and reportWriteProtection methods.␊
     */␊
    virtual IOReturn␉recordMediaParameters(void);␊
␊
    /*!␊
     * @function rejectMedia␊
     * @abstract␊
     * Reject new media.␊
     * @discussion␊
     * This method will be called if validateNewMedia returns False (thus rejecting␊
     * the new media. A vendor may choose to override this method to control behavior␊
     * when media is rejected.␊
     * ␊
     * The default implementation simply calls ejectMedia.␊
     */␊
    virtual void␉rejectMedia(void);␉/* default ejects */␊
    ␊
    /*!␊
     * @function validateNewMedia␊
     * @abstract␊
     * Verify that new media is acceptable.␊
     * @discussion␊
     * This method will be called whenever new media is detected. Return true to accept␊
     * the media, or false to reject it (and call rejectMedia). Vendors might override␊
     * this method to handle password-protection for new media.␊
     * ␊
     * The default implementation always returns True, indicating media is accepted.␊
     */␊
    virtual bool␉validateNewMedia(void);␊
␊
    /* --- Internally used methods. --- */␊
␊
    /*␊
     * @group␊
     * Internally Used Methods␊
     * @discussion␊
     * These methods are used internally, and will not generally be modified.␊
     */␊
    ␊
    /*!␊
     * @function checkForMedia␊
     * @abstract␊
     * Check if media has newly arrived or disappeared.␊
     * @discussion␊
     * This method does most of the work in polling for media, first␊
     * calling the block storage device's reportMediaState method. If␊
     * reportMediaState reports no change in the media state, kIOReturnSuccess␊
     * is returned. If the media state has indeed changed, a call is made to␊
     * mediaStateHasChanged to act on the event.␊
     */␊
    virtual IOReturn␉checkForMedia(void);␊
␊
    /*!␊
     * @function getDeviceTypeName␊
     * @abstract␊
     * Return the desired device name.␊
     * @discussion␊
     * This method returns a string, used to compare the ␊
     * kIOBlockStorageDeviceTypeKey of our provider. This method is called from␊
     * probe.␊
     *  ␊
     * The default implementation of this method returns ␊
     * kIOBlockStorageDeviceTypeGeneric.␊
     */␊
    virtual const char * getDeviceTypeName(void);␊
␊
    /*!␊
     * @function initMediaState␊
     * @abstract␊
     * Initialize media-related instance variables.␊
     * @discussion␊
     * Called when media is not present, this method marks the device state␊
     * as not having media present, not spun up, and write-enabled.␊
     */␊
    virtual void␉initMediaState(void);␊
    ␊
    /*!␊
     * @function mediaStateHasChanged␊
     * @abstract␊
     * React to a new media insertion or a media removal.␊
     * @discussion␊
     * This method is called on a media state change, that is, an arrival␊
     * or removal. If media has just become available, calls are made to␊
     * recordMediaParameters and acceptNewMedia. If media has just gone␊
     * away, a call is made to decommissionMedia, with the forcible␊
     * parameter set to true. The forcible tear-down is needed to enforce␊
     * the disappearance of media, regardless of interested clients.␊
     */␊
    virtual IOReturn␉mediaStateHasChanged(IOMediaState state);␊
␊
    /*␊
     * @endgroup␊
     */␊
␊
protected:␊
␊
    /*!␊
     * @function breakUpRequest␊
     * @discussion␊
     * The breakUpRequest method checks to see if the incoming request exceeds␊
     * our transfer constraints, and if so, breaks up the request into smaller␊
     * sub-requests.␊
     *␊
     * This method is part of a sequence of methods invoked for each read/write␊
     * request.  The first is prepareRequest, which allocates and prepares some␊
     * context for the transfer; the second is deblockRequest, which aligns the␊
     * transfer at the media's block boundaries; third is breakUpRequest, which␊
     * breaks up the transfer into multiple sub-transfers when certain hardware␊
     * constraints are exceeded; fourth is executeRequest, which implements the␊
     * actual transfer from the block storage device.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param context␊
     * Additional context information for the data transfer (e.g. block size).␊
     */␊
␊
#ifdef __LP64__␊
    virtual void breakUpRequest(UInt64                byteStart,␊
                                IOMemoryDescriptor *  buffer,␊
                                IOStorageAttributes * attributes,␊
                                IOStorageCompletion * completion,␊
                                Context *             context);␊
#else /* !__LP64__ */␊
    virtual void breakUpRequest(UInt64                byteStart,␊
                                IOMemoryDescriptor *  buffer,␊
                                IOStorageCompletion   completion,␊
                                Context *             context); /* 10.1.2 */␊
#endif /* !__LP64__ */␊
␊
    /*!␊
     * @function prepareRequest␊
     * @discussion␊
     * The prepareRequest method allocates and prepares state for the transfer.␊
     *␊
     * This method is part of a sequence of methods invoked for each read/write␊
     * request.  The first is prepareRequest, which allocates and prepares some␊
     * context for the transfer; the second is deblockRequest, which aligns the␊
     * transfer at the media's block boundaries; third is breakUpRequest, which␊
     * breaks up the transfer into multiple sub-transfers when certain hardware␊
     * constraints are exceeded; fourth is executeRequest, which implements the␊
     * actual transfer from the block storage device.␊
     *␊
     * This method's implementation is not typically overridden.␊
     * @param byteStart␊
     * Starting byte offset for the data transfer.␊
     * @param buffer␊
     * Buffer for the data transfer.  The size of the buffer implies the size of␊
     * the data transfer.␊
     * @param attributes␊
     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     * @param completion␊
     * Completion routine to call once the data transfer is complete.  It is the␊
     * responsibility of the callee to maintain the information for the duration␊
     * of the data transfer, as necessary.␊
     */␊
␊
    virtual void prepareRequest(UInt64                byteStart,␊
                                IOMemoryDescriptor *  buffer,␊
                                IOStorageAttributes * attributes,␊
                                IOStorageCompletion * completion); /* 10.5.0 */␊
␊
public:␊
␊
    /*!␊
     * @function requestIdle␊
     * @abstract␊
     * Request that the device enter an idle state.␊
     * @discussion␊
     * Request that the device enter an idle state.  The device will exit this state on the␊
     * next read or write request, or as it sees necessary.  One example is for a DVD drive␊
     * to spin down when it enters such an idle state, and spin up on the next read request␊
     * from the system.␊
     */␊
    virtual IOReturn␉requestIdle(void); /* 10.6.0 */␊
␊
#ifdef __LP64__␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  0);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  1);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  2);␊
#else /* !__LP64__ */␊
    OSMetaClassDeclareReservedUsed(IOBlockStorageDriver,  0);␊
    OSMetaClassDeclareReservedUsed(IOBlockStorageDriver,  1);␊
    OSMetaClassDeclareReservedUsed(IOBlockStorageDriver,  2);␊
#endif /* !__LP64__ */␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  3);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  4);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  5);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  6);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  7);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  8);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  9);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 10);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 11);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 12);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 13);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 14);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 15);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 16);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 17);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 18);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 19);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 20);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 21);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 22);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 23);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 24);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 25);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 26);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 27);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 28);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 29);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 30);␊
    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 31);␊
};␊
␊
#endif /* __cplusplus */␊
#endif /* KERNEL */␊
#endif /* !_IOBLOCKSTORAGEDRIVER_H */␊
 ␊
 typedef UInt32 IOMediaState;␊
 ␊
-#ifdef KERNEL␊
-#ifdef __cplusplus␊
-␊
-/*␊
- * Kernel␊
- */␊
-␊
-#include <IOKit/storage/IOBlockStorageDevice.h>␊
-#include <IOKit/storage/IOMedia.h>␊
-#include <IOKit/storage/IOStorage.h>␊
-#include <kern/thread_call.h>␊
-␊
-/*!␊
- * @class IOBlockStorageDriver␊
- * @abstract␊
- * The common base class for generic block storage drivers.␊
- * @discussion␊
- * The IOBlockStorageDriver class is the common base class for generic block␊
- * storage drivers.  It matches and communicates via an IOBlockStorageDevice␊
- * interface, and connects to the remainder of the storage framework via the␊
- * IOStorage protocol. It extends the IOStorage protocol by implementing the␊
- * appropriate open and close semantics, deblocking for unaligned transfers,␊
- * polling for ejectable media, locking and ejection policies, media object␊
- * creation and tear-down, and statistics gathering and reporting.␊
- *␊
- * Block storage drivers are split into two parts: the generic driver handles␊
- * all generic device issues, independent of the lower-level transport␊
- * mechanism (e.g. SCSI, ATA, USB, FireWire). All storage operations␊
- * at the generic driver level are translated into a series of generic␊
- * device operations. These operations are passed via the IOBlockStorageDevice␊
- * nub to a transport driver, which implements the appropriate␊
- * transport-dependent protocol to execute these operations.␊
- *␊
- * To determine the write-protect state of a device (or media), for␊
- * example, the generic driver would issue a call to the␊
- * Transport Driver's reportWriteProtection method. If this were a SCSI␊
- * device, its transport driver would issue a Mode Sense command to␊
- * extract the write-protection status bit. The transport driver then␊
- * reports true or false to the generic driver.␊
- * ␊
- * The generic driver therefore has no knowledge of, or involvement␊
- * with, the actual commands and mechanisms used to communicate with␊
- * the device. It is expected that the generic driver will rarely, if␊
- * ever, need to be subclassed to handle device idiosyncrasies; rather,␊
- * the transport driver should be changed via overrides.␊
- * ␊
- * A generic driver could be subclassed to create a different type of␊
- * generic device. The generic driver IOCDBlockStorageDriver class is␊
- * a subclass of IOBlockStorageDriver, adding CD functions.␊
- */␊
-␊
-class IOBlockStorageDriver : public IOStorage␊
-{␊
-    OSDeclareDefaultStructors(IOBlockStorageDriver);␊
-␊
-public:␊
-␊
-    /*!␊
-     * @enum Statistics␊
-     * @abstract␊
-     * Indices for the different statistics that getStatistics() can report.␊
-     * @constant kStatisticsReads Number of read operations thus far.␊
-     * @constant kStatisticsBytesRead Number of bytes read thus far.␊
-     * @constant kStatisticsTotalReadTime Nanoseconds spent performing reads thus far.␊
-     * @constant kStatisticsLatentReadTime Nanoseconds of latency during reads thus far.␊
-     * @constant kStatisticsReadRetries Number of read retries thus far.␊
-     * @constant kStatisticsReadErrors Number of read errors thus far.␊
-     * @constant kStatisticsWrites Number of write operations thus far.␊
-     * @constant kStatisticsSingleBlockWrites Number of write operations for a single block thus far.␊
-     * @constant kStatisticsBytesWritten Number of bytes written thus far.␊
-     * @constant kStatisticsTotalWriteTime Nanoseconds spent performing writes thus far.␊
-     * @constant kStatisticsLatentWriteTime Nanoseconds of latency during writes thus far.␊
-     * @constant kStatisticsWriteRetries Number of write retries thus far.␊
-     * @constant kStatisticsWriteErrors Number of write errors thus far.␊
-     */␊
-␊
-    enum Statistics␊
-    {␊
-        kStatisticsReads,␊
-        kStatisticsBytesRead,␊
-        kStatisticsTotalReadTime,␊
-        kStatisticsLatentReadTime,␊
-        kStatisticsReadRetries,␊
-        kStatisticsReadErrors,␊
-␊
-        kStatisticsWrites,␊
-        kStatisticsSingleBlockWrites,␊
-        kStatisticsBytesWritten,␊
-        kStatisticsTotalWriteTime,␊
-        kStatisticsLatentWriteTime,␊
-        kStatisticsWriteRetries,␊
-        kStatisticsWriteErrors␊
-    };␊
-␊
-    static const UInt32 kStatisticsCount = kStatisticsWriteErrors + 1;␊
-␊
-protected:␊
-␊
-    struct Context;␊
-␊
-    struct ExpansionData␊
-    {␊
-        bool           mediaDirtied;␊
-        UInt64         maxReadBlockTransfer;␊
-        UInt64         maxWriteBlockTransfer;␊
-        IONotifier *   powerEventNotifier;␊
-        UInt32         deblockRequestWriteLockCount;␊
-        UInt64         maxReadSegmentTransfer;␊
-        UInt64         maxWriteSegmentTransfer;␊
-        UInt64         maxReadSegmentByteTransfer;␊
-        UInt64         maxWriteSegmentByteTransfer;␊
-        UInt64         minSegmentAlignmentByteTransfer;␊
-        UInt64         maxSegmentWidthByteTransfer;␊
-        Context *      contexts;␊
-        IOSimpleLock * contextsLock;␊
-        UInt32         contextsCount;␊
-        UInt32         contextsMaxCount;␊
-    };␊
-    ExpansionData * _expansionData;␊
-␊
-    #define _mediaDirtied                    \␊
-              IOBlockStorageDriver::_expansionData->mediaDirtied␊
-    #define _maxReadBlockTransfer            \␊
-              IOBlockStorageDriver::_expansionData->maxReadBlockTransfer␊
-    #define _maxWriteBlockTransfer           \␊
-              IOBlockStorageDriver::_expansionData->maxWriteBlockTransfer␊
-    #define _powerEventNotifier              \␊
-              IOBlockStorageDriver::_expansionData->powerEventNotifier␊
-    #define _deblockRequestWriteLockCount    \␊
-              IOBlockStorageDriver::_expansionData->deblockRequestWriteLockCount␊
-    #define _maxReadSegmentTransfer          \␊
-              IOBlockStorageDriver::_expansionData->maxReadSegmentTransfer␊
-    #define _maxWriteSegmentTransfer         \␊
-              IOBlockStorageDriver::_expansionData->maxWriteSegmentTransfer␊
-    #define _maxReadSegmentByteTransfer      \␊
-              IOBlockStorageDriver::_expansionData->maxReadSegmentByteTransfer␊
-    #define _maxWriteSegmentByteTransfer     \␊
-              IOBlockStorageDriver::_expansionData->maxWriteSegmentByteTransfer␊
-    #define _minSegmentAlignmentByteTransfer \␊
-              IOBlockStorageDriver::_expansionData->minSegmentAlignmentByteTransfer␊
-    #define _maxSegmentWidthByteTransfer     \␊
-              IOBlockStorageDriver::_expansionData->maxSegmentWidthByteTransfer␊
-    #define _contexts                        \␊
-              IOBlockStorageDriver::_expansionData->contexts␊
-    #define _contextsLock                    \␊
-              IOBlockStorageDriver::_expansionData->contextsLock␊
-    #define _contextsCount                   \␊
-              IOBlockStorageDriver::_expansionData->contextsCount␊
-    #define _contextsMaxCount                \␊
-              IOBlockStorageDriver::_expansionData->contextsMaxCount␊
-␊
-    OSSet *         _openClients;␊
-    OSNumber *      _statistics[kStatisticsCount];␊
-␊
-    /*␊
-     * @struct Context␊
-     * @discussion␊
-     * Context structure for a read/write operation.  It describes the block size,␊
-     * and where applicable, a block type and block sub-type, for a data transfer,␊
-     * as well as the completion information for the original request.  Note that␊
-     * the block type field is unused in the IOBlockStorageDriver class.␊
-     * @field block.size␊
-     * Block size for the operation.␊
-     * @field block.type␊
-     * Block type for the operation.  Unused in IOBlockStorageDriver.  The default␊
-     * value for this field is IOBlockStorageDriver::kBlockTypeStandard.␊
-     * @field block.typeSub␊
-     * Block sub-type for the operation.  It's definition depends on block.type.␊
-     * Unused in IOBlockStorageDriver.␊
-     * @field request.byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param request.buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param request.attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.␊
-     * @param request.completion␊
-     * Completion routine to call once the data transfer is complete.␊
-     */␊
-␊
-    struct Context␊
-    {␊
-#ifdef __LP64__␊
-        struct␊
-        {␊
-            UInt64               byteStart;␊
-            IOMemoryDescriptor * buffer;␊
-            IOStorageAttributes  attributes;␊
-            IOStorageCompletion  completion;␊
-        } request;␊
-␊
-        struct␊
-        {␊
-            UInt32               size;␊
-            UInt8                type;␊
-            UInt8                typeSub[3];␊
-        } block;␊
-␊
-        AbsoluteTime timeStart;␊
-␊
-        UInt64 reserved0704;␊
-        UInt64 reserved0768;␊
-        UInt64 reserved0832;␊
-        UInt64 reserved0896;␊
-#else /* !__LP64__ */␊
-        struct␊
-        {␊
-            UInt32               size;␊
-            UInt8                type;␊
-            UInt8                typeSub[3];␊
-        } block;␊
-␊
-        struct␊
-        {␊
-            UInt64               byteStart;␊
-            IOMemoryDescriptor * buffer;␊
-            IOStorageCompletion  completion;␊
-        } original;␊
-␊
-        AbsoluteTime timeStart;␊
-␊
-        struct␊
-        {␊
-            IOStorageAttributes  attributes;␊
-        } request;␊
-␊
-        UInt32 reserved0448;␊
-#endif /* !__LP64__ */␊
-␊
-        Context * next;␊
-    };␊
-␊
-    static const UInt8 kBlockTypeStandard = 0x00;␊
-␊
-    /*␊
-     * Free all of this object's outstanding resources.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     */␊
-␊
-    void free();␊
-␊
-    /*!␊
-     * @function handleOpen␊
-     * @discussion␊
-     * The handleOpen method grants or denies permission to access this object␊
-     * to an interested client.  The argument is an IOStorageAccess value that␊
-     * specifies the level of access desired -- reader or reader-writer.␊
-     *␊
-     * This method can be invoked to upgrade or downgrade the access level for␊
-     * an existing client as well.  The previous access level will prevail for␊
-     * upgrades that fail, of course.   A downgrade should never fail.  If the␊
-     * new access level should be the same as the old for a given client, this␊
-     * method will do nothing and return success.  In all cases, one, singular␊
-     * close-per-client is expected for all opens-per-client received.␊
-     *␊
-     * This implementation replaces the IOService definition of handleIsOpen().␊
-     * @param client␊
-     * Client requesting the open.␊
-     * @param options␊
-     * Options for the open.  Set to zero.␊
-     * @param access␊
-     * Access level for the open.  Set to kIOStorageAccessReader or␊
-     * kIOStorageAccessReaderWriter.␊
-     * @result␊
-     * Returns true if the open was successful, false otherwise.␊
-     */␊
-␊
-    virtual bool handleOpen(IOService *  client,␊
-                            IOOptionBits options,␊
-                            void *       access);␊
-␊
-    /*!␊
-     * @function handleIsOpen␊
-     * @discussion␊
-     * The handleIsOpen method determines whether the specified client, or any␊
-     * client if none is specified, presently has an open on this object.␊
-     *␊
-     * This implementation replaces the IOService definition of handleIsOpen().␊
-     * @param client␊
-     * Client to check the open state of.  Set to zero to check the open state␊
-     * of all clients.␊
-     * @result␊
-     * Returns true if the client was (or clients were) open, false otherwise.␊
-     */␊
-␊
-    virtual bool handleIsOpen(const IOService * client) const;␊
-␊
-    /*!␊
-     * @function handleClose␊
-     * @discussion␊
-     * The handleClose method closes the client's access to this object.␊
-     *␊
-     * This implementation replaces the IOService definition of handleIsOpen().␊
-     * @param client␊
-     * Client requesting the close.␊
-     * @param options␊
-     * Options for the close.  Set to zero.␊
-     */␊
-␊
-    virtual void handleClose(IOService * client, IOOptionBits options);␊
-␊
-    /*!␊
-     * @function addToBytesTransferred␊
-     * @discussion␊
-     * Update the total number of bytes transferred, the total transfer time,␊
-     * and the total latency time -- used for statistics.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param bytesTransferred␊
-     * Number of bytes transferred in this operation.␊
-     * @param totalTime␊
-     * Nanoseconds spent performing this operation.␊
-     * @param latentTime␊
-     * Nanoseconds of latency during this operation.␊
-     * @param isWrite␊
-     * Indicates whether this operation was a write, otherwise is was a read.␊
-     */␊
-␊
-    virtual void addToBytesTransferred(UInt64 bytesTransferred,␊
-                                       UInt64 totalTime,␊
-                                       UInt64 latentTime,␊
-                                       bool   isWrite);␊
-␊
-    /*!␊
-     * @function incrementErrors␊
-     * @discussion␊
-     * Update the total error count -- used for statistics.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param isWrite␊
-     * Indicates whether this operation was a write, otherwise is was a read.␊
-     */␊
-␊
-    virtual void incrementErrors(bool isWrite);␊
-␊
-    /*!␊
-     * @function incrementRetries␊
-     * @discussion␊
-     * Update the total retry count -- used for statistics.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param isWrite␊
-     * Indicates whether this operation was a write, otherwise is was a read.␊
-     */␊
-␊
-    virtual void incrementRetries(bool isWrite);␊
-␊
-    /*!␊
-     * @function allocateContext␊
-     * @discussion␊
-     * Allocate a context structure for a read/write operation.␊
-     * @result␊
-     * Context structure.␊
-     */␊
-␊
-    virtual Context * allocateContext();␊
-␊
-    /*!␊
-     * @function deleteContext␊
-     * @discussion␊
-     * Delete a context structure from a read/write operation.␊
-     * @param context␊
-     * Context structure to be deleted.␊
-     */␊
-␊
-    virtual void deleteContext(Context * context);␊
-␊
-#ifndef __LP64__␊
-    virtual void prepareRequest(UInt64               byteStart,␊
-                                IOMemoryDescriptor * buffer,␊
-                                IOStorageCompletion  completion) __attribute__ ((deprecated));␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function deblockRequest␊
-     * @discussion␊
-     * The deblockRequest method checks to see if the incoming request rests␊
-     * on the media's block boundaries, and if not, deblocks it.  Deblocking␊
-     * involves rounding out the request to the nearest block boundaries and␊
-     * transferring the excess bytes into a scratch buffer.␊
-     *␊
-     * This method is part of a sequence of methods invoked for each read/write␊
-     * request.  The first is prepareRequest, which allocates and prepares some␊
-     * context for the transfer; the second is deblockRequest, which aligns the␊
-     * transfer at the media's block boundaries; third is breakUpRequest, which␊
-     * breaks up the transfer into multiple sub-transfers when certain hardware␊
-     * constraints are exceeded; fourth is executeRequest, which implements the␊
-     * actual transfer from the block storage device.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param context␊
-     * Additional context information for the data transfer (e.g. block size).␊
-     */␊
-␊
-#ifdef __LP64__␊
-    virtual void deblockRequest(UInt64                byteStart,␊
-                                IOMemoryDescriptor *  buffer,␊
-                                IOStorageAttributes * attributes,␊
-                                IOStorageCompletion * completion,␊
-                                Context *             context);␊
-#else /* !__LP64__ */␊
-    virtual void deblockRequest(UInt64                byteStart,␊
-                                IOMemoryDescriptor *  buffer,␊
-                                IOStorageCompletion   completion,␊
-                                Context *             context);␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function executeRequest␊
-     * @discussion␊
-     * Execute an asynchronous storage request.  The request is guaranteed to be␊
-     * block-aligned.␊
-     *␊
-     * This method is part of a sequence of methods invoked for each read/write␊
-     * request.  The first is prepareRequest, which allocates and prepares some␊
-     * context for the transfer; the second is deblockRequest, which aligns the␊
-     * transfer at the media's block boundaries; third is breakUpRequest, which␊
-     * breaks up the transfer into multiple sub-transfers when certain hardware␊
-     * constraints are exceeded; fourth is executeRequest, which implements the␊
-     * actual transfer from the block storage device.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param context␊
-     * Additional context information for the data transfer (e.g. block size).␊
-     */␊
-␊
-#ifdef __LP64__␊
-    virtual void executeRequest(UInt64                byteStart,␊
-                                IOMemoryDescriptor *  buffer,␊
-                                IOStorageAttributes * attributes,␊
-                                IOStorageCompletion * completion,␊
-                                Context *             context);␊
-#else /* !__LP64__ */␊
-    virtual void executeRequest(UInt64                byteStart,␊
-                                IOMemoryDescriptor *  buffer,␊
-                                IOStorageCompletion   completion,␊
-                                Context *             context);␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function handleStart␊
-     * @discussion␊
-     * Prepare the block storage driver for operation.␊
-     *␊
-     * This is where a media object needs to be created for fixed media, and␊
-     * optionally for removable media.␊
-     *␊
-     * Note that this method is called from within the start() routine;␊
-     * if this method returns successfully,  it should be prepared to accept␊
-     * any of IOBlockStorageDriver's APIs.␊
-     * @param provider␊
-     * This object's provider.␊
-     * @result␊
-     * Returns true on success, false otherwise.␊
-     */␊
-␊
-    virtual bool handleStart(IOService * provider);␊
-␊
-    /*!␊
-     * @function handleYield␊
-     * @discussion␊
-     * Stop the block storage driver.␊
-     *␊
-     * This method is called as a result of a kIOMessageServiceIsRequestingClose␊
-     * provider message.  The argument is passed in as-is from the message.  The␊
-     * options are unused.␊
-     *␊
-     * This is where the driver should clean up its state in preparation for␊
-     * removal from the system.␊
-     *␊
-     * Note that this method is called from within the yield() routine.␊
-     *␊
-     * This method is called with the arbitration lock held.␊
-     * @param provider␊
-     * This object's provider.␊
-     */␊
-␊
-    virtual bool handleYield(IOService *  provider,␊
-                             IOOptionBits options  = 0,␊
-                             void *       argument = 0);␊
-␊
-␊
-    /*!␊
-     * @function getMediaBlockSize␊
-     * @discussion␊
-     * Ask the driver about the media's natural block size.␊
-     * @result␊
-     * Natural block size, in bytes.␊
-     */␊
-␊
-    virtual UInt64 getMediaBlockSize() const;␊
-␊
-public:␊
-␊
-    using IOStorage::read;␊
-    using IOStorage::write;␊
-␊
-    /*␊
-     * Initialize this object's minimal state.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     */␊
-␊
-    virtual bool init(OSDictionary * properties = 0);␊
-␊
-    /*␊
-     * This method is called once we have been attached to the provider object.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     */␊
-␊
-    virtual bool start(IOService * provider);␊
-␊
-    /*␊
-     * This method is called before we are detached from the provider object.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     */␊
-␊
-    virtual void stop(IOService * provider);␊
-␊
-    /*␊
-     * This method is called as a result of a kIOMessageServiceIsRequestingClose␊
-     * provider message.  The argument is passed in as-is from the message.  The␊
-     * options are unused.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     */␊
-␊
-    virtual bool yield(IOService *  provider,␊
-                       IOOptionBits options  = 0,␊
-                       void *       argument = 0);␊
-␊
-    /*!␊
-     * @function read␊
-     * @discussion␊
-     * The read method is the receiving end for all read requests from the␊
-     * storage framework (through the media object created by this driver).␊
-     *␊
-     * This method initiates a sequence of methods (stages) for each read/write␊
-     * request.  The first is prepareRequest, which allocates and prepares some␊
-     * context for the transfer; the second is deblockRequest, which aligns the␊
-     * transfer at the media's block boundaries; third is breakUpRequest, which␊
-     * breaks up the transfer into multiple sub-transfers when certain hardware␊
-     * constraints are exceeded; fourth is executeRequest, which implements the␊
-     * actual transfer from the block storage device.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param client␊
-     * Client requesting the read.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     */␊
-␊
-    virtual void read(IOService *           client,␊
-                      UInt64                byteStart,␊
-                      IOMemoryDescriptor *  buffer,␊
-                      IOStorageAttributes * attributes,␊
-                      IOStorageCompletion * completion);␊
-␊
-    /*!␊
-     * @function write␊
-     * @discussion␊
-     * The write method is the receiving end for all write requests from the␊
-     * storage framework (through the media object created by this driver).␊
-     *␊
-     * This method initiates a sequence of methods (stages) for each read/write␊
-     * request.  The first is prepareRequest, which allocates and prepares some␊
-     * context for the transfer; the second is deblockRequest, which aligns the␊
-     * transfer at the media's block boundaries; third is breakUpRequest, which␊
-     * breaks up the transfer into multiple sub-transfers when certain hardware␊
-     * constraints are exceeded; fourth is executeRequest, which implements the␊
-     * actual transfer from the block storage device.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param client␊
-     * Client requesting the write.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     */␊
-␊
-    virtual void write(IOService *           client,␊
-                       UInt64                byteStart,␊
-                       IOMemoryDescriptor *  buffer,␊
-                       IOStorageAttributes * attributes,␊
-                       IOStorageCompletion * completion);␊
-␊
-    /*!␊
-     * @function synchronizeCache␊
-     * @discussion␊
-     * Flush the cached data in the storage object, if any, synchronously.␊
-     * @param client␊
-     * Client requesting the cache synchronization.␊
-     * @result␊
-     * Returns the status of the cache synchronization.␊
-     */␊
-␊
-    virtual IOReturn synchronizeCache(IOService * client);␊
-␊
-    /*!␊
-     * @function discard␊
-     * @discussion␊
-     * Delete unused data from the storage object at the specified byte offset,␊
-     * synchronously.␊
-     * @param client␊
-     * Client requesting the operation.␊
-     * @param byteStart␊
-     * Starting byte offset for the operation.␊
-     * @param byteCount␊
-     * Size of the operation.␊
-     * @result␊
-     * Returns the status of the operation.␊
-     */␊
-␊
-    virtual IOReturn discard(IOService * client,␊
-                             UInt64      byteStart,␊
-                             UInt64      byteCount);␊
-␊
-    /*!␊
-     * @function ejectMedia␊
-     * @discussion␊
-     * Eject the media from the device.  The driver is responsible for tearing␊
-     * down the media object it created before proceeding with the eject.   If␊
-     * the tear-down fails, an error should be returned.␊
-     * @result␊
-     * An IOReturn code.␊
-     */␊
-␊
-    virtual IOReturn ejectMedia();␊
-␊
-    /*!␊
-     * @function formatMedia␊
-     * @discussion␊
-     * Format the media with the specified byte capacity.  The driver is␊
-     * responsible for tearing down the media object and recreating it.␊
-     * @param byteCapacity␊
-     * Number of bytes to format media to.␊
-     * @result␊
-     * An IOReturn code.␊
-     */␊
-␊
-    virtual IOReturn formatMedia(UInt64 byteCapacity);␊
-␊
-    /*!␊
-     * @function lockMedia␊
-     * @discussion␊
-     * Lock or unlock the ejectable media in the device, that is, prevent␊
-     * it from manual ejection or allow its manual ejection.␊
-     * @param lock␊
-     * Pass true to lock the media, otherwise pass false to unlock the media.␊
-     * @result␊
-     * An IOReturn code.␊
-     */␊
-␊
-    virtual IOReturn lockMedia(bool lock);␊
-␊
-    /*!␊
-     * @function pollMedia␊
-     * @discussion␊
-     * Poll for the presence of media in the device.  The driver is responsible␊
-     * for tearing down the media object it created should the media have been␊
-     * removed since the last poll, and vice-versa, creating the media object␊
-     * should new media have arrived since the last poll.␊
-     * @result␊
-     * An IOReturn code.␊
-     */␊
-␊
-    virtual IOReturn pollMedia();␊
-␊
-    /*!␊
-     * @function isMediaEjectable␊
-     * @discussion␊
-     * Ask the driver whether the media is ejectable.␊
-     * @result␊
-     * Returns true if the media is ejectable, false otherwise.␊
-     */␊
-␊
-    virtual bool isMediaEjectable() const;␊
-␊
-#ifdef __LP64__␊
-    /*!␊
-     * @function isMediaRemovable␊
-     * @discussion␊
-     * Ask the driver whether the media is ejectable.␊
-     * @result␊
-     * Returns true if the media is ejectable, false otherwise.␊
-     */␊
-␊
-    virtual bool isMediaRemovable() const;␊
-#endif /* __LP64__ */␊
-␊
-    /*!␊
-     * @function isMediaPollExpensive␊
-     * @discussion␊
-     * Ask the driver whether a pollMedia() would be an expensive operation,␊
-     * that is, one that requires the device to spin up or delay for a while.␊
-     * @result␊
-     * Returns true if polling the media is expensive, false otherwise.␊
-     */␊
-␊
-    virtual bool isMediaPollExpensive() const;␊
-␊
-    /*!␊
-     * @function isMediaPollRequired␊
-     * @discussion␊
-     * Ask the driver whether the block storage device requires polling,  which is␊
-     * typically required for devices without the ability to asynchronously detect␊
-     * the arrival or departure of the media.␊
-     * @result␊
-     * Returns true if polling the media is required, false otherwise.␊
-     */␊
-␊
-    virtual bool isMediaPollRequired() const;␊
-␊
-    virtual bool isMediaWritable() const;␊
-␊
-    /*!␊
-     * @function getMediaState␊
-     * @discussion␊
-     * Ask the driver about the media's current state.␊
-     * @result␊
-     * An IOMediaState value.␊
-     */␊
-␊
-    virtual IOMediaState getMediaState() const;␊
-␊
-    /*!␊
-     * @function getFormatCapacities␊
-     * @discussion␊
-     * Ask the driver to report the feasible formatting capacities for the␊
-     * inserted media (in bytes).  This routine fills the caller's buffer,␊
-     * up to the maximum count specified if the real number of capacities␊
-     * would overflow the buffer.   The return value indicates the actual␊
-     * number of capacities copied to the buffer.␊
-     *␊
-     * If the capacities buffer is not supplied or if the maximum count is␊
-     * zero, the routine returns the proposed count of capacities instead.␊
-     * @param capacities␊
-     * Buffer that will receive the UInt64 capacity values.␊
-     * @param capacitiesMaxCount␊
-     * Maximum number of capacity values that can be held in the buffer.␊
-     * @result␊
-     * Actual number of capacity values copied to the buffer, or if no buffer␊
-     * is given, the total number of capacity values available.␊
-     */␊
-␊
-    virtual UInt32 getFormatCapacities(UInt64 * capacities,␊
-                                       UInt32   capacitiesMaxCount) const;␊
-␊
-    /*!␊
-     * @function getStatistics␊
-     * @discussion␊
-     * Ask the driver to report its operating statistics.␊
-     *␊
-     * The statistics are each indexed by IOBlockStorageDriver::Statistics␊
-     * indices.  This routine fills the caller's buffer, up to the maximum␊
-     * count specified if the real number of statistics would overflow the␊
-     * buffer.  The return value indicates the actual number of statistics␊
-     * copied to the buffer.␊
-     *␊
-     * If the statistics buffer is not supplied or if the maximum count is␊
-     * zero, the routine returns the proposed count of statistics instead.␊
-     * @param statistics␊
-     * Buffer that will receive the UInt64 statistic values.␊
-     * @param statisticsMaxCount␊
-     * Maximum number of statistic values that can be held in the buffer.␊
-     * @result␊
-     * Actual number of statistic values copied to the buffer, or if no buffer␊
-     * is given, the total number of statistic values available.␊
-     */␊
-␊
-    virtual UInt32 getStatistics(UInt64 * statistics,␊
-                                 UInt32   statisticsMaxCount) const;␊
-␊
-    /*!␊
-     * @function getStatistic␊
-     * @discussion␊
-     * Ask the driver to report one of its operating statistics.␊
-     * @param statistic␊
-     * Statistic index (an IOBlockStorageDriver::Statistics index).␊
-     * @result␊
-     * Statistic value.␊
-     */␊
-␊
-    virtual UInt64 getStatistic(Statistics statistic) const;␊
-␊
-    /*␊
-     * Generic entry point for calls from the provider.  A return value of␊
-     * kIOReturnSuccess indicates that the message was received, and where␊
-     * applicable, that it was successful.␊
-     */␊
-␊
-    virtual IOReturn message(UInt32 type, IOService * provider, void * argument);␊
-␊
-    /*␊
-     * Obtain this object's provider.  We override the superclass's method to␊
-     * return a more specific subclass of IOService -- IOBlockStorageDevice.  ␊
-     * This method serves simply as a convenience to subclass developers.␊
-     */␊
-␊
-    virtual IOBlockStorageDevice * getProvider() const;␊
-␊
-protected:␊
-␊
-    IOLock *      _deblockRequestWriteLock;␊
-    thread_call_t _pollerCall;␊
-␊
-    /*␊
-     * This is the completion routine for the broken up breaker sub-requests.␊
-     * It verifies the success of the just-completed stage,  transitions to␊
-     * the next stage, then builds and issues a transfer for the next stage.␊
-     */␊
-␊
-    static void breakUpRequestCompletion(void *   target,␊
-                                         void *   parameter,␊
-                                         IOReturn status,␊
-                                         UInt64   actualByteCount);␊
-␊
-    /*␊
-     * This is the completion routine for the aligned deblocker sub-requests.␊
-     * It verifies the success of the just-completed stage,  transitions to␊
-     * the next stage, then builds and issues a transfer for the next stage.␊
-     */␊
-␊
-    static void deblockRequestCompletion(void *   target,␊
-                                         void *   parameter,␊
-                                         IOReturn status,␊
-                                         UInt64   actualByteCount);␊
-␊
-    /*␊
-     * This is the completion routine for the prepared request.  It updates␊
-     * the driver's statistics, performs some clean up work, then calls the␊
-     * original request's completion routine.␊
-     */␊
-␊
-    static void prepareRequestCompletion(void *   target,␊
-                                         void *   parameter,␊
-                                         IOReturn status,␊
-                                         UInt64   actualByteCount);␊
-␊
-    /*␊
-     * Schedule the poller mechanism.␊
-     */␊
-␊
-    virtual void schedulePoller();␊
-␊
-    /*␊
-     * Unschedule the poller mechanism.␊
-     */␊
-␊
-    virtual void unschedulePoller();␊
-␊
-    /*␊
-     * This method is the timeout handler for the poller mechanism.  It polls␊
-     * for media and reschedules another timeout if there are still no opens.␊
-     */␊
-␊
-    static void poller(void *, void *);␊
-␊
-    /*␊
-     * This method is the power event handler for restarts and shutdowns.␊
-     */␊
-␊
-    static IOReturn handlePowerEvent(void *      target,␊
-                                     void *      parameter,␊
-                                     UInt32      messageType,␊
-                                     IOService * provider,␊
-                                     void *      messageArgument,␊
-                                     vm_size_t   messageArgumentSize);␊
-␊
-protected:␊
-␊
-    /* Device info: */␊
-␊
-    /*!␊
-     * @var _removable␊
-     * True if the media is removable; False if it is fixed (not removable).␊
-     */␊
-    bool␉␉_removable;␊
-␊
-    /*!␊
-     * @var _ejectable␊
-     * True if the media is ejectable under software control.␊
-     */␊
-    bool␉␉_ejectable;␉␉/* software-ejectable */␊
-␊
-    /*!␊
-     * @var _lockable␊
-     * True if the media can be locked in the device under software control.␊
-     */␊
-    bool␉␉_lockable;␉␉/* software lockable in device */␊
-    /*!␊
-     * @var _pollIsRequired␊
-     * True if we must poll to detect media insertion or removal.␊
-     */␊
-    bool␉␉_pollIsRequired;␊
-    /*!␊
-     * @var _pollIsExpensive␊
-     * True if polling is expensive; False if not.␊
-     */␊
-    bool␉␉_pollIsExpensive;␊
-␊
-    /* Media info and states: */␊
-␊
-    /*!␊
-     * @var _mediaObject␊
-     * A pointer to the media object we have instantiated (if any).␊
-     */␊
-    IOMedia *␉␉_mediaObject;␊
-    /*!␊
-     * @var _mediaType␊
-     * Type of the media (can be used to differentiate between the␊
-     * different types of CD media, DVD media, etc).␊
-     */␊
-    UInt32␉␉_mediaType;␊
-    /*!␊
-     * @var _mediaPresent␊
-     * True if media is present in the device; False if not.␊
-     */␊
-    bool␉␉_mediaPresent;␉␉/* media is present and ready */␊
-    /*!␊
-     * @var _writeProtected␊
-     * True if the media is write-protected; False if not.␊
-     */␊
-    bool␉␉_writeProtected;␊
-    ␊
-private:␊
-␊
-    /*!␊
-     * @var _mediaStateLock␊
-     * A lock used to protect during media checks.␊
-     */␊
-    IOLock *␉␉_mediaStateLock;␊
-␊
-protected:␊
-␊
-    /*!␊
-     * @var _mediaBlockSize␊
-     * The block size of the media, in bytes.␊
-     */␊
-    UInt64␉␉_mediaBlockSize;␊
-    /*!␊
-     * @var _maxBlockNumber␊
-     * The maximum allowable block number for the media, zero-based.␊
-     */␊
-    UInt64␉␉_maxBlockNumber;␊
-␊
-    /*!␊
-     * @var _maxReadByteTransfer␊
-     * The maximum byte transfer allowed for read operations.␊
-     */␊
-    UInt64␉␉_maxReadByteTransfer;␊
-␊
-    /*!␊
-     * @var _maxWriteByteTransfer␊
-     * The maximum byte transfer allowed for write operations.␊
-     */␊
-    UInt64␉␉_maxWriteByteTransfer;␊
-␊
-    /*!␊
-     * @function acceptNewMedia␊
-     * @abstract␊
-     * React to new media insertion.␊
-     * @discussion␊
-     * This method logs the media block size and block count, then calls␊
-     * instantiateMediaObject to get a media object instantiated. The␊
-     * media object is then attached above us and registered.␊
-     * ␊
-     * This method can be overridden to control what happens when new media␊
-     * is inserted. The default implementation deals with one IOMedia object.␊
-     */␊
-    virtual IOReturn␉acceptNewMedia(void);␊
-    ␊
-    /*!␊
-     * @function constrainByteCount␊
-     * @abstract␊
-     * Constrain the byte count for this IO to device limits.␊
-     * @discussion␊
-     * This function should be called prior to each read or write operation, so that␊
-     * the driver can constrain the requested byte count, as necessary, to meet␊
-     * current device limits. Such limits could be imposed by the device depending␊
-     * on operating modes, media types, or transport protocol (e.g. ATA, SCSI).␊
-     * ␊
-     * At present, this method is not used.␊
-     * @param requestedCount␊
-     * The requested byte count for the next read or write operation.␊
-     * @param isWrite␊
-     * True if the operation will be a write; False if the operation will be a read.␊
-     */␊
-    virtual UInt64␉constrainByteCount(UInt64 requestedCount,bool isWrite);␊
-␊
-    /*!␊
-     * @function decommissionMedia␊
-     * @abstract␊
-     * Decommission an existing piece of media that has gone away.␊
-     * @discussion␊
-     * This method wraps a call to terminate, to tear down the stack and␊
-     * the IOMedia object for the media. If "forcible" is true, the media␊
-     * object will be forgotten, and initMediaState will be called. A␊
-     * forcible decommission would occur when an unrecoverable error␊
-     * happens during tear-down (e.g. perhaps a client is still open), but␊
-     * we must still forget about the media.␊
-     * @param forcible␊
-     * True to force forgetting of the media object even if terminate reports␊
-     * that there was an active client.␊
-     */␊
-    virtual IOReturn␉decommissionMedia(bool forcible);␊
-␊
-    /*!␊
-     * @function instantiateDesiredMediaObject␊
-     * @abstract␊
-     * Create an IOMedia object for media.␊
-     * @discussion␊
-     * This method creates the exact type of IOMedia object desired. It is called by␊
-     * instantiateMediaObject. A subclass may override this one-line method to change␊
-     * the type of media object actually instantiated.␊
-     */␊
-    virtual IOMedia *␉instantiateDesiredMediaObject(void);␊
-␊
-    /*!␊
-     * @function instantiateMediaObject␊
-     * @abstract␊
-     * Create an IOMedia object for media.␊
-     * @discussion␊
-     * This method creates an IOMedia object from the supplied parameters. It is a␊
-     * convenience method to wrap the handful of steps to do the job.␊
-     * @param base␊
-     * Byte number of beginning of active data area of the media. Usually zero.␊
-     * @param byteSize␊
-     * Size of the data area of the media, in bytes.␊
-     * @param blockSize␊
-     * Block size of the media, in bytes.␊
-     * @param mediaName␊
-     * Name of the IOMedia object.␊
-     * @result␊
-     * A pointer to the created IOMedia object, or a null on error.␊
-     */␊
-    virtual IOMedia *␉instantiateMediaObject(UInt64 base,UInt64 byteSize,␊
-                                            UInt32 blockSize,char *mediaName);␊
-␊
-    /*!␊
-     * @function recordMediaParameters␊
-     * @abstract␊
-     * Obtain media-related parameters on media insertion.␊
-     * @discussion␊
-     * This method obtains media-related parameters via calls to the␊
-     * Transport Driver's reportBlockSize, reportMaxValidBlock,␊
-     * and reportWriteProtection methods.␊
-     */␊
-    virtual IOReturn␉recordMediaParameters(void);␊
-␊
-    /*!␊
-     * @function rejectMedia␊
-     * @abstract␊
-     * Reject new media.␊
-     * @discussion␊
-     * This method will be called if validateNewMedia returns False (thus rejecting␊
-     * the new media. A vendor may choose to override this method to control behavior␊
-     * when media is rejected.␊
-     * ␊
-     * The default implementation simply calls ejectMedia.␊
-     */␊
-    virtual void␉rejectMedia(void);␉/* default ejects */␊
-    ␊
-    /*!␊
-     * @function validateNewMedia␊
-     * @abstract␊
-     * Verify that new media is acceptable.␊
-     * @discussion␊
-     * This method will be called whenever new media is detected. Return true to accept␊
-     * the media, or false to reject it (and call rejectMedia). Vendors might override␊
-     * this method to handle password-protection for new media.␊
-     * ␊
-     * The default implementation always returns True, indicating media is accepted.␊
-     */␊
-    virtual bool␉validateNewMedia(void);␊
-␊
-    /* --- Internally used methods. --- */␊
-␊
-    /*␊
-     * @group␊
-     * Internally Used Methods␊
-     * @discussion␊
-     * These methods are used internally, and will not generally be modified.␊
-     */␊
-    ␊
-    /*!␊
-     * @function checkForMedia␊
-     * @abstract␊
-     * Check if media has newly arrived or disappeared.␊
-     * @discussion␊
-     * This method does most of the work in polling for media, first␊
-     * calling the block storage device's reportMediaState method. If␊
-     * reportMediaState reports no change in the media state, kIOReturnSuccess␊
-     * is returned. If the media state has indeed changed, a call is made to␊
-     * mediaStateHasChanged to act on the event.␊
-     */␊
-    virtual IOReturn␉checkForMedia(void);␊
-␊
-    /*!␊
-     * @function getDeviceTypeName␊
-     * @abstract␊
-     * Return the desired device name.␊
-     * @discussion␊
-     * This method returns a string, used to compare the ␊
-     * kIOBlockStorageDeviceTypeKey of our provider. This method is called from␊
-     * probe.␊
-     *  ␊
-     * The default implementation of this method returns ␊
-     * kIOBlockStorageDeviceTypeGeneric.␊
-     */␊
-    virtual const char * getDeviceTypeName(void);␊
-␊
-    /*!␊
-     * @function initMediaState␊
-     * @abstract␊
-     * Initialize media-related instance variables.␊
-     * @discussion␊
-     * Called when media is not present, this method marks the device state␊
-     * as not having media present, not spun up, and write-enabled.␊
-     */␊
-    virtual void␉initMediaState(void);␊
-    ␊
-    /*!␊
-     * @function mediaStateHasChanged␊
-     * @abstract␊
-     * React to a new media insertion or a media removal.␊
-     * @discussion␊
-     * This method is called on a media state change, that is, an arrival␊
-     * or removal. If media has just become available, calls are made to␊
-     * recordMediaParameters and acceptNewMedia. If media has just gone␊
-     * away, a call is made to decommissionMedia, with the forcible␊
-     * parameter set to true. The forcible tear-down is needed to enforce␊
-     * the disappearance of media, regardless of interested clients.␊
-     */␊
-    virtual IOReturn␉mediaStateHasChanged(IOMediaState state);␊
-␊
-    /*␊
-     * @endgroup␊
-     */␊
-␊
-protected:␊
-␊
-    /*!␊
-     * @function breakUpRequest␊
-     * @discussion␊
-     * The breakUpRequest method checks to see if the incoming request exceeds␊
-     * our transfer constraints, and if so, breaks up the request into smaller␊
-     * sub-requests.␊
-     *␊
-     * This method is part of a sequence of methods invoked for each read/write␊
-     * request.  The first is prepareRequest, which allocates and prepares some␊
-     * context for the transfer; the second is deblockRequest, which aligns the␊
-     * transfer at the media's block boundaries; third is breakUpRequest, which␊
-     * breaks up the transfer into multiple sub-transfers when certain hardware␊
-     * constraints are exceeded; fourth is executeRequest, which implements the␊
-     * actual transfer from the block storage device.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param context␊
-     * Additional context information for the data transfer (e.g. block size).␊
-     */␊
-␊
-#ifdef __LP64__␊
-    virtual void breakUpRequest(UInt64                byteStart,␊
-                                IOMemoryDescriptor *  buffer,␊
-                                IOStorageAttributes * attributes,␊
-                                IOStorageCompletion * completion,␊
-                                Context *             context);␊
-#else /* !__LP64__ */␊
-    virtual void breakUpRequest(UInt64                byteStart,␊
-                                IOMemoryDescriptor *  buffer,␊
-                                IOStorageCompletion   completion,␊
-                                Context *             context); /* 10.1.2 */␊
-#endif /* !__LP64__ */␊
-␊
-    /*!␊
-     * @function prepareRequest␊
-     * @discussion␊
-     * The prepareRequest method allocates and prepares state for the transfer.␊
-     *␊
-     * This method is part of a sequence of methods invoked for each read/write␊
-     * request.  The first is prepareRequest, which allocates and prepares some␊
-     * context for the transfer; the second is deblockRequest, which aligns the␊
-     * transfer at the media's block boundaries; third is breakUpRequest, which␊
-     * breaks up the transfer into multiple sub-transfers when certain hardware␊
-     * constraints are exceeded; fourth is executeRequest, which implements the␊
-     * actual transfer from the block storage device.␊
-     *␊
-     * This method's implementation is not typically overridden.␊
-     * @param byteStart␊
-     * Starting byte offset for the data transfer.␊
-     * @param buffer␊
-     * Buffer for the data transfer.  The size of the buffer implies the size of␊
-     * the data transfer.␊
-     * @param attributes␊
-     * Attributes of the data transfer.  See IOStorageAttributes.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     * @param completion␊
-     * Completion routine to call once the data transfer is complete.  It is the␊
-     * responsibility of the callee to maintain the information for the duration␊
-     * of the data transfer, as necessary.␊
-     */␊
-␊
-    virtual void prepareRequest(UInt64                byteStart,␊
-                                IOMemoryDescriptor *  buffer,␊
-                                IOStorageAttributes * attributes,␊
-                                IOStorageCompletion * completion); /* 10.5.0 */␊
-␊
-public:␊
-␊
-    /*!␊
-     * @function requestIdle␊
-     * @abstract␊
-     * Request that the device enter an idle state.␊
-     * @discussion␊
-     * Request that the device enter an idle state.  The device will exit this state on the␊
-     * next read or write request, or as it sees necessary.  One example is for a DVD drive␊
-     * to spin down when it enters such an idle state, and spin up on the next read request␊
-     * from the system.␊
-     */␊
-    virtual IOReturn␉requestIdle(void); /* 10.6.0 */␊
-␊
-#ifdef __LP64__␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  0);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  1);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  2);␊
-#else /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUsed(IOBlockStorageDriver,  0);␊
-    OSMetaClassDeclareReservedUsed(IOBlockStorageDriver,  1);␊
-    OSMetaClassDeclareReservedUsed(IOBlockStorageDriver,  2);␊
-#endif /* !__LP64__ */␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  3);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  4);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  5);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  6);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  7);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  8);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver,  9);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 10);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 11);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 12);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 13);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 14);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 15);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 16);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 17);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 18);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 19);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 20);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 21);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 22);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 23);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 24);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 25);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 26);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 27);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 28);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 29);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 30);␊
-    OSMetaClassDeclareReservedUnused(IOBlockStorageDriver, 31);␊
-};␊
-␊
-#endif /* __cplusplus */␊
-#endif /* KERNEL */␊
 #endif /* !_IOBLOCKSTORAGEDRIVER_H */␊

-152
153 153
154 154
155 
156 
157 
158 
159 
160 
161 155
162 156
163 157
+␉@$(SYMROOT)/machOconv $(SYMROOT)/boot.sys $(SYMROOT)/boot␊
␊
␊
$(SYMROOT)/vers.h:␊
␉@echo "#define I386BOOT_VERSION \"5.0.132\"" > $(SYMROOT)/vers.h␊
␉@echo "#define I386BOOT_BUILDDATE \"`date \"+%Y-%m-%d %H:%M:%S\"`\"" >> $(SYMROOT)/vers.h␊
␉@echo "#define I386BOOT_CHAMELEONVERSION \"`cat ../../version`\"" >> $(SYMROOT)/vers.h␊
␉@echo "#define I386BOOT_CHAMELEONREVISION \"`svnversion -n | tr -d [:alpha:]`\"" >> $(SYMROOT)/vers.h␊
␊
$(SYMROOT)/art.h:␊
␉@if [ "$(PNGCRUSH)" ]; then␉\␊
␉␉echo "optimizing art files ...\n$(PNGCRUSH) $(PNGOPTIONS) artwork/$(THEME)"; \␊
 ␉@$(SYMROOT)/machOconv $(SYMROOT)/boot.sys $(SYMROOT)/boot␊
 ␊
 ␊
-$(SYMROOT)/vers.h:␊
-␉@echo "#define I386BOOT_VERSION \"5.0.132\"" > $(SYMROOT)/vers.h␊
-␉@echo "#define I386BOOT_BUILDDATE \"`date \"+%Y-%m-%d %H:%M:%S\"`\"" >> $(SYMROOT)/vers.h␊
-␉@echo "#define I386BOOT_CHAMELEONVERSION \"`cat ../../version`\"" >> $(SYMROOT)/vers.h␊
-␉@echo "#define I386BOOT_CHAMELEONREVISION \"`svnversion -n | tr -d [:alpha:]`\"" >> $(SYMROOT)/vers.h␊
-␊
 $(SYMROOT)/art.h:␊
 ␉@if [ "$(PNGCRUSH)" ]; then␉\␊
 ␉␉echo "optimizing art files ...\n$(PNGCRUSH) $(PNGOPTIONS) artwork/$(THEME)"; \␊

-191
192 192
193 193
194 
194
195
196
197
198
199
200
201
202
195 203
196 204
197 205
+␉␊
␉usb_loop();␊
␉␊
␉execute_hook("Kernel Start", (void*)kernelEntry, (void*)bootArgs, NULL, NULL);␉// Notify modules that the kernel is about to be started␊
    if (checkOSVersion("10.7"))␊
    {␊
        execute_hook("Kernel Start", (void*)kernelEntry, (void*)bootArgs, NULL, NULL);␉// Notify modules that the kernel is about to be started␊
    }␊
    else␊
    {␊
        execute_hook("Kernel Start", (void*)kernelEntry, (void*)bootArgsPreLion, NULL, NULL);␉// Notify modules that the kernel is about to be started␊
    }␊
    ␊
␉// If we were in text mode, switch to graphics mode.␊
␉// This will draw the boot graphics unless we are in␊
␉// verbose mode.␊
 ␉␊
 ␉usb_loop();␊
 ␉␊
-␉execute_hook("Kernel Start", (void*)kernelEntry, (void*)bootArgs, NULL, NULL);␉// Notify modules that the kernel is about to be started␊
+    if (checkOSVersion("10.7"))␊
+    {␊
+        execute_hook("Kernel Start", (void*)kernelEntry, (void*)bootArgs, NULL, NULL);␉// Notify modules that the kernel is about to be started␊
+    }␊
+    else␊
+    {␊
+        execute_hook("Kernel Start", (void*)kernelEntry, (void*)bootArgsPreLion, NULL, NULL);␉// Notify modules that the kernel is about to be started␊
+    }␊
+    ␊
 ␉// If we were in text mode, switch to graphics mode.␊
 ␉// This will draw the boot graphics unless we are in␊
 ␉// verbose mode.␊

-161
162 162
163 163
164 
164
165 165
166 166
167 
167
168 168
169 169
170 170
+.PHONY: $(SRCROOT)/sym/i386/boot_modules.c␊
␊
$(SRCROOT)/sym/i386/boot_modules.c: ␊
␉echo "\tstart_built_in_module(\"$(MODULE_NAME)\", &$(MODULE_START));" >> $@␊
␉@echo "\tstart_built_in_module(\"$(MODULE_NAME)\", &$(MODULE_START));" >> $@␊
␉␊
$(SRCROOT)/sym/i386/boot_modules.h:␊
␉echo "void $(MODULE_START)(); // $(MODULE_NAME)" >> $@␊
␉@echo "void $(MODULE_START)(); // $(MODULE_NAME)" >> $@␊
␊
␊
#dependencies␊
 .PHONY: $(SRCROOT)/sym/i386/boot_modules.c␊
 ␊
 $(SRCROOT)/sym/i386/boot_modules.c: ␊
-␉echo "\tstart_built_in_module(\"$(MODULE_NAME)\", &$(MODULE_START));" >> $@␊
+␉@echo "\tstart_built_in_module(\"$(MODULE_NAME)\", &$(MODULE_START));" >> $@␊
 ␉␊
 $(SRCROOT)/sym/i386/boot_modules.h:␊
-␉echo "void $(MODULE_START)(); // $(MODULE_NAME)" >> $@␊
+␉@echo "void $(MODULE_START)(); // $(MODULE_NAME)" >> $@␊
 ␊
 ␊
 #dependencies␊

-60
61 61
62 62
63 
63
64 64
65 65
66 66
... ...
68 68
69 69
70 70
71 
71
72 72
73 73
+␊
$(SYMROOT)/boot_modules.c: ${OBJROOT} ${SYMROOT}/modules/ ${OBJROOT} $(addprefix $(OBJROOT)/, ${MODULE_OBJS})␊
ifeq ($(BUILT_IN),yes)␊
␉echo "// Autogenerated - do not modify" > $@␊
␉@echo "// Autogenerated - do not modify" > $@␊
␉@echo "#include <modules.h>" >> $@␊
␉@echo "#include \"boot_modules.h\"" >> $@␊
␉@echo "void start_built_in_modules() {" >> $@␊

␊
$(SYMROOT)/boot_modules.h: ${OBJROOT} ${SYMROOT}/modules/ ${OBJROOT} $(addprefix $(OBJROOT)/, ${MODULE_OBJS})␊
ifeq ($(BUILT_IN),yes)␊
␉echo "// Autogenerated - do not modify" > $@␊
␉@echo "// Autogenerated - do not modify" > $@␊
␉@echo "void start_built_in_modules(); " > $@␊
endif␊
 ...
 ␊
 $(SYMROOT)/boot_modules.c: ${OBJROOT} ${SYMROOT}/modules/ ${OBJROOT} $(addprefix $(OBJROOT)/, ${MODULE_OBJS})␊
 ifeq ($(BUILT_IN),yes)␊
-␉echo "// Autogenerated - do not modify" > $@␊
+␉@echo "// Autogenerated - do not modify" > $@␊
 ␉@echo "#include <modules.h>" >> $@␊
 ␉@echo "#include \"boot_modules.h\"" >> $@␊
 ␉@echo "void start_built_in_modules() {" >> $@␊
 ␊
 $(SYMROOT)/boot_modules.h: ${OBJROOT} ${SYMROOT}/modules/ ${OBJROOT} $(addprefix $(OBJROOT)/, ${MODULE_OBJS})␊
 ifeq ($(BUILT_IN),yes)␊
-␉echo "// Autogenerated - do not modify" > $@␊
+␉@echo "// Autogenerated - do not modify" > $@␊
 ␉@echo "void start_built_in_modules(); " > $@␊
 endif␊

-
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
+/*␊
 * Copyright (c) 2002 Apple Computer, Inc. All rights reserved.␊
 * ␊
 * @APPLE_LICENSE_HEADER_START@␊
 * ␊
 * 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.␊
 * ␊
 * 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,␊
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,␊
 * 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@␊
 */␊
␊
#include "mbr.h"␊
␊
/* Prototypes */␊
void AUTO_print_styles __P((FILE *));␊
int AUTO_init __P((disk_t *, char *, mbr_t *));␊
␊
#define AUTO_OK   0␊
#define AUTO_ERR  -1␊
+/*␊
+ * Copyright (c) 2002 Apple Computer, Inc. All rights reserved.␊
+ * ␊
+ * @APPLE_LICENSE_HEADER_START@␊
+ * ␊
+ * 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.␊
+ * ␊
+ * 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,␊
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,␊
+ * 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@␊
+ */␊
+␊
+#include "mbr.h"␊
+␊
+/* Prototypes */␊
+void AUTO_print_styles __P((FILE *));␊
+int AUTO_init __P((disk_t *, char *, mbr_t *));␊
+␊
+#define AUTO_OK   0␊
+#define AUTO_ERR  -1␊

-
2
3
4
5
6
7
+config FDISK440␊
␉bool "fdisk440 utility"␊
␉default y␊
␉help␊
␉  Say Y here if you want to compile the fdisk440 utility.␊
␉  fdisk440 is used to update the boot0 file on the partition by replacing the first 440 bytes, instead of the first 446 bytes as with frisk.␊
␉  When in doubt, say "Y".␊
+config FDISK440␊
+␉bool "fdisk440 utility"␊
+␉default y␊
+␉help␊
+␉  Say Y here if you want to compile the fdisk440 utility.␊
+␉  fdisk440 is used to update the boot0 file on the partition by replacing the first 440 bytes, instead of the first 446 bytes as with frisk.␊
+␉  When in doubt, say "Y".␊

-6
7 7
8 8
9
10
+␉  bdmesg is used to dump any messages thrown during the␊
␉  chameleon boot sequence.␊
␉  When in doubt, say "Y".␊
␊
source "i386/util/fdisk/Cconfig"␊
 ␉  bdmesg is used to dump any messages thrown during the␊
 ␉  chameleon boot sequence.␊
 ␉  When in doubt, say "Y".␊
+␊
+source "i386/util/fdisk/Cconfig"␊

-31
32 32
33 33
34 
34
35 35
36 36
37 37
... ...
42 42
43 43
44 44
45
46
47
48
49
50
51
45 52
46 53
+␊
DIRS_NEEDED = $(OBJROOT) $(SYMROOT)␊
␊
all: $(DIRS_NEEDED) $(SYMPROG)␊
all: $(DIRS_NEEDED) $(SYMPROG) fdisk440␊
␊
$(SYMPROG): $(addprefix $(OBJROOT)/, $(OBJECTS))␊
␉@echo "\t[LD32] $(@F)_32"␊

␉@lipo -create -arch i386 $(SYMROOT)/$(@F)_32 -arch x86_64 $(SYMROOT)/$(@F)_64 -output $(SYMROOT)/$(@F)␊
␉@$(RM) $(SYMROOT)/$(@F)_32 $(SYMROOT)/$(@F)_64␊
␊
␊
␊
.PHONY: fdisk440␊
fdisk440:␊
␉@echo ================= make all for fdisk =================;␊
␉@$(MAKE) -C fdisk␊
␊
#dependencies␊
-include $(OBJROOT)/Makedep␊
 ...
 ␊
 DIRS_NEEDED = $(OBJROOT) $(SYMROOT)␊
 ␊
-all: $(DIRS_NEEDED) $(SYMPROG)␊
+all: $(DIRS_NEEDED) $(SYMPROG) fdisk440␊
 ␊
 $(SYMPROG): $(addprefix $(OBJROOT)/, $(OBJECTS))␊
 ␉@echo "\t[LD32] $(@F)_32"␊
 ␉@lipo -create -arch i386 $(SYMROOT)/$(@F)_32 -arch x86_64 $(SYMROOT)/$(@F)_64 -output $(SYMROOT)/$(@F)␊
 ␉@$(RM) $(SYMROOT)/$(@F)_32 $(SYMROOT)/$(@F)_64␊
 ␊
+␊
+␊
+.PHONY: fdisk440␊
+fdisk440:␊
+␉@echo ================= make all for fdisk =================;␊
+␉@$(MAKE) -C fdisk␊
+␊
 #dependencies␊
 -include $(OBJROOT)/Makedep␊

-66
67 67
68 68
69 
70 
69
70
71 71
72 72
73 73
... ...
121 121
122 122
123 123
124 
125 
126 
127 
128 
129 
130 
131 
132 124
133 125
134 126
+␉cp -f ${1%/*}/i386/cdboot ${1}/Core/Root/usr/standalone/i386␊
␉cp -f ${1%/*}/i386/chain0 ${1}/Core/Root/usr/standalone/i386␊
␉fixperms "${1}/Core/Root/"␊
␉cp -f ${pkgroot}/fdisk440 ${1}/Core/Root/usr/sbin␊
#␉cp -f ${1%/*}/i386/bdmesg ${1}/Core/Root/usr/sbin␊
␉cp -f ${1%/*}/i386/fdisk440 ${1}/Core/Root/usr/sbin␊
␉cp -f ${1%/*}/i386/bdmesg ${1}/Core/Root/usr/sbin␊
␉local coresize=$( du -hkc "${1}/Core/Root" | tail -n1 | awk {'print $1'} )␊
␉echo "␉[BUILD] i386 "␊
␉buildpackage "${1}/Core" "/" "0" "start_visible=\"false\" start_selected=\"true\"" >/dev/null 2>&1␊

␉␉outline[$((outlinecount++))]="${indent[$xmlindent]}\t</line>"␊
␉# End build Modules packages␊
␊
␉# build bdmesg package ␊
#␉␉mkdir -p ${1}/Bdmesg/Root␊
#␉␉cp -f ${1%/*}/i386/bdmesg ${1}/Bdmesg/Root␊
#␉␉fixperms "${1}/Bdmesg/Root/"␊
␉␉# echo "␉[BUILD] bdmesg "␊
#␉␉buildpackage "${1}/Bdmesg" "/usr/sbin/" "0" "start_visible=\"false\" start_selected=\"true\"" >/dev/null 2>&1␊
␉# End build bdmesg package ␊
␊
␉((xmlindent--))␊
␉outline[$((outlinecount++))]="${indent[$xmlindent]}\t</line>"␊
# End build Chameleon package␊
 ...
 ␉cp -f ${1%/*}/i386/cdboot ${1}/Core/Root/usr/standalone/i386␊
 ␉cp -f ${1%/*}/i386/chain0 ${1}/Core/Root/usr/standalone/i386␊
 ␉fixperms "${1}/Core/Root/"␊
-␉cp -f ${pkgroot}/fdisk440 ${1}/Core/Root/usr/sbin␊
-#␉cp -f ${1%/*}/i386/bdmesg ${1}/Core/Root/usr/sbin␊
+␉cp -f ${1%/*}/i386/fdisk440 ${1}/Core/Root/usr/sbin␊
+␉cp -f ${1%/*}/i386/bdmesg ${1}/Core/Root/usr/sbin␊
 ␉local coresize=$( du -hkc "${1}/Core/Root" | tail -n1 | awk {'print $1'} )␊
 ␉echo "␉[BUILD] i386 "␊
 ␉buildpackage "${1}/Core" "/" "0" "start_visible=\"false\" start_selected=\"true\"" >/dev/null 2>&1␊
 ␉␉outline[$((outlinecount++))]="${indent[$xmlindent]}\t</line>"␊
 ␉# End build Modules packages␊
 ␊
-␉# build bdmesg package ␊
-#␉␉mkdir -p ${1}/Bdmesg/Root␊
-#␉␉cp -f ${1%/*}/i386/bdmesg ${1}/Bdmesg/Root␊
-#␉␉fixperms "${1}/Bdmesg/Root/"␊
-␉␉# echo "␉[BUILD] bdmesg "␊
-#␉␉buildpackage "${1}/Bdmesg" "/usr/sbin/" "0" "start_visible=\"false\" start_selected=\"true\"" >/dev/null 2>&1␊
-␉# End build bdmesg package ␊
-␊
 ␉((xmlindent--))␊
 ␉outline[$((outlinecount++))]="${indent[$xmlindent]}\t</line>"␊
 # End build Chameleon package␊

Download the corresponding diff file