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

annotate docs/man/man8/ftjail-freebsd-update.rst @ 341:a204a7415d4a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
"ftjail freebsd-update" is implemented. It supports custom mountpoints also.
author Franz Glasner <fzglas.hg@dom66.de>
date Sat, 03 Dec 2022 21:12:23 +0100
parents d3b5fe2712ca
children 89877869a665
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
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 Synopsis
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 --------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8
341
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
9 **ftjail freebsd-update** [**-k**] [**-o** `old-origin`] `directory` `new-origin` [`etcupdate-tarball`]
334
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
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12 Description
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 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
16
341
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
17 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
18
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
19 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
20 the fully re-mounted directory tree that is rooted at `directory`
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
21 using `etcupdate-tarball` as new "current".
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
22
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
23
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
24 Options
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
25 -------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
26
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
27 .. program:: ftjail freebsd-update
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
28
339
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
29 .. option:: -k
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
30
341
a204a7415d4a "ftjail freebsd-update" is implemented.
Franz Glasner <fzglas.hg@dom66.de>
parents: 340
diff changeset
31 Keep all temporary files. Temporary files are created in :file:`/var/tmp`.
339
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
32
e1d6807b0c4d Implement option handling for ftjail freebsd-update and the "-k" option
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
33 .. 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
34
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
35 .. option:: -o 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
36
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
37 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
38 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
39
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
40 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
41 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
42
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
43
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
44 Environment
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
45 -----------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
46
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
47 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
48
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
49
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
50 See Also
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
51 --------
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
52
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
53 :manpage:`ftjail(8)`, :manpage:`freebsd-update(8)`, :manpage:`etcupdate(8)`