Man page - zfs-release(8)

Manual

---

ZFS-HOLD (8) System Manager’s Manual ZFS-HOLD (8)

NAME

zfs-hold — hold ZFS snapshots to prevent their removal

SYNOPSIS

zfs hold [ -r ] tag snapshot …
zfs holds [ -rHp ] snapshot …
zfs release [ -r ] tag snapshot …

DESCRIPTION
zfs hold [ -r ] tag snapshot …

Adds a single reference, named with the tag argument, to the specified snapshots. Each snapshot has its own tag namespace, and tags must be unique within that space.

If a hold exists on a snapshot, attempts to destroy that snapshot by using the zfs destroy command return EBUSY .

-r

Specifies that a hold with the given tag is applied recursively to the snapshots of all descendent file systems.

zfs holds [ -rHp ] snapshot …

Lists all existing user references for the given snapshot or snapshots.

-r

Lists the holds that are set on the named descendent snapshots, in addition to listing the holds on the named snapshot.

-H

Do not print headers, use tab-delimited output.

-p

Prints holds timestamps as Unix epoch timestamps.

zfs release [ -r ] tag snapshot …

Removes a single reference, named with the tag argument, from the specified snapshot or snapshots. The tag must already exist for each snapshot. If a hold exists on a snapshot, attempts to destroy that snapshot by using the zfs destroy command return EBUSY .

-r

Recursively releases a hold with the given tag on the snapshots of all descendent file systems.

SEE ALSO

zfs-destroy (8) OpenZFS June 30, 2019 ZFS-HOLD (8)

---