Module Name:    src
Committed By:   njoly
Date:           Sun Jul 28 14:38:25 UTC 2013

Modified Files:
        src/lib/libc/sys: mkdir.2

Log Message:
Add mkdirat(2) specific errors.


To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/lib/libc/sys/mkdir.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/mkdir.2
diff -u src/lib/libc/sys/mkdir.2:1.27 src/lib/libc/sys/mkdir.2:1.28
--- src/lib/libc/sys/mkdir.2:1.27	Sun Jan 13 08:15:02 2013
+++ src/lib/libc/sys/mkdir.2	Sun Jul 28 14:38:25 2013
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mkdir.2,v 1.27 2013/01/13 08:15:02 dholland Exp $
+.\"	$NetBSD: mkdir.2,v 1.28 2013/07/28 14:38:25 njoly Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)mkdir.2	8.2 (Berkeley) 12/11/93
 .\"
-.Dd November 18, 2012
+.Dd July 28, 2013
 .Dt MKDIR 2
 .Os
 .Sh NAME
@@ -83,11 +83,12 @@ The directory's owner ID is set to the p
 The directory's group ID is set to that of the parent directory in
 which it is created.
 .Sh RETURN VALUES
-A 0 return value indicates success.
-A \-1 return value indicates an error, and an error code is stored in
-.Va errno .
+.Rv -std mkdir mkdirat
 .Sh ERRORS
+Both
 .Fn mkdir
+and
+.Fn mkdirat
 will fail and no directory will be created if:
 .Bl -tag -width Er
 .It Bq Er EACCES
@@ -126,6 +127,24 @@ A component of the path prefix is not a 
 .It Bq Er EROFS
 The named file resides on a read-only file system.
 .El
+.Pp
+In addition,
+.Fn mkdirat
+will fail if:
+.Bl -tag -width Er
+.It Bq Er EBADF
+.Fa path
+does not specify an absolute path and
+.Fa fd
+is neither
+.Dv AT_FDCWD
+nor a valid file descriptor open for reading or searching.
+.It Bq Er ENOTDIR
+.Fa path
+is not an absolute path and
+.Fa fd
+is a file descriptor associated with a non-directory file.
+.El
 .Sh SEE ALSO
 .Xr chmod 2 ,
 .Xr stat 2 ,

Reply via email to