feat: add secluded args compatibility option

2026-09-03 16:31:37 +02:00
parent 190fc5d300
commit 50f9ebb55b
7 changed files with 39 additions and 1 deletions
@@ -89,6 +89,7 @@ partial, alternate, and planned behavior.
 | `-a, --archive` | Archive mode: enables `-c -m -M` (no `-s`) |
 | `-m` | Multithreading mode |
 | `-s` | Chunk serialization (batch all files per chunk) |
+| `--secluded-args` | Rsync-compatible long form. SSH already sends transfer arguments through FastSync's protocol; `-s` remains chunk serialization. |
 | `-f, --sendfile` | Sendfile zero-copy. Incompatible with `-c` / `-s`. TCP only. |
 | `-M, --preserve` | Preserve supported file metadata (mode and mtime; ownership and atime are unsupported) |
 | `-n, --dry-run` | Scan and print what would be transferred |
@@ -359,6 +360,12 @@ particular, FastSync currently uses `-p` for SSH port, `-s` for chunk
 serialization, and `-S` for sparse handling. These meanings must be reconciled
 before FastSync can claim full rsync CLI compatibility.

+`--secluded-args` is supported as a long-form compatibility option. FastSync's
+SSH transport already launches only the remote server's `--stdio` command and
+sends transfer configuration through its protocol. The rsync short form `-s`
+is intentionally not aliased because it remains FastSync's chunk-serialization
+option.
+
 ## Client Options

 ### Selection and transfer