* 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.
---
ChangeLog | 10 ++++++++++
doc/glibc-functions/flistxattr.texi | 3 +++
doc/glibc-functions/listxattr.texi | 3 +++
doc/glibc-functions/llistxattr.texi | 3 +++
doc/posix-functions/fchdir.texi | 3 +++
doc/posix-functions/fstat.texi | 3 +++
doc/posix-functions/fstatvfs.texi | 3 +++
7 files changed, 28 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index f56e8d02ba..d33a584ad8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2025-01-10 Paul Eggert <egg...@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 <br...@clisp.org>
gitlog-to-changelog: Recommend more reliable Makefile rule idiom.
diff --git a/doc/glibc-functions/flistxattr.texi
b/doc/glibc-functions/flistxattr.texi
index e84b033ec6..04d2b70fc4 100644
--- a/doc/glibc-functions/flistxattr.texi
+++ b/doc/glibc-functions/flistxattr.texi
@@ -18,4 +18,7 @@ FreeBSD 14.0, NetBSD 5.0, OpenBSD 7.5, Minix 3.1.8, AIX 5.1,
HP-UX 11, Solaris 1
@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
diff --git a/doc/glibc-functions/listxattr.texi
b/doc/glibc-functions/listxattr.texi
index 9a678c9e91..0eb8216a58 100644
--- a/doc/glibc-functions/listxattr.texi
+++ b/doc/glibc-functions/listxattr.texi
@@ -18,4 +18,7 @@ FreeBSD 14.0, NetBSD 5.0, OpenBSD 7.5, Minix 3.1.8, AIX 5.1,
HP-UX 11, Solaris 1
@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
diff --git a/doc/glibc-functions/llistxattr.texi
b/doc/glibc-functions/llistxattr.texi
index 6667f24c76..3d2a74f9fb 100644
--- a/doc/glibc-functions/llistxattr.texi
+++ b/doc/glibc-functions/llistxattr.texi
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
@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
diff --git a/doc/posix-functions/fchdir.texi b/doc/posix-functions/fchdir.texi
index af85162392..890c18f5f9 100644
--- a/doc/posix-functions/fchdir.texi
+++ b/doc/posix-functions/fchdir.texi
@@ -17,4 +17,7 @@ But the replacement function is not safe to be used in
libraries and is not mult
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
diff --git a/doc/posix-functions/fstat.texi b/doc/posix-functions/fstat.texi
index c17c0b41d3..ce6a9d5079 100644
--- a/doc/posix-functions/fstat.texi
+++ b/doc/posix-functions/fstat.texi
@@ -39,6 +39,9 @@ Portability problems not fixed by Gnulib:
@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.
diff --git a/doc/posix-functions/fstatvfs.texi
b/doc/posix-functions/fstatvfs.texi
index 602795ad53..c75f5bf989 100644
--- a/doc/posix-functions/fstatvfs.texi
+++ b/doc/posix-functions/fstatvfs.texi
@@ -20,4 +20,7 @@ Portability problems not fixed by Gnulib:
@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
--
2.45.2
