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