Project

General

Profile

Feature #9621

Make createtxg and guid properties public

Added by Josh Paetzel about 1 year ago. Updated about 1 year ago.

Status:
Closed
Priority:
Normal
Assignee:
-
Category:
zfs - Zettabyte File System
Start date:
2018-06-21
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:
needs-triage

Description

Make guid and createtxg public zfs properties.
Document said changes.
Fix a display bug with createtxg

ZoL has the following commit message:

commit 305bc4b370b20de81eaf10a1cf724374258b74d1
Author: Christian Schwarz <>
Date: Wed May 10 00:36:53 2017 +0200

Make createtxg and guid properties public
Document the existence of `createtxg` and `guid` native properties
in man pages and zfs command output.
One of the great features of ZFS is incremental replication of
snapshots, possibly between pools on different machines.
Shell scripts are commonly used to auomate this procedure. They have to
find the most recent common snapshot between both sides and then
perform incremental send & recv.
Currently, scripts rely on the sorting order of `zfs list`, which
defaults to `createtxg`, and the assumption that snapshot names on
either side do not change.
By making `createtxg` and `guid` part of the public ZFS interface,
scripts are enabled to use
a) `createtxg` to determine the logical & temporal order of snapshots
(the creation property is not an equivalent substitute since
multiple snapshots may be created within one second)
b) `guid` to uniquely identify a snapshot, independent of its current
display name
This has the potential of making scripts safer and correct.
Reviewed-by: George Melikov &lt;&gt;
Reviewed-by: Brian Behlendorf &lt;&gt;
Reviewed-by: DHE &lt;&gt;
Reviewed-by: Richard Laager &lt;&gt;
Signed-off-by: Christian Schwarz &lt;&gt;
Closes #6102

History

#1

Updated by Prakash Surya about 1 year ago

  • Subject changed from Bring in 305bc4b3 from ZoL, which documents and makes public guid and createtxg zfs props to Make createtxg and guid properties public
#2

Updated by Electric Monk about 1 year ago

  • Status changed from New to Closed
  • % Done changed from 0 to 100

git commit e8d4a73c868afb740396041be80ed2b141065e76

commit  e8d4a73c868afb740396041be80ed2b141065e76
Author: Josh Paetzel <josh@tcbug.org>
Date:   2018-07-24T22:49:45.000Z

    9621 Make createtxg and guid properties public
    Reviewed by: Andy Stormont <astormont@racktopsystems.com>
    Reviewed by: Paul Dagnelie <pcd@delphix.com>
    Reviewed by: Matt Ahrens <matt@delphix.com>
    Reviewed by: Yuri Pankov <yuripv@yuripv.net>
    Approved by: Robert Mustacchi <rm@joyent.com>

Also available in: Atom PDF