Powered by

snapdir locations

List directories and stores where snapshots have been recorded.

locations queries the catalog and prints the directories and stores it has seen snapshots for. 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 locations [OPTIONS]

Options

locations 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 to operate on.
--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 all known locations:

snapdir locations

List locations using a specific catalog adapter:

snapdir locations --catalog default

Disable catalog querying explicitly:

snapdir locations --catalog none

See also