RTEMS 4.10.0 On-Line Library

Input and Output Primitives Manager readv - Vectored read from a file

RTEMS POSIX API User's Guide

5.4.14: readv - Vectored read from a file

CALLING SEQUENCE:

#include <sys/uio.h>

ssize_t readv(
  int                 fd,
  const struct iovec *iov,
  int                 iovcnt
);

STATUS CODES:

In addition to the errors detected by Input and Output Primitives Manager read - Reads from a file, read(), this routine may return -1 and sets errno based upon the following errors:

EINVAL: The sum of the iov_len values in the iov array overflowed an ssize_t.
EINVAL: The iovcnt argument was less than or equal to 0, or greater than IOV_MAX.

DESCRIPTION:

The readv() function is equivalent to read() except as described here. The readv() function shall place the input data into the iovcnt buffers specified by the members of the iov array: iov[0], iov[1], ..., iov[iovcnt-1].

Each iovec entry specifies the base address and length of an area in memory where data should be placed. The readv() function always fills an area completely before proceeding to the next.

NOTES:

NONE

RTEMS POSIX API User's Guide