CoreStorage Fusion Drive

CoreStorage is the Mac logical volume layer used by Fusion Drives and FileVault 2 on OS X 10.7 to 10.12, before APFS. It is found on older Macs and backups; both members are needed to rebuild the volume.

Overview

Core Storage physical volumes carry a label (CS) with a volume header, a metadata block and copies of the XML plist describing logical volume groups, logical volume families and logical volumes. A Fusion Drive is a group of an SSD and a hard disk presented as one logical volume with tiered extents.

History

  • Introduced with OS X Lion (2011) and used for Fusion Drive in OS X Mountain Lion (2012).
  • Superseded by APFS.

Structures

Offsets are in bytes from the start of the structure named in each heading. Field names are descriptive and are not an official specification. Fixed-width integers are shown as u/i (unsigned/signed) followed by bit width and byte order.

Check Header

OffsetSizeTypeFieldNotes
0x82u16 LE–
0x488u64 LE–
0x581u8–
0x591u8–
0x604u32 LEBlock Size

Parse Family

OffsetSizeTypeFieldNotes
0x684u32 LECompressed
0x6C4u32 LEUncompressed
0x704u32 LEXml Offset
0x744u32 LEXml Size

Parse Family

OffsetSizeTypeFieldNotes
0x44i32 LESalt Length
0x44i32 LELength
0x184i32 LEKey Length
0x1C4i32 LEWrapped Length
0xA84i32 LEIterations

Parse Map

OffsetSizeTypeFieldNotes
0x88u64 LELogical
0x104u32 LEBlocks
0x208u64 LEPhysical
0x262u16 LEPv

Parse Volume

OffsetSizeTypeFieldNotes
0x804u32 LEXml Offset
0x844u32 LEXml Size

Read Encrypted Metadata

OffsetSizeTypeFieldNotes
0x82u16 LE–
0xA2u16 LEType
0x108u64 LETransaction

Read Header

OffsetSizeTypeFieldNotes
0xA84u32 LE–
0xB016bytes–
0x13016bytes–
0x14016bytes–
104 + copy * 88u64 LE–

Read Label

OffsetSizeTypeFieldNotes
0x88u64 LECount
0x208u64 LEPrimary
0x288u64 LESecondary

Read Label

OffsetSizeTypeFieldNotes
0xA2u16 LE–
0x108u64 LETransaction
0xDC4u32 LEDescriptor
0xE04u32 LEPlist Offset
0xE44u32 LEPlist Size

Verify Crc

OffsetSizeTypeFieldNotes
0x04u32 LEStored
0x44u32 LECrc

Other fields read

Read inOffsetSizeTypeFieldNotes
Parse Map0x404u32 LECount
Verify Crci8u64 LECrc

Constants

Core Storage Metadata

NameValueTypeNotes
HeaderSize512int
MetadataBlockSize8192int

The group’s plist: its PV list gives the PV indexes.

NameValueTypeNotes
ChunkBlocks64int

Implementation limits

ClassNameValueNotes
Core Storage MetadataMaxMetadataBlocks1 << 17
Structures and constants were extracted from the implementation. Prose sections are a summary from public sources; verify details before relying on them.