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 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	speci-
	 fied 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 snap-
	 shots.

	 -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)

FreeBSD	14.3			 June 30, 2019			   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+14.3-RELEASE+and+Ports>

home | help