]> Savannah Git Hosting - gnulib.git/commitdiff
doc: document some file system portability issues
authorPaul Eggert <eggert@cs.ucla.edu>
Fri, 10 Jan 2025 18:34:58 +0000 (10:34 -0800)
committerPaul Eggert <eggert@cs.ucla.edu>
Fri, 10 Jan 2025 18:35:19 +0000 (10:35 -0800)
* 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
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

index f56e8d02ba882a0912e152399673c5e11ff6f01e..d33a584ad8e139f2cdba8625decae730421a00f4 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+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.
index e84b033ec69c5e3655e5feb6d1d8cbd6c00232b5..04d2b70fc4a5f6a3673258bfd19f905dd0efeb65 100644 (file)
@@ -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
index 9a678c9e91e5245acedc42d43c98663248078dfd..0eb8216a58d904f71285786e750763678cd12e07 100644 (file)
@@ -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
index 6667f24c76c2f6204929c9eda2310e43559d4f6f..3d2a74f9fb55556a62777714e846560312b0525d 100644 (file)
@@ -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
index af85162392c689d58e5cab21d1cf948ce6614620..890c18f5f9a0fe3326d3ae019a879330303e495c 100644 (file)
@@ -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
index c17c0b41d323e55675961d11bedb4e6af6a6e3e3..ce6a9d50792b7f862eeb2537e163519bf5753f1d 100644 (file)
@@ -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.
index 602795ad537f70dff4c33393065de39f45f1234b..c75f5bf9897e77aff992183682238724121f1e9a 100644 (file)
@@ -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