From nobody@FreeBSD.org  Fri Feb 28 13:49:11 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id DF750AFC
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 28 Feb 2014 13:49:11 +0000 (UTC)
Received: from newred.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id CBFF11CB7
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 28 Feb 2014 13:49:11 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by newred.freebsd.org (8.14.7/8.14.7) with ESMTP id s1SDnBji039900
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 28 Feb 2014 13:49:11 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.7/8.14.7/Submit) id s1SDnBqi039893;
	Fri, 28 Feb 2014 13:49:11 GMT
	(envelope-from nobody)
Message-Id: <201402281349.s1SDnBqi039893@cgiserv.freebsd.org>
Date: Fri, 28 Feb 2014 13:49:11 GMT
From: Jack-Benny Persson <jack-benny@cyberinfo.se>
To: freebsd-gnats-submit@FreeBSD.org
Subject: The Handbook (chapter 15.4) does not mention /etc/jail.conf 
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         187142
>Category:       docs
>Synopsis:       [handbook] [patch] 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:  Sun Apr 13 23:15:33 UTC 2014
>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:
