Module Name: src
Committed By: njoly
Date: Mon Jul 29 14:34:59 UTC 2013
Modified Files:
src/lib/libc/sys: utimes.2
Log Message:
Add utimensat(2) specific errors.
To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.38 src/lib/libc/sys/utimes.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/utimes.2
diff -u src/lib/libc/sys/utimes.2:1.37 src/lib/libc/sys/utimes.2:1.38
--- src/lib/libc/sys/utimes.2:1.37 Fri Mar 8 16:52:11 2013
+++ src/lib/libc/sys/utimes.2 Mon Jul 29 14:34:59 2013
@@ -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 set the current time, or to
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 @@ does not match the owner of the file and
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
