Gamma™ : Version 6.4
	Input/Output

`fd_read`

fd_read — reads a buffer or string from a file identified by a file descriptor.

Syntax

fd_read (fd, buffer|string, length?, offset?)

fd: A file descriptor as returned from fd_open.
buffer|string: A buffer or string to be read from the file.
length: An integer specifying the length of the buffer or string.
offset: An integer specifying the position in the file to begin reading the buffer or string.

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

This function reads a buffer or string from 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 read operation.

EBADF The passed fd is invalid or not open for writing.

EFBIG File is too big.

EINTR Read was interrupted by a signal.

EINVAL iovcnt was less than or equal to 0, or greater than UIO_MAXIOV.

EIO Physical I/O error.

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


fd_open		fd_to_file