1434033ead90f8c556c42dec5021b49d7b60ff7f
[gnulib.git] / 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, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
14 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
15 Interix 3.5, BeOS.
16 @item
17 This function returns a bogus value instead of failing with
18 @code{ENOSYS} on some platforms:
19 Linux kernel 2.6.21.
20 @item
21 When using @code{UTIME_OMIT} or @code{UTIME_NOW}, some systems require
22 the @code{tv_sec} argument to be 0, and don't necessarily handle all
23 file permissions in the manner required by POSIX:
24 Linux kernel 2.6.25.
25 @end itemize
26
27 Portability problems not fixed by Gnulib:
28 @itemize
29 @item
30 Some platforms lack the ability to change the timestamps of a file
31 descriptor, so the replacement can fail with @code{ENOSYS}; the gnulib
32 module @samp{utimens} provides a more reliable interface @code{gl_futimens}.
33 @end itemize