Mercurial > hgrepos > FreeBSD > ports > sysutils > local-bsdtools
diff 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 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/man/man8/fzfs-create-tree.rst Mon Feb 20 00:43:30 2023 +0100 @@ -0,0 +1,72 @@ +.. -*- coding: utf-8; indent-tabs-mode: nil; -*- + +fzfs-create-tree +================ + +.. program:: fzfs create-tree + + +Synopsis +-------- + +**fzfs create-tree** [**-A**] [**-M** `mountpoint`] [**-n**] [**-p**] [**-u**] `source-dataset` `dest-dataset` + +Description +----------- + +Copy the ZFS filesystem structure that is rooted at `source-dataset` +to the destination rooted at `dest-dataset`. + +The content of the filesystems is **not** copied. This is also true for +permissions and/or ACLs. + +`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`, +`exec`, `setuid`, `compression`, `primarycache`, `sync` and +`readonly`. + +By default `canmount` is also copied. But this can be modified with +options :option:`-A` and :option:`-p`. + + +Options +------- + +.. option:: -A + + Unconditionally set the ZFS property `canmount=noauto` for all + created datasets in the destination tree. This option 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. + +.. option:: -n + + Dry-run. Do not really create datasets but show what would be done. + +.. option:: -p + + Copy the `canmount` property only from the source to the root + destination dataset This will be overwritten by the option + :option:`-A`. + +.. option:: -u + + Do not mount the newly created datasets. + + +Environment +----------- + +All environment variables that affect :command:`zfs` are effective also. + + +See Also +-------- + +:manpage:`fzfs(8)`
