.pa 1
.he 'READ (II)'3/15/72'READ (II)'
.ti 0
NAME		read  --  read from file
.sp
.ti 0
SYNOPSIS	(file descriptor in r0)
.br
sys read; buffer; nbytes  / read = 3.
.br
(nread in r0)
.sp
.ti 0
DESCRIPTION	A file descriptor is a word
returned from a successful open____ or creat_____ call.
.sp
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 typewriter at most one line
will be returned.
In any event the number of characters read is returned
in r0.
.sp
If r0 returns with value 0, then
end-of-file has been reached.
.sp
.ti 0
SEE ALSO	open(II), creat(II)
.sp
.ti 0
DIAGNOSTICS	As mentioned,
r0 is 0 on return when the end of the file has been reached.
If the read was otherwise unsuccessful
the error bit (c-bit) is set.  Many conditions,
can generate an error:
physical I/O errors, bad buffer address,
preposterous nbytes______, file descriptor not that of
an input file.
.sp
.ti 0
BUGS		--
