Mercurial > hgrepos > FreeBSD > ports > sysutils > local-bsdtools
comparison docs/man/man8/fzfs-create-tree.rst @ 380:6be930eb7490
Implement the "fzfs create-tree" command
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Mon, 20 Feb 2023 00:43:30 +0100 |
| parents | |
| children | bf0d63c8e682 |
comparison
equal
deleted
inserted
replaced
| 379:b4173e88c57c | 380:6be930eb7490 |
|---|---|
| 1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*- | |
| 2 | |
| 3 fzfs-create-tree | |
| 4 ================ | |
| 5 | |
| 6 .. program:: fzfs create-tree | |
| 7 | |
| 8 | |
| 9 Synopsis | |
| 10 -------- | |
| 11 | |
| 12 **fzfs create-tree** [**-A**] [**-M** `mountpoint`] [**-n**] [**-p**] [**-u**] `source-dataset` `dest-dataset` | |
| 13 | |
| 14 Description | |
| 15 ----------- | |
| 16 | |
| 17 Copy the ZFS filesystem structure that is rooted at `source-dataset` | |
| 18 to the destination rooted at `dest-dataset`. | |
| 19 | |
| 20 The content of the filesystems is **not** copied. This is also true for | |
| 21 permissions and/or ACLs. | |
| 22 | |
| 23 `dest-dataset` must not exist already. | |
| 24 | |
| 25 By default some important dataset properties that are set locally in | |
| 26 the source tree are copied to the destination. This includes `atime`, | |
| 27 `exec`, `setuid`, `compression`, `primarycache`, `sync` and | |
| 28 `readonly`. | |
| 29 | |
| 30 By default `canmount` is also copied. But this can be modified with | |
| 31 options :option:`-A` and :option:`-p`. | |
| 32 | |
| 33 | |
| 34 Options | |
| 35 ------- | |
| 36 | |
| 37 .. option:: -A | |
| 38 | |
| 39 Unconditionally set the ZFS property `canmount=noauto` for all | |
| 40 created datasets in the destination tree. This option overwrites | |
| 41 option :option:`-p`. | |
| 42 | |
| 43 .. option:: -M mountpoint | |
| 44 | |
| 45 Set the `mountpoint` property for the root `dest-dataset` to `mountpoint`. | |
| 46 All children will be set to inherit it. | |
| 47 | |
| 48 .. option:: -n | |
| 49 | |
| 50 Dry-run. Do not really create datasets but show what would be done. | |
| 51 | |
| 52 .. option:: -p | |
| 53 | |
| 54 Copy the `canmount` property only from the source to the root | |
| 55 destination dataset This will be overwritten by the option | |
| 56 :option:`-A`. | |
| 57 | |
| 58 .. option:: -u | |
| 59 | |
| 60 Do not mount the newly created datasets. | |
| 61 | |
| 62 | |
| 63 Environment | |
| 64 ----------- | |
| 65 | |
| 66 All environment variables that affect :command:`zfs` are effective also. | |
| 67 | |
| 68 | |
| 69 See Also | |
| 70 -------- | |
| 71 | |
| 72 :manpage:`fzfs(8)` |