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
202
203
204
205
|
.\" 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>
.\"
.\" Traduction 13/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 8/04/97
.TH SELECT 2 "8 Avril 1997" Linux "Manuel du programmeur Linux"
.SH NOM
select, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \- Multiplexage d'entres/sorties synchrones.
.SH SYNOPSIS
.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 DESCRIPTION
.B select
attend des changements d'tat sur plusieurs descripteurs de fichiers.
.PP
Il y a trois ensembles indpendants de descripteurs qui sont surveills
simultanment.
Ceux de l'ensemble
.I readfds
seront surveills pour vrifier si des caractres deviennent disponibles
en lecture.
Les descripteurs de l'ensemble
.I writefds
seront surveills pour vrifier si l'on peut crire immdiatement
sur eux.
Ceux de l'ensemble
.I exceptfds
seront surveills pour l'occurence de conditions exceptionnelles.
Il en existe deux types : l'arrive de donnes hors-bande sur une
socket, et la disponibilit d'informations d'tat concernant un
pseudo-terminal en mode paquet.
On peut indiquer un pointeur NULL la place d'un ensemble si l'on ne
veut pas en tenir compte.
En sortie, les ensembles sont modifis pour indiquer les descripteurs
qui ont chang de statut.
.PP
Quatre macros sont disponibles pour la manipulation des ensembles
.B FD_ZERO
efface un ensemble.
.B FD_SET
et
.B FD_CLR
ajoutent et suppriment un descripteur dans un ensemble.
.B FD_ISSET
vrifie si un descripteur est contenu dans un ensemble, principalement
utile aprs le retour de
.B select.
.PP
.I n
est le numro du plus grand descripteur des 3 ensembles, plus 1.
.PP
.I timeout
est une limite suprieure au temps pass dans
.B select
avant son retour.
Elle peut tre nulle, ce qui conduit
.B select
revenir immdiatement.
Si le timeout est NULL (aucun),
.B select
peut bloquer indfiniment.
.SH "VALEUR RENVOYE"
En cas de russite
.BR select
renvoie le nombre de descripteurs dans les ensembles, qui peut tre nul
si le dlai de timeout a expir avant que quoi que ce soit d'intressant
ne se produise.
.BR select
retourne \-1 s'il choue, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
.TP 0.8i
.B EBADF
Un descripteur de fichier (dans l'un des ensembles) est invalide.
.TP
.B EINTR
Un signal a t intercept.
.TP
.B EINVAL
.I n
est ngatif
.TP
.B ENOMEM
Pas assez de mmoire pour le noyau.
.SH NOTES
Certaines applications appellent
.B select
avec les trois ensembles vides,
.B n
nul, et un dlai de timeout non nul, afin d'endormir, de manire portable,
le processus avec une prcision plus fine que la seconde.
.PP
Sous Linux
.I timeout
est modifi pour indiquer le temps restant mais la plupart des autres
implmentations ne le font pas.
Ceci pose des problemes la fois pour porter sur d'autres systmes du
code dvelopp sous Linux qui utilise cette valeur de
.I timeout
modifie, et pour porter sous Linux du code qui rutilise plusieurs
fois la structure timeval sans la rinitialiser.
La meilleure attitude adopter est de considrer
.I timeout
comme indfini aprs le retour de
.B select.
.SH EXEMPLE
.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 retval;
/* Surveiller stdin (fd 0) en attente d'entres */
FD_ZERO(&rfds);
FD_SET(0, &rfds);
/* Pendant 5 secondes maxi */
tv.tv_sec = 5;
tv.tv_usec = 0;
retval = select(1, &rfds, NULL, NULL, &tv);
/* Considerer tv comme indfini maintenant ! */
if (retval)
printf("Donnes disponibles maintenant\\n");
/* FD_ISSET(0, &rfds) est vrai */
else
printf("Pas de donnes depuis 5 secondes\\n");
exit(0);
}
.fi
.SH CONFORMIT
BSD 4.4 (la fonction
.B select
est apparue dans BSD 4.2). Gnralement portable depuis ou vers des
systmes non-BSD supportant des clones de la couche sockets BSD (y compris
les variantes du Systeme V).
Nanmoins, sachez que les variantes du systme V fixent une variable de
timeout avant le retour alors que les variantes BSD ne le font pas.
.SH "VOIR AUSSI"
.BR accept (2),
.BR connect (2),
.BR read (2),
.BR recv (2),
.BR send (2),
.BR write (2)
.SH TRADUCTION
Christophe Blaess, 1997.
|
