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

annotate docs/man/man8/ftjail.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 bc418b122fc9
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 ftjail
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 ======
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 Synopsis
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 --------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
9 **ftjail -hV**
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11 **ftjail subcommand**
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13
298
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
14 Description
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
15 -----------
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
16
662
bc418b122fc9 fzfs: Implement option "-f" for the "umount" command: try to forcefully umount a dataset tree
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
17 Management tool for Thin Jails: creation of base and skeleton ZFS datasets,
298
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
18 mount and population helpers.
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
19
323
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
20 The following global options are implemented:
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
21
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
22 .. program:: ftjail
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
23
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
24 .. option:: -h
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
25
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
26 Print a short usage message to stdout and exit.
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
27
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
28 .. option:: -V
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
29
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
30 Print the program name and version number to stdout and exit.
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
31
298
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
32
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
33 Subcommands
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34 -----------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
35
308
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
36 :manpage:`ftjail-build-etcupdate-current-tmpl(8)`
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
37
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
38 Build a "current" tree suitable for the default and extract mode
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
39 of \"etcupdate\"
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
40
658
260a81d769a6 Implemented "ftjail check-freebsd-update": thorough check for preconditions to a successful run of "ftjail freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 470
diff changeset
41 :manpage:`ftjail-check-freebsd-update(8)`
260a81d769a6 Implemented "ftjail check-freebsd-update": thorough check for preconditions to a successful run of "ftjail freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 470
diff changeset
42
260a81d769a6 Implemented "ftjail check-freebsd-update": thorough check for preconditions to a successful run of "ftjail freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 470
diff changeset
43 Check for preconditions to run :manpage:`ftjail-freebsd-update(8)`
260a81d769a6 Implemented "ftjail check-freebsd-update": thorough check for preconditions to a successful run of "ftjail freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 470
diff changeset
44 for a Thin Jail successfully
260a81d769a6 Implemented "ftjail check-freebsd-update": thorough check for preconditions to a successful run of "ftjail freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 470
diff changeset
45
372
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
46 :manpage:`ftjail-copy-skel(8)`
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
47
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
48 Recursively copy template skeleton contents into jail-specific datasets
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
49
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
50 :manpage:`ftjail-datasets-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
51
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
52 Create ZFS template datasets for new Thin Jails using base and skeleton
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
53
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
54 :manpage:`ftjail-freebsd-update(8)`
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
55
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
56 A :manpage:`freebsd-update(8)` implementation for Thin Jails
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
57
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
58 :manpage:`ftjail-mount-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
59
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
60 Canonically mount the RO base and the RW skeleton of a Thin Jail
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
61
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
62 :manpage:`ftjail-umount-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
63
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
64 Unmount mounted Thin Jail template datasets
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
65
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
66 :manpage:`ftjail-interlink-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
67
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
68 Create proper symlinks for "skeleton" style Thin Jails
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
69
307
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 301
diff changeset
70 :manpage:`ftjail-populate-tmpl(8)`
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
71
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
72 Populate a prepared directory structure with the contents of a
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
73 FreeBSD base system
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
74
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
75 :manpage:`ftjail-snapshot-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
76
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
77 Recursively create ZFS snapshots of the RO base datasets and the RW
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
78 skeleton datasets
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
79
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
80
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
81 Implementation Notes
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
82 --------------------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
83
307
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 301
diff changeset
84 All commands with the exception of :command:`ftjail populate-tmpl` and
299
49890965e43c FIX: "ftjail interlink-tmpl" also does NOT need a ZFS filesystem: document it accordingly
Franz Glasner <fzglas.hg@dom66.de>
parents: 298
diff changeset
85 :command:`ftjail interlink-tmpl` require ZFS as filesystem.
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
86
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
87
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
88 Environment
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
89 -----------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
90
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
91 All environment variables that affect :command:`zfs` are effective also.
468
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
92
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
93
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
94 Examples
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
95 --------
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
96
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
97 Prepare the containers for the template datasets
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
98 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
99
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
100 Container for templates::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
101
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
102 zfs create -o canmount=off -o mountpoint=/jail/ttmpl zpool/jail/ttmpl
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
103
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
104 Sub-container for all read-only bases::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
105
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
106 zfs create -o canmount=off zpool/jail/ttmpl/base-ro
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
107
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
108 Sub-container for all read-write volumes::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
109
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
110 zfs create -o canmount=off zpool/jail/ttmpl/skel-rw
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
111
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
112
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
113 Create a new complete template for a FreeBSD distribution
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
114 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
115
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
116 Create new template datasets and populate them from a distribution archive.
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
117 The example is for FreeBSD 13.3-RELEASE::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
118
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
119 # prepare empty datasets
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
120 ftjail datasets-tmpl -P zpool/jail/ttmpl/base-ro zpool/jail/ttmpl/skel-rw 13.3-RELEASE
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
121
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
122 #
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
123 # Here you can adjust some properties (``canmount``) or create some additional
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
124 # datasets manually.
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
125 #
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
126
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
127 # mount at a temporary mountpoint
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
128 mkdir /var/tmp/13.3
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
129 ftjail mount-tmpl -P zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE /var/tmp/13.3
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
130
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
131 # populate the contents from the distribution archive
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
132 ftjail populate-tmpl -P /var/tmp/13.3 base-13.3-RELEASE.txz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
133
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
134 # If the kernel is wanted also then extract it like this
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
135 ftjail populate-tmpl -P -b /var/tmp/13.3 base-13.3-RELEASE.txt kernel-13.3-RELEASE.txz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
136
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
137 Make a named snapshot named "base" for the original::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
138
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
139 ftjail snapshot-tmpl zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE base
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
140
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
141 Also prepare the :command:`etcupdate`::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
142
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
143 ftjail build-etcupdate-current-tmpl /var/tmp/13.3 etcupdate-current-13.3@base.tbz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
144
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
145 Update to the current patch level and tag accordingly (e.g. "p5")::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
146
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
147 # Update
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
148 freebsd-update -b /var/tmp/13.3 -d /var/tmp/13.3/var/db/freebsd-update/ --currently-running 13.3-RELEASE fetch
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
149 freebsd-update -b /var/tmp/13.3 -d /var/tmp/13.3/var/db/freebsd-update/ --currently-running 13.3-RELEASE install
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
150
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
151 # Snapshot
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
152 ftjail snapshot-tmpl zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE p5
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
153
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
154 # Do not forget to prepare for etcupdate
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
155 ftjail build-etcupdate-current-tmpl /var/tmp/13.3 etcupdate-current-13.3@p5.tbz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
156
470
c65a79d84e9e FIX: German -> englich in man
Franz Glasner <fzglas.hg@dom66.de>
parents: 468
diff changeset
157 Unmount::
468
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
158
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
159 ftjail umount-tmpl zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
160
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
161
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
162 Container and Common Location for instantiated Thin Jails
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
163 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
164
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
165 All thin jails are located at :file:`/jail/TROOT`::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
166
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
167 zfs create -o mountpoint=/jail/TROOT zpool/jail/TROOT
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
168
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
169 Create the variable datasets (read-write) with the same mountpoint as above::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
170
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
171 zfs create -o canmount=off -o mountpoint=/jail/TROOT zpool/jail/TVAR
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
172
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
173
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
174 Creation of a real Thin Jail
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
175 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
176
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
177 Clone the read-only root filesystem base::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
178
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
179 zfs clone -o readonly=on zpool/jail/ttmpl/base-ro/13.3-RELEASE@p5 zpool/jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
180
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
181 If you want some additional directory (e.g. for :file:`/srv` et al.) do this
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
182 instead::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
183
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
184 zfs clone -o readonly=off zpool/jail/ttmpl/base-ro/13.3-RELEASE@p5 zpool/jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
185 # change before making it read-only
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
186 mkdir /jail/TROOT/build13/srv
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
187 zfs set readonly=on zpool/jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
188
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
189 Copy -- not clone -- the variable parts::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
190
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
191 ftjail copy-skel -P zpool/jail/ttmpl/skel-rw/13.3-RELEASE p5 zpool/jail/TVAR/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
192
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
193 Configure some important parts (as in "normal" jails)::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
194
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
195 mount -t devfs devfs /jail/TROOT/build13/dev
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
196 fjail configure /jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
197 umount /jail/TROOT/build13/dev