Skip to content

docs(windows): audit backslash-leak in wire-encoded filenames (#1939)#3515

Merged
oferchen merged 1 commit into
masterfrom
docs/windows-path-1939
May 1, 2026
Merged

docs(windows): audit backslash-leak in wire-encoded filenames (#1939)#3515
oferchen merged 1 commit into
masterfrom
docs/windows-path-1939

Conversation

@oferchen
Copy link
Copy Markdown
Owner

@oferchen oferchen commented May 1, 2026

Summary

  • Documents the High-severity backslash-leak finding for tracker Optimize rolling checksum SIMD reductions #1939: a Windows-native oc-rsync sender emits \\ (0x5C) bytes inside wire-encoded filenames where the rsync wire contract requires /, causing silent on-disk corruption on POSIX peers.
  • Lists every affected code path (sender flist emit, walk relative-path, filter evaluation, receiver delete-walk) with crate/file.rs:line citations and concrete reproduction steps using --write-batch= capture against both oc-rsync on windows-msvc and upstream Cygwin rsync on the same host.
  • Captures the remediation plan tracked by issue Expand interop coverage and tune super-linter #1905: a path_bytes_to_wire(&Path) -> Cow<'_, [u8]> helper applied at four sites in protocol::flist and transfer::generator::file_list, paired with regression tests and a Windows-sender -> Linux-receiver CI matrix entry.

Replaces the previous content of docs/audits/windows-path.md (which was an interim verification note for #1905) with the full audit document required by tracker #1939. References parent audit #1842, fix tracker #1905, and the related Windows workstream entries (#1866, #1867, #1869, #1900).

Test plan

  • CI checks pass

Document the High-severity backslash-leak finding with reproduction
steps and the remediation plan referencing task #1905. Refines the
parent audit #1842 (windows-path-normalization.md) with a focused
finding-level write-up: code paths, reproduction commands (daemon and
batch capture), upstream comparison via Cygwin, the path_bytes_to_wire
helper plan, regression-test obligations, and the Windows-sender ->
Linux-receiver CI matrix entry.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 1, 2026
@oferchen oferchen merged commit 07e9d3d into master May 1, 2026
12 checks passed
@oferchen oferchen deleted the docs/windows-path-1939 branch May 1, 2026 21:08
oferchen added a commit that referenced this pull request May 5, 2026
…#3515)

Document the High-severity backslash-leak finding with reproduction
steps and the remediation plan referencing task #1905. Refines the
parent audit #1842 (windows-path-normalization.md) with a focused
finding-level write-up: code paths, reproduction commands (daemon and
batch capture), upstream comparison via Cygwin, the path_bytes_to_wire
helper plan, regression-test obligations, and the Windows-sender ->
Linux-receiver CI matrix entry.
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