fsync, fdatasync: generalize fsync write access doc

diff --git a/ChangeLog b/ChangeLog
index 3cebc0d793226ccb690c331c3392efdc3778c222..15c7c1a94106be704e09bdc1f768401c35b67961 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,8 +1,11 @@
 2025-07-22  Collin Funk  <collin.funk1@gmail.com>
+           Paul Eggert  <eggert@cs.ucla.edu>
 
-       doc: Document that fsync doesn't work on directories on AIX 7.3.
-       Reported by Lakshmi-Surekha <Lakshmi.Kovvuri@ibm.com> in:
+       doc: Document that fsync and fdatasync require write access.
+       Reported for fsync on AIX by Lakshmi-Surekha
+       <Lakshmi.Kovvuri@ibm.com> in:
        <https://github.com/tukaani-project/xz/issues/188>.
+       * doc/posix-functions/fdatasync.texi:
        * doc/posix-functions/fsync.texi: Document the behavior.
 
 2025-07-22  Paul Eggert  <eggert@cs.ucla.edu>

diff --git a/doc/posix-functions/fdatasync.texi b/doc/posix-functions/fdatasync.texi
index 646c5b9985d615706735f87faa7d0512ad6811af..d2e7c6e9648d93cc1a39d4c359727fa8e3081afb 100644 (file)
--- a/doc/posix-functions/fdatasync.texi
+++ b/doc/posix-functions/fdatasync.texi
@@ -19,4 +19,9 @@ Mac OS X 10.5, FreeBSD 11.0, OpenBSD 3.8, Minix 3.1.8, mingw, MSVC 14, Android 2
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+If the argument is a file descriptor that lacks write access,
+such as a directory file descriptor, this function fails
+with @code{EBADF} on some platforms:
+AIX 7.3, Cygwin 3.6.x.
 @end itemize

diff --git a/doc/posix-functions/fsync.texi b/doc/posix-functions/fsync.texi
index 924546516b401b89e5b9e13bf8448ac8995bff40..48ff17bccf502fc41193e731f0422fd16e98cbc6 100644 (file)
--- a/doc/posix-functions/fsync.texi
+++ b/doc/posix-functions/fsync.texi
@@ -17,12 +17,8 @@ mingw, MSVC 14.
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-If the argument is a read-only file descriptor, this function fails
+If the argument is a file descriptor that lacks write access,
+such as a directory file descriptor, this function fails
 with @code{EBADF} on some platforms:
-AIX 7.2, Cygwin 2.9.
-
-@item
-If the argument is a directory file descriptor, this function fails with
-@code{EBADF} on some platforms:
-AIX 7.3.
+AIX 7.3, Cygwin 3.6.x.
 @end itemize