Mercurial > hgrepos > FreeBSD > ports > sysutils > local-bsdtools
diff docs/man/man8/fzfs-create-tree.rst @ 623:b74c65ceab96
Docs: Enhanced manuals
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Sun, 22 Sep 2024 19:07:26 +0200 |
| parents | 54c6eecbe53f |
| children |
line wrap: on
line diff
--- a/docs/man/man8/fzfs-create-tree.rst Sun Sep 22 16:04:18 2024 +0200 +++ b/docs/man/man8/fzfs-create-tree.rst Sun Sep 22 19:07:26 2024 +0200 @@ -22,14 +22,20 @@ `dest-dataset` must not exist already. -By default some important dataset properties that are set locally in -the source tree are copied to the destination. This includes `atime`, +By default some important dataset properties are copied from +the source tree to the destination. This includes `atime`, `exec`, `setuid`, `compression`, `primarycache`, `sync` and -`readonly`. +`readonly`. But they are copied *only* if are of type ``local`` in +the source. By default `canmount` is also copied. But this can be modified with options :option:`-A` and :option:`-p`. +The `mountpoint` property is not copied. Normally it will be inherited +as the ZFS rules for `dest-dataset` regarding its parent are applied. +This can be changed with :option:`-M mountpoint`. Child datasets always +will inherit their mountpoint from `dest-dataset`. + Options ------- @@ -37,13 +43,16 @@ .. option:: -A Unconditionally set the ZFS property `canmount=noauto` for all - created datasets in the destination tree. This option overwrites + created datasets in the destination tree. This option also overwrites option :option:`-p`. .. option:: -M <mountpoint> - Set the `mountpoint` property for the root `dest-dataset` to `mountpoint`. - All children will be set to inherit it. + Set the `mountpoint` property for the destination root `dest-dataset` + to `mountpoint`. All children will be set to inherit it. + + If not given then the mountpoint will we inherited by normal ZFS + inheritance from the destination's parent. .. option:: -n @@ -51,13 +60,12 @@ .. option:: -p - Copy the `canmount` property only from the source to the root - destination dataset This will be overwritten by the option - :option:`-A`. + Copy the `canmount` property only from the source root to the destinaion + root dataset This will be overwritten by the option :option:`-A`. .. option:: -u - Do not mount the newly created datasets. + Do not mount the newly created datasets when they are created. Environment
