Describe snapshot remove with a remote key when the listing fails
check / check (push) Successful in 13m44s
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:
1 parent
db06c5eab4
commit
9790e86b90
3 files changed
+28
-12
No files matched your search
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user