.\" 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>
.\"	* translated from english to german
.\"
.TH SELECT 2 "27. April 1996" "Linux" "Systemaufrufe"
.SH BEZEICHNUNG
select \- Synchrone I/O-Multiplexsteuerung
.SH BERSICHT
.B #include <sys/time.h>
.br
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.sp
.BI "int select(int " n ", fd_set *" readfds ", fd_set *"
.IB writefds ", fd_set *" exceptfds ", struct timeval " timeout ");"
.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 BESCHREIBUNG
.B select()
wartet fr eine Reihe von Dateideskriptoren, da sich deren Status
ndert.

Es werden drei voneinander unabhngige Mengen von Deskriptoren
behandelt.  Bei den in
.I readfds
enthaltenen wird darauf geachtet, da neue Zeichen zum Lesen
ankommen, bei den in
.I writefds
angegebenen wird reagiert, wenn weitere Zeichen geschrieben werden
knnen, und bei den in
.I exceptfds
angegebenen Deskriptoren wird reagiert, wenn etwas auergewhnliches
passiert ist.  Wenn die Routine beendet wird, werden die bergebenen
Mengen so verndert, da sie anzeigen, welcher Deskriptor seinen
Status gendert hat.

Vier Makros werden bereitgestellt, um mit diesen Mengen zu arbeiten.
.B FD_ZERO
lscht eine Menge,
.B FD_SET
und
.B FD_CLR
fgt einen Deskriptor zur Menge hinzu bzw. lscht diesen,
.B FD_ISSET
prft, ob der Deskriptor in der Menge enthalten ist.  Dieses ist
insbesondere nach einem
.BR "select()" -Aufruf
sinnvoll.

.I n
entspricht der Zahl des am hchsten nummerierten Datei-Deskriptors in allen
drei Mengen, plus 1.

.I timeout
ist eine obere zeitliche Grenze, die
.B select()
wartet, bis es weitergeht.  Ist der Wert null, kehrt
.B select()
sofort zurck.  Wenn
.I timeout
.B NULL
ist (kein timeout), kann
.B select()
unendlich lang blockieren.

.SH "RCKGABEWERTE"
Bei Erfolg gibt
.B select()
die Anzahl der Deskriptoren zurck, deren Status sich gendert hat.
Wenn ein Fehler aufgetreten ist, wird \-1 zurckgegeben und 
.I errno
entsprechend gesetzt.  Die Mengen und
.I timeout
befinden sich in einem undefinierten Zustand, auf deren Inhalt sollte
sich also bei einem Fehler nicht mehr verlassen werden.

.SH FEHLER
.TP 0.8i
.B EBADF
In einer der Mengen wurde ein ungltiger Datei-Deskriptor angegeben.
.TP
.B EINTR 
Ein nicht-blockierendes Signal wurde empfangen.
.TP
.B EINVAL 
.I n
ist negativ.
.TP
.B ENOMEM
.B select()
ist nicht in der Lage, Speicher fr die internen Tabellen zu
bekommen.

.SH ANMERKUNGEN
Einige Programme rufen
.B select()
mit drei leeren Mengen,
.I n
gleich null und einem von null verschiedenen
.I timeout
auf, um eine portable Mglichkeit zu haben, ein
.B sleep()
mit der Przision von Bruchteilen einer Sekunde zu benutzen.

Bei Linux wird
.I timeout
derart verndert, da es der nicht verstrichenen Zeit
entspricht (relativ zum vorherigen
.IR timeout ).
Die meisten anderen Implementierungen unterlassen dieses, was Probleme
mit sich bringt, wenn unter Linux geschriebener Quellcode, der
.I timeout
auswertet, auf andere Betriebssysteme portiert wird, und wenn Quellcode
von anderen Betriebssystemen auf Linux portiert wird, der das struct
timeval fr mehrere
.BR select() s
in einer Schleife ohne Reinitialisierung verwendet.  Portabler Code
sollte daher annehmen, da
.I timeout
undefiniert ist, nachdem
.B select()
beendet ist.

Nachdem der einzige Schreiber eine named Pipe schliet, wird
.B select()
zurckkehren und angeben, da etwas von der Pipe gelesen werden kann.
Wenn dann von dieser gelesen wird, wird 
.BR read (2)
0 zurckliefern, was das Dateiende markiert.  Code, der annimmt, da
.B select()
blockiert, sollte die Pipe mit
.B O_RDWR
statt
.B O_RDONLY
ffnen.

.SH BEISPIEL
.nf
#include <stdio.h>
#include <sys/time.h>
#include <sys/types.h>
#include <unistd.h>

int main(int argc, char *argv[])
{
    fd_set rfds;
    struct timeval tv;
    int retval;

    /* Achte auf stdin (fd 0), um zu sehen, wenn es
     * Eingaben gibt.
     */
    FD_ZERO(&rfds);
    FD_SET(0, &rfds);
    /* Warte bis zu fnf Sekunden. */
    tv.tv_sec = 5;
    tv.tv_usec = 0;

    retval = select(1, &rfds, NULL, NULL, &tv);
    /* Verla Dich jetzt blo nicht auf den Wert von tv! */

    if (retval)
        printf("Daten sind jetzt da.\\n");
        /* FD_ISSET(0, &rfds) mte jetzt true sein. */
    else
        printf("Keine Datein innerhalb von fnf Sekunden.\\n");

    exit(0);
}
.fi
.SH "SIEHE AUCH"
.BR accept (2),
.BR connect (2),
.BR read (2),
.BR recv (2),
.BR send (2),
.BR write (2).