zfs-bookmark.8

ZFS-BOOKMARK(8)

System Manager's Manual

ZFS-BOOKMARK(8)

NAME

zfs-bookmark — create bookmark of ZFS snapshot

SYNOPSIS

zfs bookmark [-r] snapshot|bookmark newbookmark

DESCRIPTION

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. The dataset of newbookmark, if given, must be the same as that of the source snapshot.

Either the source or newbookmark may be given in short form (@snapshot or #bookmark), in which case its dataset is taken from the other argument.

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