These docs describe unreleased changes on master. Read the latest stable documentation.
Remove syq partial files below local or SSH directory trees. Stop copies writing
into those trees before deleting partials:
syq clean-partials --dry-run -v backup
syq clean-partials backup
See interrupted-copy recovery for
which files this removes. Results use the rm record format.
syq clean-partials [OPTIONS] <TREE>...
| Argument / option | Meaning |
|---|
--on <ENDPOINT> | Removal endpoint ([USER@]HOST[:PORT]); omitted means local |
-C, --cwd <DIR> | Resolve relative trees from DIR at the removal endpoint |
--root <DIR> | Confine traversal beneath DIR |
<TREE>... | Directory trees to search |
| Argument / option | Meaning |
|---|
-n, --dry-run | Preview without changing copy/removal data; remote setup may still cache the helper or install syq; requested results files are still written |
-v, --verbose... | List removed paths |
-q, --quiet | Suppress non-error messages |
| Argument / option | Meaning |
|---|
--performance-tuning <KEY=VALUE,...> | Filesystem removal workers: workers=N |
| Argument / option | Meaning |
|---|
--progress | Show progress even when stderr is not a terminal |
--no-progress | Never show the human progress display |
--progress-json | Emit machine-readable progress lines (JSON) on stderr |
--results <FILE> | Write the machine-readable NDJSON result stream to FILE (created fresh; an existing file is refused) |
--results-fd <FD> | Write the result stream to an inherited file descriptor the caller opened (e.g. --results-fd 3 3>run.ndjson); must be above 2 |
| Argument / option | Meaning |
|---|
--syq-path <PATH> | Use this exact syq executable on the remote removal endpoint |
--no-bootstrap | Use syq on the remote PATH instead of installing a helper |
| Argument / option | Meaning |
|---|
-h, --help | Show common usage and options |
-V, --version | Print version |
--help-all | Show all options and details |