Skip to content

ntfs2refs 0.0.1

Latest

Choose a tag to compare

@github-actions github-actions released this 18 Nov 19:08
· 1 commit to main since this release
87517a1

ntfs2refs 0.0.1

WARNING: NTFS2REFS IS EXPERIMENTAL SOFTWARE.
FOR EVALUATION AND TESTING ONLY. DO NOT USE IT IN PRODUCTION.

IT REWRITES THE FILE SYSTEM OF A VOLUME IN PLACE, FROM NTFS TO REFS.
IT HAS BEEN TESTED ONLY ON VIRTUAL DISKS IN A LABORATORY. A FAULT IN
IT, IN WINDOWS OR IN THE HARDWARE CAN DESTROY EVERYTHING ON THE VOLUME.

BACK UP EVERYTHING ON THE VOLUME, AND CHECK THAT YOU CAN RESTORE THE
BACKUP, BEFORE YOU CONVERT. YOU USE THIS SOFTWARE ENTIRELY AT YOUR OWN
RISK. IT COMES WITH NO WARRANTY OF ANY KIND. READ DISCLAIMER.md.

Built by lab\New-Release.ps1 from commit 87517a1cdf90ba5a3f78765548406a08aab9a340 with rustc 1.98.1 (48a229cea 2026-09-01).

File SHA-256 Signed by
ntfs2refs.exe 0307eb8c902689ff06437975adcccf9f945a40645905d89f1977f942f4e5b4d6 Fara Technologies LLC
ntfs2refs-recovery.exe 07b512407fb284a1653ab1f6348acbde713089542fb7f8e97fa31e5c040d9738 Fara Technologies LLC
lab-volume-manifest.exe afd9afa48885518564f8195dabd5a00f0b67d49f6f1e4bb649ab5ab895f06ef2 Fara Technologies LLC

What this executable admits

capabilities.json in this archive is the output of ntfs2refs capabilities (schema 5). In short:

  • Windows build 26100 or later; conversions were run on builds 26100 and 26300.
  • ReFS clusters of 4096 or 65536 bytes for a data volume; the version Windows formats the shadow with: 3.14 or a later 3.x (only 3.14 has been converted).
  • A data volume: a disk other than the running Windows': a GPT disk, which may hold other partitions, or an MBR disk the volume has to itself; --list says for each NTFS partition whether it qualifies.
  • An installed Windows that is not running: windows-11-build-26300-dev-drive.

Not carried over:

  • object IDs of files and directories, which Windows gives to the targets of shortcuts: ReFS has no object IDs.
  • the NTFS compression flag: compressed data is stored as ordinary data on ReFS.
  • the change journal: the converted volume starts a new one.
  • the case-sensitive mark of a directory in which no two names differ only by case: the converter does not set it on the new volume; every name stays reachable.

Refused before anything is written:

  • 8.3 short names. To do: fsutil 8dot3name strip, then fsutil 8dot3name set : 1.
  • a BitLocker-encrypted volume. To do: decrypt it (manage-bde -off).
  • shadow copies of the volume, snapshot storage kept on it, or a shadow-copy provider of backup software that holds a shadow copy on the machine or does not answer. To do: delete the shadow copies; the provider is named.
  • EFS-encrypted files. To do: cipher /d.
  • files with the TEMPORARY or OFFLINE attribute.
  • reparse points other than symbolic links, junctions, app execution aliases and the files of the Windows Subsystem for Linux (Data Deduplication, compact /exe, cloud placeholders). To do: named per kind.
  • a named data stream on a directory.
  • disk quotas in use. To do: fsutil quota disable.
  • two names in one directory that differ only by case. To do: rename one of them, then fsutil file setCaseSensitiveInfo disable.
  • a dirty volume, an NTFS log that was not closed, an open transaction. To do: chkdsk /f, or a clean dismount.
  • a volume with no file on it. To do: format it as ReFS.

What was shown, and what was not

docs/feature-matrix.md lists every NTFS feature with what a conversion does with it and the lab case that shows it; docs/recovery-matrix.md lists every point at which a conversion was interrupted and how each recovery ended. docs/cli-workflow.md is the operating and recovery guide.

Not shown:

  • a physical disk: every lab disk is virtual.
  • a volume holding more than 23 GB.
  • a power cut to the storage itself: the lab ends the converter's process or turns the virtual machine off.
  • a Windows build other than those in windows_builds.confirmed_builds, and a ReFS version other than 3.14.
  • a conversion to standard ReFS on Windows 11 (the lab's does not format one), a Windows boot volume of Windows Server, and Windows 11 on build 26100.
  • --minimize-scratch.
  • the restart route (--restart-media) on Windows 11, on a physical machine, with BitLocker on the Windows volume, and interrupted while it converts.

Verify the download

The executables are signed by Fara Technologies LLC and by Mike Fara (Azure Artifact Signing), and the ZIP and executables carry a build-provenance attestation of this repository's release workflow:

gh attestation verify ntfs2refs-0.0.1-windows-x64.zip --repo faratech/ntfs2refs --signer-workflow faratech/ntfs2refs/.github/workflows/release.yml