summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthew Dempsky <matthew@cvs.openbsd.org>2011-07-19 03:37:41 +0000
committerMatthew Dempsky <matthew@cvs.openbsd.org>2011-07-19 03:37:41 +0000
commit1b85a3020c4a4665b20e5e1c5d4a03c749dd5db2 (patch)
treee5c8a6d82f6785d602c6739ac85117fcbb87d4f5
parent35079cc1e8f038dc53a700df6b690ac8b2552f03 (diff)
document that we don't currently handle UTIME_OMIT correctly for the mtime timestamp
-rw-r--r--lib/libc/sys/utimes.217
1 files changed, 15 insertions, 2 deletions
diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2
index d2823928452..d81e7ede94d 100644
--- a/lib/libc/sys/utimes.2
+++ b/lib/libc/sys/utimes.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: utimes.2,v 1.12 2011/07/18 23:21:19 matthew Exp $
+.\" $OpenBSD: utimes.2,v 1.13 2011/07/19 03:37:40 matthew Exp $
.\" $NetBSD: utimes.2,v 1.9 1996/04/23 10:34:16 mycroft Exp $
.\"
.\" Copyright (c) 1990, 1993
@@ -30,7 +30,7 @@
.\"
.\" @(#)utimes.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: July 18 2011 $
+.Dd $Mdocdate: July 19 2011 $
.Dt UTIMES 2
.Os
.Sh NAME
@@ -260,3 +260,16 @@ and
.Fn futimens
function calls appeared in
.Ox 5.0 .
+.Sh CAVEATS
+.St -p1003.1-2008
+specifies that
+.Fn utimensat
+and
+.Fn futimens
+shall mark the last file status change timestamp (i.e.,
+.Fa st_ctim )
+for update upon successful completion.
+However, currently some filesystems (e.g., UFS)
+will not do so if
+.Dv UTIME_OMIT
+specified for the modification timestamp argument.