Scroll to navigation

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

NAME

zfs-hold
Hold a snapshot to prevent it being removed with the zfs destroy command.

SYNOPSIS

zfs hold [-r] tag snapshot...

zfs holds [-rH] snapshot...

zfs release [-r] tag snapshot...

DESCRIPTION

zfs hold [-r] tag snapshot...
Adds a single reference, named with the tag argument, to the specified snapshot or 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 [-rH] 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.
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 Linux