READ(II) 8/5/73 READ(II)





READ(II)                     8/5/73                      READ(II)







NAME

     read - read from file



SYNOPSIS

     (read = 3.)

     (file descriptor in r0)

     sys read; buffer; nbytes



     read(fildes, buffer, nbytes)

     char *buffer;



DESCRIPTION

     A file descriptor is a word returned from a successful open,

     creat,  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 typewriter at most one  line

     will  be  returned.   In  any event the number of characters

     read is returned (in r0).



     If the returned  value  is  0,  then  end-of-file  has  been

     reached.



SEE ALSO

     open(II), creat(II), pipe(II)



DIAGNOSTICS

     As mentioned, 0 is returned 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.  From  C,

     a -1 return indicates the error.
squoze.net
