man/man2/readv.2: Document RWF_NOAPPEND

Document flag introduced in Linux v6.9.

Cc: Rich Felker <dalias@libc.org>
Cc: Christian Brauner <brauner@kernel.org>
Signed-off-by: John Garry <john.g.garry@oracle.com>
Message-ID: <20241126090847.297371-2-john.g.garry@oracle.com>
[alx: wfix, srcfix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man/man2/readv.2 b/man/man2/readv.2
index 78232c19ffe8cc4013ff1b7a8bcad766a708a2e2..5ba5aebc2e11e2fe8a7df6e18601b8d21e51d0fe 100644 (file)
--- a/man/man2/readv.2
+++ b/man/man2/readv.2
@@ -238,6 +238,29 @@ However, if the
 .I offset
 argument is \-1, the current file offset is updated.
 .TP
+.BR RWF_NOAPPEND " (since Linux 6.9)"
+Do not honor the
+.B O_APPEND
+.BR open (2)
+flag.
+This flag is meaningful only for
+.BR pwritev2 ().
+Historically,
+Linux honored
+.B O_APPEND
+flag if set and ignored the offset argument,
+which is a bug.
+For
+.BR pwritev2 (),
+the
+.I offset
+argument is honored as expected if
+.B RWF_NOAPPEND
+flag is set,
+the same as if
+.B O_APPEND
+flag were not set.
+.TP
 .BR RWF_ATOMIC " (since Linux 6.11)"
 Requires that
 writes to regular files in block-based filesystems