fd_write
fd_write — writes a buffer or string to a file identified by a file
descriptor.
Syntax
fd_write (fd, buffer|string, length?, offset?)
Arguments
- fd
- A file
descriptor as returned from fd_open.
- buffer|string
- A buffer or string to write to the
file.
- length
- An integer specifying the length of
the buffer or string.
- offset
- An integer specifying the position in
the file to begin writing the buffer or
string.
Returns
The number of bytes actually written to the file, or -1 on
failure and the errno is set.
Description
This function writes a buffer or string to the specified
file.
When an error occurs, the following errnos are possible:
- EAGAIN The O_NONBLOCK
flag is set for the fd and
the process would be delayed in the write
operation.
- EBADF The passed
fd is invalid or not open
for writing.
- EFBIG File is too big.
- EINTR Write was interrupted by a signal.
- EINVAL iovcnt was
less than or equal to 0, or greater than
UIO_MAXIOV.
- EIO Physical I/O error.
- ENOSPC No free space remaining on drive.
- EPIPE Attempt to
write to a pipe (or FIFO) that is not open for
write. SIGPIPE is also sent to process.
Example
Gamma> x = fd_open("/fd/ser1",O_RDWR);
4
Gamma> fd_write(x,"hello\n");
6
Gamma> fd_close(x);
t
