From larse@nik.isi.edu Fri Jun 13 16:40:55 2003 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7C19737B401 for ; 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 ; 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 ; 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 Reply-To: Lars Eggert 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 >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 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 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: