zfs-bookmark(8)

zfs-bookmark8

Create bookmark of zfs snapshot

Usage

zfs {bookmark [-r] snapshot | bookmark newbookmark}

Overview

Creates a new bookmark of the given snapshot or bookmark. Bookmarks mark the point in time when the snapshot was created, and can be used as the incremental source for a zfs send.

-r

Recursively create bookmarks for the given source snapshot of all descendent datasets. The source must be a snapshot, and a bookmark is created only for the descendants that have a snapshot of that name; descendants without it are skipped.

Not on Linux.

When creating a bookmark from an existing redaction bookmark, the resulting bookmark is not a redaction bookmark.

This feature must be enabled to be used. See zpool-features(7) for details on ZFS feature flags and the bookmarks feature.

Examples

Example 1 : No Creating a bookmark

The following example creates a bookmark to a snapshot. This bookmark can then be used instead of a snapshot in send streams.

# zfs bookmark rpool@snapshot rpool#bookmark

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

-r since FreeBSD 16.0-CURRENT (2026-10-27).

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