7ffffc7890c9011025c9ef66823f28e0e656910a
[gnulib.git] / doc / posix-functions / utime.texi
1 @node utime
2 @section @code{utime}
3 @findex utime
4
5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/utime.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 On some old platforms (Sequent), @code{utime (file, NULL)} fails to set the
17 file's timestamp to the current time.
18 @item
19 On some platforms, this function mis-handles trailing slash:
20 Solaris 9.
21 @item
22 This function cannot set full timestamp resolution.  Use
23 @code{utimensat(AT_FDCWD,file,times,0)}, or the gnulib module utimens,
24 instead.
25 @item
26 On some platforms, the prototype for @code{utime} omits @code{const}
27 for the second argument.  Fortunately, the argument is not modified,
28 so it is safe to cast away const:
29 mingw.
30 @end itemize