Skip to main content

Global Flags

Global flags are flags that are available for any of the supported commands.

-h (--help)​

Prints helpful infomation about:

  • Root CLI - cipr -h or cipr --help
  • Any supported provider command - cipr aws -h or cipr aws --help

See all supported providers here: Supported Providers

--version​

cipr uses Semantic Versioning. cipr --version prints it on the CLI.

--config​

Use another TOML config file for this run.

CLI command
cipr aws --config /path/to/cipr.toml

Default: $HOME/.config/cipr/cipr.toml.

See cipr Config for all settings and the cipr configure command.

-v (--verbose)​

Full verbosity mode. Equivalent to --verbose-mode=full.

--verbose-mode​

Can be used without -v (--verbose) flag. When used with -v (--verbose) flag, --verbose-mode overrides it.

Default: none.

Options:

  • --verbose-mode none
  • --verbose-mode mini
  • --verbose-mode full

For more info on verbosity levels, check Data Formats.

--source​

Temporarily overrides the configured source of IP ranges.

For more info about config, please visit - cipr Config

Supported values:

  • config uses the endpoint or local file from cipr.toml
  • an HTTP or HTTPS URL fetches that URL directly
  • a relative or absolute file path reads that local file

hosted remains an alias for config.

Default: config.

--no-cache​

Bypass the on-disk cache for this run. This skips both reading the cached response and writing a fresh one. An existing cache file remains unchanged, so a later call without --no-cache can reuse it while it is still valid.

Only affects configured endpoints. Custom URLs and local files passed through --source do not use the cache.

Default: false.

For more info about how caching works and how to tune the per-provider TTL, see cipr Config.

--proxy​

Use an HTTP or HTTPS proxy for network requests.

CLI command
cipr aws --proxy http://proxy.example.com:8080

This flag overrides the proxy value in cipr.toml. When neither is set, cipr uses HTTP_PROXY, HTTPS_PROXY and NO_PROXY from the environment.

Save the proxy with cipr configure --proxy <url>.

--debug​

Write source, cache, proxy and HTTP diagnostics to stderr. IP range output does not change.

CLI command
cipr aws --debug

Save this setting with cipr configure --debug. Disable the saved setting with cipr configure --debug=false.