zfs-release(8)

zfs-release8

Hold zfs snapshots to prevent their removal

Part of zfs-hold(8).

Usage

zfs hold [-r] tag snapshot…

zfs holds [-rHp] snapshot…

zfs release [-r] tag snapshot…

Overview

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.

Releases

15 releases since FreeBSD 13.0-RELEASE; the text changed 4 times.

  1. 13.0
  2. 13.1–13.5
  3. 14.0–14.5
  4. 15.0–15.1
  5. 16.0

-p since FreeBSD 14.0-RELEASE.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.