From jhs@berklix.com  Fri May 14 19:59:16 2010
Return-Path: <jhs@berklix.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id A7F2B1065670
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 14 May 2010 19:59:16 +0000 (UTC)
	(envelope-from jhs@berklix.com)
Received: from tower.berklix.org (tower.berklix.org [83.236.223.114])
	by mx1.freebsd.org (Postfix) with ESMTP id 1A7A98FC08
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 14 May 2010 19:59:15 +0000 (UTC)
Received: from park.js.berklix.net (p549A2CFE.dip.t-dialin.net [84.154.44.254])
	(authenticated bits=0)
	by tower.berklix.org (8.14.2/8.14.2) with ESMTP id o4EJx9uY070157;
	Fri, 14 May 2010 19:59:09 GMT
	(envelope-from jhs@berklix.com)
Received: from fire.js.berklix.net (fire.js.berklix.net [192.168.91.41])
	by park.js.berklix.net (8.13.8/8.13.8) with ESMTP id o4EJwuxH035066;
	Fri, 14 May 2010 21:59:04 +0200 (CEST)
	(envelope-from jhs@berklix.com)
Received: from fire.js.berklix.net (localhost [127.0.0.1])
	by fire.js.berklix.net (8.14.3/8.14.3) with ESMTP id o4EJwY9k070933;
	Fri, 14 May 2010 21:58:39 +0200 (CEST)
	(envelope-from jhs@fire.js.berklix.net)
Received: (from jhs@localhost)
	by fire.js.berklix.net (8.14.3/8.14.3/Submit) id o4EJuPkF070907;
	Fri, 14 May 2010 21:56:25 +0200 (CEST)
	(envelope-from jhs)
Message-Id: <201005141956.o4EJuPkF070907@fire.js.berklix.net>
Date: Fri, 14 May 2010 21:56:25 +0200 (CEST)
From: "Julian H. Stacey" <jhs@berklix.com>
Reply-To: "Julian H. Stacey" <jhs@berklix.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc: jhs@berklix.com, Garrett Cooper <yanefbsd@gmail.com>,
        Jilles Tjoelker <jilles@stack.nl>
Subject: Patch to add an example to man mount for devfs
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         146600
>Category:       bin
>Synopsis:       Patch to add an example to man mount for devfs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jilles
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri May 14 20:00:17 UTC 2010
>Closed-Date:    Sat Jun 26 14:44:18 UTC 2010
>Last-Modified:  Sat Jun 26 14:50:03 UTC 2010
>Originator:     Julian H. Stacey
>Release:        FreeBSD 8.0-RELEASE i386
>Organization:
http://berklix.com BSD Linux Unix Consultancy, Munich/Muenchen.
>Environment:
System: FreeBSD fire.js.berklix.net 8.0-RELEASE FreeBSD 8.0-RELEASE #0: Wed Apr 21 10:27:18 CEST 2010 jhs@fire.js.berklix.net:/usr1/src/sys/amd64/compile/FIRE64.small2 amd64


	
>Description:
	Patch to add an example to man mount for devfs
>How-To-Repeat:
	See patch below & thread on hackers
	Subject:        /dev/null & zero inside chroot for make release
>Fix:

	Please commit patch appended
	(OK, nroff macros work, but feel free to improve.)
-----

http://berklix.com/~jhs/src/bsd/fixes/FreeBSD/src/gen/sbin/mount/

*** 8.0-RELEASE/src/sbin/mount/mount.8	Sun Oct 25 02:10:29 2009
--- new-generic/src/sbin/mount/mount.8	Fri May 14 21:31:56 2010
***************
*** 444,449 ****
--- 444,460 ----
  .Pp
  Most file systems will be dynamically loaded by the kernel
  if not already present, and if the kernel module is available.
+ .Pp
+ Example to create a /dev in a 
+ .Cm
+ chroot 
+ :
+ .ce
+ mount -t devfs dev /usrb/chroot/dev
+ useful for an encapsulated environment in which to try:
+ .ce
+ cd /usr/src/release ; make release 
+ .\" ---
  .It Fl u
  The
  .Fl u
***************
*** 516,521 ****
--- 527,534 ----
  .Xr ext2fs 5 ,
  .Xr fstab 5 ,
  .Xr procfs 5 ,
+ .Xr chroot 8 ,
+ .Xr devfs 8 ,
  .Xr kldload 8 ,
  .Xr mount_cd9660 8 ,
  .Xr mount_msdosfs 8 ,

>Release-Note:
>Audit-Trail:

From: Jilles Tjoelker <jilles@stack.nl>
To: bug-followup@FreeBSD.org, jhs@berklix.com
Cc:  
Subject: Re: bin/146600: Patch to add an example to man mount for devfs
Date: Sat, 15 May 2010 16:25:49 +0200

 I don't think this belongs in mount(8); just a reference to devfs(5)
 would suffice. The example in devfs(5) could be changed to mount a
 /some/chroot/dev instead of /dev (which is already done by kernel or
 init). Because most chroots need a devfs, it seems unnecessary to
 mention 'make release' in there.
 
 -- 
 Jilles Tjoelker

From: "Julian H. Stacey" <jhs@berklix.com>
To: Jilles Tjoelker <jilles@stack.nl>
Cc: bug-followup@FreeBSD.org
Subject: Re: bin/146600: Patch to add an example to man mount for devfs 
Date: Sat, 15 May 2010 18:25:07 +0200

 Hi,
 Reference:
 > From:		Jilles Tjoelker <jilles@stack.nl> 
 > Date:		Sat, 15 May 2010 16:25:49 +0200 
 > Message-id:	<20100515142549.GA74137@stack.nl> 
 
 Jilles Tjoelker wrote:
 > I don't think this belongs in mount(8); just a reference to devfs(5)
 > would suffice.
 
 I think the example useful, as it took too long to derive syntax.
 
 
 > The example in devfs(5) could be changed to mount a
 > /some/chroot/dev instead of /dev (which is already done by kernel or
 > init).
 
 Feel free to send-pr a diff :-)
 
 
 > Because most chroots need a devfs, it seems unnecessary to
 > mention 'make release' in there.
 
 Agreed, leave or omit s commiter chooses, I'm easy.
 
 Cheers,
 Julian
 -- 
 Julian Stacey: BSD Unix Linux C Sys Eng Consultants Munich http://berklix.com
 Mail plain text,  Not HTML quoted-printable Base64 http://www.asciiribbon.org

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: bin/146600: commit references a PR
Date: Sat, 29 May 2010 20:24:10 +0000 (UTC)

 Author: jilles
 Date: Sat May 29 20:24:01 2010
 New Revision: 208647
 URL: http://svn.freebsd.org/changeset/base/208647
 
 Log:
   Clarify devfs manpages slightly.
   
   mount(8): add xref to devfs(5)
   devfs(5): change example to something more likely to be useful (it is not
   necessary to mount a devfs on /dev manually, but for chroots/jails it is
   often needed), mention since when devfs is preferred to device nodes on ufs
   
   PR:		146600
   MFC after:	2 weeks
 
 Modified:
   head/sbin/mount/mount.8
   head/share/man/man5/devfs.5
 
 Modified: head/sbin/mount/mount.8
 ==============================================================================
 --- head/sbin/mount/mount.8	Sat May 29 18:26:44 2010	(r208646)
 +++ head/sbin/mount/mount.8	Sat May 29 20:24:01 2010	(r208647)
 @@ -525,6 +525,7 @@ support for a particular file system mig
  .Xr nmount 2 ,
  .Xr acl 3 ,
  .Xr mac 4 ,
 +.Xr devfs 5 ,
  .Xr ext2fs 5 ,
  .Xr fstab 5 ,
  .Xr procfs 5 ,
 
 Modified: head/share/man/man5/devfs.5
 ==============================================================================
 --- head/share/man/man5/devfs.5	Sat May 29 18:26:44 2010	(r208646)
 +++ head/share/man/man5/devfs.5	Sat May 29 20:24:01 2010	(r208647)
 @@ -38,7 +38,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd December 14, 1996
 +.Dd May 29, 2010
  .Dt DEVFS 5
  .Os
  .Sh NAME
 @@ -80,9 +80,9 @@ mount point.
  To mount a
  .Nm
  volume located on
 -.Pa /dev :
 +.Pa /mychroot/dev :
  .Pp
 -.Dl "mount -t devfs devfs /dev"
 +.Dl "mount -t devfs devfs /mychroot/dev"
  .Sh SEE ALSO
  .Xr devfs 8 ,
  .Xr mount 8
 @@ -90,7 +90,9 @@ volume located on
  The
  .Nm
  file system first appeared in
 -.Fx 2.0 .
 +.Fx 2.0
 +and became the preferred method for accessing devices in
 +.Fx 5.0 .
  The
  .Nm
  manual page first appeared in
 _______________________________________________
 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: open->patched 
State-Changed-By: jilles 
State-Changed-When: Sat May 29 20:49:59 UTC 2010 
State-Changed-Why:  
Fixed in 9-CURRENT. 


Responsible-Changed-From-To: freebsd-bugs->jilles 
Responsible-Changed-By: jilles 
Responsible-Changed-When: Sat May 29 20:49:59 UTC 2010 
Responsible-Changed-Why:  
Take. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: bin/146600: commit references a PR
Date: Wed, 23 Jun 2010 20:59:10 +0000 (UTC)

 Author: jilles
 Date: Wed Jun 23 20:59:00 2010
 New Revision: 209484
 URL: http://svn.freebsd.org/changeset/base/209484
 
 Log:
   MFC r208647,r208654: Clarify devfs manpages slightly.
   
   mount(8): add xref to devfs(5)
   devfs(5): change example to something more likely to be useful (it is not
   necessary to mount a devfs on /dev manually, but for chroots/jails it is
   often needed), mention since when devfs is preferred to device nodes on ufs
   and when device nodes on ufs stopped working
   
   PR:		146600
 
 Modified:
   stable/8/sbin/mount/mount.8
   stable/8/share/man/man5/devfs.5
 Directory Properties:
   stable/8/sbin/mount/   (props changed)
   stable/8/share/man/man5/   (props changed)
 
 Modified: stable/8/sbin/mount/mount.8
 ==============================================================================
 --- stable/8/sbin/mount/mount.8	Wed Jun 23 20:44:07 2010	(r209483)
 +++ stable/8/sbin/mount/mount.8	Wed Jun 23 20:59:00 2010	(r209484)
 @@ -525,6 +525,7 @@ support for a particular file system mig
  .Xr nmount 2 ,
  .Xr acl 3 ,
  .Xr mac 4 ,
 +.Xr devfs 5 ,
  .Xr ext2fs 5 ,
  .Xr fstab 5 ,
  .Xr procfs 5 ,
 
 Modified: stable/8/share/man/man5/devfs.5
 ==============================================================================
 --- stable/8/share/man/man5/devfs.5	Wed Jun 23 20:44:07 2010	(r209483)
 +++ stable/8/share/man/man5/devfs.5	Wed Jun 23 20:59:00 2010	(r209484)
 @@ -38,7 +38,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd December 14, 1996
 +.Dd May 30, 2010
  .Dt DEVFS 5
  .Os
  .Sh NAME
 @@ -80,9 +80,9 @@ mount point.
  To mount a
  .Nm
  volume located on
 -.Pa /dev :
 +.Pa /mychroot/dev :
  .Pp
 -.Dl "mount -t devfs devfs /dev"
 +.Dl "mount -t devfs devfs /mychroot/dev"
  .Sh SEE ALSO
  .Xr devfs 8 ,
  .Xr mount 8
 @@ -91,6 +91,10 @@ The
  .Nm
  file system first appeared in
  .Fx 2.0 .
 +It became the preferred method for accessing devices in
 +.Fx 5.0
 +and the only method in
 +.Fx 6.0 .
  The
  .Nm
  manual page first appeared in
 _______________________________________________
 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: jilles 
State-Changed-When: Sat Jun 26 14:44:17 UTC 2010 
State-Changed-Why:  
Fixed in 9.x/8.x/7.x. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: bin/146600: commit references a PR
Date: Sat, 26 Jun 2010 14:42:20 +0000 (UTC)

 Author: jilles
 Date: Sat Jun 26 14:42:07 2010
 New Revision: 209537
 URL: http://svn.freebsd.org/changeset/base/209537
 
 Log:
   MFC r208647,r208654: Clarify devfs manpages slightly.
   
   mount(8): add xref to devfs(5)
   devfs(5): change example to something more likely to be useful (it is not
   necessary to mount a devfs on /dev manually, but for chroots/jails it is
   often needed), mention since when devfs is preferred to device nodes on ufs
   and when device nodes on ufs stopped working
   
   PR:		146600
 
 Modified:
   stable/7/sbin/mount/mount.8
   stable/7/share/man/man5/devfs.5
 Directory Properties:
   stable/7/sbin/mount/   (props changed)
   stable/7/sbin/mount/mount_fs.c   (props changed)
   stable/7/share/man/man5/   (props changed)
 
 Modified: stable/7/sbin/mount/mount.8
 ==============================================================================
 --- stable/7/sbin/mount/mount.8	Sat Jun 26 13:20:40 2010	(r209536)
 +++ stable/7/sbin/mount/mount.8	Sat Jun 26 14:42:07 2010	(r209537)
 @@ -507,6 +507,7 @@ support for a particular file system mig
  .Xr nmount 2 ,
  .Xr acl 3 ,
  .Xr mac 4 ,
 +.Xr devfs 5 ,
  .Xr ext2fs 5 ,
  .Xr fstab 5 ,
  .Xr procfs 5 ,
 
 Modified: stable/7/share/man/man5/devfs.5
 ==============================================================================
 --- stable/7/share/man/man5/devfs.5	Sat Jun 26 13:20:40 2010	(r209536)
 +++ stable/7/share/man/man5/devfs.5	Sat Jun 26 14:42:07 2010	(r209537)
 @@ -38,7 +38,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd December 14, 1996
 +.Dd May 30, 2010
  .Dt DEVFS 5
  .Os
  .Sh NAME
 @@ -80,9 +80,9 @@ mount point.
  To mount a
  .Nm
  volume located on
 -.Pa /dev :
 +.Pa /mychroot/dev :
  .Pp
 -.Dl "mount -t devfs devfs /dev"
 +.Dl "mount -t devfs devfs /mychroot/dev"
  .Sh SEE ALSO
  .Xr devfs 8 ,
  .Xr mount 8
 @@ -91,6 +91,10 @@ The
  .Nm
  file system first appeared in
  .Fx 2.0 .
 +It became the preferred method for accessing devices in
 +.Fx 5.0
 +and the only method in
 +.Fx 6.0 .
  The
  .Nm
  manual page first appeared in
 _______________________________________________
 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:
