1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
.\"
.\" Copyright (c) 1996 Tom Bjorkholm <tomb@mydata.se>
.\"
.\" Esta documentacin es libre; usted puede redistribuirla y/o
.\" modificarla bajo las condiciones de la Licencia Pblica General
.\" GNU versin 2 o posterior; publicada por la Free Software
.\" Foundation.
.\"
.\" Las referencias de la Licencia Pblica General GNU a
.\" "cdigo objeto" y "ejecutables" sern interpretadas como
.\" la salida de cualquier sistema de formateo de documentos,
.\" incluyendo la salida intermedia e impresa.
.\"
.\" Este manual es distribuido con la esperanza de que sea til,
.\" pero SIN GARANTA ALGUNA; incluso sin la garanta implcita
.\" de MERCABILIDAD o APTITUD PARA UN PROPOSITO PARTICULAR.
.\" Ver la Licencia Pblica General para ms detalles.
.\"
.\" Usted ha debido recibir una copia de la Licencia Pblica
.\" General GNU conjuntamente con este manual; si no, escriba a
.\" la Free Software Foundation, Inc., 675 Mass Ave, Cambridge,
.\" MA 02139, USA.
.\"
.\" 1996-04-12 Tom Bjorkholm <tomb@mydata.se>
.\" Primera versin escrita
.\" Modificada el Martes 22 de Oct. 17:41:07 1996 por
.\" Eric S. Raymond <esr@thyrsus.com>
.\" Traducida al Espaol el 26 de Enero de 1.998 por
.\" Xavier E. Mrmol <xmarmol@linux.org.ve>
.\"
.TH READV 2 "1996-04-12" "Linux 1.3.86" "Manual del Programador Linux"
.SH NOMBRE
readv, writev \- lee o escribe un vector
.SH SINOPSIS
.B #include <sys/uio.h>
.sp
.BI "int readv(int " fd ", const struct iovec * " vector ", size_t " count );
.sp
.BI "int writev(int " fd ", const struct iovec * " vector ", size_t " count );
.sp
.B
\fBstruct iovec {\fR
.br
\fB__ptr_t \fIiov_base\fB;\fR /* Comienzo de Direcciones. */
.br
\fBsize_t \fIiov_len\fB;\fR /* Longitud en bytes. */
.br
\fB};\fR
.fi
.SH DESCRIPCIN
\fBreadv\fR lee datos desde el descriptor de archivo \fIfd\fR, y pone los
resultados en la zona de memoria descrita por \fIvector\fR. El nmero de
bloques de memoria es especificado por \fIcount\fR. Los bloques son llenados
en el orden especificado. Opera slo como \fBlector\fR excepto que los
datos son puestos en \fIvector\fR en lugar de en una zona contigua de memoria.
\fBwritev\fR escribe datos a el descriptor de archivo \fIfd\fR, y desde
la zona de memoria descrita por \fIvector\fR. El nmero de bloques de memoria
es especificado por \fIcount\fR. Los bloques son usados en el orden
especificado. Opera slo como \fBescritor\fR excepto que los datos son
tomados desde \fIvector\fR en lugar de una zona contigua de memoria.
.SH VALOR RETORNADO
En caso de xito \fBreadv\fR devuelve el nmero de bytes ledos.
En caso de xito \fBwritev\fR devuelve el nmero de bytes escritos.
En caso de error, \-1 es devuelto, y \fIerrno\fR es establecido apropiadamente.
.SH ERRORES
.TP 0.8i
.B EINVAL
Un argumento invlido ha sido dado. Por ejemplo \fIcount\fR podra ser
mayor que \fBMAX_IOVEC\fR, o cero. \fIfd\fR podra estar unido a un
objeto impropio para lectura (por \fBreadv\fR) o escritura (por \fBwritev\fR).
.TP
.B EFAULT
"Fallo de segmentacin." Probablemente \fIvector\fR o alguno de los
punteros \fIiov_base\fR a puntos de memoria no esta correctamente asignado.
.TP
.B EBADF
El descriptor de archivo \fIfd\fR no es vlido.
.TP
.B EINTR
La llamada ha sido interrumpida por una seal antes de que algn dato fuese ledo/escrito.
.TP
.B EAGAIN
Sin bloqueo de E/S ha sido seleccionado usando
\fBO_NONBLOCK\fR y no hubo datos disponibles inmediatamente para ser ledos.
(O el descriptor de archivo \fIfd\fR apunta a un objeto que est bloqueado.)
.TP
.B EISDIR
\fIfd\fR hace referencia a un directorio.
.TP
.B EOPNOTSUP
\fIfd\fR hace referencia a un socket o dispositivo que no soporta lectura/escritura.
.PP
Otros errores pueden ocurrir, depende de el objeto conectado a \fIfd\fR.
.SH "AJUSTADO A"
4.4BSD (
.B readv
y
.B writev
son funciones aparecidas por primeras vez en BSD 4.2).
.SH VER TAMBIN
.BR read (2),
.BR write (2),
.BR fprintf (3),
.BR fscanf (3)
|
