Mercurial > hgrepos > FreeBSD > ports > sysutils > local-bsdtools
comparison docs/man/man8/fzfs-clone-tree.rst @ 520:7d08fd78775c
fzfs: implement "fzfs clone-tree".
Clone a ZFS dataset tree and preserve locally set properties.
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Sun, 01 Sep 2024 21:34:27 +0200 |
| parents | |
| children | c05ef1c86c9c |
comparison
equal
deleted
inserted
replaced
| 519:e26183b3bac9 | 520:7d08fd78775c |
|---|---|
| 1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*- | |
| 2 | |
| 3 fzfs-clone-tree | |
| 4 =============== | |
| 5 | |
| 6 .. program:: fzfs clone-tree | |
| 7 | |
| 8 | |
| 9 Synopsis | |
| 10 -------- | |
| 11 | |
| 12 **fzfs clone-tree** [**-n**] `source-dataset` `dest-dataset` | |
| 13 | |
| 14 | |
| 15 Description | |
| 16 ----------- | |
| 17 | |
| 18 Clone the ZFS snapshot that is rooted at `source-dataset` and all | |
| 19 descendent snapshots into the destination dataset rooted at | |
| 20 `dest-dataset`. | |
| 21 | |
| 22 `source-dataset` must be a snapshot. All of its children must have a | |
| 23 snapshot with the very same snapshot. | |
| 24 | |
| 25 `dest-dataset` must not exist already. | |
| 26 | |
| 27 All properties that are of type ``local`` or ``received``are copied to the | |
| 28 destination. This is also true for ``canmount`` and ``mountpoint``. | |
| 29 | |
| 30 The cloned datasets will are *not* mounted automatically. | |
| 31 | |
| 32 If something fails it is tried to delete the intermediately created | |
| 33 datasets. | |
| 34 | |
| 35 | |
| 36 Options | |
| 37 ------- | |
| 38 | |
| 39 .. option:: -n | |
| 40 | |
| 41 Dry-run. Do not really clone datasets but show what would be done. | |
| 42 | |
| 43 | |
| 44 Environment | |
| 45 ----------- | |
| 46 | |
| 47 All environment variables that affect :command:`zfs` are effective also. | |
| 48 | |
| 49 | |
| 50 See Also | |
| 51 -------- | |
| 52 | |
| 53 :manpage:`fzfs(8)` |