FreeBSD Manual Pages
zelta-clone(8) System Manager's Manual zelta-clone(8) NAME zelta clone - Perform a recursive clone operation. SYNOPSIS zelta clone [-d depth] source/dataset[@snap] target/dataset DESCRIPTION zelta clone performs a recursive zfs clone operation on a dataset. This is useful for recursive duplication of dataset trees and backup inspection and recovery of a files replicated with zelta backup. The clones will refer- ence the latest or indicated snapshot, and consume practically no addi- tional space. Clones can be modified and destroyed without affecting their origin datasets. The source and target must be on the same host and pool. The mountpoint will be inherited below the target parent (as provided by zfs clone). The target dataset must not exist. To create a clone on a remote host ensure the source and target are identical including the username and hostname used: Example remote operation: zelta clone backup@host1.com:tank/zones/data host1.com:tank/clones/data OPTIONS Required Options source A dataset, in the form pool[/dataset][@snapshot], which will be cloned along with all of its descendents. If a snapshot is not given, the most recent snapshot will be used. target A dataset on the same pool as the source/dataset, where the clones will be created. This dataset must not exist. Logging Options -n, --dryrun Don't clone, but show the zfs clone commands that would be executed. -q Reduce verbosity. -v Increase verbosity. Dataset and Snapshot Options --snapshot-always Ensure a snapshot before cloning. --snapshot-name Specify a snapshot name. See zelta.env.example to adjust the de- fault naming scheme. -d depth, --depth depth Limits the depth of all Zelta operations. EXAMPLES Clone a dataset tree: zelta clone tank/vm/myos tank/temp/myos-202404 Recover a dataset tree, in place, to a previous snapshot's state: zfs rename tank/vm/myos tank/Archives/myos-202404 zelta clone tank/Archives/myos-202404@goodsnapshot tank/vm/myos Dry Run: Display the zfs clone commands without executing them. zelta clone -n tank/source/dataset tank/target/dataset SEE ALSO zelta(8), zelta-backup(8), zelta-match(8), zelta-options(7), zelta-pol- icy(8), zelta-revert(8), zelta-rotate(8), cron(8), ssh(1), zfs(8), zfs-clone(8), zfs-promote(8) AUTHORS Daniel J. Bell <bellhyve@zelta.space> WWW https://zelta.space zelta-clone(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHORS | WWW
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zelta-clone&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>