.\" Copyright (c) 1983, 1991, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)select.2	8.2 (Berkeley) 3/25/94
.\" %FreeBSD: src/lib/libc/sys/select.2,v 1.29 2004/07/02 23:52:13 ru Exp %
.\"
.\" $FreeBSD$
.Dd November 17, 2002
.Dt SELECT 2
.Os
.Sh 名称
.Nm select
.Nd 同期的な入出力の多重化
.Sh ライブラリ
.Lb libc
.Sh 書式
.In sys/select.h
.Ft int
.Fn select "int nfds" "fd_set *readfds" "fd_set *writefds" "fd_set *exceptfds" "struct timeval *timeout"
.Fn FD_SET fd &fdset
.Fn FD_CLR fd &fdset
.Fn FD_ISSET fd &fdset
.Fn FD_ZERO &fdset
.Sh 解説
.Fn select
システムコールは、
.Fa readfds ,
.Fa writefds
および
.Fa exceptfds
でアドレスを渡された入出力記述子集合を調べ、
それらの記述子のいくつかがそれぞれ、読取り準備完了であるか、
書込み準備完了であるか、または保留されている例外条件があるかを調べます。
検出可能な唯一の例外条件は、ソケット上に受信した帯域外のデータです。
最初の
.Fa nfds
個の記述子が各集合内でチェックされます。
すなわち、記述子集合中の 0 〜
.Fa nfds Ns No -1
の記述子が調べられます。
戻り時に
.Fn select
システムコールは指定の記述子集合を、要求された操作の準備ができている記述子で
構成される部分集合で置き換えます。
.Fn select
は、すべての集合の中で準備ができた記述子の総数を返します。
.Pp
記述子の集合は、整数配列内のビットフィールドとして保存されます。
このような記述子集合を操作するために次のマクロが用意されています:
.Fn FD_ZERO &fdset
は記述子集合
.Fa fdset
を空集合で初期化します。
.Fn FD_SET fd &fdset
は特定の記述子
.Fa fd
を
.Fa fdset
に含めます。
.Fn FD_CLR fd &fdset
は
.Fa fd
を
.Fa fdset
から削除します。
.Fn FD_ISSET fd &fdset
は
.Fa fd
が
.Fa fdset
のメンバである場合は非 0 の値を、そうでない場合は 0 を返します。
これらのマクロの動作は、記述子の値が 0 未満であるか、または
.Dv FD_SETSIZE
以上である場合は未定義です。
.Dv FD_SETSIZE
は通常、少なくとも、システムがサポートする記述子の最大数に等しくなります。
.Pp
.Fa timeout
が、NULL ポインタでない場合、それはセレクションの完了を
待つ最大間隔を指定します。
システムの活動性が、この間隔を不定時間延長することがあります。
.Pp
.Fa timeout
が NULL ポインタの場合、
.Fn select
は無期限にブロックします。
.Pp
ポーリングのためには、
.Fa timeout
引数は NULL でなく、値が 0 の timeval 構造体を指しているべきです。
.Pp
.Fa readfds ,
.Fa writefds
および
.Fa exceptfds
のどれについても、いずれの記述子も興味がない場合は
NULL ポインタを指定できます。
.Sh 戻り値
.Fn select
システムコールは記述子集合に含まれている準備のできた記述子の数を返し、
エラーが起きた場合は -1 を返します。
タイムリミットが来ると、
.Fn select
は 0 を返します。
システムコールの割り込まれることによるものも含めて
.Fn select
がエラーで戻る場合は、記述子集合は変更されません。
.Sh エラー
.Fn select
から戻るエラーは次のことを示します:
.Bl -tag -width Er
.It Bq Er EBADF
記述子集合のどれかが無効な記述子を指定していました。
.It Bq Er EFAULT
.Fa readfds , writefds , exceptfds
または
.Fa timeout
の引数の 1 つが無効なアドレスを指しています。
.It Bq Er EINTR
タイムリミットが切れる前あるいは選択したイベントのいずれかが起きる前に、
シグナルが配送されました。
.It Bq Er EINVAL
指定のタイムリミットは無効です。
どれかが負であるか、または大きすぎます。
.It Bq Er EINVAL
.Fa nfds
引数が無効でした。
.El
.Sh 関連項目
.Xr accept 2 ,
.Xr connect 2 ,
.Xr getdtablesize 2 ,
.Xr gettimeofday 2 ,
.Xr kqueue 2 ,
.Xr poll 2 ,
.Xr read 2 ,
.Xr recv 2 ,
.Xr send 2 ,
.Xr write 2 ,
.Xr clocks 7
.Sh 注
.Dv FD_SETSIZE
のデフォルトのサイズは現時点では 1024 です。
多数のオープンファイルを使用する可能性があるプログラムで
.Fn select
を実行するために、
.In sys/types.h
を取り込むヘッダを含める前にプログラムで
.Dv FD_SETSIZE
を定義することで、このサイズを増加できます。
.Pp
.Fa nfds
がオープンファイルの数より大きい場合、
.Fn select
が未使用のファイル記述子を調査することは保証されていません。
歴史的な理由で、
.Fn select
は最初の 256 個の記述子を必ず調査します。
.Sh バグ
.St -susv2
では、システムが元の timeout を適当に更新することを許しています。
したがって、タイムアウトの値が
.Fn select
システムコールによって変更されないと想定するのは賢明ではありません。
.Sh 規格
.Fn select
システムコールおよび
.Fn FD_CLR ,
.Fn FD_ISSET ,
.Fn FD_SET ,
.Fn FD_ZERO
マクロは
.St -p1003.1-2001
に適合します。
.Sh 歴史
.Fn select
システムコールは
.Bx 4.2
で登場しました。