From davidc@acns.ab.ca  Sat Dec  1 15:35:14 2001
Return-Path: <davidc@acns.ab.ca>
Received: from mail.acns.ab.ca (h24-64-56-135.cg.shawcable.net [24.64.56.135])
	by hub.freebsd.org (Postfix) with ESMTP id 70F5B37B428
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  1 Dec 2001 15:35:04 -0800 (PST)
Received: from colnta.acns.ab.ca (colnta.acns.ab.ca [192.168.1.2])
	by mail.acns.ab.ca (8.11.6/8.11.3) with ESMTP id fB1NZ3b19873
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 1 Dec 2001 16:35:03 -0700 (MST)
	(envelope-from davidc@colnta.acns.ab.ca)
Received: (from davidc@localhost)
	by colnta.acns.ab.ca (8.11.6/8.11.3) id fB1NZ3C47642;
	Sat, 1 Dec 2001 16:35:03 -0700 (MST)
	(envelope-from davidc)
Message-Id: <200112012335.fB1NZ3C47642@colnta.acns.ab.ca>
Date: Sat, 1 Dec 2001 16:35:03 -0700 (MST)
From: Chad David <davidc@acns.ab.ca>
Reply-To: Chad David <davidc@acns.ab.ca>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: New section 9 manual pages 
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         32431
>Category:       docs
>Synopsis:       New section 9 manual pages
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    alfred
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Dec 01 15:40:00 PST 2001
>Closed-Date:    Sun Dec 2 16:25:21 PST 2001
>Last-Modified:  Sun Dec 02 16:26:06 PST 2001
>Originator:     Chad David
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
ACNS Inc. 
>Environment:
System: FreeBSD colnta 4.4-STABLE FreeBSD 4.4-STABLE #9: Tue Nov 20 16:38:27 MST 2001 davidc@colnta:/mnt1/obj/usr/src/sys/COLNTA i386


	
>Description:
	A number of new section 9 manual pages.  Any comments
	related to technical details and page format are welcome.

	As well, any comments on how to make the entire section
	9 manual pages more useful are very welcome!
>How-To-Repeat:
	
>Fix:

begin 644 pages.tgz
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
6Z:233CKII)-..CU9^G^-9]4:`,@`````
`
end

	
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->alfred 
Responsible-Changed-By: alfred 
Responsible-Changed-When: Sat Dec 1 17:54:45 PST 2001 
Responsible-Changed-Why:  
I'll take care of this, I have some feedback for Chad that I need him 
to address before these can be committed. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32431 
State-Changed-From-To: open->feedback 
State-Changed-By: alfred 
State-Changed-When: Sat Dec 1 18:13:46 PST 2001 
State-Changed-Why:  
I need several of the included manpages cleaned up and fleshed out 
before they will be included in the system: 

vfs_getnewfsid.9: 

The vfs_getnewfsid() function allocates a new filesystem identifier for 
the mount point given. 
ok, why would one do this? 

The actual fsid is made up of two 32 bit integers.  The first is unique 
in the set of mounted filesystems, while the second holds the filesystem 
type. 
since the function returns void, where is this stored? 

what other functions use this fsid and why? 

vfs_getvfs.9: 
The vfs_getvfs() function returns the mount point structure for a 
filesystem given its filesystem identifier. 
Where, when and how does one aquire a fsid_t *fsid? 

vfs_mountedon.9:  
The vfs_mountedon() function checks a vnode for a valid mount point 
structure, and returns that the vnode is busy if it does have a valid 
mount point. 
?? 
Needs rewording, perhaps: 
The vfs_mountedon() function returns EBUSY if the passed vnode is 
currently in use as a mount point. 
?? 

vfs_mountedon.9: 
The vfs_mountedon() function checks a vnode for a valid mount point 
structure, and returns that the vnode is busy if it does have a valid 
mount point. 
This is pretty vauge and doesn't make sense to me, upon investigation 
it seems that what vfs_mountedon(9) does is check whether a device 
vnode is busy in the sense that it has a filesystem mounted on top of 
it. 
can you reword this to something like my description? 

vfs_rootmountalloc: 
The vfs_rootmountalloc() function allocates a mount structure initialized 
from the vfsconf type that matches fstypename. 
er, ok, why?  What does this mean?  What's a vfsconf type?  Does it need 
a manpage? 

I think we need to get Chad a commit bit so he can do these at his  
leasure. :) 


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32431 
State-Changed-From-To: feedback->closed 
State-Changed-By: alfred 
State-Changed-When: Sun Dec 2 16:25:21 PST 2001 
State-Changed-Why:  
Chad did an excellent job addressing my requests for additional 
clarification in the submitted documentation, it has been integrated. 

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