Gamma™ : Version 6.4
	Input/Output

`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?)

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.

The number of bytes actually written to the file, or -1 on failure and the errno is set.

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.

Gamma> x = fd_open("/fd/ser1",O_RDWR);
4
Gamma> fd_write(x,"hello\n");
6
Gamma> fd_close(x);
t


fd_to_file		fileno