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 ,