ReFS is Microsoft’s copy-on-write file system with checksummed metadata, used on Windows Server storage pools, Hyper-V and backup repositories, and on Dev Drive volumes in Windows 11. Its format is undocumented and changes between versions, so third-party support is partial.
Overview
ReFS stores all metadata in B+-tree tables (the Minstore engine) with copy-on-write updates and checksums on metadata. A container table maps virtual cluster numbers to physical clusters. Volumes carry a superblock, checkpoints and a version (v1.x, v3.x).
History
Introduced with Windows Server 2012; version 3 arrived with Windows Server 2016.
Dev Drive support arrived with Windows 11 23H2.
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.
Add Deleted
Offset
Size
Type
Field
Notes
0x18
8
u64 LE
–
0x30
8
u64 LE
–
Add Deleted
Offset
Size
Type
Field
Notes
0x2
2
u16 LE
Key Flags
0x2
2
u16 LE
–
Add Deleted
Offset
Size
Type
Field
Notes
0x0
8
u64 LE
–
0x0
4
u32 LE
Header
0x8
8
u64 LE
–
0x18
8
u64 LE
–
0x30
8
u64 LE
–
0x40
4
u32 LE
Is Directory
0x80
8
u64 LE
File Id
Build Entry
Offset
Size
Type
Field
Notes
0x0
8
u64 LE
File Id
0x8
8
u64 LE
Target
0x10
8
u64 LE
Created
0x18
8
u64 LE
Modified
0x20
8
u64 LE
Changed
0x28
8
u64 LE
Accessed
0x38
8
u64 LE
Size
0x40
4
u32 LE
Attributes
0x80
8
u64 LE
–
Creation Time
Offset
Size
Type
Field
Notes
0x10
8
u64 LE
–
0x28
8
u64 LE
–
List Folder
Offset
Size
Type
Field
Notes
0x0
2
u16 LE
–
0x2
2
u16 LE
Key Flags
Load Table
Offset
Size
Type
Field
Notes
0x0
2
u16 LE
–
0x8
8
u64 LE
–
Scan Slack
Offset
Size
Type
Field
Notes
0x0
2
u16 LE
Type
0x2
2
u16 LE
–
0x8
8
u64 LE
–
Scan Slack
Offset
Size
Type
Field
Notes
at
4
u32 LE
Size
at + 4
2
u16 LE
Key Offset
at + 6
2
u16 LE
Key Length
at + 0x0A
2
u16 LE
Value Offset
at + 0x0C
2
u16 LE
Value Length
Add File
Offset
Size
Type
Field
Notes
0x28
8
u64 LE
Created
0x30
8
u64 LE
Modified
0x38
8
u64 LE
Changed
0x40
8
u64 LE
Accessed
0x48
4
u32 LE
Attributes
0x58
8
u64 LE
Size
0x60
8
u64 LE
Allocated Size
Add Named
Offset
Size
Type
Field
Notes
0x10
2
u16 LE
Snapshot
0x44
4
u32 LE
–
0x4C
8
u64 LE
–
Build Data
Offset
Size
Type
Field
Notes
0x0
4
u32 LE
Node
0x4
4
u32 LE
–
0xC
4
u32 LE
–
0x10
2
u16 LE
–
0x20
8
u64 LE
Inline Size
v34 ? 0x34 : 0x30
8
u64 LE
Allocated
v34 ? 0x3C : 0x38
8
u64 LE
Size
Open Read
Offset
Size
Type
Field
Notes
0x2
2
u16 LE
Extent Backed
0x18
8
u64 LE
–
0x20
8
u64 LE
Size
Parse
Offset
Size
Type
Field
Notes
0x8
4
u32 LE
Arker
0x8
2
u16 LE
–
0xC
2
u16 LE
–
0xC
2
u16 LE
Type
0x10
4
u32 LE
Sub
Reparse Buffer
Offset
Size
Type
Field
Notes
0x8
4
u32 LE
At
at + 4
2
u16 LE
Length
Reparse Target
Offset
Size
Type
Field
Notes
0x8
2
u16 LE
Substitute Offset
0xA
2
u16 LE
Substitute Length
0xC
2
u16 LE
Print Offset
0xE
2
u16 LE
Print Length
Parse
Offset
Size
Type
Field
Notes
0x10
4
bytes
–
0x18
8
u64 LE
Total Sectors
0x20
4
u32 LE
Bytes Per Sector
0x24
4
u32 LE
Sectors Per Cluster
0x28
1
u8
Major
0x29
1
u8
Minor
0x2A
2
u16 LE
Checksum Type
0x38
8
u64 LE
Serial
0x40
8
u64 LE
Container Bytes
Verify
Offset
Size
Type
Field
Notes
0x0
4
u32 LE
–
0x0
8
u64 LE
–
Refs Const
Offset
Size
Type
Field
Notes
o
8
u64 LE
–
o
4
u32 LE
–
o
2
u16 LE
–
Live Offsets
Offset
Size
Type
Field
Notes
header + (int)start + i * 4
2
u16 LE
–
header + 0x10
4
u32 LE
Start
header + 0x14
4
u32 LE
Count
Rows
Offset
Size
Type
Field
Notes
slot
2
u16 LE
Row
header + 0x10
4
u32 LE
Start
header + 0x14
4
u32 LE
Count
header + 0x20
4
u32 LE
End
Try Row
Offset
Size
Type
Field
Notes
row + 4
2
u16 LE
Key Offset
row + 6
2
u16 LE
Key Length
row + 0x0A
2
u16 LE
Value Offset
row + 0x0C
2
u16 LE
Value Length
Parse
Offset
Size
Type
Field
Notes
offset + i * 8
8
u64 LE
Lcn
offset + 0x22
1
u8
Type
offset + 0x23
1
u8
Digest Offset
offset + 0x24
2
u16 LE
Length
Parse Object Value
Offset
Size
Type
Field
Notes
0x42
1
u8
Type
0x44
4
u32 LE
Length
Collect Extents
Offset
Size
Type
Field
Notes
at
8
u64 LE
–
header
4
u32 LE
–
at + 8
2
u16 LE
–
at + 0x0C
4
u32 LE
–
at + 0x14
4
u32 LE
Clusters
header + 0x14
4
u32 LE
–
Load Checkpoint
Offset
Size
Type
Field
Notes
0x5C
4
u32 LE
Reference Size
0x78
4
u32 LE
Flags
0x90
4
u32 LE
Count
0x94
4
u32 LE
–
slot
4
u32 LE
At
Load Checkpoint
Offset
Size
Type
Field
Notes
0x48
8
u64 LE
Table
0xA0
4
u32 LE
–
0xA4
2
u16 LE
Compression Format
Load Checkpoint
Offset
Size
Type
Field
Notes
0x0
8
u64 LE
–
0x8
8
u64 LE
–
Read Checkpoints
Offset
Size
Type
Field
Notes
0x0
4
bytes
–
0x60
8
u64 LE
–
Read Checkpoints
Offset
Size
Type
Field
Notes
0x0
4
bytes
–
0x70
4
u32 LE
At
0x74
4
u32 LE
Count
(int)at + i * 8
8
u64 LE
Lcn
Other fields read
Read in
Offset
Size
Type
Field
Notes
Add Deleted
0x2
2
u16 LE
–
List Folder
0x80
8
u64 LE
–
Add File
0x0
4
u32 LE
Tag
Build Data
0x0
4
u32 LE
Their Node
Open Read
0x0
4
u32 LE
Extents
Open Read
0x20
8
u64 LE
–
Open Read
0x38
8
u64 LE
–
Has Signature
0x3
4
bytes
–
Page Header
0x50
4
u32 LE
Header
Load Checkpoint
row.Length – 16
8
u64 LE
–
Read Page
0x0
4
bytes
–
Read Volume Label
0x0
2
u16 LE
–
Record Attributes
0x0
4
u32 LE
Header
Constants
Refs File System
Name
Value
Type
Notes
DeletedIdBase
1UL << 63
ulong
StrictUtf16
new UnicodeEncoding(bigEndian: false, byteOrderMark: false, throwOnInvalidBytes: true)
Object table (virtual addresses), then its duplicate
Name
Value
Type
Notes
message
“table deeper than expected; the rest was not read”
string
Implementation limits
Class
Name
Value
Notes
Refs File System
MaxCachedHomes
64
Refs Volume
MaxDepth
16
Refs Volume
MaxCachedPages
512
Signatures and magic strings referenced
Text
Where checked
ReFS
Has Signature
FSRS
Parse
MSB+
Page Header
SUPB
Read Checkpoints
CHKP
Read Checkpoints
MSB+
Read Page
SUPB
Has Superblock
Structures and constants were extracted from the implementation. Prose sections are a summary from public sources; verify details before relying on them.