read.2 (131365) | read.2 (131504) |
---|---|
1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)read.2 8.4 (Berkeley) 2/26/94 | 1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)read.2 8.4 (Berkeley) 2/26/94 |
33.\" $FreeBSD: head/lib/libc/sys/read.2 131365 2004-06-30 20:09:10Z ru $ | 33.\" $FreeBSD: head/lib/libc/sys/read.2 131504 2004-07-02 23:52:20Z ru $ |
34.\" 35.Dd February 26, 1994 36.Dt READ 2 37.Os 38.Sh NAME 39.Nm read , 40.Nm readv , 41.Nm pread --- 65 unchanged lines hidden (view full) --- 107.Fa d 108(see 109.Xr lseek 2 ) . 110Upon return from 111.Fn read , 112the pointer is incremented by the number of bytes actually read. 113.Pp 114Objects that are not capable of seeking always read from the current | 34.\" 35.Dd February 26, 1994 36.Dt READ 2 37.Os 38.Sh NAME 39.Nm read , 40.Nm readv , 41.Nm pread --- 65 unchanged lines hidden (view full) --- 107.Fa d 108(see 109.Xr lseek 2 ) . 110Upon return from 111.Fn read , 112the pointer is incremented by the number of bytes actually read. 113.Pp 114Objects that are not capable of seeking always read from the current |
115position. The value of the pointer associated with such an | 115position. 116The value of the pointer associated with such an |
116object is undefined. 117.Pp 118Upon successful completion, 119.Fn read , 120.Fn readv , 121and 122.Fn pread 123return the number of bytes actually read and placed in the buffer. --- 37 unchanged lines hidden (view full) --- 161.Fa d 162was negative. 163.It Bq Er EAGAIN 164The file was marked for non-blocking I/O, 165and no data were ready to be read. 166.It Bq Er EISDIR 167The file descriptor is associated with a directory residing 168on a file system that does not allow regular read operations on | 117object is undefined. 118.Pp 119Upon successful completion, 120.Fn read , 121.Fn readv , 122and 123.Fn pread 124return the number of bytes actually read and placed in the buffer. --- 37 unchanged lines hidden (view full) --- 162.Fa d 163was negative. 164.It Bq Er EAGAIN 165The file was marked for non-blocking I/O, 166and no data were ready to be read. 167.It Bq Er EISDIR 168The file descriptor is associated with a directory residing 169on a file system that does not allow regular read operations on |
169directories (e.g. NFS). | 170directories (e.g.\& NFS). |
170.It Bq Er EOPNOTSUPP 171The file descriptor is associated with a file system and file type that 172do not allow regular read operations on it. 173.It Bq Er EOVERFLOW 174The file descriptor is associated with a regular file, 175.Fa nbytes 176is greater than 0, 177.Fa offset --- 78 unchanged lines hidden --- | 171.It Bq Er EOPNOTSUPP 172The file descriptor is associated with a file system and file type that 173do not allow regular read operations on it. 174.It Bq Er EOVERFLOW 175The file descriptor is associated with a regular file, 176.Fa nbytes 177is greater than 0, 178.Fa offset --- 78 unchanged lines hidden --- |