c_cpp/lib/gnulib/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 Minix 3.1.8, mingw, MSVC 9, Interix 3.5, BeOS.
  18 @item
  19 The declaration of this function lacks @code{const} in the second argument
  20 on some platforms:
  21 OSF/1 5.1.
  22 @item
  23 On some platforms, this function mis-handles trailing slash:
  24 FreeBSD 7.2, Solaris 9.
  25 @item
  26 This function cannot set full timestamp resolution.  In particular,
  27 some platforms incorrectly round rather than truncate.  Use
  28 @code{utimensat(AT_FDCWD,file,times,0)}, or the gnulib module utimens,
  29 instead.
  30 @item
  31 On some platforms, @code{utimes (file, NULL)} fails to set the
  32 file's timestamp to the current time:
  33 glibc 2.3.3.
  34 @item
  35 On some platforms, @code{utimes} failed on read-only files when
  36 @code{utime} worked fine.
  37 glibc 2.2.5.
  38 @end itemize
  39
  40 Extension: Gnulib provides a module @samp{utimens} that works around these
  41 problems and allows to set the time with nanosecond resolution (as far as
  42 supported by the file system).