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

annotate docs/man/man8/ftjail-datasets-tmpl.rst @ 807:ed94334bc6f1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fports: Update manual pages to show the now current syntax
author Franz Glasner <fzglas.hg@dom66.de>
date Tue, 05 Nov 2024 11:18:52 +0100
parents 5da1455547d3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
300
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 ftjail-datasets-tmpl
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 ====================
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 Synopsis
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 --------
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
9 **ftjail datasets-tmpl** [**-L**] `dataset-parent-base` `dataset-parent-skeleton` `name`
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11 **ftjail datasets-tmpl** [**-P**] `dataset-parent-base` `dataset-parent-skeleton` `name`
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
14 Description
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
15 -----------
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
16
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
17 Create ZFS template datasets, i.e. the ro base and the rw skeleton to
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
18 be used within Thin Jails.
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
19
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
20 The ZFS datasets `dataset-parent-base` and `dataset-parent-skeleton`
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
21 must exist already.
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
22
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
23 A child with name `name` must not exist already for both given parent
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
24 datasets.
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
25
620
5da1455547d3 Manpages: note that ftjail datasets-tmpl does not automatically mount newly created datasets automatically
Franz Glasner <fzglas.hg@dom66.de>
parents: 300
diff changeset
26 All datasets are creating using :command:`zfs create` and employing its
5da1455547d3 Manpages: note that ftjail datasets-tmpl does not automatically mount newly created datasets automatically
Franz Glasner <fzglas.hg@dom66.de>
parents: 300
diff changeset
27 ``-u`` option so that the newly created file system is not mounted
5da1455547d3 Manpages: note that ftjail datasets-tmpl does not automatically mount newly created datasets automatically
Franz Glasner <fzglas.hg@dom66.de>
parents: 300
diff changeset
28 automatically at creation time.
5da1455547d3 Manpages: note that ftjail datasets-tmpl does not automatically mount newly created datasets automatically
Franz Glasner <fzglas.hg@dom66.de>
parents: 300
diff changeset
29
5da1455547d3 Manpages: note that ftjail datasets-tmpl does not automatically mount newly created datasets automatically
Franz Glasner <fzglas.hg@dom66.de>
parents: 300
diff changeset
30 See :manpage:`ftjail-mount-tmpl(8)` for properly mounting the created
5da1455547d3 Manpages: note that ftjail datasets-tmpl does not automatically mount newly created datasets automatically
Franz Glasner <fzglas.hg@dom66.de>
parents: 300
diff changeset
31 datasets.
5da1455547d3 Manpages: note that ftjail datasets-tmpl does not automatically mount newly created datasets automatically
Franz Glasner <fzglas.hg@dom66.de>
parents: 300
diff changeset
32
300
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
33
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34 Options
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
35 -------
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
36
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
37 .. program:: ftjail datasets-tmpl
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
38
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
39 .. option:: -L
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
40
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
41 Create dataset properties optimized for employing a
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
42 :file:`skeleton` subdirectory (i.e. Thin Jails using symbolic links
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
43 from a (read-only) root into the writeable parts of the system).
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
44
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
45 .. option:: -P
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
46
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
47 Create ZFS dataset properties optimized for direct mounts of skeleton
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
48 children over an already mounted base.
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
49
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
50
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
51 Environment
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
52 -----------
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
53
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
54 All environment variables that affect :command:`zfs` are effective also.
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
55
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
56
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
57 See Also
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
58 --------
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
59
901b0e3c0dab All manual pages for ftjail done
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
60 :manpage:`ftjail(8)`, :manpage:`ftjail-mount-tmpl(8)`,