v7 man page for read

Query: read

OS: v7

Section: 2

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

READ(2) 							System Calls Manual							   READ(2)

NAME
read - read from file
SYNOPSIS
read(fildes, buffer, nbytes) char *buffer;
DESCRIPTION
A file descriptor is a word returned from a successful open, creat, dup, or pipe call. Buffer is the location of nbytes contiguous bytes into which the input will be placed. It is not guaranteed that all nbytes bytes will be read; for example if the file refers to a type- writer at most one line will be returned. In any event the number of characters read is returned. If the returned value is 0, then end-of-file has been reached.
SEE ALSO
open(2), creat(2), dup(2), pipe(2)
DIAGNOSTICS
As mentioned, 0 is returned when the end of the file has been reached. If the read was otherwise unsuccessful the return value is -1. Many conditions can generate an error: physical I/O errors, bad buffer address, preposterous nbytes, file descriptor not that of an input file.
ASSEMBLER
(read = 3.) (file descriptor in r0) sys read; buffer; nbytes (byte count in r0) READ(2)
Related Man Pages
read(2) - freebsd
preadv(2) - freebsd
read(2) - ultrix
readv(2) - ultrix
readv(2) - opendarwin
Similar Topics in the Unix Linux Community
How to read n number of lines from a file
Measure thread execution (in C, unix)
how to run an already made script run against a list of ip addresses solaris 8 question
New Feature: Member and Reader's Time Zones and Times in Profiles
Read multiple text files and copy data to csv