zpool-checkpoint(8)

zpool-checkpoint8

Check-point current zfs storage pool state

Usage

zpool checkpoint [-d [-w]] pool

Overview

Checkpoints the current state of pool , which can be later restored by zpool import --rewind-to-checkpoint. The existence of a checkpoint in a pool prohibits the following zpool subcommands: remove, attach, detach, split, and reguid. In addition, it may break reservation boundaries if the pool lacks free space. The zpool status command indicates the existence of a checkpoint or the progress of discarding a checkpoint from a pool. zpool list can be used to check how much space the checkpoint takes from the pool.

Options

-d, --discard

Discards an existing checkpoint from pool.

-w, --wait

Waits until the checkpoint has finished being discarded before returning.

Releases

15 releases since FreeBSD 13.0-RELEASE; the text changed 4 times.

  1. 13.0
  2. 13.1–13.5
  3. 14.0–14.5
  4. 15.0–15.1
  5. 16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.