NetBSD Problem Report #52607

From www@NetBSD.org  Mon Oct  9 17:24:01 2017
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 7940D7A25E
	for <gnats-bugs@gnats.NetBSD.org>; Mon,  9 Oct 2017 17:24:01 +0000 (UTC)
Message-Id: <20171009172400.B48057A28C@mollari.NetBSD.org>
Date: Mon,  9 Oct 2017 17:24:00 +0000 (UTC)
From: tomh0665@gmail.com
Reply-To: tomh0665@gmail.com
To: gnats-bugs@NetBSD.org
Subject: Documentation error for mount_procfs in fstab
X-Send-Pr-Version: www-1.0

>Number:         52607
>Category:       misc
>Synopsis:       Documentation error for mount_procfs in fstab
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gutteridge
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Oct 09 17:25:00 +0000 2017
>Closed-Date:    Sun Apr 19 19:56:42 +0000 2020
>Last-Modified:  Sun Apr 19 19:56:42 +0000 2020
>Originator:     Tom
>Release:        web page
>Organization:
>Environment:
[irrelevant] NetBSD localhost 7.1 NetBSD 7.1 (GENERIC.201703111743Z) amd64
>Description:
On
https://www.netbsd.org/docs/misc/index.html#procfs

/proc /proc procfs rw 0 0
should be
procfs /proc procfs rw 0 0
>How-To-Repeat:
n/a
>Fix:
n/a

>Release-Note:

>Audit-Trail:

Responsible-Changed-From-To: misc-bug-people->leot
Responsible-Changed-By: leot@NetBSD.org
Responsible-Changed-When: Mon, 09 Oct 2017 17:31:30 +0000
Responsible-Changed-Why:
Take


From: Leonardo Taccari <leot@NetBSD.org>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: misc/52607: Documentation error for mount_procfs in fstab
Date: Mon, 09 Oct 2017 19:52:25 +0200

 Hello Tom,

 tomh0665@gmail.com writes:
 > >Number:         52607
 > >Category:       misc
 > >Synopsis:       Documentation error for mount_procfs in fstab
 > >Confidential:   no
 > >Severity:       non-critical
 > >Priority:       low
 > >Responsible:    misc-bug-people
 > >State:          open
 > >Class:          doc-bug
 > >Submitter-Id:   net
 > >Arrival-Date:   Mon Oct 09 17:25:00 +0000 2017
 > >Originator:     Tom
 > >Release:        web page
 > >Organization:
 > >Environment:
 > [irrelevant] NetBSD localhost 7.1 NetBSD 7.1 (GENERIC.201703111743Z) amd64
 > >Description:
 > On
 > https://www.netbsd.org/docs/misc/index.html#procfs
 >
 > /proc /proc procfs rw 0 0
 > should be
 > procfs /proc procfs rw 0 0
 > [...]

 While I think that several ports nowdays usually contains the
 `procfs /proc procfs rw' (several configuration in src/distrib/
 and sysinst(8) itself) entry, also `/proc /proc procfs rw 0 0'
 correctly works (and that's also present in
 src/share/examples/fstab/fstab.pseudo, apart the web page you've
 linked).

 Am I missing something?

From: Robert Elz <kre@munnari.OZ.AU>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: misc/52607: Documentation error for mount_procfs in fstab
Date: Tue, 10 Oct 2017 03:26:16 +0700

     Date:        Mon,  9 Oct 2017 17:55:01 +0000 (UTC)
     From:        Leonardo Taccari <leot@NetBSD.org>
     Message-ID:  <20171009175501.A7CCC7A28C@mollari.NetBSD.org>

   |  also `/proc /proc procfs rw 0 0' correctly works

 As does:
 	anything-at-all /proc procfs ...

 The "device" field is simply irrelevant for procfs/kernfs/tmpfs (et al.)
 and can be anything.

 mount_procfs(8) uses /proc (as does mount_kernfs(8) for /kern) whereas
 mount_tmpfs(8) uses just "tmpfs".

 Something should probably say that the arg is irrelevant and ignored,
 and is present (in mount_xxxfs and fstab) merely to be consistent with
 the mount_xxxfs commands (and fstab lines) that mount devices, but what
 is there really doesn't matter at all.   Nothing is right or wrong,
 nor is using /proc vs procfs more or less consistent, both are used.

 kre

Responsible-Changed-From-To: leot->misc-bug-people
Responsible-Changed-By: leot@NetBSD.org
Responsible-Changed-When: Sun, 10 Mar 2019 22:02:49 +0000
Responsible-Changed-Why:
Unassign from myself (I have not made any progress on that for
more than one year, sorry!)

(Based on Robert comments maybe documentation can be added
that the "device" field is just irrelevant.)


Responsible-Changed-From-To: misc-bug-people->gutteridge
Responsible-Changed-By: gutteridge@NetBSD.org
Responsible-Changed-When: Sat, 01 Jun 2019 22:15:45 +0000
Responsible-Changed-Why:
Take.

From: "David H. Gutteridge" <gutteridge@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/52607 CVS commit: src/share/man/man5
Date: Sun, 19 Apr 2020 19:20:32 +0000

 Module Name:	src
 Committed By:	gutteridge
 Date:		Sun Apr 19 19:20:32 UTC 2020

 Modified Files:
 	src/share/man/man5: fstab.5

 Log Message:
 fstab.5: note the first field is a placeholder for some FSes

 Addresses PR misc/52607. (I suppose something about this could also be
 added to the man pages for the mount commands for each applicable file
 system, but I think this should suffice.)


 To generate a diff of this commit:
 cvs rdiff -u -r1.46 -r1.47 src/share/man/man5/fstab.5

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: gutteridge@NetBSD.org
State-Changed-When: Sun, 19 Apr 2020 19:56:42 +0000
State-Changed-Why:
Details added to the fstab(5) man page. Thanks for the PR!

>Unformatted:

Home	PR Database Search