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

3 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12
  3. 13

From zfsutils-linux 2.3.9-0+deb13u1 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.