c_cpp/lib/gnulib/doc/posix-functions/futimens.texi

   1 @node futimens
   2 @section @code{futimens}
   3 @findex futimens
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/futimens.html}
   6
   7 Gnulib module: futimens
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 This function is missing on some platforms:
  13 glibc 2.3.6, Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8,
  14 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, MSVC 9,
  15 Interix 3.5, BeOS.
  16 However, the replacement function may end up truncating timestamps to
  17 less resolution than supported by the file system.
  18 @item
  19 This function returns a bogus value instead of failing with
  20 @code{ENOSYS} on some platforms:
  21 Linux kernel 2.6.21.
  22 @item
  23 When using @code{UTIME_OMIT} or @code{UTIME_NOW}, some systems require
  24 the @code{tv_sec} argument to be 0, and don't necessarily handle all
  25 file permissions in the manner required by POSIX:
  26 Linux kernel 2.6.25.
  27 @item
  28 When using @code{UTIME_OMIT} for the modification time, but specifying
  29 an access time, some systems fail to update the change time:
  30 Linux kernel 2.6.32, Solaris 11.1.
  31 @item
  32 Passing @code{AT_FDCWD} as the fd argument does not properly fail with
  33 @code{EBADF} on some systems:
  34 glibc 2.11, Solaris 11.
  35 @end itemize
  36
  37 Portability problems not fixed by Gnulib:
  38 @itemize
  39 @item
  40 Some platforms lack the ability to change the timestamps of a file
  41 descriptor, so the replacement can fail with @code{ENOSYS}; the gnulib
  42 module @samp{utimens} provides a more reliable interface @code{fdutimens}.
  43 @item
  44 The mere act of using @code{stat} modifies the access time of
  45 directories on some platforms, so @code{utimensat} can only
  46 effectively change directory modification time:
  47 Cygwin 1.5.x.
  48 @end itemize