annotate docs/man/man8/local-bsdtools.rst @ 649:4ee9a8042f4a

common.subr: _get_jail_from_path() now just returns when the jail is dying. But it prints the name of the jail if it is yet dying. Real error reporting must not consistently be done in the caller.
author Franz Glasner <fzglas.hg@dom66.de>
date Fri, 27 Sep 2024 21:21:34 +0200
parents 7d08fd78775c
children 260a81d769a6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
283
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
2
279
86d8929e4747 Add the Sphinx documentation sources as generated by sphinx-quickstart
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 .. local-bsdtools documentation master file, created by
86d8929e4747 Add the Sphinx documentation sources as generated by sphinx-quickstart
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 sphinx-quickstart on Sat Sep 17 21:32:09 2022.
283
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
5
279
86d8929e4747 Add the Sphinx documentation sources as generated by sphinx-quickstart
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6
283
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
7 local-bsdtools
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
8 ==============
279
86d8929e4747 Add the Sphinx documentation sources as generated by sphinx-quickstart
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
9
370
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
10 Description
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
11 -----------
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
12
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
13 A collection of helper tools specific for FreeBSD.
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
14
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
15 They help with
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
16
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
17 - managing the installed ports and packages
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
18 - creating, installing and updating jails
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
19 - creating, installing and updating "thin jails"
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
20 - recursively mounting of ZFS dataset hierarchies
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
21
387
9921352225a9 Weekly periodic script to execute an action when any of given files are readable.
Franz Glasner <fzglas.hg@dom66.de>
parents: 386
diff changeset
22 The package contains also a set of daily periodic scripts to
370
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
23
402
1ccd7bf1ed06 Make ZFS uppercased in output messages and in the documentation
Franz Glasner <fzglas.hg@dom66.de>
parents: 395
diff changeset
24 - trim ZFS pools regularly
370
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
25 - update the IPv6 neighbour cache
391
8b1740deedbb Refactor: Renamed the weekly 800.local-certbot-post-deploy to a daily 720.local-triggered-action.
Franz Glasner <fzglas.hg@dom66.de>
parents: 387
diff changeset
26 - handle (file-)triggered actions (e.g. to indirectly handle certbot
8b1740deedbb Refactor: Renamed the weekly 800.local-certbot-post-deploy to a daily 720.local-triggered-action.
Franz Glasner <fzglas.hg@dom66.de>
parents: 387
diff changeset
27 deploy actions)
387
9921352225a9 Weekly periodic script to execute an action when any of given files are readable.
Franz Glasner <fzglas.hg@dom66.de>
parents: 386
diff changeset
28
9921352225a9 Weekly periodic script to execute an action when any of given files are readable.
Franz Glasner <fzglas.hg@dom66.de>
parents: 386
diff changeset
29 All the periodic scripts are disabled by default.
370
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
30
279
86d8929e4747 Add the Sphinx documentation sources as generated by sphinx-quickstart
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
31
283
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
32 See Also
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
33 --------
279
86d8929e4747 Add the Sphinx documentation sources as generated by sphinx-quickstart
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34
409
4219294c2930 Prepare the skeleton of man pages for all the configuration files used:
Franz Glasner <fzglas.hg@dom66.de>
parents: 404
diff changeset
35 - :manpage:`bsmtp2dma.conf(5)`
404
6c0c9159744d Move the manual pages for the periodic scripts into man secition 5
Franz Glasner <fzglas.hg@dom66.de>
parents: 402
diff changeset
36 - :manpage:`local-bsdtools-periodic(5)`
409
4219294c2930 Prepare the skeleton of man pages for all the configuration files used:
Franz Glasner <fzglas.hg@dom66.de>
parents: 404
diff changeset
37 - :manpage:`package-mapping.conf(5)`
4219294c2930 Prepare the skeleton of man pages for all the configuration files used:
Franz Glasner <fzglas.hg@dom66.de>
parents: 404
diff changeset
38 - :manpage:`pkgtools.conf(5)`
395
64d73ad6e37d Begin a manpage for all install periodic scripts
Franz Glasner <fzglas.hg@dom66.de>
parents: 391
diff changeset
39
284
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
40 - :manpage:`bsmtp2dma(8)`
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
41 - :manpage:`check-ports(8)`
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
42 - :manpage:`fjail(8)`
315
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
43
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
44 * :manpage:`fjail-configure(8)`
370
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
45 * :manpage:`fjail-copy(8)`
315
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
46 * :manpage:`fjail-datasets(8)`
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
47 * :manpage:`fjail-hostid(8)`
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
48 * :manpage:`fjail-mount(8)`
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
49 * :manpage:`fjail-populate(8)`
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
50 * :manpage:`fjail-privs(8)`
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
51 * :manpage:`fjail-umount(8)`
9c5b76df4f9d Begin manual pages for the "fjail" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 314
diff changeset
52
369
3a902f0d3351 FIX: Consistently format the list in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 315
diff changeset
53 - :manpage:`fjail-copy(8)`
370
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
54
284
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
55 - :manpage:`ftjail(8)`
303
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
56
370
6d62096c3714 Give a overview description in local-bsdtools(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 369
diff changeset
57 * :manpage:`ftjail-build-etcupdate-current-tmpl(8)`
303
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
58 * :manpage:`ftjail-copy-skel(8)`
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
59 * :manpage:`ftjail-datasets-tmpl(8)`
371
910d0bd96ebe FIX: Add ftjail-frebsd-update(8) into local-bsdtools(8) also
Franz Glasner <fzglas.hg@dom66.de>
parents: 370
diff changeset
60 * :manpage:`ftjail-freebsd-update(8)`
303
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
61 * :manpage:`ftjail-interlink-tmpl(8)`
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
62 * :manpage:`ftjail-mount-tmpl(8)`
307
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 303
diff changeset
63 * :manpage:`ftjail-populate-tmpl(8)`
303
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
64 * :manpage:`ftjail-snapshot-tmpl(8)`
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
65 * :manpage:`ftjail-umount-tmpl(8)`
2ad545b9031c FIX: Add missing subcommand manpages to the local-bsdtools(8) manpage
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
66
284
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
67 - :manpage:`fpkg(8)`
462
bfa134565e0e Begin the manual pages for fwireguard
Franz Glasner <fzglas.hg@dom66.de>
parents: 420
diff changeset
68
467
6ecd16725818 Begin refactoring bhyve into fbhyve.
Franz Glasner <fzglas.hg@dom66.de>
parents: 462
diff changeset
69 - :manpage:`fbhyve(8)`
6ecd16725818 Begin refactoring bhyve into fbhyve.
Franz Glasner <fzglas.hg@dom66.de>
parents: 462
diff changeset
70
462
bfa134565e0e Begin the manual pages for fwireguard
Franz Glasner <fzglas.hg@dom66.de>
parents: 420
diff changeset
71 - :manpage:`fwireguard(8)`
467
6ecd16725818 Begin refactoring bhyve into fbhyve.
Franz Glasner <fzglas.hg@dom66.de>
parents: 462
diff changeset
72
284
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
73 - :manpage:`fzfs(8)`
279
86d8929e4747 Add the Sphinx documentation sources as generated by sphinx-quickstart
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
74
520
7d08fd78775c fzfs: implement "fzfs clone-tree".
Franz Glasner <fzglas.hg@dom66.de>
parents: 467
diff changeset
75 * :manpage:`fzfs-clone-tree(8)`
420
bf0d63c8e682 Begin fzfs-copy-tree: man page structure done
Franz Glasner <fzglas.hg@dom66.de>
parents: 409
diff changeset
76 * :manpage:`fzfs-copy-tree(8)`
380
6be930eb7490 Implement the "fzfs create-tree" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 371
diff changeset
77 * :manpage:`fzfs-create-tree(8)`
284
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
78 * :manpage:`fzfs-mount(8)`
106cd5d9da7e Put all manual pages into section 8 (FreeBSD System Manager's Manual)
Franz Glasner <fzglas.hg@dom66.de>
parents: 283
diff changeset
79 * :manpage:`fzfs-umount(8)`
283
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
80
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
81
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
82 Environment
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
83 -----------
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
84
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
85 Because the tools use different helper tools like :command:`zfs` or
1fc3b04b39fa Build and package manual pages for fzfs, fzfs-mount and fzfs-umount.
Franz Glasner <fzglas.hg@dom66.de>
parents: 279
diff changeset
86 :command:`pkg` the relevant environment variables according to this tools
314
90c512baf109 Wording
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
87 also do apply generally.
385
d058f55fffea Expand some keyword in the mail manual page also
Franz Glasner <fzglas.hg@dom66.de>
parents: 380
diff changeset
88
d058f55fffea Expand some keyword in the mail manual page also
Franz Glasner <fzglas.hg@dom66.de>
parents: 380
diff changeset
89
d058f55fffea Expand some keyword in the mail manual page also
Franz Glasner <fzglas.hg@dom66.de>
parents: 380
diff changeset
90 History
d058f55fffea Expand some keyword in the mail manual page also
Franz Glasner <fzglas.hg@dom66.de>
parents: 380
diff changeset
91 -------
d058f55fffea Expand some keyword in the mail manual page also
Franz Glasner <fzglas.hg@dom66.de>
parents: 380
diff changeset
92
386
84d2735fe7f6 Simplified version tagging a lot: it is also faster now.
Franz Glasner <fzglas.hg@dom66.de>
parents: 385
diff changeset
93 :Version: @(#)@@SIMPLEVERSIONTAG@@
385
d058f55fffea Expand some keyword in the mail manual page also
Franz Glasner <fzglas.hg@dom66.de>
parents: 380
diff changeset
94 :ID: $HGid$