Mon Sep 2 00:00:25 2019 UTC ()
read was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf


(sevan)
diff -r1.38 -r1.39 src/lib/libc/sys/read.2
cvs diff -r1.38 -r1.39 src/lib/libc/sys/read.2 (expand / switch to unified diff)

--- src/lib/libc/sys/read.2 2019/08/07 19:13:49 1.38
+++ src/lib/libc/sys/read.2 2019/09/02 00:00:25 1.39
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: read.2,v 1.38 2019/08/07 19:13:49 wiz Exp $ 1.\" $NetBSD: read.2,v 1.39 2019/09/02 00:00:25 sevan Exp $
2.\" 2.\"
3.\" Copyright (c) 1980, 1991, 1993 3.\" Copyright (c) 1980, 1991, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors 14.\" 3. Neither the name of the University nor the names of its contributors
@@ -19,27 +19,27 @@ @@ -19,27 +19,27 @@
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE. 28.\" SUCH DAMAGE.
29.\" 29.\"
30.\" @(#)read.2 8.4 (Berkeley) 2/26/94 30.\" @(#)read.2 8.4 (Berkeley) 2/26/94
31.\" 31.\"
32.Dd August 7, 2019 32.Dd September 2, 2019
33.Dt READ 2 33.Dt READ 2
34.Os 34.Os
35.Sh NAME 35.Sh NAME
36.Nm read , 36.Nm read ,
37.Nm readv , 37.Nm readv ,
38.Nm pread , 38.Nm pread ,
39.Nm preadv 39.Nm preadv
40.Nd read input 40.Nd read input
41.Sh LIBRARY 41.Sh LIBRARY
42.Lb libc 42.Lb libc
43.Sh SYNOPSIS 43.Sh SYNOPSIS
44.In unistd.h 44.In unistd.h
45.Ft ssize_t 45.Ft ssize_t
@@ -242,27 +242,27 @@ appeared in @@ -242,27 +242,27 @@ appeared in
242The 242The
243.Fn pread 243.Fn pread
244function call 244function call
245appeared in 245appeared in
246.At V.4 . 246.At V.4 .
247The 247The
248.Fn readv 248.Fn readv
249function call 249function call
250appeared in 250appeared in
251.Bx 4.2 . 251.Bx 4.2 .
252The 252The
253.Fn read 253.Fn read
254function call appeared in 254function call appeared in
255.At v2 . 255.At v1 .
256.Sh CAVEATS 256.Sh CAVEATS
257Error checks should explicitly test for \-1. 257Error checks should explicitly test for \-1.
258Code such as 258Code such as
259.Bd -literal 259.Bd -literal
260 while ((nr = read(fd, buf, sizeof(buf))) > 0) 260 while ((nr = read(fd, buf, sizeof(buf))) > 0)
261.Ed 261.Ed
262.Pp 262.Pp
263is not maximally portable, as some platforms allow for 263is not maximally portable, as some platforms allow for
264.Va nbytes 264.Va nbytes
265to range between 265to range between
266.Dv SSIZE_MAX 266.Dv SSIZE_MAX
267and 267and
268.Dv SIZE_MAX 268.Dv SIZE_MAX