comparison docs/man/man8/fzfs-copy-tree.rst @ 420:bf0d63c8e682

Begin fzfs-copy-tree: man page structure done
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 18 Sep 2023 09:43:12 +0200
parents
children a571a30bcf8a
comparison
equal deleted inserted replaced
419:8c7f686ef66f 420:bf0d63c8e682
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
2
3 fzfs-copy-tree
4 ==============
5
6 .. program:: fzfs copy-tree
7
8
9 Synopsis
10 --------
11
12 **fzfs copy-tree** [**-A**] [**-M** `mountpoint`] [**-n**] [**-p**] [**-u**] `source-dataset` `dest-dataset`
13
14 Description
15 -----------
16
17 Copy the ZFS filesystem structure and contents that is rooted at
18 `source-dataset` to the destination rooted at `dest-dataset`.
19
20 The content of the filesystems is copied also.
21
22 `dest-dataset` must not exist already.
23
24 By default `canmount` is also copied. But this can be modified with
25 options :option:`-A` and :option:`-p`.
26
27
28 Options
29 -------
30
31 .. option:: -A
32
33 Unconditionally set the ZFS property `canmount=noauto` for all
34 created datasets in the destination tree. This option overwrites
35 option :option:`-p`.
36
37 .. option:: -M mountpoint
38
39 Set the `mountpoint` property for the root `dest-dataset` to `mountpoint`.
40 All children will be set to inherit it.
41
42 .. option:: -n
43
44 Dry-run. Do not really create and copy datasets but show what would
45 be done.
46
47 .. option:: -p
48
49 Copy the `canmount` property only from the source to the root
50 destination dataset This will be overwritten by the option
51 :option:`-A`.
52
53 .. option:: -u
54
55 Do not mount the copied datasets.
56
57
58 Environment
59 -----------
60
61 All environment variables that affect :command:`zfs` are effective also.
62
63
64 See Also
65 --------
66
67 :manpage:`fzfs(8)`, :manpage:`fzfs-create-tree(8)`