cfd8fd315fbc76b95820ba4cda8b7da80f5969a9
[gnulib.git] / doc / posix-functions / utimes.texi
1 @node utimes
2 @section @code{utimes}
3 @findex utimes
4
5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/utimes.html}
6
7 Gnulib module: ---
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @end itemize
12
13 Portability problems not fixed by Gnulib:
14 @itemize
15 @item
16 This function is missing on some platforms:
17 mingw, Interix 3.5, BeOS.
18 @item
19 On some platforms, this function mis-handles trailing slash:
20 FreeBSD 7.2, Solaris 9.
21 @item
22 This function cannot set full timestamp resolution.  In particular,
23 some platforms incorrectly round rather than truncate.  Use
24 @code{utimensat(AT_FDCWD,file,times,0)}, or the gnulib module utimens,
25 instead.
26 @item
27 On some platforms, @code{utimes (file, NULL)} fails to set the
28 file's timestamp to the current time:
29 glibc 2.3.3.
30 @item
31 On some platforms, @code{utimes} failed on read-only files when
32 @code{utime} worked fine.
33 glibc 2.2.5.
34 @end itemize