APFS Fusion Drive

An APFS Fusion Drive pairs a small SSD with a hard disk as one APFS container, as shipped on some iMacs and Mac minis from 2012 on. Recovery needs both members, and the format keeps hot data on the SSD tier.

Overview

An APFS Fusion container has two devices, a main (fast) tier and a secondary tier, each with a container superblock that lists both. A fusion middle tree maps address ranges to tiers, and a write-back cache lives on the fast device. Blocks are addressed through a combined logical space.

History

  • Fusion Drive was introduced with OS X Mountain Lion (2012) on Core Storage; APFS support came in macOS High Sierra.

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.

No fixed-offset structures were found.

Constants

Implementation limits

ClassNameValueNotes
Apfs Fusion DeviceMaxChunk1024 * 1024
Apfs Fusion Middle TreeMaxRecords8_000_000
Structures and constants were extracted from the implementation. Prose sections are a summary from public sources; verify details before relying on them.