NOMBRE

       readv, writev - leen o escriben datos en múltiples buffers

SINOPSIS

       #include <sys/uio.h>

       ssize_t readv(int fd, const struct iovec *vector, int count);

       ssize_t writev(int fd, const struct iovec *vector, int count);

DESCRIPCIÓN

       La  función readv() lee count bloques del fichero asociado con el descriptor de fichero fd
       en múltiples buffers descritos por vector.

       La función writev() escribe como máximo count bloques descritos por vector en  el  fichero
       asociado con el descriptor de fichero fd.

       El puntero vector apunta a una estructura iovec definida en <sys/uio.h> como

          struct iovec {
              void *iov_base;   /* Dirección de comienzo */
              size_t iov_len;   /* Número de bytes */
          };

       Los buffers son procesados en el orden especificado.

       La  función  readv()  trabaja  exactamente  igual  que read(2) salvo que rellena múltiples
       buffers.

       La función writev() trabaja exactamente igual que write(2)  salvo  que  escribe  múltiples
       buffers.

VALOR DEVUELTO

       En  caso  de  éxito,  la  función  readv()  devuelve el número de bytes leídos; la función
       writev() devuelve el número de bytes escritos.  En caso de error, se  devuelve  -1,  y  se
       modifica errno con un valor apropiado.

ERRORES

       Los  errores  son  los  mismos  que  para read(2) y write(2).  Adicionalmente se define el
       siguiente error.

       EINVAL La suma de los valores iov_len provoca un desbordamiento por  arriba  en  un  valor
              ssize_t.  O bien, el contador count es cero o mayor que MAX_IOVEC.

CONFORME A

       4.4BSD  (las  funciones  readv  y  writev aparecieron por primera vez en BSD 4.2), Unix98,
       POSIX 1003.1-2001.  La biblioteca libc5 de Linux usaba  size_t  como  tipo  del  parámetro
       count, e int como tipo devuelto por estas funciones.

FALLOS

       No  es  recomendable  mezclar  llamadas  a funciones como readv() o writev(), que trabajan
       sobre descriptores de fichero, con funciones de la biblioteca stdio; los resultados  serán
       indefinidos y probablemente indeseados.

VÉASE TAMBIÉN

       read(2), write(2)

                                         17 octubre 2002                                 READV(2)