Skip to content

Instantly share code, notes, and snippets.

@0xbadfca11

0xbadfca11/00_README.md

Last active October 29, 2024 07:24
Show Gist options
  • Save 0xbadfca11/da0598e47dd643d933dc to your computer and use it in GitHub Desktop.
Save 0xbadfca11/da0598e47dd643d933dc to your computer and use it in GitHub Desktop.
Download ZIP
Windows ReFS versions
Raw
00_README.md
Raw
Windows ReFS versions.en.md

Version number is reported by fsutil fsinfo refsinfo, available on Windows 10 and Windows Server 2016.

ReFS 1.1

  • Version of formatted by Windows Server 2012.
  • Version 1.1 is used already in Windows Server 8 Beta. I have never seen version 1.0.
  • Can use and store alternate data streams, when mount on 8.1/2012 R2 or later.

ReFS 1.2

  • Version of formatted by Windows 8.1, Windows 10 v1507 to v1607, Windows Server 2012 R2, and when specified ReFSv1 on Windows Server 2016 or later.
  • Cannot use alternate data streams, when mount on 2012.

ReFS 9.2

  • Version that can be formatted with Windows 10 Technical Preview build 9841 to 9860 and Windows Server 2016 TP1 (It's not default). Could not mount in 10 9879 or 2016 TP2 and later.

ReFS 11.2

  • Version that can be formatted with Windows 10 Technical Preview build 9879 (It's not default). Could not mount in 9926 and later.

ReFS 12.2

  • Version that can be formatted with Windows 10 Technical Preview build 9926 (It's not default). Could not mount in 10041 and later.

ReFS 22.2

  • Version that can be formatted with Windows 10 Technical Preview build 10041 to 10049 (It's not default). Could not mount in 10061 and later.

ReFS 2.0

  • Version of formatted by Windows Server 2016 TP2/TP3.
  • Version that can be formatted with between Windows 10 Technical Preview build 10061 or later and earlier than 10130 (It's not default). Could not mount in Windows 10 Insider Preview build 10130 and later, or Windows Server 2016 TP4 and later.

ReFS v2 Overview
http://www.snia.org/sites/default/files/SDC15_presentations/file_sys/JRTipton_ReFS_v2.pdf
http://www.snia.org/events/storage-developer/presentations15#file_sys

ReFS 3.0

  • Version of formatted by Windows Server 2016 TP4/TP5.
  • Upgrade to 3.1 when writable mount from Windows Server 2016 RTM.

ReFS 3.1

  • Version of formatted by Windows Server 2016.

ReFS 3.2

  • Version of formatted by Windows 10 v1703.
  • Version that can be formatted with Windows 10 Insider Preview 15002 or later (It's not default at 15002) and Windows Server Insider Preview build 16237.
    • It became the default between after than 15002 and 15019 or earlier.

ReFS 3.3

ReFS 3.4

  • Version of formatted by Windows 10 Enterprise v1803, Windows Server 2019 and Windows Server version 1803.
  • Version of formatted by Windows 10 Enterprise Insider Preview build 17083 and Windows Server Insider Preview build 17079.

ReFS 3.5

  • Version of formatted by Windows 10 Enterprise Insider Preview build 19536 and Windows Server Insider Preview build 19551.
  • Added hardlink support if fresh formatted volume.
    • Can't use hardlink if upgraded from previous version.
  • Upgrade to 3.6 when writable mount from Windows 10 Insider Preview build 21292.

ReFS 3.6

  • Version of formatted by Windows 10 Enterprise Insider Preview build 21292 and Windows Server Insider Preview build 20282.
  • Upgrade to 3.7 when writable mount from Windows 10 Insider Preview build 21313.

ReFS 3.7

  • Version of formatted by Windows 11 Enterprise v21H2 and Windows Server 2022.
  • Version of formatted by Windows 10 Enterprise Insider Preview build 21313 and Windows Server Insider Preview build 20303.

ReFS 3.9

  • Version of formatted by Windows 11 Enterprise v22H2.
  • Version of formatted by Windows 11 Enterprise Insider Preview build 22598 and Windows Server Insider Preview build 25099.
  • Added post process compression with LZ4 & ZSTD, transparent decompression.

Mountability

ReFS\Windows 2012 8.1/2012 R2 10 v1507 2016 10 v1703 10 v1709 10 v1803/2019 11 v21H2/2022 11 v21H2
1.1 Yes Yes1 Yes1 Yes1 Yes1 Yes1 Yes1 Yes1 Yes1
1.2 Yes Yes Yes Yes Yes Yes Yes Yes Yes
3.1 No No No Yes Yes2 Yes3 Yes4 Yes56 Yes76
3.2 No No Yes Yes3 Yes4 Yes56 Yes76
3.3 No No Yes Yes4 Yes56 Yes76
3.4 No Yes Yes56 Yes76
3.7 No Yes Yes8
3.9 No Yes

Notes
Empty filed is "I don't know. I haven't tested.".

License: CC BY

Footnotes

  1. "Volume "?:" was mounted in an older version of Windows. Some features may be lost." was recorded to event log when writable mount. I don't know what's been lost. ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8

  2. Upgrade to 3.2 when writable mount. ↩

  3. Upgrade to 3.3 when writable mount. ↩ ↩2

  4. Upgrade to 3.4 when writable mount. ↩ ↩2 ↩3

  5. Upgrade to 3.7 when writable mount. ↩ ↩2 ↩3 ↩4

  6. Can't use hardlink. ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8

  7. Upgrade to 3.9 when writable mount. Can't mount read-only. ↩ ↩2 ↩3 ↩4

  8. Upgrade to 3.9 when writable mount. ↩

Raw
Windows ReFS versions.ja.md

バージョン番号はWindows 10とWindows Server 2016で使用可能なfsutil fsinfo refsinfoで報告されるもの。

ReFS 1.1

  • Windows Server 2012でフォーマットしたバージョン。
  • Windows Server 8 Betaの時点で1.1であり1.0の存在は不明。
  • 8.1/2012 R2以降でマウントした場合はAlternate Data Stream使用可能。

ReFS 1.2

  • Windows 8.1、Windows 10 v1507からv1607、Windows Server 2012 R2でフォーマットしたとき、およびWindows Server 2016以降でReFSv1を指定してフォーマットしたときのバージョン。
  • 2012でマウントした場合はAlternate Data Stream使用不可。

ReFS 9.2

  • Windows 10 TP ビルド9841から9860とWindows Server 2016 TP1でフォーマット可能なバージョン（デフォルトではない）。10 9879/ 2016 TP2以降ではマウント不可。

ReFS 11.2

  • Windows 10 TP ビルド9879でフォーマット可能なバージョン（デフォルトではない）。9926以降ではマウント不可。

ReFS 12.2

  • Windows 10 TP ビルド9926でフォーマット可能なバージョン（デフォルトではない）。10041以降ではマウント不可。

ReFS 22.2

  • Windows 10 TP ビルド10041から10049でフォーマット可能なバージョン（デフォルトではない）。10061以降ではマウント不可。

ReFS 2.0

  • Windows Server 2016 TP2/TP3でフォーマットしたバージョン。
  • Windows 10 TP ビルド10061から10130より前でフォーマット可能なバージョン（デフォルトではない）。10 10130以降、2016 TP4以降ではマウント不可。

ReFS v2の概要
http://www.snia.org/sites/default/files/SDC15_presentations/file_sys/JRTipton_ReFS_v2.pdf
http://www.snia.org/events/storage-developer/presentations15#file_sys

ReFS 3.0

  • Windows Server 2016 TP4/TP5でフォーマットしたバージョン。
  • Windows Server 2016から書き込み可能でマウントすると3.1にアップグレードされる。

ReFS 3.1

  • Windows Server 2016でフォーマットしたバージョン。

ReFS 3.2

  • Windows 10 v1703でフォーマットしたバージョン。
  • Windows 10 Insider Preview ビルド15002およびWindows Server Insider Preview ビルド16237でフォーマット可能なバージョン（15002ではデフォルトではない）。
    • 15002より後、15019までの間にデフォルトになった。

ReFS 3.3

ReFS 3.4

  • Windows 10 Enterprise v1803、Windows Server 2019およびWindows Server version 1803でフォーマットしたバージョン。
  • Windows 10 Enterprise Insider Preview ビルド17083およびWindows Server Insider Preview ビルド17079でフォーマットしたバージョン。

ReFS 3.5

  • Windows 10 Enterprise Insider Preview ビルド19536およびWindows Server Insider Previewビルド19551でフォーマットしたバージョン。
  • 新規フォーマットした場合に限りハードリンク使用可能。
    • 3.5未満からアップグレードした場合は使用不可。
  • Windows 10 Insider Preview ビルド21292から書き込み可能でマウントすると3.6にアップグレードされる。

ReFS 3.6

  • Windows 10 Enterprise Insider Preview 21292およびWindows Server Insider Previewビルド20282でフォーマットしたバージョン。
  • Windows 10 Insider Preview ビルド21313から書き込み可能でマウントすると3.7にアップグレードされる。

ReFS 3.7

  • Windows 11 Enterprise v21H2およびWindows Server 2022でフォーマットしたバージョン。
  • Windows 10 Enterprise Insider Preview 21313およびWindows Server Insider Previewビルド20303でフォーマットしたバージョン。

ReFS 3.9

  • Windows 11 Enterprise v22H2でフォーマットしたバージョン。
  • Windows 11 Enterprise Insider Preview 22598およびWindows Server Insider Previewビルド25099でフォーマットしたバージョン。
  • LZ4 & ZSTDによる事後圧縮と透過伸長が追加。

マウント可否

ReFS\Windows 2012 8.1/2012 R2 10 v1507 2016 10 v1703 10 v1709 10 v1803/2019 11 v21H2/2022 11 v21H2
1.1 Yes Yes1 Yes1 Yes1 Yes1 Yes1 Yes1 Yes1 Yes1
1.2 Yes Yes Yes Yes Yes Yes Yes Yes Yes
3.1 No No No Yes Yes2 Yes3 Yes4 Yes56 Yes76
3.2 No No Yes Yes3 Yes4 Yes56 Yes76
3.3 No No Yes Yes4 Yes56 Yes76
3.4 No Yes Yes56 Yes76
3.7 No Yes Yes8
3.9 No Yes

空欄は「テストしてないので分かりません」を意味します。

License: CC BY

Footnotes

  1. 書き込み可能でマウントするとイベントログに「ボリューム "?:" は、以前のバージョンの Windows にマウントされていました。一部の機能が失われた可能性があります。」が出力される。具体的に何が失われるのかは不明。 ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8

  2. 書き込み可能でマウントすると3.2にアップグレードされる。 ↩

  3. 書き込み可能でマウントすると3.3にアップグレードされる。 ↩ ↩2

  4. 書き込み可能でマウントすると3.4にアップグレードされる。 ↩ ↩2 ↩3

  5. 書き込み可能でマウントすると3.7にアップグレードされる。 ↩ ↩2 ↩3 ↩4

  6. ハードリンク使用不可。 ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8

  7. 書き込み可能でマウントすると3.9にアップグレードされる。書き込み禁止でマウントすることはできない。 ↩ ↩2 ↩3 ↩4

  8. 書き込み可能でマウントすると3.9にアップグレードされる。 ↩

@smsimeonov
Copy link

Just chiming in to say that a REFS 3.4 volume cannot be seen by Windows 11 23H2.
refsutil reports no problem
Event Log says "The file system detected an allocation inconsistency on volume X:"

@JonasKlose
Copy link

Apparently W11 / 26052 introduced ReFS V 3.14.

@Karl-WE
Copy link

Karl-WE commented Feb 10, 2024

Agreed.

@Karl-WE
Copy link

Karl-WE commented Mar 4, 2024

Understand this is a voluntary gist not related to official documentation, do you @0xbadfca11 to update this to reflect the changes happened post 3.9?

@youk
Copy link

youk commented Mar 4, 2024

What should be the source of information (except the changing version numbers)? The official documentation hasn't seen update for more than a year.

@GXTX
Copy link

GXTX commented Mar 4, 2024

Tbf, that page is open to contributions, but I'm imagining something like this gist would never be accepted.

@youk
Copy link

youk commented Mar 4, 2024

So you are suggesting to make contributions to Microsoft documentation based on.. what? Some guesswork?

@GXTX
Copy link

GXTX commented Mar 5, 2024

Is observed behavior guesswork?

@youk
Copy link

youk commented Mar 5, 2024

Yes, as any empiricism.

@0xbadfca11
Copy link
Author

0xbadfca11 commented Mar 5, 2024 via email

@zotabee
Copy link

zotabee commented Mar 5, 2024

I declare this article to be outdated. I'm depressed and can't do activity right now. Also cannot promise anything about future updates.

Hope you will get better soon! Thanks the initial work!!!

@Certezalito
Copy link

I declare this article to be outdated. I'm depressed and can't do activity right now. Also cannot promise anything about future updates.

That is unfortunate to hear; I wish you the best. Thank you for your work, it is much appreciated.

@Karl-WE
Copy link

Karl-WE commented Mar 6, 2024 •
edited
Loading

Thank you for the notice and including it in the top. Also, massive thanks for all the time and maintenance of this gist!
Just for those that might overlook it, ReFS version to be continued here: https://gist.github.com/XenoPanther/15d8fad49fbd51c6bd946f2974084ef8

@HotCakeX
Copy link

I found a new feature in ReFS v3.14 in build 24H2 release preview

HotCakeX/Harden-Windows-Security#260

@13xforever
Copy link

I love how the official documentation removed the version info, and just links here instead

@Karl-WE
Copy link

Karl-WE commented Oct 22, 2024

This gist is no longer updated can you cite the reference?

@13xforever
Copy link

last link on https://learn.microsoft.com/en-us/windows-server/storage/refs/refs-overview#additional-references

@Karl-WE
Copy link

Karl-WE commented Oct 29, 2024

Thank you for spotting this @13xforever. Strongly believe this was an update request from my end longer ago.

MSFT docs never contained this specific versioning information focused on ReFS features and limitations only. My attempts to implement a similar thing as this gist (or maintained follow-up), were not successful.

I have filed a PR to address this: MicrosoftDocs/windowsserverdocs#7960

Much appreciate participation!

As per request of the original maintainer, let's continue on the gist linked above.

@13xforever
Copy link

They had a table comparing ntfs/refs features with specific version notes when they were implemented

@Karl-WE
Copy link

Karl-WE commented Oct 29, 2024

Ah yes. I can remember that. They used footnotes. But that was hard to read at times and not easy to maintain. Some changes that I proposed back then via PRs.

Since the most ReFS features are available on fully supported Windows Server / Client versions, I think the reference is a good approach.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment