Lines Matching +full:read +full:- +full:to +full:- +full:read

13 .\"    may be used to endorse or promote products derived from this software
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32 .Nm read ,
36 .Nd read input
42 .Fn read "int fd" "void *buf" "size_t nbytes"
52 .Fn read
54 attempts to read
58 into the buffer pointed to by
68 array: iov[0], iov[1], ..., iov[iovcnt\|\-\|1].
74 perform the same functions, but read from the specified position in
85 .Bd -literal -offset indent -compact
103 .Fn read
110 .Fn read ,
111 the pointer is incremented by the number of bytes actually read.
113 Objects that are not capable of seeking always read from the current
119 .Fn read ,
124 return the number of bytes actually read and placed in the buffer.
125 The system guarantees to read the number of bytes requested if
127 before the end-of-file, but in no other case.
130 .St -p1003.1-2004 ,
132 .Fn read
135 syscalls are atomic with respect to each other in the effects on file
138 .Fn read
149 number of bytes actually read is returned.
150 Upon reading end-of-file,
152 Otherwise, a -1 is returned and the global variable
154 is set to indicate the error.
157 .Fn read ,
164 .Bl -tag -width Er
173 argument refers to a socket, and the remote socket end is
185 Failed to read from a file, e.g. /proc/<pid>/regs while <pid> is not stopped
187 A read from a slow device
196 The file was marked for non-blocking I/O,
197 and no data were ready to be read.
200 Directories may only be read directly by root if the filesystem supports it and
203 sysctl MIB is set to a non-zero value.
209 do not allow regular read operations on it.
215 is before the end-of-file, and
217 is greater than or equal to the offset maximum established
228 is non-zero).
236 .Bl -tag -width Er
241 was less than or equal to 0, or greater than
260 is non-zero).
272 .Bl -tag -width Er
294 .Fn read
295 system call is expected to conform to
296 .St -p1003.1-90 .
301 system calls are expected to conform to
302 .St -xpg4.2 .
317 .Fn read