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)