From nobody@FreeBSD.org  Thu Sep 20 02:21:41 2007
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 105F916A417
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 20 Sep 2007 02:21:41 +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 E865013C468
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 20 Sep 2007 02:21:40 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l8K2Le6e033010
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 20 Sep 2007 02:21:40 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.1/8.14.1/Submit) id l8K2LeaX033008;
	Thu, 20 Sep 2007 02:21:40 GMT
	(envelope-from nobody)
Message-Id: <200709200221.l8K2LeaX033008@www.freebsd.org>
Date: Thu, 20 Sep 2007 02:21:40 GMT
From: Ighighi <ighighi@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: sysctl(3) description of kern.file no longer applies since 5.0
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         116480
>Category:       docs
>Synopsis:       sysctl(3) description of kern.file no longer applies since 5.0
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jilles
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 20 02:30:01 GMT 2007
>Closed-Date:    Wed May 05 22:09:13 UTC 2010
>Last-Modified:  Wed May  5 22:10:04 UTC 2010
>Originator:     Ighighi
>Release:        6.2-STABLE
>Organization:
>Environment:
FreeBSD orion 6.2-STABLE FreeBSD 6.2-STABLE #0: Tue Sep 18 04:58:38 VET 2007     root@orion:/usr/obj/usr/src/sys/CUSTOM  i386
>Description:
Quoting sysctl(3):
KERN_FILE
        Return the entire file table.  The returned data consists of a
        single struct filehead followed by an array of struct file, whose
        size depends on the current number of such objects in the system.

This is no longer the case since 5.0.  The entire file table is an array of
"struct xfile" structures (defined in <sys/file.h>).
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:

From: Jason Helfman <jhelfman@e-e.com>
To: bug-followup@FreeBSD.org, ighighi@gmail.com
Cc:  
Subject: Re: docs/116480: [request] sysctl(3) description of kern.file no longer applies since 5.0
Date: Wed, 24 Feb 2010 23:16:01 -0800

 This could probably be consolidated as part of docs/44034 PR.
 
 -j
State-Changed-From-To: open->patched 
State-Changed-By: jilles 
State-Changed-When: Sun Apr 25 12:36:38 UTC 2010 
State-Changed-Why:  
Fixed in 9-CURRENT. 


Responsible-Changed-From-To: freebsd-doc->jilles 
Responsible-Changed-By: jilles 
Responsible-Changed-When: Sun Apr 25 12:36:38 UTC 2010 
Responsible-Changed-Why:  
Take. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/116480: commit references a PR
Date: Sun, 25 Apr 2010 12:35:54 +0000 (UTC)

 Author: jilles
 Date: Sun Apr 25 12:35:39 2010
 New Revision: 207186
 URL: http://svn.freebsd.org/changeset/base/207186
 
 Log:
   sysctl(3): Update description of various kern.* variables.
   Also add xrefs for confstr(3) (as sysconf(3) but for strings) and kvm(3)
   (which is a more convenient way to access some of the variables).
   
   PR:		116480
   MFC after:	1 week
 
 Modified:
   head/lib/libc/gen/sysctl.3
 
 Modified: head/lib/libc/gen/sysctl.3
 ==============================================================================
 --- head/lib/libc/gen/sysctl.3	Sun Apr 25 05:09:08 2010	(r207185)
 +++ head/lib/libc/gen/sysctl.3	Sun Apr 25 12:35:39 2010	(r207186)
 @@ -28,7 +28,7 @@
  .\"	@(#)sysctl.3	8.4 (Berkeley) 5/9/95
  .\" $FreeBSD$
  .\"
 -.Dd February 21, 2010
 +.Dd April 25, 2010
  .Dt SYSCTL 3
  .Os
  .Sh NAME
 @@ -325,7 +325,7 @@ information.
  .It "KERN_BOOTFILE	string	yes"
  .It "KERN_BOOTTIME	struct timeval	no"
  .It "KERN_CLOCKRATE	struct clockinfo	no"
 -.It "KERN_FILE	struct file	no"
 +.It "KERN_FILE	struct xfile	no"
  .It "KERN_HOSTID	integer	yes"
  .It "KERN_HOSTUUID	string	yes"
  .It "KERN_HOSTNAME	string	yes"
 @@ -342,14 +342,14 @@ information.
  .It "KERN_OSREV	integer	no"
  .It "KERN_OSTYPE	string	no"
  .It "KERN_POSIX1	integer	no"
 -.It "KERN_PROC	struct proc	no"
 +.It "KERN_PROC	node	not applicable"
  .It "KERN_PROF	node	not applicable"
  .It "KERN_QUANTUM	integer	yes"
  .It "KERN_SAVED_IDS	integer	no"
  .It "KERN_SECURELVL	integer	raise only"
  .It "KERN_UPDATEINTERVAL	integer	no"
  .It "KERN_VERSION	string	no"
 -.It "KERN_VNODE	struct vnode	no"
 +.It "KERN_VNODE	struct xvnode	no"
  .El
  .Bl -tag -width 6n
  .It Li KERN_ARGMAX
 @@ -370,10 +370,8 @@ This structure contains the clock, stati
  frequencies, the number of micro-seconds per hz tick and the skew rate.
  .It Li KERN_FILE
  Return the entire file table.
 -The returned data consists of a single
 -.Va struct filehead
 -followed by an array of
 -.Va struct file ,
 +The returned data consists of an array of
 +.Va struct xfile ,
  whose size depends on the current number of such objects in the system.
  .It Li KERN_HOSTID
  Get or set the host ID.
 @@ -525,10 +523,8 @@ Note, the vnode table is not necessarily
  the system.
  The returned data consists of an array whose size depends on the
  current number of such objects in the system.
 -Each element of the array contains the kernel address of a vnode
 -.Va struct vnode *
 -followed by the vnode itself
 -.Va struct vnode .
 +Each element of the array consists of a
 +.Va struct xvnode .
  .El
  .Ss CTL_NET
  The string and integer information available for the CTL_NET level
 @@ -854,6 +850,8 @@ An attempt is made to set a read-only va
  A process without appropriate privilege attempts to set a value.
  .El
  .Sh SEE ALSO
 +.Xr confstr 3 ,
 +.Xr kvm 3 ,
  .Xr sysconf 3 ,
  .Xr sysctl 8
  .Sh HISTORY
 _______________________________________________
 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: Wed May 5 22:09:13 UTC 2010 
State-Changed-Why:  
Fixed in 9.x, 8.x, 7.x; no fix planned for 6.x. Thanks! 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/116480: commit references a PR
Date: Wed,  5 May 2010 22:01:08 +0000 (UTC)

 Author: jilles
 Date: Wed May  5 22:00:57 2010
 New Revision: 207679
 URL: http://svn.freebsd.org/changeset/base/207679
 
 Log:
   MFC r207186: sysctl(3): Update description of various kern.* variables.
   Also add xrefs for confstr(3) (as sysconf(3) but for strings) and kvm(3)
   (which is a more convenient way to access some of the variables).
   
   PR:		116480
 
 Modified:
   stable/8/lib/libc/gen/sysctl.3
 Directory Properties:
   stable/8/lib/libc/   (props changed)
   stable/8/lib/libc/stdtime/   (props changed)
 
 Modified: stable/8/lib/libc/gen/sysctl.3
 ==============================================================================
 --- stable/8/lib/libc/gen/sysctl.3	Wed May  5 21:48:40 2010	(r207678)
 +++ stable/8/lib/libc/gen/sysctl.3	Wed May  5 22:00:57 2010	(r207679)
 @@ -28,7 +28,7 @@
  .\"	@(#)sysctl.3	8.4 (Berkeley) 5/9/95
  .\" $FreeBSD$
  .\"
 -.Dd January 28, 2009
 +.Dd April 25, 2010
  .Dt SYSCTL 3
  .Os
  .Sh NAME
 @@ -326,7 +326,7 @@ information.
  .It "KERN_BOOTFILE	string	yes"
  .It "KERN_BOOTTIME	struct timeval	no"
  .It "KERN_CLOCKRATE	struct clockinfo	no"
 -.It "KERN_FILE	struct file	no"
 +.It "KERN_FILE	struct xfile	no"
  .It "KERN_HOSTID	integer	yes"
  .It "KERN_HOSTUUID	string	yes"
  .It "KERN_HOSTNAME	string	yes"
 @@ -343,14 +343,14 @@ information.
  .It "KERN_OSREV	integer	no"
  .It "KERN_OSTYPE	string	no"
  .It "KERN_POSIX1	integer	no"
 -.It "KERN_PROC	struct proc	no"
 +.It "KERN_PROC	node	not applicable"
  .It "KERN_PROF	node	not applicable"
  .It "KERN_QUANTUM	integer	yes"
  .It "KERN_SAVED_IDS	integer	no"
  .It "KERN_SECURELVL	integer	raise only"
  .It "KERN_UPDATEINTERVAL	integer	no"
  .It "KERN_VERSION	string	no"
 -.It "KERN_VNODE	struct vnode	no"
 +.It "KERN_VNODE	struct xvnode	no"
  .El
  .Pp
  .Bl -tag -width 6n
 @@ -372,10 +372,8 @@ This structure contains the clock, stati
  frequencies, the number of micro-seconds per hz tick and the skew rate.
  .It Li KERN_FILE
  Return the entire file table.
 -The returned data consists of a single
 -.Va struct filehead
 -followed by an array of
 -.Va struct file ,
 +The returned data consists of an array of
 +.Va struct xfile ,
  whose size depends on the current number of such objects in the system.
  .It Li KERN_HOSTID
  Get or set the host ID.
 @@ -527,10 +525,8 @@ Note, the vnode table is not necessarily
  the system.
  The returned data consists of an array whose size depends on the
  current number of such objects in the system.
 -Each element of the array contains the kernel address of a vnode
 -.Va struct vnode *
 -followed by the vnode itself
 -.Va struct vnode .
 +Each element of the array consists of a
 +.Va struct xvnode .
  .El
  .Ss CTL_NET
  The string and integer information available for the CTL_NET level
 @@ -859,6 +855,8 @@ An attempt is made to set a read-only va
  A process without appropriate privilege attempts to set a value.
  .El
  .Sh SEE ALSO
 +.Xr confstr 3 ,
 +.Xr kvm 3 ,
  .Xr sysconf 3 ,
  .Xr sysctl 8
  .Sh HISTORY
 _______________________________________________
 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/116480: commit references a PR
Date: Wed,  5 May 2010 22:07:37 +0000 (UTC)

 Author: jilles
 Date: Wed May  5 22:07:28 2010
 New Revision: 207681
 URL: http://svn.freebsd.org/changeset/base/207681
 
 Log:
   MFC r207186: sysctl(3): Update description of various kern.* variables.
   Also add xrefs for confstr(3) (as sysconf(3) but for strings) and kvm(3)
   (which is a more convenient way to access some of the variables).
   
   PR:		116480
 
 Modified:
   stable/7/lib/libc/gen/sysctl.3
 Directory Properties:
   stable/7/lib/libc/   (props changed)
   stable/7/lib/libc/stdtime/   (props changed)
 
 Modified: stable/7/lib/libc/gen/sysctl.3
 ==============================================================================
 --- stable/7/lib/libc/gen/sysctl.3	Wed May  5 22:06:05 2010	(r207680)
 +++ stable/7/lib/libc/gen/sysctl.3	Wed May  5 22:07:28 2010	(r207681)
 @@ -28,7 +28,7 @@
  .\"	@(#)sysctl.3	8.4 (Berkeley) 5/9/95
  .\" $FreeBSD$
  .\"
 -.Dd April 10, 2007
 +.Dd April 25, 2010
  .Dt SYSCTL 3
  .Os
  .Sh NAME
 @@ -323,7 +323,7 @@ information.
  .It "KERN_BOOTFILE	string	yes"
  .It "KERN_BOOTTIME	struct timeval	no"
  .It "KERN_CLOCKRATE	struct clockinfo	no"
 -.It "KERN_FILE	struct file	no"
 +.It "KERN_FILE	struct xfile	no"
  .It "KERN_HOSTID	integer	yes"
  .It "KERN_HOSTUUID	string	yes"
  .It "KERN_HOSTNAME	string	yes"
 @@ -340,14 +340,14 @@ information.
  .It "KERN_OSREV	integer	no"
  .It "KERN_OSTYPE	string	no"
  .It "KERN_POSIX1	integer	no"
 -.It "KERN_PROC	struct proc	no"
 +.It "KERN_PROC	node	not applicable"
  .It "KERN_PROF	node	not applicable"
  .It "KERN_QUANTUM	integer	yes"
  .It "KERN_SAVED_IDS	integer	no"
  .It "KERN_SECURELVL	integer	raise only"
  .It "KERN_UPDATEINTERVAL	integer	no"
  .It "KERN_VERSION	string	no"
 -.It "KERN_VNODE	struct vnode	no"
 +.It "KERN_VNODE	struct xvnode	no"
  .El
  .Pp
  .Bl -tag -width 6n
 @@ -369,10 +369,8 @@ This structure contains the clock, stati
  frequencies, the number of micro-seconds per hz tick and the skew rate.
  .It Li KERN_FILE
  Return the entire file table.
 -The returned data consists of a single
 -.Va struct filehead
 -followed by an array of
 -.Va struct file ,
 +The returned data consists of an array of
 +.Va struct xfile ,
  whose size depends on the current number of such objects in the system.
  .It Li KERN_HOSTID
  Get or set the host ID.
 @@ -526,10 +524,8 @@ Note, the vnode table is not necessarily
  the system.
  The returned data consists of an array whose size depends on the
  current number of such objects in the system.
 -Each element of the array contains the kernel address of a vnode
 -.Va struct vnode *
 -followed by the vnode itself
 -.Va struct vnode .
 +Each element of the array consists of a
 +.Va struct xvnode .
  .El
  .Ss CTL_MACHDEP
  The set of variables defined is architecture dependent.
 @@ -869,6 +865,8 @@ An attempt is made to set a read-only va
  A process without appropriate privilege attempts to set a value.
  .El
  .Sh SEE ALSO
 +.Xr confstr 3 ,
 +.Xr kvm 3 ,
  .Xr sysconf 3 ,
  .Xr sysctl 8
  .Sh HISTORY
 _______________________________________________
 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:
