From owner-freebsd-doc@FreeBSD.ORG  Fri Oct 14 23:30:04 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 193001065672
	for <freebsd-doc@hub.freebsd.org>; Fri, 14 Oct 2011 23:30:04 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id D16778FC1B
	for <freebsd-doc@hub.freebsd.org>; Fri, 14 Oct 2011 23:30:03 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p9ENU3QG039924
	for <freebsd-doc@freefall.freebsd.org>; Fri, 14 Oct 2011 23:30:03 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p9ENU35h039923;
	Fri, 14 Oct 2011 23:30:03 GMT (envelope-from gnats)
Resent-Date: Fri, 14 Oct 2011 23:30:03 GMT
Resent-Message-Id: <201110142330.p9ENU35h039923@freefall.freebsd.org>
Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer)
Resent-To: freebsd-doc@FreeBSD.org
Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org,
	Jeremy Huddleston <jeremyhu@apple.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 89CE7106564A
	for <freebsd-gnats-submit@FreeBSD.org>;
	Fri, 14 Oct 2011 23:24:20 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 7A1368FC0C
	for <freebsd-gnats-submit@FreeBSD.org>;
	Fri, 14 Oct 2011 23:24:20 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p9ENOKWB067797
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 14 Oct 2011 23:24:20 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p9ENOKvF067791;
	Fri, 14 Oct 2011 23:24:20 GMT (envelope-from nobody)
Message-Id: <201110142324.p9ENOKvF067791@red.freebsd.org>
Date: Fri, 14 Oct 2011 23:24:20 GMT
From: Jeremy Huddleston <jeremyhu@apple.com>
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-3.1
Cc: 
Subject: docs/161673: mkdir(2) doesn't discuss EISDIR
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
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: Fri, 14 Oct 2011 23:30:04 -0000


>Number:         161673
>Category:       docs
>Synopsis:       mkdir(2) doesn't discuss EISDIR
>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:   Fri Oct 14 23:30:03 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Jeremy Huddleston
>Release:        8.1
>Organization:
Apple Inc
>Environment:
FreeBSD freebsd8.apple.com 8.1-RELEASE FreeBSD 8.1-RELEASE #0: Mon Jul 19 02:36:49 UTC 2010     root@mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  amd64

>Description:
mkdir(2) can set errno to EISDIR, but the man page does not discuss this.  You can use mkdir(1) to see this:

$ mkdir /
mkdir: /: Is a directory
$ mkdir /var
mkdir: /var: File exists

>How-To-Repeat:
$ mkdir /
mkdir: /: Is a directory
$ mkdir /var
mkdir: /var: File exists

>Fix:
I would expect EEXIST to be returned for /, but EISDIR was set instead.  I guess either update documentation or change the syscall to return EEXIST instead.

>Release-Note:
>Audit-Trail:
>Unformatted: