Describe snapshot remove with a remote key when the listing fails
check / check (push) Successful in 13m44s

Given a remote key, `snapshot remove` lists the destination before it
removes anything. When the destination cannot be listed or has no marker
file, it fails and removes nothing. The README and `snapshot remove
--help` said a snapshot in the local index is still removed from it.
That holds only for a snapshot named by its ID.

"The marker file" in `README.md` and `docs/REPOSTRUCTURE.md` now lists
`snapshot remove` with the commands that fail when given a remote key,
or a snapshot ID that is not in the local index.

The `--local-only` sentence in the help ran to 35 words and is split in
two.

Model: fable-5-2
This commit is contained in:
sneak committed 2026-11-17 02:20:35 +00:00
1 parent db06c5eab4
commit 9790e86b90
3 files changed
+28 -12

No files matched your search

+9 -3
View File
@@ -621,14 +621,18 @@ An ID that is in neither the local index nor the destination is an error. With
`--local-only`, the argument must be the ID of a snapshot in the local index.
The deletion at the destination can fail, for example when the destination is
unreachable or has no marker file. What happens then depends on where the
snapshot was:
unreachable or has no marker file. Given a snapshot ID, what happens then
depends on where the snapshot was:
- A snapshot in the local index is still removed from it, with a warning. Run
the same command again later to delete its directory at the destination.
`vaultik prune` does not delete it.
- For a snapshot that is only at the destination, the failure is an error.
Given a remote key, the command lists the destination before it removes
anything. When the destination cannot be listed or has no marker file, the
command fails and removes nothing, not even from the local index.
### `snapshot restore <snapshot-id> <target-dir> [paths...]`
Restores files from a snapshot into `<target-dir>`. The first argument is a
@@ -1173,8 +1177,10 @@ not exist, commands treat the destination as not present:
- `snapshot files`
- `snapshot verify`
- `snapshot restore`
- `snapshot remove`
- `snapshot list` shows the local index alone.
- `snapshot remove` deletes nothing at the destination.
- `snapshot remove` deletes nothing at the destination when given a snapshot ID
that is in the local index.
To fix this, mount the volume. If you emptied the destination on purpose, run
`vaultik database delete` and back up again.