From owner-svn-src-all@FreeBSD.ORG  Wed May  5 22:17:18 2010
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 4FA7B106564A;
	Wed,  5 May 2010 22:17:18 +0000 (UTC)
	(envelope-from jilles@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [69.147.83.44])
	by mx1.freebsd.org (Postfix) with ESMTP id 3DEEF8FC08;
	Wed,  5 May 2010 22:17:18 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id o45MHHgW080007;
	Wed, 5 May 2010 22:17:17 GMT (envelope-from jilles@svn.freebsd.org)
Received: (from jilles@localhost)
	by svn.freebsd.org (8.14.3/8.14.3/Submit) id o45MHHsT080005;
	Wed, 5 May 2010 22:17:17 GMT (envelope-from jilles@svn.freebsd.org)
Message-Id: <201005052217.o45MHHsT080005@svn.freebsd.org>
From: Jilles Tjoelker <jilles@FreeBSD.org>
Date: Wed, 5 May 2010 22:17:17 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
	svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org
X-SVN-Group: stable-8
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r207684 - stable/8/lib/libc/gen
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
	user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 05 May 2010 22:17:18 -0000

Author: jilles
Date: Wed May  5 22:17:17 2010
New Revision: 207684
URL: http://svn.freebsd.org/changeset/base/207684

Log:
  MFC r206760: getcwd(3): Clarify that EACCES may or may not be checked.
  
  POSIX permits but does not require checking access on the current and parent
  directories.
  
  Because various programs do not like it if getcwd(3) fails, it seems best
  to avoid checking access as much as possible. There are various reports in
  GNATS about this (search for getcwd).
  
  Our getcwd(3) implementation first queries the kernel for the pathname
  directly, which does not check any permissions but sometimes fails, and then
  falls back to reading all parent directories for the names.
  
  PR:		standards/44425

Modified:
  stable/8/lib/libc/gen/getcwd.3
Directory Properties:
  stable/8/lib/libc/   (props changed)
  stable/8/lib/libc/stdtime/   (props changed)

Modified: stable/8/lib/libc/gen/getcwd.3
==============================================================================
--- stable/8/lib/libc/gen/getcwd.3	Wed May  5 22:15:20 2010	(r207683)
+++ stable/8/lib/libc/gen/getcwd.3	Wed May  5 22:17:17 2010	(r207684)
@@ -28,7 +28,7 @@
 .\"     @(#)getcwd.3	8.2 (Berkeley) 12/11/93
 .\" $FreeBSD$
 .\"
-.Dd November 24, 1997
+.Dd April 17, 2010
 .Dt GETCWD 3
 .Os
 .Sh NAME
@@ -108,8 +108,6 @@ The
 function
 will fail if:
 .Bl -tag -width Er
-.It Bq Er EACCES
-Read or search permission was denied for a component of the pathname.
 .It Bq Er EINVAL
 The
 .Fa size
@@ -124,6 +122,16 @@ The
 argument is greater than zero but smaller than the length of the pathname
 plus 1.
 .El
+.Pp
+The
+.Fn getcwd
+function
+may fail if:
+.Bl -tag -width Er
+.It Bq Er EACCES
+Read or search permission was denied for a component of the pathname.
+This is only checked in limited cases, depending on implementation details.
+.El
 .Sh SEE ALSO
 .Xr chdir 2 ,
 .Xr fchdir 2 ,