+2025-01-10 Paul Eggert <eggert@cs.ucla.edu>
+
+ doc: document some file system portability issues
+ * doc/glibc-functions/flistxattr.texi:
+ * doc/glibc-functions/listxattr.texi:
+ * doc/glibc-functions/llistxattr.texi:
+ * doc/posix-functions/fchdir.texi, doc/posix-functions/fstat.texi:
+ * doc/posix-functions/fstatvfs.texi:
+ Document some portability gotchas that Gnulib does not work around.
+
2025-01-10 Bruno Haible <bruno@clisp.org>
gitlog-to-changelog: Recommend more reliable Makefile rule idiom.
@item
This function has an extra @code{options} parameter on some platforms:
macOS 14.
+@item
+This function fails with @code{EACCES} on unreadable files accessed via NFS:
+Linux kernel 6.12.
@end itemize
@item
This function has an extra @code{options} parameter on some platforms:
macOS 14.
+@item
+This function fails with @code{EACCES} on unreadable files accessed via NFS:
+Linux kernel 6.12.
@end itemize
@item
This function is missing on many non-glibc platforms:
macOS 14, FreeBSD 14.0, NetBSD 5.0, OpenBSD 7.5, Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 11.4, Cygwin 1.5.x, mingw, MSVC 14, Android 4.0.4.
+@item
+This function fails with @code{EACCES} on unreadable files accessed via NFS:
+Linux kernel 6.12.
@end itemize
Portability problems not fixed by Gnulib:
@itemize
+@item
+This function fails if the file descriptor was opened with @code{O_PATH}:
+Linux kernel 3.4.
@end itemize
@item
@xref{sys/stat.h}, for general portability problems with @code{struct stat}.
@item
+This function fails if the file descriptor was opened with @code{O_PATH}:
+Linux kernel 3.5.
+@item
On Cygwin, @code{fstat} applied to the file descriptors 0 and 1, returns
different @code{st_ino} values, even if standard input and standard output
are not redirected and refer to the same terminal.
@item
This function is missing on some platforms:
OpenBSD 3.8, mingw, MSVC 14, Android 4.3.
+@item
+This function fails if the file descriptor was opened with @code{O_PATH}:
+Linux kernel 3.11.
@end itemize