From nobody@FreeBSD.org  Sun Aug 29 22:31:48 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id BECB110656B1
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Aug 2010 22:31:48 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id AF3988FC1B
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Aug 2010 22:31:48 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o7TMVm6Z015122
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Aug 2010 22:31:48 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o7TMVm1R015121;
	Sun, 29 Aug 2010 22:31:48 GMT
	(envelope-from nobody)
Message-Id: <201008292231.o7TMVm1R015121@www.freebsd.org>
Date: Sun, 29 Aug 2010 22:31:48 GMT
From: cc <cpt_complain@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Jail names
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         150098
>Category:       docs
>Synopsis:       [handbook] document naming conventions of jail names in handbook and rc.conf(5)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 29 22:40:03 UTC 2010
>Closed-Date:    Sun Sep 12 18:55:10 UTC 2010
>Last-Modified:  Sun Sep 12 19:00:13 UTC 2010
>Originator:     cc
>Release:        8.0 Release
>Organization:
>Environment:
>Description:
It should be mentioned in the Handbook

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/jails.html

and the man pages

http://www.freebsd.org/cgi/man.cgi?query=jail&apropos=0&sektion=0&manpath=FreeBSD+8.1-RELEASE&format=html

that jail names should contain only numbers or letters.
Special characters and punctuation will confuse the parser.
>How-To-Repeat:
Try to create a jail with the name, for instance, jail-bird or jail_bird.
The initialization file rc.conf will produce error messages at boot time.
>Fix:


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: vwe 
Responsible-Changed-When: Mon Aug 30 18:34:35 UTC 2010 
Responsible-Changed-Why:  
over to the documentation team 

http://www.freebsd.org/cgi/query-pr.cgi?pr=150098 
Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Sat Sep 4 18:59:11 UTC 2010 
Responsible-Changed-Why:  
I'll take it. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=150098 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/150098: commit references a PR
Date: Sat,  4 Sep 2010 20:19:35 +0000 (UTC)

 gjb         2010-09-04 20:19:26 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/jails chapter.sgml 
   Log:
   Note in the Jails chapter that jail_list should contain only
   alphanumeric characters.
   
   PR:             docs/150098
   Submitted by:   cc (cpt_complain at yahoo dot com)
   Approved by:    jkois (co-mentor)
   
   Revision  Changes    Path
   1.21      +5 -0      doc/en_US.ISO8859-1/books/handbook/jails/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: Glen Barber <gjb@FreeBSD.org>
To: bug-followup@FreeBSD.org, cpt_complain@yahoo.com
Cc:  
Subject: Re: docs/150098: [all] document naming conventions of jail names
Date: Sat, 04 Sep 2010 16:31:33 -0400

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 Hello,
 
 I have patched this chapter in the Handbook, and the change should be
 visible within a few hours.  I am working on a similar fix for the man
 pages, however rc.conf(5) may be a better location to note this, as it
 is a rc-specific entry.
 
 Best regards,
 
 - -- 
 Glen Barber
 FreeBSD Documentation Project
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.9 (Darwin)
 
 iQEcBAEBAgAGBQJMgqykAAoJEFJPDDeguUaj5c4IAKHf/VrfovDbXdVz2UDamqgg
 Ws9w7T9fb+yseUja4zBqFHVykUaHeb/RkczL0h/AduOihX6qBtmksTZSu1PoeiHT
 iIfhr8vgiBqr/SSPgjW69avsNzOjhCvv3jeBbqXAfdftaaAKd6pu5Dd5PUlx/ICs
 namWLHv5ie1oAGMC9KgPyD0ZoN2F6Z4A438BfTAar4wSNCrOj7X7ktBH0aiTUA5o
 T2tZ0MC1CtrmKkw+XMR4eR8ebvt5DvlMmDHwCYbCAjYINBNsFZtgkX34t/RzTR73
 dxBKmfMxg6Wp9t/gO4/09xDGAdhYq6+xL3SM/5xsXiV+pp5MY2nNM5lwTPutPKQ=
 =0caB
 -----END PGP SIGNATURE-----
 
State-Changed-From-To: open->patched 
State-Changed-By: gjb 
State-Changed-When: Sun Sep 5 20:05:35 UTC 2010 
State-Changed-Why:  
Patched in HEAD.  MFC after 1 week. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=150098 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/150098: commit references a PR
Date: Sun,  5 Sep 2010 20:05:12 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Sun Sep  5 20:04:54 2010
 New Revision: 212241
 URL: http://svn.freebsd.org/changeset/base/212241
 
 Log:
   Note in rc.conf(5) that jail_list should contain only alphanumeric
   characters.
   
   PR:		150098
   Submitted by:	cc (cpt_complain at yahoo dot com)
   Approved by:	keramida (mentor)
   MFC after:	1 week
 
 Modified:
   head/share/man/man5/rc.conf.5
 
 Modified: head/share/man/man5/rc.conf.5
 ==============================================================================
 --- head/share/man/man5/rc.conf.5	Sun Sep  5 20:04:02 2010	(r212240)
 +++ head/share/man/man5/rc.conf.5	Sun Sep  5 20:04:54 2010	(r212241)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd August 3, 2010
 +.Dd September 4, 2010
  .Dt RC.CONF 5
  .Os
  .Sh NAME
 @@ -3503,7 +3503,8 @@ A space separated list of names for jail
  This is purely a configuration aid to help identify and
  configure multiple jails.
  The names specified in this list will be used to
 -identify settings common to an instance of a jail.
 +identify settings common to an instance of a jail,
 +and should contain alphanumeric characters only.
  Assuming that the jail in question was named
  .Li vjail ,
  you would have the following dependent variables:
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/150098: commit references a PR
Date: Sun, 12 Sep 2010 18:37:39 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Sun Sep 12 18:37:34 2010
 New Revision: 212503
 URL: http://svn.freebsd.org/changeset/base/212503
 
 Log:
   MFC 212241.
   
   Note that jail_list should contain alphanumeric characters only.
   
   PR:		150098
   Approved by:	keramida (mentor)
 
 Modified:
   stable/8/share/man/man5/rc.conf.5
 
 Modified: stable/8/share/man/man5/rc.conf.5
 ==============================================================================
 --- stable/8/share/man/man5/rc.conf.5	Sun Sep 12 18:04:47 2010	(r212502)
 +++ stable/8/share/man/man5/rc.conf.5	Sun Sep 12 18:37:34 2010	(r212503)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd April 14, 2010
 +.Dd September 4, 2010
  .Dt RC.CONF 5
  .Os
  .Sh NAME
 @@ -3402,7 +3402,8 @@ A space separated list of names for jail
  This is purely a configuration aid to help identify and
  configure multiple jails.
  The names specified in this list will be used to
 -identify settings common to an instance of a jail.
 +identify settings common to an instance of a jail,
 +and should contain alphanumeric characters only.
  Assuming that the jail in question was named
  .Li vjail ,
  you would have the following dependent variables:
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Sun Sep 12 18:54:39 UTC 2010 
State-Changed-Why:  
MFC'd to stable/8 and stable/7.  Thanks! 


http://www.freebsd.org/cgi/query-pr.cgi?pr=150098 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/150098: commit references a PR
Date: Sun, 12 Sep 2010 18:51:02 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Sun Sep 12 18:50:57 2010
 New Revision: 212504
 URL: http://svn.freebsd.org/changeset/base/212504
 
 Log:
   MFC 212241.
   
   Note that jail_list should contain alphanumeric characters only.
   
   PR:		150098
   Approved by:	keramida (mentor)
 
 Modified:
   stable/7/share/man/man5/rc.conf.5
 
 Modified: stable/7/share/man/man5/rc.conf.5
 ==============================================================================
 --- stable/7/share/man/man5/rc.conf.5	Sun Sep 12 18:37:34 2010	(r212503)
 +++ stable/7/share/man/man5/rc.conf.5	Sun Sep 12 18:50:57 2010	(r212504)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd November 11, 2009
 +.Dd September 4, 2010
  .Dt RC.CONF 5
  .Os
  .Sh NAME
 @@ -3369,7 +3369,8 @@ A space separated list of names for jail
  This is purely a configuration aid to help identify and
  configure multiple jails.
  The names specified in this list will be used to
 -identify settings common to an instance of a jail.
 +identify settings common to an instance of a jail,
 +and should contain alphanumeric characters only.
  Assuming that the jail in question was named
  .Li vjail ,
  you would have the following dependent variables:
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
