RTEMS Logo

RTEMS 4.10.2 On-Line Library


Input and Output Primitives Manager write - Writes to a file

PREV UP NEXT Bookshelf RTEMS POSIX API User's Guide

5.4.6: write - Writes to a file

CALLING SEQUENCE:

#include <unistd.h>

int write(
  int           fildes,
  const void   *buf,
  unsigned int  nbytes
);

STATUS CODES:

EAGAIN
The O_NONBLOCK flag is set for a file descriptor and the process would be delayed in the I/O operation.
EBADF
Invalid file descriptor
EFBIG
An attempt was made to write to a file that exceeds the maximum file size
EINTR
The function was interrupted by a signal.
EIO
Input or output error.
ENOSPC
No space left on disk.
EPIPE
Attempt to write to a pope or FIFO with no reader.
EINVAL
Bad buffer pointer

DESCRIPTION:

The write() function writes nbyte from the array pointed to by buf into the file associated with fildes.

If nybte is zero and the file is a regular file, the write() function returns zero and has no other effect. If nbyte is zero and the file is a special file, te results are not portable.

The write() function returns the number of bytes written. This number will be less than nbytes if there is an error. It will never be greater than nbytes.

NOTES:

NONE


PREV UP NEXT Bookshelf RTEMS POSIX API User's Guide

Copyright © 1988-2008 OAR Corporation