Scroll to navigation

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

NAME

zfs-holdhold 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.

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.
Lists the holds that are set on the named descendent snapshots, in addition to listing the holds on the named snapshot.
Do not print headers, use tab-delimited output.
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.
Recursively releases a hold with the given tag on the snapshots of all descendent file systems.

SEE ALSO

zfs-destroy(8)

June 30, 2019 OpenZFS