---
source: src/main.rs
expression: sub.render_long_help().to_string()
---
Probe and switch storage destinations.
`check` probes a destination end-to-end; `use` switches the configured destination - a pointer change that moves no data. To copy data between stores use `pond copy`; to see where data lives and how big it is use `pond status`.
Usage: pond storage [OPTIONS] <COMMAND>
Commands:
check Probe a destination end-to-end
use Switch the configured destination. Moves no data
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')
Global options:
--storage-path <URL>
Storage destination: a local path or remote URL.
Accepts a bare path, `~/path`, `file://`, `s3://bucket/prefix`, `s3+https://host/bucket/prefix`, `gs://`, `az://`, or the keyword `local` (the platform default local data dir). Default: `[storage].path` from config, then the platform data dir (`~/.local/share/pond`).
[env: POND_STORAGE_PATH]
--config-file <PATH>
Config file to read (default: `~/.config/pond/config.toml`)
[env: POND_CONFIG_FILE]
-v, --verbose...
Increase logging verbosity
-q, --quiet...
Decrease logging verbosity
Examples:
pond storage check s3+https://host/bucket/pond probe a destination end-to-end
pond storage use s3+https://host/bucket/pond probe, then switch the destination