V1/man/man2/read.2

Compare this file to the similar file:
Show the results in this format: 

        11/3/71                                                 SYS READ (II)

NAME              read -- read from file

SYNOPSIS          (file descriptor in r0)
                  sys      read; buffer; nchars          / read = 3.
                  (nread in r0)

DESCRIPTION       A file descriptor is a word returned from a successful open call.

                  Buffer is the location of nchars contiguous bytes into which the
                  input will be placed. It is not guaranteed that all nchars bytes
                  will be read, however; 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.

                  If r0 returns with value 0, then end--of--file has been reached.

FILES

SEE ALSO          open

DIAGNOSTICS As    , 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, all rare, can generate an error: physical I/O errors, bad
                  buffer address, preposterous nchars, file descriptor not that of an
                  input file.

BUGS

OWNER             ken, dmr