.\" SPDX-License-Identifier: CDDL-1.0
.\"
.\" This file and its contents are supplied under the terms of the
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source.  A copy of the CDDL is also available via the Internet at
.\" https://opensource.org/license/CDDL-1.0.
.\"
.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
.\" Copyright (c) 2017 Datto Inc.
.\" Copyright (c) 2018 George Melikov. All Rights Reserved.
.\" Copyright 2017 Nexenta Systems, Inc.
.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
.\"
.Dd July 11, 2022
.Dt ZPOOL-CHECKPOINT 8
.Os
.
.Sh NAME
.Nm zpool-checkpoint
.Nd check-point current ZFS storage pool state
.Sh SYNOPSIS
.Nm zpool
.Cm checkpoint
.Op Fl d Op Fl w
.Ar pool
.
.Sh DESCRIPTION
Checkpoints the current state of
.Ar pool
, which can be later restored by
.Nm zpool Cm import --rewind-to-checkpoint .
The existence of a checkpoint in a pool prohibits the following
.Nm zpool
subcommands:
.Cm remove , attach , detach , split , No and Cm reguid .
In addition, it may break reservation boundaries if the pool lacks free
space.
The
.Nm zpool Cm status
command indicates the existence of a checkpoint or the progress of discarding a
checkpoint from a pool.
.Nm zpool Cm list
can be used to check how much space the checkpoint takes from the pool.
.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl d , -discard
Discards an existing checkpoint from
.Ar pool .
.It Fl w , -wait
Waits until the checkpoint has finished being discarded before returning.
.El
.
.Sh SEE ALSO
.Xr zfs-snapshot 8 ,
.Xr zpool-import 8 ,
.Xr zpool-status 8