Mercurial > hgrepos > FreeBSD > ports > sysutils > local-bsdtools
changeset 326:db04f195db32
Man pages for fjail-configure and fjail-hostid
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Tue, 29 Nov 2022 09:41:36 +0100 |
| parents | a60fb7a719b3 |
| children | 37eb955f2395 |
| files | docs/conf.py docs/man/man8/fjail-configure.rst docs/man/man8/fjail-hostid.rst pkg-plist |
| diffstat | 4 files changed, 89 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/docs/conf.py Mon Nov 28 22:53:54 2022 +0100 +++ b/docs/conf.py Tue Nov 29 09:41:36 2022 +0100 @@ -74,9 +74,10 @@ ("man/man8/local-bsdtools", "local-bsdtools", 'FreeBSD administration helper tools v%s' % release, [author], 8), ("man/man8/bsmtp2dma", "bsmtp2dma", "Bacula compatible mail submission program", [author], 8), ("man/man8/fjail", "fjail", "Management of jails", [author], 8), + ("man/man8/fjail-configure", "fjail-configure", "Basic configuration of jails", [author], 8), #("man/man8/fjail-copy", "fjail-copy", "Recursively copy ZFS datasets including all properties", [author], 8), #("man/man8/fjail-datasets", "fjail-datasets", "Create a new tree of ZFS datasets that will encompass a jail", [author], 8), - #("man/man8/fjail-hostid", "fjail-hostid", "Compute a proposal for a new BSD Host UUID and ID", [author], 8), + ("man/man8/fjail-hostid", "fjail-hostid", "Generate a proposal for a new BSD Host UUID and ID", [author], 8), #("man/man8/fjail-mount", "fjail-mount", "Recursively mount a ZFS dataset and its children", [author], 8), #("man/man8/fjail-populate", "fjail-populate", "Populate a directory with content from a FreeBSD base.txz", [author], 8), #("man/man8/fjail-privs", "fjail-privs", "Adjust some privileges within a mounted jail", [author], 8),
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/man/man8/fjail-configure.rst Tue Nov 29 09:41:36 2022 +0100 @@ -0,0 +1,50 @@ +.. -*- coding: utf-8; indent-tabs-mode: nil; -*- + +fjail-configure +=============== + +Synopsis +-------- + +**fjail configure** `mountpoint` + + +Description +----------- + +Configure some basic settings of a jail that is mounted at `mountpoint`. + +The "root" account within the jail is deactivated. + +In the jail's :file:`/etc/rc.conf`:: + + sendmail_enable="NONE" + clear_tmp_enable="YES" + clear_tmp_X="NO" + syslogd_flags="-ss" + bsdstats_enable="NO" + +The timezone is set to "Europe/Berlin" if not yet set. + +The :file:`/etc/resolv.conf` is copied from the host into the jail if +the target does not exist yet. + +:command:`/usr/bin/newaliases` is called within the jail. + +In the jail's :file:`/etc/periodic.conf.local`:: + + daily_ntpd_leapfile_enable="NO" + daily_status_zfs_zpool_list_enable="NO" + daily_status_disks_enable="NO" + daily_status_uptime_enable="NO" + +Can be used for all sort of jails (normal, thin). + +A proposal for a hostid suitable for use within the jail is printed to +stdout also; this is done by calling :command:`fjail hostid`. + + +See Also +-------- + +:manpage:`fjail(8)`, :manpage:`ftjail(8)`, :manpage:`fjail-hostid(8)`
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/man/man8/fjail-hostid.rst Tue Nov 29 09:41:36 2022 +0100 @@ -0,0 +1,35 @@ +.. -*- coding: utf-8; indent-tabs-mode: nil; -*- + +fjail-hostid +============ + +Synopsis +-------- + +**fjail hostid** + + +Description +----------- + +Generate a proposal for a new BSD host UUID and ID and print it to stdout. + +The output is suitable for inclusion in a :file:`/etc/jail.conf`. + + +Examples +-------- + +:: + + # fjail hostid + Proposed hostuuid/hostid: + host.hostuuid = "868be13d-6fc0-11ed-827f-74d435fd3892"; + host.hostid = 582606249; + # + + +See Also +-------- + +:manpage:`fjail(8)`, :manpage:`ftjail(8)`
--- a/pkg-plist Mon Nov 28 22:53:54 2022 +0100 +++ b/pkg-plist Tue Nov 29 09:41:36 2022 +0100 @@ -9,6 +9,8 @@ %%DOCS%%man/man8/local-bsdtools.8.gz %%DOCS%%man/man8/bsmtp2dma.8.gz %%DOCS%%man/man8/fjail.8.gz +%%DOCS%%man/man8/fjail-configure.8.gz +%%DOCS%%man/man8/fjail-hostid.8.gz %%DOCS%%man/man8/fpkg.8.gz %%DOCS%%man/man8/ftjail.8.gz %%DOCS%%man/man8/ftjail-build-etcupdate-current-tmpl.8.gz
