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 a	snapshot to prevent it being removed with the zfs de-
     stroy 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.

       -r  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.

       -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 snapshot...
       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://www.freebsd.org/cgi/man.cgi?query=zfs-release&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help