From larse@nik.isi.edu  Fri Jun 13 16:40:55 2003
Return-Path: <larse@nik.isi.edu>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7C19737B401
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 13 Jun 2003 16:40:55 -0700 (PDT)
Received: from nik.isi.edu (nik.isi.edu [128.9.168.58])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0CEB943F93
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 13 Jun 2003 16:40:55 -0700 (PDT)
	(envelope-from larse@nik.isi.edu)
Received: from nik.isi.edu (localhost [127.0.0.1])
	by nik.isi.edu (8.12.9/8.12.9) with ESMTP id h5DNesLM068775
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 13 Jun 2003 16:40:54 -0700 (PDT)
	(envelope-from larse@nik.isi.edu)
Received: (from larse@localhost)
	by nik.isi.edu (8.12.9/8.12.9/Submit) id h5DNesZX068774;
	Fri, 13 Jun 2003 16:40:54 -0700 (PDT)
Message-Id: <200306132340.h5DNesZX068774@nik.isi.edu>
Date: Fri, 13 Jun 2003 16:40:54 -0700 (PDT)
From: Lars Eggert <larse@nik.isi.edu>
Reply-To: Lars Eggert <larse@nik.isi.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: mount(2) man page error
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         53303
>Category:       docs
>Synopsis:       mount(2) man page error
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jun 13 16:50:13 PDT 2003
>Closed-Date:    Sat Feb 26 04:46:06 GMT 2005
>Last-Modified:  Sat Feb 26 04:46:06 GMT 2005
>Originator:     Lars Eggert <larse@isi.edu>
>Release:        FreeBSD 5.1-CURRENT i386
>Organization:
>Environment:
System: FreeBSD nik.isi.edu 5.1-CURRENT FreeBSD 5.1-CURRENT #1: Thu Jun 12 10:02:16 PDT 2003 root@nik.isi.edu:/usr/obj/usr/src/sys/KERNEL-1.23 i386


	
>Description:
The mount(2) man page implicitly refers to a nonexisting mount_ufs man page
in this paragraph:

     Data is a pointer to a structure that contains the type specific argu-
     ments to mount.  The format for these argument structures is described in
     the manual page for each filesystem.  By convention filesystem manual
     pages are named by prefixing ``mount_'' to the name of the filesystem as
     returned by lsvfs(1).  Thus the NFS filesystem is described by the
     mount_nfs(8) manual page.

Since lsvfs lists "ufs" as a file system name, mount_ufs should exist that
documents toe appropriate structure.

>How-To-Repeat:
# lsvfs 
Filesystem                        Refs Flags
-------------------------------- ----- ---------------
ufs                                  2 
procfs                               1 synthetic
linprocfs                            1 synthetic
ntfs                                 1 
nfs                                  4 network

# man mount_ufs
No manual entry for mount_ufs

>Fix:

	


>Release-Note:
>Audit-Trail:

From: Marc Silver <marcs@draenor.org>
To: freebsd-gnats-submit@FreeBSD.org, larse@nik.isi.edu
Cc:  
Subject: Re: docs/53303: mount(2) man page error
Date: Sat, 17 Jan 2004 08:51:53 +0000

 --sm4nu43k4a2Rpi4c
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hi,
 
 It seems as though UFS is currently seen as an internally known file
 system type, and therefore there is no mount_ufs command or man page.
 I've modified the man page for mount(2) slightly, so that it now reads:
 
       The data argument is a pointer to a structure that contains the
       type spe- cific arguments to mount.  The format for these argument
       structures is described in the manual page for each file system.
       By convention file system manual pages are named by prefixing
       ``mount_'' to the name of the file system as returned by lsvfs(1).
       Thus the NFS file system is described by the mount_nfs(8) manual
       page.  It should however be noted that manual pages for internally
       known file system types such as UFS, do not exist.
 
 Would that be sufficient?
 
 - Marc
 
 --sm4nu43k4a2Rpi4c
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="mount.2.patch"
 
 --- mount.2-orig	Sat Jan 17 10:36:52 2004
 +++ mount.2	Sat Jan 17 10:45:12 2004
 @@ -166,7 +166,8 @@
  .Tn NFS
  file system is described by the
  .Xr mount_nfs 8
 -manual page.
 +manual page.  It should however be noted that manual pages for 
 +internally known file system types such as UFS, do not exist.
  .Pp
  The
  .Fn unmount
 
 --sm4nu43k4a2Rpi4c--

From: Lars Eggert <lars.eggert@netlab.nec.de>
To: marcs@draenor.org, freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/53303: mount(2) man page error
Date: Thu, 22 Apr 2004 09:56:49 +0200

 Hi,
 
 the proposed change addresses the issue.
 
 Even better though would be a reference to where the respective 
 information can be found for UFS (but I don't know where that would 
 be.)
 
 Lars
 -- 
 Lars Eggert                                     NEC Network Laboratories
 
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Thu Feb 24 00:33:29 GMT 2005 
State-Changed-Why:  
Slightly different version of the patch committed, thanks 
for the submission! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Thu Feb 24 00:33:29 GMT 2005 
Responsible-Changed-Why:  
Over to me, MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=53303 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Sat Feb 26 04:45:28 GMT 2005 
State-Changed-Why:  
MFC complete, close this PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=53303 
>Unformatted:
