term% cat index.txt READ(2) System Calls Manual READ(2)
NAME
read, readn, write - read or write file
SYNOPSIS
#include <u.h>
#include <libc.h>
long read(int fd, void *buf, long nbytes)
long readn(int fd, void *buf, long nbytes)
long write(int fd, void *buf, long nbytes)
DESCRIPTION
Read reads nbytes bytes of data from the offset in the file associated
with fd into memory at buf. The offset is advanced by the number of
bytes read. It is not guaranteed that all nbytes bytes will be read;
for example if the file refers to the console, at most one line will be
returned. In any event the number of characters read is returned. A
return value of 0 is conventionally interpreted as end of file.
Readn is just like read, but does successive read calls until nbytes
have been read, or a read system call returns a non-positive count.
Write writes nbytes bytes of data starting at buf to the file associ‐
ated with fd at the file offset. The offset is advanced by the number
of bytes written. The number of characters actually written is re‐
turned. It should be regarded as an error if this is not the same as
requested.
SOURCE
/sys/src/libc/9syscall
/sys/src/libc/port/readn.c
SEE ALSO
intro(2), open(2), dup(2), pipe(2)
DIAGNOSTICS
These functions set errstr.
READ(2)