docs/187142: The Handbook (chapter 15.4) does not mention /etc/jail.conf

[Jack-Benny Persson]

>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: