listxattr: document Linux 6.15 bug

This bug should be fixed in Linux kernel 6.16; see:
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=fe78e02600f83d81e55f6fc352d82c4f264a2901
For what it's worth, Coreutils decided not to work around the bug,
and instead to suggest updating to a fixed kernel or to a future
version of libattr with at least the following patches:
https://cgit.git.savannah.gnu.org/cgit/attr.git/commit/?id=58abfe6eba0d8d58a61ee8bee0615f74d393fff2
https://cgit.git.savannah.gnu.org/cgit/attr.git/commit/?id=504ab19d7b032212755ab3c7df16be98d5b5212e

diff --git a/doc/glibc-functions/flistxattr.texi b/doc/glibc-functions/flistxattr.texi
index 8aa4eb73a9a8be893504c804a683ec4eb67a8ef2..9b9d21a6d8086c6247cad306b5b25cb01525c0cf 100644 (file)
--- a/doc/glibc-functions/flistxattr.texi
+++ b/doc/glibc-functions/flistxattr.texi
@@ -25,4 +25,7 @@ Linux kernel 6.12.
 This function does not report synthetic @code{security.*} extended attributes
 on @code{tmpfs} and @code{kernfs}-based file systems:
 Linux kernel 6.14.
+@item
+This function can fail with @code{ERANGE} even if the buffer is large enough:
+Linux kernel 6.15.
 @end itemize

diff --git a/doc/glibc-functions/listxattr.texi b/doc/glibc-functions/listxattr.texi
index 769d69edd474249cdc7423665b8985c4fef7c069..c47b4b50fbe08853002a7e5501cfd8535071ccb5 100644 (file)
--- a/doc/glibc-functions/listxattr.texi
+++ b/doc/glibc-functions/listxattr.texi
@@ -25,4 +25,7 @@ Linux kernel 6.12.
 This function does not report synthetic @code{security.*} extended attributes
 on @code{tmpfs} and @code{kernfs}-based file systems:
 Linux kernel 6.14.
+@item
+This function can fail with @code{ERANGE} even if the buffer is large enough:
+Linux kernel 6.15.
 @end itemize

diff --git a/doc/glibc-functions/llistxattr.texi b/doc/glibc-functions/llistxattr.texi
index 8801ccdca5e1d5cc4f9fe41dcb1d33206b5dec95..0db5c5004b8c5ccc92239b1613a4670aa6f97864 100644 (file)
--- a/doc/glibc-functions/llistxattr.texi
+++ b/doc/glibc-functions/llistxattr.texi
@@ -22,4 +22,7 @@ Linux kernel 6.12.
 This function does not report synthetic @code{security.*} extended attributes
 on @code{tmpfs} and @code{kernfs}-based file systems:
 Linux kernel 6.14.
+@item
+This function can fail with @code{ERANGE} even if the buffer is large enough:
+Linux kernel 6.15.
 @end itemize