ZPOOL-CHECKPOINT(8) System Manager's Manual ZPOOL-CHECKPOINT(8)

# [NAME](#NAME)

`zpool-checkpoint` — check-point current ZFS storage pool state

# [SYNOPSIS](#SYNOPSIS)

`zpool` `checkpoint` \[`-d` \[`-w`]] `pool`

# [DESCRIPTION](#DESCRIPTION)

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](#OPTIONS)

[`-d`](#d), `--discard`

Discards an existing checkpoint from `pool`.

[`-w`](#w), `--wait`

Waits until the checkpoint has finished being discarded before returning.

# [SEE ALSO](#SEE_ALSO)

[zfs-snapshot(8)](/man/os/zfs/zfs-snapshot.8), [zpool-import(8)](/man/os/zfs/zpool-import.8), [zpool-status(8)](/man/os/zfs/zpool-status.8)

July 11, 2022 OpenZFS

---

Document: zpool-checkpoint(8) from zfs 2.4.4-r4 (Chainguard OS)
Source: https://github.com/openzfs/zfs