---
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
