poll tests: Avoid test failure on BSD and Solaris systems.
[gnulib.git] / doc / posix-functions / fchownat.texi
blob530afea11b0aaa4550279103eae11db7665474a9
1 @node fchownat
2 @section @code{fchownat}
3 @findex fchownat
5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/fchownat.html}
7 Gnulib module: fchownat
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, Cygwin 1.5.x, mingw, MSVC 14.
15 But the replacement function is not safe to be used in libraries and
16 is not multithread-safe.  Also, the replacement may fail to change
17 symlinks if @code{lchown} is unsupported, or fail altogether if
18 @code{chown} is unsupported.
19 @item
20 This function is declared in @code{<sys/stat.h>}, not in @code{<unistd.h>},
21 on some platforms:
22 Android 4.3.
23 @item
24 Some platforms fail to detect trailing slash on non-directories, as in
25 @code{fchown(dir,"link-to-file/",uid,gid,flag)}:
26 Solaris 9.
27 @item
28 Some platforms mistakenly dereference symlinks when using
29 @code{AT_SYMLINK_NOFOLLOW}:
30 Linux kernel 2.6.17.
31 @item
32 This function does not fail for an empty filename on some platforms:
33 Linux with glibc < 2.11.
34 @end itemize
36 Portability problems not fixed by Gnulib:
37 @itemize
38 @end itemize