This change is taken from ZoL
commit 305bc4b370b20de81eaf10a1cf724374258b74d1
Author: Christian Schwarz <m...@cschwarz.com>
Date: Wed May 10 00:36:53 2017 +0200
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 <m...@gmelikov.ru>
Reviewed-by: Brian Behlendorf <behlendo...@llnl.gov>
Reviewed-by: DHE <g...@dehacked.net>
Reviewed-by: Richard Laager <rlaa...@wiktel.com>
Signed-off-by: Christian Schwarz <m...@cschwarz.com>
Closes #6102
https://www.illumos.org/issues/9621
You can view, comment on, or merge this pull request online at:
https://github.com/openzfs/openzfs/pull/656
-- Commit Summary --
* Make createtxg and guid properties public
-- File Changes --
M usr/src/common/zfs/zfs_prop.c (8)
M usr/src/lib/libzfs/common/libzfs_dataset.c (1)
M usr/src/man/man1m/zfs.1m (12)
M usr/src/uts/common/sys/fs/zfs.h (2)
-- Patch Links --
https://github.com/openzfs/openzfs/pull/656.patch
https://github.com/openzfs/openzfs/pull/656.diff
--
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/openzfs/openzfs/pull/656
------------------------------------------
openzfs: openzfs-developer
Permalink:
https://openzfs.topicbox.com/groups/developer/Tb0c0d1f1c824d904-M21330810c34dd2167f316da8
Delivery options: https://openzfs.topicbox.com/groups
