path: root/ja_JP.eucJP/man/man2/select.2

.\" 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.14.2.3 2001/07/22 12:06:51 dd Exp %
.\"
.\" $FreeBSD: doc/ja_JP.eucJP/man/man2/select.2,v 1.5 2001/05/14 01:08:23 horikawa Exp $
.Dd March 25, 1994
.Dt SELECT 2
.Os BSD 4.2
.Sh 名称
.Nm select
.Nd 同期的な入出力の多重化
.Sh ライブラリ
.Lb libc
.Sh 書式
.Fd #include <sys/types.h>
.Fd #include <sys/time.h>
.Fd #include <unistd.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
が、ヌルポインタでない場合、それはセレクションの完了を
待つ最大インターバルを指定します。
システムの活動性が、このインターバルを不定時間延長することがあります。
.Pp
.Fa timeout
がヌルポインタの場合、
.Fn select
は無期限にブロックします。
.Pp
ポーリングのためには、
.Fa timeout
引数はヌルでなく、値が 0 の timeval 構造体を指しているべきです。
.Pp
.Fa readfds ,
.Fa writefds
および
.Fa exceptfds
のどれについても、いずれの記述子も興味がない場合は
ヌルポインタを指定できます。
.Sh 戻り値
.Fn select
は記述子集合に含まれている準備のできた記述子の数を返し、
エラーが起きた場合は -1 を返します。
タイムリミットが来ると、
.Fn select
は 0 を返します。
割り込みによるものも含めて
.Fn select
がエラーで戻る場合は、記述子集合は変更されません。
.Sh エラー
.Fn select
から戻るエラーは次のことを示します。
.Bl -tag -width Er
.It Bq Er EBADF
記述子集合のどれかが無効な記述子を指定していました。
.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 read 2 ,
.Xr recv 2 ,
.Xr send 2 ,
.Xr write 2 ,
.Xr clocks 7
.Sh 注釈
.Dv FD_SETSIZE
のデフォルトのサイズは現時点では　
1024 です。
多数のオープンファイルを使用する可能性があるプログラムで
.Fn select
を実行するために、
.Aq Pa sys/types.h
を取り込むヘッダを含める前にプログラムで
.Dv FD_SETSIZE
を定義することで、このサイズを増加できます。
.Pp
.Fa nfds
がオープンファイルの数より大きい場合、
.Fn select
が未使用のファイル記述子を調査することは保証されていません。
歴史的な理由で、
.Fn select
は最初の
256 個の記述子を必ず調査します。
.Sh バグ
.St -susv2
では、システムが元の timeout を適当に更新することを許しています。
したがって、タイムアウトの値が
.Fn select
呼び出しによって変更されないと想定するのは賢明ではありません。
.Sh 歴史
.Fn select
関数は
.Bx 4.2
で登場しました。