doc: mention timestamp portability issues
[pspp] / 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 This function cannot set full timestamp resolution.  In particular,
20 some platforms incorrectly round rather than truncate.  Use
21 @code{utimensat(AT_FDCWD,file,times,0)} instead.
22 @item
23 On some platforms, @code{utimes (file, NULL)} fails to set the
24 file's timestamp to the current time:
25 glibc 2.3.3.
26 @item
27 On some platforms, @code{utimes} failed on read-only files when
28 @code{utime} worked fine.
29 glibc 2.2.5.
30 @end itemize