    WRITE(II)                     8/5/73                    WRITE(II)

    NAME
         write - write on a file

    SYNOPSIS
         (write = 4.)
         (file descriptor in r0)
         sys  write; buffer; nbytes

         write(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 address of nbytes contiguous bytes  which  are
         written  on the output file.  The number of characters actu-
         ally written is returned (in r0).  It should be regarded  as
         an error if this is not the same as requested.

         Writes  which are multiples of 512 characters long and begin
         on a 512-byte boundary in the file are more  efficient  than
         any others.

    SEE ALSO
         creat(II), open(II), pipe(II)

    DIAGNOSTICS
         The  error  bit  (c-bit) is set on an error: bad descriptor,
         buffer address, or count; physical I/O errors.   From  C,  a
         returned value of -1 indicates an error.

                                  - 1 -