From owner-freebsd-doc  Sat Jun 30 13:30: 7 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id E556737B408
	for <freebsd-doc@freebsd.org>; Sat, 30 Jun 2001 13:30:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.3/8.11.3) id f5UKU1Z73584;
	Sat, 30 Jun 2001 13:30:01 -0700 (PDT)
	(envelope-from gnats)
Received: from segfault.monkeys.com (236.dsl9226.surewest.net [63.92.26.236])
	by hub.freebsd.org (Postfix) with ESMTP id 35C2637B405
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 30 Jun 2001 13:24:14 -0700 (PDT)
	(envelope-from rfg@monkeys.com)
Received: by segfault.monkeys.com (Postfix, from userid 1237)
	id AFDAA4DA76; Sat, 30 Jun 2001 13:24:13 -0700 (PDT)
Message-Id: <20010630202413.AFDAA4DA76@segfault.monkeys.com>
Date: Sat, 30 Jun 2001 13:24:13 -0700 (PDT)
From: rfg@monkeys.com
Reply-To: rfg@monkeys.com
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/28553: EACCES result for mkdir(2) not completely documented
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         28553
>Category:       docs
>Synopsis:       EACCES result for mkdir(2) not completely documented
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 30 13:30:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 4.2-RELEASE i386
>Organization:
Infinite Monkeys & co.
>Environment:


>Description:

	The ERRORS section of the man page for mkdir(2) fails to mention
	that mkdir(2) will fail, return a -1, and yield an EACCES errno
	result when and if the user executing the call to mkdir(2) lacks
	write permission for the directory that would contain the directory
	to be created.

>How-To-Repeat:

	man 2 mkdir

>Fix:

	Change the [EACCES] part of the errors section to read as follows:

	[EACCES]	Search permission is denied for a component of the
			path prefix, or write permission is denied for the
			directory that would immediately contain the new
			directory to be created.
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message