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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is copyright (C) 1992 Drew Eckhardt,
.\" copyright (C) 1995 Michael Shields.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
.\" Modified 1995-05-18 by Jim Van Zandt <jrv@vanzandt.mv.com>
.\" Sun Feb 11 14:07:00 MET 1996 Martin Schulze <joey@linux.de>
.\" * layout slightly modified
.\"
.\" Modified Mon Oct 21 23:05:29 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Translated into Spanish Fri 23 Jan 1998 by Gerardo Aburruzaga
.\" Garca <gerardo.aburruzaga@uca.es>
.\"
.TH SELECT 2 "23 Enero 1998" "Linux 1.2" "Manual del Programador Linux"
.SH NOMBRE
select, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \- multiplexacin de E/S sncrona
.\"synchronous I/O multiplexing
.SH SINOPSIS
.B #include <sys/time.h>
.br
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.sp
\fBint select(int \fIn\fB, fd_set *\fIreadfds\fB,
fd_set *\fIwritefds\fB, fd_set *\fIexceptfds\fB,
struct timeval *\fItimeout\fB);
.sp
.BI "FD_CLR(int " fd ", fd_set *" set );
.br
.BI "FD_ISSET(int " fd ", fd_set *" set );
.br
.BI "FD_SET(int " fd ", fd_set *" set );
.br
.BI "FD_ZERO(fd_set *" set );
.fi
.SH DESCRIPCIN
.B select
espera a que una serie de descriptores de ficheros cambien su estado.
.\"waits for a number of file descriptors to change status.
.PP
Se miran tres conjuntos independientes de descriptores. Aqullos
listados en
.I readfds
sern observados para ver si hay caracteres que llegan a estar
disponibles para lectura, aqullos en
.I writefds
sern observados para ver si es correcto escribir inmediatamente en
ellos, y aqullos en
.I exceptfds
sern observados para ver si ocurren excepciones. En caso de xito,
los conjuntos se modifican en marcha para indicar qu descriptores
cambiaron realmente su estado.
.PP
Se proporcionan cuatro macros para manipular los conjuntos.
.B FD_ZERO
limpiar un conjunto.
.B FD_SET
y
.B FD_CLR
aaden o borran un descriptor dado a o de un conjunto.
.B FD_ISSET
mira a ver si un descriptor es parte del conjunto; esto es til
despus de que
.B select
regrese.
.PP
.I n
es el descriptor con el nmero ms alto en cualquiera de los tres
conjuntos, ms 1.
.PP
.I timeout
es un lmite superior de la cantidad de tiempo transcurrida antes de que
.B select
regrese. Puede ser cero, causando que
.B select
regrese inmediatamente. Si
.I timeout
es NULL (no hay tiempo de espera),
.B select
puede bloquear indefinidamente.
.SH VALOR DEVUELTO
En caso de xito,
.B select
devuelve el nmero de descriptores contenidos en los conjuntos de
descriptores, que puede ser cero si el tiempo de espera expira antes
de que ocurra algo interesante.
En caso de error, se devuelve \-1, y se pone un valor apropiado en
.IR errno ;
los conjuntos y
.I timeout
estarn indefinidos, as que no
confe en sus contenidos tras un error.
.SH ERRORES
.TP 0.8i
.B EBADF
Se ha dado un descriptor de fichero invlido en uno de los conjuntos.
.TP
.B EINTR
Se ha capturado una seal no bloqueante.
.TP
.B EINVAL
.I n
es negativo.
.TP
.B ENOMEM
.B select
no ha sido capaz de reservar memoria para las tablas internas.
.SH OBSERVACIONES
Hay algn cdigo por ah que llama a
.B select
con los tres conjuntos vacos,
.I n
cero, y un
.I timeout
distinto de cero como una forma transportable y curiosa de dormir con
una precisin por debajo del segundo.
.PP
En Linux,
.I timeout
se modifica para reflejar la cantidad de tiempo no dormido; la mayora
de otras implementaciones no hacen esto. Esto produce problemas cuando
el cdigo de Linux que lee
.I timeout
se transporta a otros sistemas operativos, y cuando se transporta a
Linux cdigo que reutiliza una struct timeval para varias
.BR select s
en un bucle sin reinicializarla. Considere que
.I timeout
est indefinido despus de que
.B select
regrese.
.SH EJEMPLO
.nf
#include <stdio.h>
#include <sys/time.h>
#include <sys/types.h>
#include <unistd.h>
int
main(void)
{
fd_set rfds;
struct timeval tv;
int valret;
/* Mirar stdin (df 0) para ver si tiene entrada */
FD_ZERO(&rfds);
FD_SET(0, &rfds);
/* Esperar hasta 5 s */
tv.tv_sec = 5;
tv.tv_usec = 0;
valret = select(1, &rfds, NULL, NULL, &tv);
/* No confiar ahora en el valor de tv! */
if (valret)
printf("Los datos ya estn disponibles.\\n");
/* FD_ISSET(0, &rfds) ser verdadero */
else
printf("Ningn dato en 5 segundos.\\n");
return(0);
}
.fi
.SH CONFORME CON
4.4BSD (la funcin
.B select
apareci por primera vez en 4.2BSD). Generalmente es transportable a o
desde sistemas no-BSD que admitan clones de la capa de zcalos de BSD
(incluyendo variantes System V). Sin embargo, observe que la variante
System V normalmente pone la variable de espera antes de salir, pero
la variante BSD no.
.SH CONSULTE TAMBIN
.BR accept (2),
.BR connect (2),
.BR read (2),
.BR recv (2),
.BR send (2),
.BR write (2).
|
