From: John Garry <john.g.garry@oracle.com>
Date: Tue, 26 Nov 2024 09:08:46 +0000 (+0000)
Subject: man/man2/readv.2: Document RWF_NOAPPEND
X-Git-Tag: man-pages-6.10~31
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=64fc4bb4ae09a4559a5789a6ede952c0f8570b39;p=thirdparty%2Fman-pages.git

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 78232c19f..5ba5aebc2 100644
--- 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