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

annotate docs/man/man8/ftjail-freebsd-update.rst @ 796:e48d173534ec

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fports: Implement "fports detail" to print the status of all given packages in the most detail possible
author Franz Glasner <fzglas.hg@dom66.de>
date Thu, 31 Oct 2024 14:42:51 +0100
parents 82a98db83a13
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 ftjail-freebsd-update
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 =====================
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5
660
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
6 .. program:: ftjail freebsd-update
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
7
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
8
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
9 Synopsis
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10 --------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11
660
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
12 **ftjail freebsd-update** [**-k**] [**-o** `old-origin`] [[**-R** `dataset@snapname`]...] `directory` `new-origin` [`etcupdate-tarball`]
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
14
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
15 Description
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
16 -----------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
17
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
18 A :manpage:`freebsd-update(8)` for a Thin Jail.
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
19
341
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
20 Make the ZFS dataset mounted at `directory` a read-only clone of `new-origin`.
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
21
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
22 If `etcupdate-tarball` is given also call :manpage:`etcupdate(8)` on
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
23 the fully re-mounted directory tree that is rooted at `directory`
430
a05c5d520f86 Wording in manpage Glasner <hg@dom66.de>
Franz Glasner <hg@dom66.de>
parents: 342
diff changeset
24 using `etcupdate-tarball` as the new "current".
341
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
25
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: 622
diff changeset
26 See also :manpage:`ftjail-check-freebsd-update(8)` for a tool that
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: 622
diff changeset
27 tries to thoroughly check the preconditions to run this tool 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: 622
diff changeset
28
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
29
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
30 Options
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
31 -------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
32
660
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
33 .. option:: -R <dataset@snapname>
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
34
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
35 Create ZFS snapshots for `dataset` and all its children before
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
36 updating.
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
37
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
38 The snapshots may not exist already.
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
39
82a98db83a13 ftjail: Implement a "-R" option for "ftjail freebsd-update" and "ftjail check-freebsd-update".
Franz Glasner <fzglas.hg@dom66.de>
parents: 658
diff changeset
40 Can be given more than once.
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
41
339
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
42 .. option:: -k
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
43
342
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
44 Keep all temporary files.
339
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
45
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
46 .. note:: On unexpected errors temp files are automatically kept.
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
47
622
54c6eecbe53f Docs: as per the Sphinx docs: option argument names should be enclosed in angle brackets
Franz Glasner <fzglas.hg@dom66.de>
parents: 430
diff changeset
48 .. option:: -o <old-origin>
340
d3b5fe2712ca Implement "ftjail freebsd-update -o" for a more exhaustige check the clone's origin
Franz Glasner <fzglas.hg@dom66.de>
parents: 339
diff changeset
49
d3b5fe2712ca Implement "ftjail freebsd-update -o" for a more exhaustige check the clone's origin
Franz Glasner <fzglas.hg@dom66.de>
parents: 339
diff changeset
50 In addition to check that `directory` is a ZFS clone also check that
d3b5fe2712ca Implement "ftjail freebsd-update -o" for a more exhaustige check the clone's origin
Franz Glasner <fzglas.hg@dom66.de>
parents: 339
diff changeset
51 its origin is equal to `old-origin`.
d3b5fe2712ca Implement "ftjail freebsd-update -o" for a more exhaustige check the clone's origin
Franz Glasner <fzglas.hg@dom66.de>
parents: 339
diff changeset
52
d3b5fe2712ca Implement "ftjail freebsd-update -o" for a more exhaustige check the clone's origin
Franz Glasner <fzglas.hg@dom66.de>
parents: 339
diff changeset
53 Note that a check that `directory` is a ZFS clone with some origin
d3b5fe2712ca Implement "ftjail freebsd-update -o" for a more exhaustige check the clone's origin
Franz Glasner <fzglas.hg@dom66.de>
parents: 339
diff changeset
54 is done by default.
d3b5fe2712ca Implement "ftjail freebsd-update -o" for a more exhaustige check the clone's origin
Franz Glasner <fzglas.hg@dom66.de>
parents: 339
diff changeset
55
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
56
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
57 Environment
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
58 -----------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
59
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
60 All environment variables that affect :command:`zfs` are effective also.
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
61
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
62
342
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
63 Files
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
64 -----
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
65
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
66 A unique temporary directory is created within :file:`/var/tmp`. All
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
67 temporary files are created within this directory.
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
68
89877869a665 Create all temporary files within a unique temporary directory
Franz Glasner <fzglas.hg@dom66.de>
parents: 341
diff changeset
69
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
70 See Also
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
71 --------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
72
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: 622
diff changeset
73 :manpage:`ftjail(8)`, :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: 622
diff changeset
74 :manpage:`freebsd-update(8)`, :manpage:`etcupdate(8)`