From fanf@dotat.at  Thu Mar 15 11:11:01 2001
Return-Path: <fanf@dotat.at>
Received: from hand.dotat.at (sfo-gw.covalent.net [207.44.198.62])
	by hub.freebsd.org (Postfix) with ESMTP id AA7E737B71A
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 Mar 2001 11:11:00 -0800 (PST)
	(envelope-from fanf@dotat.at)
Received: from fanf by hand.dotat.at with local (Exim 3.20 #3)
	id 14dPm2-0000au-00
	for FreeBSD-gnats-submit@freebsd.org; Thu, 15 Mar 2001 04:54:06 +0000
Message-Id: <E14dPm2-0000au-00@hand.dotat.at>
Date: Thu, 15 Mar 2001 04:54:06 +0000
From: Tony Finch <dot@dotat.at>
Reply-To: Tony Finch <dot@dotat.at>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] properly document vfc_flags in getvfsent(3)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         25837
>Category:       docs
>Synopsis:       [PATCH] properly document vfc_flags in getvfsent(3)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dd
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 15 11:20:02 PST 2001
>Closed-Date:    Wed Jul 18 22:46:45 PDT 2001
>Last-Modified:  Wed Jul 18 22:46:52 PDT 2001
>Originator:     Tony Finch <dot@dotat.at>
>Release:        FreeBSD 4.3-BETA i386
>Organization:
Covalent Technologies, Inc.
>Environment:
System: FreeBSD hand.dotat.at 4.3-BETA FreeBSD 4.3-BETA #5: Thu Mar 15 02:42:59 GMT 2001 fanf@hand.dotat.at:/FreeBSD/releng4/sys/compile/DELL-Latitude-CSx i386
>Description:
The getvfsent(3) manual page incorrectly says that there are no defined
valies for vfc_flags
>How-To-Repeat:
>Fix:

Index: getvfsbyname.3
===================================================================
RCS file: /home/ncvs/src/lib/libc/gen/getvfsbyname.3,v
retrieving revision 1.7.2.3
diff -u -r1.7.2.3 getvfsbyname.3
--- getvfsbyname.3	2000/12/29 14:44:44	1.7.2.3
+++ getvfsbyname.3	2001/03/15 04:50:56
@@ -67,8 +67,8 @@
 .It vfc_refcount
 the number of active mount points using the filesystem
 .It vfc_flags
-flag bits that are used to initialize a new mount point
-using the filesystem
+flag bits as described in
+.Xr getvfsent 3
 .El
 .Sh RETURN VALUES
 .Rv -std getvfsbyname
@@ -85,6 +85,7 @@
 specifies a filesystem that is unknown or not configured in the kernel.
 .El
 .Sh SEE ALSO
+.Xr getvfsent 3 ,
 .Xr mount 2 ,
 .Xr sysctl 3 ,
 .Xr mount 8 ,
Index: getvfsent.3
===================================================================
RCS file: /home/ncvs/src/lib/libc/gen/getvfsent.3,v
retrieving revision 1.17.2.3
diff -u -r1.17.2.3 getvfsent.3
--- getvfsent.3	2001/03/06 16:45:54	1.17.2.3
+++ getvfsent.3	2001/03/15 04:46:26
@@ -48,7 +48,23 @@
 (usually the number of mounts, but one greater for filesystems which
 cannot be unloaded or which are statically linked into the kernel)
 .It vfc_flags
-flag bits, of which none are currently defined
+flag bits
+.El
+.Pp
+The flags are defined as follows:
+.Bl -tag -width VFCF_SYNTHETIC
+.It VFCF_STATIC
+statically compiled into kernel
+.It VFCF_NETWORK
+may get data over the network
+.It VFCF_READONLY
+writes are not implemented
+.It VFCF_SYNTHETIC
+data does not represent real files
+.It VFCF_LOOPBACK
+aliases some other mounted FS
+.It VFCF_UNICODE
+stores file names as Unicode
 .El
 .Pp
 The
>Release-Note:
>Audit-Trail:

From: "mdoc(7) police" <ru@FreeBSD.org>
To: Tony Finch <dot@dotat.at>
Cc: bug-followup@FreeBSD.org
Subject: Re: bin/25837: [PATCH] properly document vfc_flags in getvfsent(3)
Date: Thu, 15 Mar 2001 21:39:34 +0200

 On Thu, Mar 15, 2001 at 04:54:06AM +0000, Tony Finch wrote:
 > 
 > Index: getvfsbyname.3
 [...]
 >  .Sh SEE ALSO
 > +.Xr getvfsent 3 ,
 >  .Xr mount 2 ,
 >  .Xr sysctl 3 ,
 >  .Xr mount 8 ,
 
 SEE ALSO entries should be sorted by section number first,
 then by name.
 
 > Index: getvfsent.3
 [...]
 > +The flags are defined as follows:
 > +.Bl -tag -width VFCF_SYNTHETIC
 > +.It VFCF_STATIC
 > +statically compiled into kernel
 > +.It VFCF_NETWORK
 > +may get data over the network
 > +.It VFCF_READONLY
 > +writes are not implemented
 > +.It VFCF_SYNTHETIC
 > +data does not represent real files
 > +.It VFCF_LOOPBACK
 > +aliases some other mounted FS
 > +.It VFCF_UNICODE
 > +stores file names as Unicode
 >  .El
 
 #defined values should be flagged with ``Dv'' macro.
 
 
 Cheers,
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age
Responsible-Changed-From-To: freebsd-bugs->freebsd-docs 
Responsible-Changed-By: dd 
Responsible-Changed-When: Sat Apr 28 20:25:04 PDT 2001 
Responsible-Changed-Why:  
docs problem. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=25837 
State-Changed-From-To: open->analyzed 
State-Changed-By: dd 
State-Changed-When: Wed Jun 27 23:50:27 PDT 2001 
State-Changed-Why:  
Committed, thanks! 


Responsible-Changed-From-To: freebsd-docs->dd 
Responsible-Changed-By: dd 
Responsible-Changed-When: Wed Jun 27 23:50:27 PDT 2001 
Responsible-Changed-Why:  
My MFC reminder. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=25837 
State-Changed-From-To: analyzed->closed 
State-Changed-By: dd 
State-Changed-When: Wed Jul 18 22:46:45 PDT 2001 
State-Changed-Why:  
MFC'd, thanks. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=25837 
>Unformatted:
