Mercurial > hgrepos > FreeBSD > ports > sysutils > local-bsdtools

comparison docs/man/man8/fzfs-create-tree.rst @ 623:b74c65ceab96

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Docs: Enhanced manuals
author Franz Glasner <fzglas.hg@dom66.de>
date Sun, 22 Sep 2024 19:07:26 +0200
parents 54c6eecbe53f
children
comparison
equal deleted inserted replaced
622:54c6eecbe53f 623:b74c65ceab96
20 The content of the filesystems is **not** copied. This is also true for 20 The content of the filesystems is **not** copied. This is also true for
21 permissions and/or ACLs. 21 permissions and/or ACLs.
22 22
23 `dest-dataset` must not exist already. 23 `dest-dataset` must not exist already.
24 24
25 By default some important dataset properties that are set locally in 25 By default some important dataset properties are copied from
26 the source tree are copied to the destination. This includes `atime`, 26 the source tree to the destination. This includes `atime`,
27 `exec`, `setuid`, `compression`, `primarycache`, `sync` and 27 `exec`, `setuid`, `compression`, `primarycache`, `sync` and
28 `readonly`. 28 `readonly`. But they are copied *only* if are of type ``local`` in
29 the source.
29 30
30 By default `canmount` is also copied. But this can be modified with 31 By default `canmount` is also copied. But this can be modified with
31 options :option:`-A` and :option:`-p`. 32 options :option:`-A` and :option:`-p`.
33
34 The `mountpoint` property is not copied. Normally it will be inherited
35 as the ZFS rules for `dest-dataset` regarding its parent are applied.
36 This can be changed with :option:`-M mountpoint`. Child datasets always
37 will inherit their mountpoint from `dest-dataset`.
32 38
33 39
34 Options 40 Options
35 ------- 41 -------
36 42
37 .. option:: -A 43 .. option:: -A
38 44
39 Unconditionally set the ZFS property `canmount=noauto` for all 45 Unconditionally set the ZFS property `canmount=noauto` for all
40 created datasets in the destination tree. This option overwrites 46 created datasets in the destination tree. This option also overwrites
41 option :option:`-p`. 47 option :option:`-p`.
42 48
43 .. option:: -M <mountpoint> 49 .. option:: -M <mountpoint>
44 50
45 Set the `mountpoint` property for the root `dest-dataset` to `mountpoint`. 51 Set the `mountpoint` property for the destination root `dest-dataset`
46 All children will be set to inherit it. 52 to `mountpoint`. All children will be set to inherit it.
53
54 If not given then the mountpoint will we inherited by normal ZFS
55 inheritance from the destination's parent.
47 56
48 .. option:: -n 57 .. option:: -n
49 58
50 Dry-run. Do not really create datasets but show what would be done. 59 Dry-run. Do not really create datasets but show what would be done.
51 60
52 .. option:: -p 61 .. option:: -p
53 62
54 Copy the `canmount` property only from the source to the root 63 Copy the `canmount` property only from the source root to the destinaion
55 destination dataset This will be overwritten by the option 64 root dataset This will be overwritten by the option :option:`-A`.
56 :option:`-A`.
57 65
58 .. option:: -u 66 .. option:: -u
59 67
60 Do not mount the newly created datasets. 68 Do not mount the newly created datasets when they are created.
61 69
62 70
63 Environment 71 Environment
64 ----------- 72 -----------
65 73