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

FreeBSD Manual Pages

  
 
  

home | help
ZFS-HOLD(8)		FreeBSD	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 [-rH] 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
       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 [-rH] 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.

     zfs release [-r] tag snapshota|
       Removes a single	reference, named with the tag argument,	from the spec-
       ified snapshot or snapshots.  The tag must already exist	for each snap-
       shot.  If a hold	exists on a snapshot, attempts to destroy that snap-
       shot 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	13.0			 June 30, 2019			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

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

home | help