Skip to content

docs: mark Windows ReFS reflink (#1389) as implemented#4246

Merged
oferchen merged 1 commit into
masterfrom
feat/windows-refs-reflink-1389
May 17, 2026
Merged

docs: mark Windows ReFS reflink (#1389) as implemented#4246
oferchen merged 1 commit into
masterfrom
feat/windows-refs-reflink-1389

Conversation

@oferchen
Copy link
Copy Markdown
Owner

Summary

  • Investigation for Restrict CI testing to Linux and fix packaging artifacts #1389 found the Windows ReFS reflink path is already shipped in crates/fast_io/src/platform_copy/dispatch.rs (try_refs_reflink_impl, try_refs_reflink_range_impl) and wired into platform_copy_impl with the ReFS -> CopyFileEx -> std::fs::copy fallback chain.
  • Detection is provided by crates/fast_io/src/refs_detect.rs::is_refs_filesystem with per-volume memoization. CopyMethod::ReFsReflink is enumerated and reported. Public re-exports live in crates/fast_io/src/lib.rs.
  • Tests in crates/fast_io/src/platform_copy/tests.rs cover non-Windows unsupported, NTFS graceful failure, missing source, ioctl parameter construction, and the partial-range variant.
  • This PR only annotates the design note with the implementation status and records one deviation: the impl uses windows-sys 0.61 (workspace convention) rather than the higher-level windows crate suggested in the note. All unsafe remains scoped to the ioctl wrappers with SAFETY comments.

Test plan

  • No code changes; docs-only update.
  • Existing crates/fast_io/src/platform_copy/tests.rs continues to cover the ReFS reflink path.

Annotate the design note to point at the existing implementation
in fast_io::platform_copy and call out the windows-sys deviation
from the original plan.
@oferchen oferchen merged commit 675665d into master May 17, 2026
8 checks passed
@oferchen oferchen deleted the feat/windows-refs-reflink-1389 branch May 17, 2026 19:47
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 17, 2026
oferchen added a commit that referenced this pull request May 18, 2026
Annotate the design note to point at the existing implementation
in fast_io::platform_copy and call out the windows-sys deviation
from the original plan.
oferchen added a commit that referenced this pull request May 18, 2026
Annotate the design note to point at the existing implementation
in fast_io::platform_copy and call out the windows-sys deviation
from the original plan.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant