OSDN Git Service

(split) LDP: Update draft and release (from the previous commit)
[linuxjm/LDP_man-pages.git] / release / man2 / epoll_wait.2
index 3ba3e1c..655f0e3 100644 (file)
@@ -36,7 +36,7 @@
 .\" Updated 2012-05-29, Akihiro MOTOKI <amotoki@gmail.com>
 .\" Updated 2013-03-26, Akihiro MOTOKI <amotoki@gmail.com>
 .\"
-.TH EPOLL_WAIT 2 2012\-08\-17 Linux "Linux Programmer's Manual"
+.TH EPOLL_WAIT 2 2014\-01\-31 Linux "Linux Programmer's Manual"
 .SH 名前
 epoll_wait, epoll_pwait \- epoll ファイルディスクリプタの I/O イベントを待つ
 .SH 書式
@@ -56,12 +56,21 @@ epoll_wait, epoll_pwait \- epoll ファイルディスクリプタの I/O イベ
 \fBepoll_wait\fP() によって返される。
 \fImaxevents\fP 引き数は 0 より大きくなければならない。
 
-\fItimeout\fP 引き数は、 \fBepoll_wait\fP() が停止する最小時間をミリ秒で指定
-する (この停止時間はシステムクロックの粒度に切り上げられ、カーネルの
-スケジューリング遅延により少しだけ長くなる可能性がある)。
-\fItimeout\fP を \-1 に指定すると、 \fBepoll_wait\fP() は無限に停止する。
-\fItimeout\fP を 0 に指定すると、 \fBepoll_wait\fP() は利用可能なイベントが
-なくても、すぐに返る。
+The \fItimeout\fP argument specifies the number of milliseconds that
+\fBepoll_wait\fP()  will block.  The call will block until either:
+.IP * 3
+a file descriptor delivers an event;
+.IP *
+the call is interrupted by a signal handler; or
+.IP *
+the timout expires.
+.PP
+Note that the \fItimeout\fP interval will be rounded up to the system clock
+granularity, and kernel scheduling delays mean that the blocking interval
+may overrun by a small amount.  Specifying a \fItimeout\fP of \-1 causes
+\fBepoll_wait\fP()  to block indefinitely, while specifying a \fItimeout\fP equal
+to zero cause \fBepoll_wait\fP()  to return immediately, even if no events are
+available.
 
 \fIstruct epoll_event\fP は以下のように定義される:
 .sp
@@ -120,8 +129,7 @@ struct epoll_event {
 \fIevents\fP で指されるメモリ領域に書き込み権限でアクセスできない。
 .TP 
 \fBEINTR\fP
-要求されたどのイベントも発生せず、かつ \fItimeout\fP の期限が切れる前に、
-システムコールがシグナルハンドラによって割り込まれた。
+(1) 要求されたどのイベントも発生せず、かつ (2) \fItimeout\fP の期限が切れる前に、システムコールがシグナルハンドラによって割り込まれた。
 \fBsignal\fP(7) 参照。
 .TP 
 \fBEINVAL\fP
@@ -152,6 +160,6 @@ struct epoll_event {
 .SH 関連項目
 \fBepoll_create\fP(2), \fBepoll_ctl\fP(2), \fBepoll\fP(7)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.63 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。