git: 42667ceb9d00 - stable/13 - read.2: Describe debug.iosize_max_clamp

The branch stable/13 has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=42667ceb9d0026f7d1e5f95297b942af576cd929

commit 42667ceb9d0026f7d1e5f95297b942af576cd929
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2024-02-10 09:40:07 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2024-02-14 03:54:00 +0000

    read.2: Describe debug.iosize_max_clamp
    
    PR:     276937
    
    (cherry picked from commit 3e9515846f8cbff0ecccaab65d9f70890d04429e)
---
 lib/libc/sys/read.2 | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2
index e3b5b21d1c31..94644045afc1 100644
--- a/lib/libc/sys/read.2
+++ b/lib/libc/sys/read.2
@@ -25,9 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)read.2	8.4 (Berkeley) 2/26/94
-.\"
-.Dd June 4, 2020
+.Dd February 10, 2024
 .Dt READ 2
 .Os
 .Sh NAME
@@ -222,7 +220,12 @@ for this file system.
 The value
 .Fa nbytes
 is greater than
-.Dv INT_MAX .
+.Dv SSIZE_MAX
+(or greater than
+.Dv INT_MAX ,
+if the sysctl
+.Va debug.iosize_max_clamp
+is non-zero).
 .El
 .Pp
 In addition,
@@ -248,7 +251,13 @@ The sum of the
 .Fa iov_len
 values in the
 .Fa iov
-array overflowed a 32-bit integer.
+array is greater than
+.Dv SSIZE_MAX
+(or greater than
+.Dv INT_MAX ,
+if the sysctl
+.Va debug.iosize_max_clamp
+is non-zero).
 .It Bq Er EFAULT
 Part of the
 .Fa iov