man: zfs-clone.8: import examples from zfs.8

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Closes #13228
This commit is contained in:
наб 2022-03-16 18:43:33 +01:00 committed by Brian Behlendorf
parent 52f3aebdb2
commit c6fd08797f
2 changed files with 28 additions and 1 deletions

View File

@ -29,7 +29,7 @@
.\" Copyright 2018 Nexenta Systems, Inc. .\" Copyright 2018 Nexenta Systems, Inc.
.\" Copyright 2019 Joyent, Inc. .\" Copyright 2019 Joyent, Inc.
.\" .\"
.Dd May 27, 2021 .Dd March 16, 2022
.Dt ZFS-CLONE 8 .Dt ZFS-CLONE 8
.Os .Os
. .
@ -65,6 +65,32 @@ If the target filesystem or volume already exists, the operation completes
successfully. successfully.
.El .El
. .
.Sh EXAMPLES
.\" These are, respectively, examples 9, 10 from zfs.8
.\" Make sure to update them bidirectionally
.Ss Example 1 : No Creating a ZFS Clone
The following command creates a writable file system whose initial contents are
the same as
.Ar pool/home/bob@yesterday .
.Dl # Nm zfs Cm clone Ar pool/home/bob@yesterday pool/clone
.
.Ss Example 2 : No Promoting a ZFS Clone
The following commands illustrate how to test out changes to a file system, and
then replace the original file system with the changed one, using clones, clone
promotion, and renaming:
.Bd -literal -compact -offset Ds
.No # Nm zfs Cm create Ar pool/project/production
populate /pool/project/production with data
.No # Nm zfs Cm snapshot Ar pool/project/production Ns @ Ns Ar today
.No # Nm zfs Cm clone Ar pool/project/production@today pool/project/beta
make changes to /pool/project/beta and test them
.No # Nm zfs Cm promote Ar pool/project/beta
.No # Nm zfs Cm rename Ar pool/project/production pool/project/legacy
.No # Nm zfs Cm rename Ar pool/project/beta pool/project/production
once the legacy version is no longer needed, it can be destroyed
.No # Nm zfs Cm destroy Ar pool/project/legacy
.Ed
.
.Sh SEE ALSO .Sh SEE ALSO
.Xr zfs-promote 8 , .Xr zfs-promote 8 ,
.Xr zfs-snapshot 8 .Xr zfs-snapshot 8

View File

@ -301,6 +301,7 @@ if invalid command line options were specified.
.Sh EXAMPLES .Sh EXAMPLES
.\" Examples 1, 4, 6, 14, 16 are shared with zfs-set.8. .\" Examples 1, 4, 6, 14, 16 are shared with zfs-set.8.
.\" Examples 5 are shared with zfs-list.8. .\" Examples 5 are shared with zfs-list.8.
.\" Examples 9, 10 are shared with zfs-clone.8.
.\" Examples 12, 13 are shared with zfs-send.8. .\" Examples 12, 13 are shared with zfs-send.8.
.\" Examples 12, 13 are also shared with zfs-receive.8. .\" Examples 12, 13 are also shared with zfs-receive.8.
.\" Examples 17, 18, 19, 20, 21 are shared with zfs-allow.8. .\" Examples 17, 18, 19, 20, 21 are shared with zfs-allow.8.