annotate docs/man/man8/fjail-configure.rst @ 806:b59054f11029

fports: Implement "fports detail -b" to print details about all packages that are not installed from the blessed FreeBSD repo. While there change option handling to allow a combination of selection flags: merge all selected packages and sort if needed.
author Franz Glasner <fzglas.hg@dom66.de>
date Tue, 05 Nov 2024 10:57:06 +0100
parents cf331d11a393
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 fjail-configure
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 ===============
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 Synopsis
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 --------
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
9 **fjail configure** [**-d**] `mountpoint`
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12 Description
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13 -----------
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
14
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
15 Configure some basic settings of a jail that is mounted at `mountpoint`.
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
16
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
17 .. program:: fjail configure
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
18
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
19 .. option:: -d
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
20
332
cf331d11a393 Wording in man page
Franz Glasner <fzglas.hg@dom66.de>
parents: 331
diff changeset
21 Temporarily also mount a standard devfs filesystem at `mountpoint`/dev.
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
22
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
23 The following configuration settings are applied:
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
24
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
25 The "root" account within the jail is deactivated.
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
26
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
27 In the jail's :file:`/etc/rc.conf`::
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
28
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
29 sendmail_enable="NONE"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
30 clear_tmp_enable="YES"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
31 clear_tmp_X="NO"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
32 syslogd_flags="-ss"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
33 bsdstats_enable="NO"
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
35 The timezone is set to "Europe/Berlin" if not yet set.
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
36
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
37 The :file:`/etc/resolv.conf` is copied from the host into the jail if
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
38 the target does not exist yet.
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
39
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
40 :command:`/usr/bin/newaliases` is called within the jail.
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
41
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
42 In the jail's :file:`/etc/periodic.conf.local`::
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
43
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
44 daily_ntpd_leapfile_enable="NO"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
45 daily_status_zfs_zpool_list_enable="NO"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
46 daily_status_disks_enable="NO"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
47 daily_status_uptime_enable="NO"
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
48
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
49 This command can be used for all sort of jails (normal, thin).
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
50
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
51 A proposal for a hostid suitable for use within the jail is printed to
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
52 stdout also; this is done by calling :command:`fjail hostid`.
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
53
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
54
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
55 Implementation Notes
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
56 --------------------
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
57
331
4a17b1f4c378 Require a mounted and working devfs within the jail when configuring a jail.
Franz Glasner <fzglas.hg@dom66.de>
parents: 328
diff changeset
58 A populated and working dev filesystem within the jail is needed to
4a17b1f4c378 Require a mounted and working devfs within the jail when configuring a jail.
Franz Glasner <fzglas.hg@dom66.de>
parents: 328
diff changeset
59 work properly. This is checked for.
328
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
60
184412e2543e Implement the -d option for fjail configure: temporarily mount a devfs filesystem
Franz Glasner <fzglas.hg@dom66.de>
parents: 326
diff changeset
61
326
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
62 See Also
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
63 --------
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
64
db04f195db32 Man pages for fjail-configure and fjail-hostid
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
65 :manpage:`fjail(8)`, :manpage:`ftjail(8)`, :manpage:`fjail-hostid(8)`