WRITE(3spp)         RISC/os Reference Manual          WRITE(3spp)



NAME
     write - write output

SYNOPSIS
     int  write(fd, buf, nbytes)
     int  fd;
     char *buf;
     int nbytes;

DESCRIPTION
     Write attempts to write nbytes of data to the object refer-
     enced by the file descriptor fd from the buffer pointed to
     by buf.

     On objects capable of seeking, write starts at a position
     given by the pointer associated with fd, see lseek(2).  Upon
     return from write, the pointer is incremented by the number
     of bytes actually written.

     Objects that are not capable of seeking, always write from
     the current position.  The value of the pointer associated
     with such an object is undefined.

RETURN VALUE
     Upon successful completion the number of bytes actually
     written is returned.  Otherwise, a -1 is returned and the
     global variable errno is set to indicate the error.

SEE ALSO
     lseek(3spp), open(3spp)

























                         Printed 1/6/92                    Page 1