Powered by

snapdir ancestors

List ancestor snapshot IDs and their locations.

ancestors walks the catalog history for a snapshot and prints the IDs that precede it, along with where they were recorded. The default catalog is used when --catalog is unset. Pass --catalog none to disable catalog queries; the command prints a disabled message instead of silently returning an empty result. See the History guide.

Usage

snapdir ancestors [OPTIONS]

Options

ancestors takes no positional arguments.

Option Description
--catalog <NAME> Catalog adapter to use. Env: SNAPDIR_CATALOG; unset uses the default catalog, none disables the query.
--location <DIR\|STORE> Context (directory or store) for catalog queries.
--id <ID> Snapshot ID whose ancestors to list.
--store <URI> Store URI fallback for catalog locations. Env: SNAPDIR_STORE.
--cache-dir <DIR> Directory where the object cache and default catalog are stored. Env: SNAPDIR_CACHE_DIR.
-q, --quiet / --no-progress / --color <WHEN> / --verbose Universal output-control options.

Examples

List the ancestors of a snapshot:

snapdir ancestors --id 1220abc...

List ancestors scoped to a particular location:

snapdir ancestors --id 1220abc... --location /srv/project

Disable catalog querying explicitly:

snapdir ancestors --id 1220abc... --catalog none

See also