[src/trunk]: src/lib/libc/sys Add utimensat(2) specific errors.

[njoly <njoly%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f12b227362f7
branches:  trunk
changeset: 788927:f12b227362f7
user:      njoly <njoly%NetBSD.org@localhost>
date:      Mon Jul 29 14:34:59 2013 +0000

description:
Add utimensat(2) specific errors.

diffstat:

 lib/libc/sys/utimes.2 |  27 +++++++++++++++++++++------
 1 files changed, 21 insertions(+), 6 deletions(-)

diffs (55 lines):

diff -r 8308a0e03a1e -r f12b227362f7 lib/libc/sys/utimes.2
--- a/lib/libc/sys/utimes.2     Mon Jul 29 13:15:24 2013 +0000
+++ b/lib/libc/sys/utimes.2     Mon Jul 29 14:34:59 2013 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: utimes.2,v 1.37 2013/03/08 16:52:11 christos Exp $
+.\"    $NetBSD: utimes.2,v 1.38 2013/07/29 14:34:59 njoly Exp $
 .\"
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)utimes.2   8.1 (Berkeley) 6/4/93
 .\"
-.Dd March 8, 2013
+.Dd July 19, 2013
 .Dt UTIMES 2
 .Os
 .Sh NAME
@@ -167,10 +167,7 @@
 to let the time unchanged (this allows changing access time but not
 modification time, and vice-versa).
 .Sh RETURN VALUES
-Upon successful completion, a value of 0 is returned.
-Otherwise, a value of \-1 is returned and
-.Va errno
-is set to indicate the error.
+.Rv -std utimes lutimes futimes utimens lutimens futimens utimensat
 .Sh ERRORS
 .Fn utimes ,
 .Fn lutimes ,
@@ -219,6 +216,24 @@
 The file system containing the file is mounted read-only.
 .El
 .Pp
+In addition,
+.Fn utimensat
+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
+.Pp
 .Fn futimes
 and
 .Fn futimens