Date: Fri, 28 Feb 2014 13:49:11 GMT From: Jack-Benny Persson <jack-benny@cyberinfo.se> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/187142: The Handbook (chapter 15.4) does not mention /etc/jail.conf Message-ID: <201402281349.s1SDnBqi039893@cgiserv.freebsd.org> Resent-Message-ID: <201402281350.s1SDo0Oh053251@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 187142
>Category: docs
>Synopsis: The Handbook (chapter 15.4) does not mention /etc/jail.conf
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: update
>Submitter-Id: current-users
>Arrival-Date: Fri Feb 28 13:50:00 UTC 2014
>Closed-Date:
>Last-Modified:
>Originator: Jack-Benny Persson
>Release:
>Organization:
>Environment:
>Description:
FreeBSD Handbook chapter 15.4 (Creating and Controlling Jails).
Since FreeBSD 9.1 the /etc/jail.conf file is the recommended way to configure jails. The Handbook does not mention this in it's present form.
>How-To-Repeat:
>Fix:
Patch attached with submission follows:
Index: en_US.ISO8859-1/books/handbook/jails/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/handbook/jails/chapter.xml (revision 44074)
+++ en_US.ISO8859-1/books/handbook/jails/chapter.xml (working copy)
@@ -373,6 +373,25 @@
<para>For a full list of available options, please see the
&man.rc.conf.5; manual page.</para>
</note>
+
+<note>
+<para>From FreeBSD 9.1 and above the recommended way is to place the jail settings in <filename>/etc/jail.conf</filename> (see &man.jail.conf.5;).
+For example a jail config similar to above would look like this in <filename>/etc/jail.conf</filename>.
+<programlisting>
+<replaceable>www</replaceable> { # Name of the jail from jail_list in /etc/rc.conf
+ host.hostname = <replaceable>www</replaceable>.example.org; # Hostname
+ ip4.addr = 192.168.0.10; # IP address of the jail
+ path = "<replaceable>/usr/jail/www</replaceable>"; # Path to the jail
+ devfs_ruleset = <replaceable>www_ruleset</replaceable>; # DevFS ruleset
+ mount.devfs; # Mount devfs inside the jail
+ exec.start = "/bin/sh /etc/rc"; # Start command to run
+ exec.stop = "/bin/sh /etc/rc.shutdown"; # Stop command to run to stop the jail
+}
+</programlisting>
+</para>
+</note>
+
+
</step>
</procedure>
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402281349.s1SDnBqi039893>