% zprune(8) | System Manager's Manual
zprune - destroy snapshot prune candidates selected by zelta prune
zprune [OPTIONS] source [target]
zprune destroys snapshots selected by zelta prune. It previews grouped zfs destroy commands with zfs destroy -nvp, prints a summary of snapshot count and estimated reclaim, asks for confirmation, then destroys the same candidates.
Candidate selection, filters, prune guards, and retention options are identical to zelta prune. See zelta-prune(8) for strategy details. zprune requires a target or --no-prune-guard.
--force, -f
: Destroy candidates without asking for confirmation.
--quiet, -q
: Do not display the zfs destroy command list.
--dryrun, -n
: Preview compact destroy commands and the summary, then exit without prompting or destroying.
--verbose, -v
: Expand snapshot ranges in the command preview. With --quiet, print only the summary and exit.
--help, -h
: Show command usage.
--version, -V
: Show zprune version information and exit.
All other options are forwarded to zelta prune. See zelta-prune(8) for complete behavior, including --prune-num, --prune-time, --prune-grid, --prune-size, --prune-guard, --include, --exclude, and --depth.
zprune applies these checks before destruction:
--dryrun shows compact destroy commands and summary, then exits before prompting;y or yes unless --force is used;If the source is remote, destruction runs on that host through ZELTA_REMOTE_COMMAND (default ssh).
Preview default candidates and confirm before destroying:
zprune tank/data backup:tank/data
Destroy without the confirmation prompt:
zprune --force tank/data backup:tank/data
Preview destroy commands and summary without prompting:
zprune --dryrun tank/data backup:tank/data
Print only the dry-run summary:
zprune -qn tank/data backup:tank/data
Apply a retention strategy and destroy (same options as zelta prune):
zprune --prune-grid='30x1day, 52x1week, 1year' \
tank/data backup:tank/data
Without a replica target, pass --no-prune-guard explicitly:
zprune --no-prune-guard --prune-size=10G tank/data
zprune bootstraps through zelta, so ZELTA_ENV settings such as PRUNE_GUARD are loaded before candidates are selected. See zelta-options(7) and zelta-prune(8).
Returns 0 on success and non-zero on error, aborted confirmation, failed candidate preview, or failed destruction.
For non-destructive candidate reporting, use zelta prune. To preview the exact destroy operations zprune would run, use zprune --dryrun.
zelta-prune(8), zelta(8), zelta-options(7), zfs(8), zfs-destroy(8), ssh(1)
Daniel J. Bell <bellhyve@zelta.space>