From owner-freebsd-doc@FreeBSD.ORG  Wed Jul  9 19:20:04 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 5570D37B401
	for <freebsd-doc@hub.freebsd.org>;
	Wed,  9 Jul 2003 19:20:04 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id EDEA843F85
	for <freebsd-doc@hub.freebsd.org>;
	Wed,  9 Jul 2003 19:20:03 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h6A2K3Up082461
	for <freebsd-doc@freefall.freebsd.org>;
	Wed, 9 Jul 2003 19:20:03 -0700 (PDT)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h6A2K3hk082460;
	Wed, 9 Jul 2003 19:20:03 -0700 (PDT)
Date: Wed, 9 Jul 2003 19:20:03 -0700 (PDT)
Message-Id: <200307100220.h6A2K3hk082460@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Soren Spies <sspies@apple.com>
Subject: Re: docs/39530: access(2) man page has unnecessarily broad warning
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Soren Spies <sspies@apple.com>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 10 Jul 2003 02:20:04 -0000

The following reply was made to PR docs/39530; it has been noted by GNATS.

From: Soren Spies <sspies@apple.com>
To: freebsd-gnats-submit@FreeBSD.org, Soren Spies <sspies@apple.com>
Cc:  
Subject: Re: docs/39530: access(2) man page has unnecessarily broad warning
Date: Wed, 9 Jul 2003 19:16:58 -0700

 I've noticed in FreeBSD 5.1 that we have eaccess(2) as well as a much 
 better warning in the man page (explaining the tradeoffs, but still 
 saying "never").
 
 I propose the following patch:
 diff -u access.2.orig access.2
 --- access.2.orig       Wed Jul  9 17:16:34 2003
 +++ access.2    Wed Jul  9 17:23:46 2003
 @@ -144,6 +144,15 @@
   .Fn eaccess
   system call
   likewise may be subject to races if used inappropriately.
 +.Pp
 +.Fn access
 +remains useful for providing clues to users as to whether operations
 +make sense for particular filesystem objects (e.g. 'delete' menu
 +item only highlighted in a writable folder ... avoiding interpretation
 +of the st_mode bits that the application might not understand --
 +e.g. in the case of AFS).  It also allows a cheaper file existance
 +test than
 +.Ns Xr stat 2 .
   .Sh SEE ALSO
   .Xr chmod 2 ,
   .Xr intro 2 ,
 
 
 
 --
 Soren Spies
 Apple Computer, Inc.