Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 snapshota|
     zfs holds [-rHp] snapshota|
     zfs release [-r] tag snapshota|

DESCRIPTION
     zfs hold [-r] tag snapshota|
       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 us-
       ing 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] snapshota|
       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 snapshota|
       Removes a single reference, named with the tag argument, from the  speci-
       fied  snapshot  or  snapshots.  The tag must already exist for each snap-
       shot.  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)

FreeBSD ports 15.1		November 8, 2022		     ZFS-HOLD(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zfs-release&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help