NetBSD Problem Report #36947

From lloyd@archangel.must-have-coffee.gen.nz  Fri Sep  7 22:06:25 2007
Return-Path: <lloyd@archangel.must-have-coffee.gen.nz>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id 7A0E563B8A2
	for <gnats-bugs@gnats.NetBSD.org>; Fri,  7 Sep 2007 22:06:25 +0000 (UTC)
Message-Id: <20070907220622.A33E815F116@archangel.must-have-coffee.gen.nz>
Date: Sat,  8 Sep 2007 10:06:22 +1200 (NZST)
From: lloyd@archangel.must-have-coffee.gen.nz
Reply-To: lloyd@archangel.must-have-coffee.gen.nz
To: gnats-bugs@NetBSD.org
Subject: incorrect information in symlink(7)
X-Send-Pr-Version: 3.95

>Number:         36947
>Category:       bin
>Synopsis:       symlink(7) refers to MNT_MAGICLINKS instead if sysctl
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    dholland
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Sep 07 22:10:00 +0000 2007
>Closed-Date:    Mon Dec 01 05:26:06 +0000 2008
>Last-Modified:  Mon Dec 01 05:26:06 +0000 2008
>Originator:     Lloyd Parkes
>Release:        NetBSD 4.0_RC1
>Organization:
Must Have Coffee
>Environment:
System: NetBSD archangel.must-have-coffee.gen.nz 4.0_RC1 NetBSD 4.0_RC1 (GENERIC) #30: Thu Sep 6 06:40:54 NZST 2007 lloyd@thallid.must-have-coffee.gen.nz:/vol/scratch/obj/sparc64/sys/arch/sparc64/compile/GENERIC sparc64
Architecture: sparc64
Machine: sparc64
>Description:

Symlink(7) says that MNT_MAGICLINKS flag must be set on the filesystem
for magic symlinks to be expanded. Mount(8) doesn't refer to any such page,
but "sysctl -a" prints out a variable caled vfs.generic.magiclinks. This
variable is not listed in the sysctl page.

I know this is a little used feature, but the doco really ought to be fixed 
in 4.0_RC2. 

>How-To-Repeat:

Read symlink(7) and then read mount(8) and become confused. 

>Fix:

Replace the first sentence in the *MAGIC SYMLINKS* section with:
Symlinks have ``magic'' patterns in them expanded when the sysctl(8) variable
vfs.generic.magiclinks is set to 1.

I've referred to sysctl(8) rather than sysctl(3) because that's a more
useful page for someone who is in the middle of making magic symlinks
work.

>Release-Note:

>Audit-Trail:
From: David Holland <dholland-bugs@netbsd.org>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: bin/36947: symlink(7) refers to MNT_MAGICLINKS instead if sysctl
Date: Sun, 20 Jan 2008 04:54:00 +0000

 This was fixed in -r1.13 of symlink.7, but as far as I can tell the
 fix hasn't been pulled up to netbsd-4 yet, and it probably should be.

 -- 
 David A. Holland
 dholland@netbsd.org

From: dieter roelants <dieter.NetBSD@pandora.be>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: bin/36947: symlink(7) refers to MNT_MAGICLINKS instead if
 sysctl
Date: Sun, 20 Jan 2008 12:04:58 +0100

 On Sun, 20 Jan 2008 04:55:02 +0000 (UTC)
 David Holland <dholland-bugs@netbsd.org> wrote:

 >  This was fixed in -r1.13 of symlink.7, but as far as I can tell the
 >  fix hasn't been pulled up to netbsd-4 yet, and it probably should be.

 statvfs(5) should also be adapted; it still documents ST_MAGICLINKS

 dieter

From: "David A. Holland" <dholland@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/36947 CVS commit: src/share/man/man5
Date: Mon, 23 Jun 2008 04:22:36 +0000 (UTC)

 Module Name:	src
 Committed By:	dholland
 Date:		Mon Jun 23 04:22:36 UTC 2008

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

 Log Message:
 Remove description of ST_MAGICLINKS; it went away a long time ago.
 From PR 36947.


 To generate a diff of this commit:
 cvs rdiff -r1.9 -r1.10 src/share/man/man5/statvfs.5

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

Responsible-Changed-From-To: bin-bug-people->dholland
Responsible-Changed-By: dholland@NetBSD.org
Responsible-Changed-When: Sun, 30 Nov 2008 23:14:08 +0000
Responsible-Changed-Why:
I've been handling it.


State-Changed-From-To: open->pending-pullups
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Sun, 30 Nov 2008 23:14:08 +0000
State-Changed-Why:
pullup-4 #1244 filed.


From: Soren Jacobsen <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/36947 CVS commit: [netbsd-4] src/share/man/man5
Date: Sun, 30 Nov 2008 23:57:22 +0000 (UTC)

 Module Name:	src
 Committed By:	snj
 Date:		Sun Nov 30 23:57:22 UTC 2008

 Modified Files:
 	src/share/man/man5 [netbsd-4]: statvfs.5

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #1244):
 	share/man/man5/statvfs.5: revision 1.10
 Remove description of ST_MAGICLINKS; it went away a long time ago.
 From PR 36947.


 To generate a diff of this commit:
 cvs rdiff -r1.9 -r1.9.6.1 src/share/man/man5/statvfs.5

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

State-Changed-From-To: pending-pullups->closed
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Mon, 01 Dec 2008 05:26:06 +0000
State-Changed-Why:
Fixed, and finally pulled up to -4.


>Unformatted:

Home	PR Database Search