summaryrefslogtreecommitdiffstats
path: root/lib/libc/gen/utime.3
diff options
context:
space:
mode:
authorjilles <jilles@FreeBSD.org>2016-06-09 22:14:58 +0000
committerjilles <jilles@FreeBSD.org>2016-06-09 22:14:58 +0000
commit563b27479d0b1c0ffa26232b3d397e3ef0124590 (patch)
tree8a65cd6c77bd6b3ec0d93048a55612c09f6fdad3 /lib/libc/gen/utime.3
parent7e85cd3717a06b98f2acad2c3fc5fd8384a929ef (diff)
downloadFreeBSD-src-563b27479d0b1c0ffa26232b3d397e3ef0124590.zip
FreeBSD-src-563b27479d0b1c0ffa26232b3d397e3ef0124590.tar.gz
utimes(2),utime(3): Add deprecation in favour of utimensat(2) and futimens(2).
Setting time by seconds or microseconds may cause unexpected effects especially if sysctl vfs.timestamp_precision=3 (not default). Calling the obsolete functions with NULL timestamps is acceptable.
Diffstat (limited to 'lib/libc/gen/utime.3')
-rw-r--r--lib/libc/gen/utime.36
1 files changed, 4 insertions, 2 deletions
diff --git a/lib/libc/gen/utime.3 b/lib/libc/gen/utime.3
index 1951613..20c7916 100644
--- a/lib/libc/gen/utime.3
+++ b/lib/libc/gen/utime.3
@@ -28,7 +28,7 @@
.\" @(#)utime.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
-.Dd June 4, 1993
+.Dd June 9, 2016
.Dt UTIME 3
.Os
.Sh NAME
@@ -43,7 +43,8 @@
.Sh DESCRIPTION
.Bf -symbolic
This interface is obsoleted by
-.Xr utimes 2 .
+.Xr utimensat 2
+because it is not accurate to fractions of a second.
.Ef
.Pp
The
@@ -79,6 +80,7 @@ for any of the errors specified for the library function
.Xr utimes 2 .
.Sh SEE ALSO
.Xr stat 2 ,
+.Xr utimensat 2 ,
.Xr utimes 2
.Sh STANDARDS
The
OpenPOWER on IntegriCloud