From seggers@semyam.dinoco.de  Sun Jul  5 04:08:40 1998
Received: from tim.xenologics.com (tim.xenologics.com [194.77.5.24])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id EAA25296
          for <FreeBSD-gnats-submit@freebsd.org>; Sun, 5 Jul 1998 04:08:37 -0700 (PDT)
          (envelope-from seggers@semyam.dinoco.de)
Received: (from uucp@localhost)
	by tim.xenologics.com (8.8.5/8.8.8) with UUCP id NAA09494
	for FreeBSD-gnats-submit@freebsd.org; Sun, 5 Jul 1998 13:07:43 +0200 (MET DST)
Received: (from seggers@localhost)
	by semyam.dinoco.de (8.8.8/8.8.8) id MAA04994;
	Sun, 5 Jul 1998 12:39:40 +0200 (CEST)
	(envelope-from seggers)
Message-Id: <199807051039.MAA04994@semyam.dinoco.de>
Date: Sun, 5 Jul 1998 12:39:40 +0200 (CEST)
From: Stefan Eggers <seggers@semyam.dinoco.de>
Reply-To: seggers@semyam.dinoco.de
To: FreeBSD-gnats-submit@freebsd.org
Cc: seggers@semyam.dinoco.de
Subject: Explain confusing mount behavior in man pages
X-Send-Pr-Version: 3.2

>Number:         7172
>Category:       docs
>Synopsis:       [PATCH] Explain confusing mount behavior in man pages
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul  5 04:10:01 PDT 1998
>Closed-Date:    Wed Jul 8 22:48:03 PDT 1998
>Last-Modified:  Wed Jul  8 22:51:39 PDT 1998
>Originator:     Stefan Eggers
>Release:        FreeBSD 2.2.6-STABLE i386
>Organization:
none
>Environment:

	2.2-stable

>Description:

	Mounting on a directory with permissions 0700 leads to the
links . and .. in the mounted filesystem to be inaccessible to non-
owners.  This is confusing and should have been documented in the
mount man pages.

>How-To-Repeat:

	Try such a mount and then as a mere user try accessing .. in
the newly mounted filesystem.  Have fun.

>Fix:
	
	Here are patches for mount(2) and mount(8) which add some
explanation under BUGS.  I think that's the appropriate place as it
can't be the intended one.

Index: mount.2
===================================================================
RCS file: /usr2/FreeBSD/CVSROOT/src/lib/libc/sys/mount.2,v
retrieving revision 1.2.2.6
diff -u -r1.2.2.6 mount.2
--- mount.2	1997/08/19 23:48:10	1.2.2.6
+++ mount.2	1998/07/05 10:35:12
@@ -435,6 +435,10 @@
 .Xr umount 8
 .Sh BUGS
 Some of the error codes need translation to more obvious messages.
+.Pp
+Mounting on a node with too restrictive permissions leads to . and ..
+within the mounted filesystem to be inaccessible.  For a filesystem
+accessible to everyone use 0755.
 .Sh HISTORY
 .Fn Mount
 and

Index: mount.8
===================================================================
RCS file: /usr2/FreeBSD/CVSROOT/src/sbin/mount/mount.8,v
retrieving revision 1.11.2.3
diff -u -r1.11.2.3 mount.8
--- mount.8	1997/12/01 00:47:09	1.11.2.3
+++ mount.8	1998/07/05 10:33:09
@@ -314,6 +314,10 @@
 .Xr umount 8
 .Sh BUGS
 It is possible for a corrupted file system to cause a crash.
+.Pp
+Mounting on a node with too restrictive permissions leads to . and ..
+within the mounted filesystem to be inaccessible.  For a filesystem
+accessible to everyone use 0755.
 .Sh HISTORY
 A
 .Nm mount
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->suspended 
State-Changed-By: phk 
State-Changed-When: Tue Jul 7 02:51:30 PDT 1998 
State-Changed-Why:  
awaiting committer 
State-Changed-From-To: suspended->closed 
State-Changed-By: jkoshy 
State-Changed-When: Wed Jul 8 22:48:03 PDT 1998 
State-Changed-Why:  
Fixed in rev 1.23 of "mount.8", thanks!  I felt mount(8) was a more 
appropriate place for this doc path than mount(2). 
>Unformatted:
