.\"
.TH EPOLL 7 2009-02-01 "Linux" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O epoll \- I/O event notification facility
-epoll \- I/O ¥¤¥Ù¥ó¥ÈÄÌÃε¡Ç½
+epoll \- I/O ã\82¤ã\83\99ã\83³ã\83\88é\80\9aç\9f¥æ©\9fè\83½
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.B #include <sys/epoll.h>
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O .B epoll
.\"O is a variant of
.\"O .BR poll (2)
.\"O .B epoll
.\"O instance:
.B epoll
-¤Ï
+は
.BR poll (2)
-¤Î°ì¼ï¤Ç¤¢¤ê¡¢¥¨¥Ã¥¸¥È¥ê¥¬¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤È
-¥ì¥Ù¥ë¥È¥ê¥¬¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Î¤É¤Á¤é¤È¤·¤Æ¤â»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤¡¢
-´Æ»ë¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î¿ô¤¬Â¿¤¤¾ì¹ç¤Ë¤â»ÈÍѤǤ¤ë¡£
+の一種であり、エッジトリガインタフェースと
+レベルトリガインタフェースのどちらとしても使用することができ、
+監視するファイルディスクリプタの数が多い場合にも使用できる。
.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤ÎºîÀ®¤ä´ÉÍý¤ò¹Ô¤¦¤¿¤á¤Ë
-°Ê²¼¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬Ä󶡤µ¤ì¤Æ¤¤¤ë:
+インスタンスの作成や管理を行うために
+以下のシステムコールが提供されている:
.IP * 3
.\"O An
.\"O .B epoll
.\"O extends the functionality of
.\"O .BR epoll_create (2).)
.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤Ï
+インスタンスは
.BR epoll_create (2)
-¤ÇºîÀ®¤µ¤ì¤ë¡£
+で作成される。
.BR epoll_create (2)
-¤ÏºîÀ®¤·¤¿ epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
-(¤â¤Ã¤È¿·¤·¤¤
+は作成した epoll インスタンスを参照するファイルディスクリプタを返す。
+(もっと新しい
.BR epoll_create1 (2)
-¤Ç¤Ï¡¢
+では、
.BR epoll_create (2)
-¤Îµ¡Ç½¤¬³ÈÄ¥¤µ¤ì¤Æ¤¤¤ë)¡£
+の機能が拡張されている)。
.IP *
.\"O Interest in particular file descriptors is then registered via
.\"O .BR epoll_ctl (2).
-ÆÃÄê¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂФ¹¤ë´Æ»ëÆâÍƤò
+特定のファイルディスクリプタに対する監視内容を
.BR epoll_ctl (2)
-¤ÇÅÐÏ¿¤¹¤ë¡£
+で登録する。
.\"O The set of file descriptors currently registered on an
.\"O .B epoll
.\"O instance is sometimes called an
.\"O .I epoll
.\"O set.
.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤Ë¸½ºßÅÐÏ¿¤µ¤ì¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î½¸¹ç¤Ï
+インスタンスに現在登録されているファイルディスクリプタの集合は
.I epoll
-½¸¹ç¤È¸Æ¤Ð¤ì¤ë¤³¤È¤â¤¢¤ë¡£
+集合と呼ばれることもある。
.IP *
.\"O Finally, the actual wait is started by
.\"O .BR epoll_wait (2).
-ºÇ¸å¤Ë
+最後に
.BR epoll_wait (2)
-¤Ç¼ÂºÝ¤Î¥¤¥Ù¥ó¥ÈÂÔ¤Á¤ò³«»Ï¤¹¤ë¡£
+で実際のイベント待ちを開始する。
.\"O .SS Level-Triggered and Edge-Triggered
-.SS ¥ì¥Ù¥ë¥È¥ê¥¬¤È¥¨¥Ã¥¸¥È¥ê¥¬
+.SS ã\83¬ã\83\99ã\83«ã\83\88ã\83ªã\82¬ã\81¨ã\82¨ã\83\83ã\82¸ã\83\88ã\83ªã\82¬
.\"O The
.\"O .B epoll
.\"O event distribution interface is able to behave both as edge-triggered
.\"O Suppose that
.\"O this scenario happens:
.B epoll
-¥¤¥Ù¥ó¥ÈÇÛÁ÷ (distribution) ¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï¡¢
-¥¨¥Ã¥¸¥È¥ê¥¬ (ET) ¤È¤·¤Æ¤â¥ì¥Ù¥ë¥È¥ê¥¬ (LT) ¤È¤·¤Æ¤âÆ°ºî¤µ¤»¤ë¤³¤È¤¬¤Ç¤¤ë¡£
-Æó¤Ä¤ÎÇÛÁ÷µ¡¹½¤Î°ã¤¤¤Ï¡¢¼¡¤Î¤è¤¦¤ËÀâÌÀ¤Ç¤¤ë¡£
-¤³¤Î¤è¤¦¤Ê¥·¥Ê¥ê¥ª¤¬µ¯¤³¤Ã¤¿¤È¤·¤è¤¦:
+イベント配送 (distribution) インタフェースは、
+エッジトリガ (ET) としてもレベルトリガ (LT) としても動作させることができる。
+二つの配送機構の違いは、次のように説明できる。
+このようなシナリオが起こったとしよう:
.IP 1. 3
.\"O The file descriptor that represents the read side of a pipe
.\"O .RI ( rfd )
.\"O is registered on the
.\"O .B epoll
.\"O instance.
-¥Ñ¥¤¥×¤ÎÆɤ߹þ¤ß¦¤òɽ¤¹¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
+ã\83\91ã\82¤ã\83\97ã\81®èªã\81¿è¾¼ã\81¿å\81´ã\82\92表ã\81\99ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
.RI ( rfd )
-¤¬
+が
.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤ËÅÐÏ¿¤µ¤ì¤ë¡£
+インスタンスに登録される。
.IP 2.
.\"O A pipe writer writes 2 kB of data on the write side of the pipe.
-¥Ñ¥¤¥×¤Ø½ñ¤¹þ¤à¥×¥í¥°¥é¥à¤¬ 2 kB ¤Î¥Ç¡¼¥¿¤ò¥Ñ¥¤¥×¤Î½ñ¤¹þ¤ß¦¤Ø½ñ¤¹þ¤à¡£
+パイプへ書き込むプログラムが 2 kB のデータをパイプの書き込み側へ書き込む。
.IP 3.
.\"O A call to
.\"O .BR epoll_wait (2)
.\"O .I rfd
.\"O as a ready file descriptor.
.BR epoll_wait (2)
-¤ò¸Æ¤Ó½Ð¤¹¤È¡¢Æɤ߹þ¤ß²Äǽ (ready) ¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤È¤·¤Æ
+を呼び出すと、読み込み可能 (ready) なファイルディスクリプタとして
.I rfd
-¤¬Ê֤롣
+が返る。
.IP 4.
.\"O The pipe reader reads 1 kB of data from
.\"O .IR rfd .
-¥Ñ¥¤¥×¤«¤éÆɤ߽Ф¹¥×¥í¥°¥é¥à¤¬¡¢1 kB ¤Î¥Ç¡¼¥¿¤ò
+パイプから読み出すプログラムが、1 kB のデータを
.I rfd
-¤«¤éÆɤ߽Ф¹¡£
+から読み出す。
.IP 5.
.\"O A call to
.\"O .BR epoll_wait (2)
.\"O is done.
.BR epoll_wait (2)
-¤Î¸Æ¤Ó½Ð¤·¤¬¹Ô¤ï¤ì¤ë¡£
+の呼び出しが行われる。
.PP
.\"O If the
.\"O .I rfd
.\"O The reason for this is that edge-triggered mode only
.\"O delivers events when changes occur on the monitored file descriptor.
.I rfd
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬
+ファイルディスクリプタが
.B EPOLLET
-¥Õ¥é¥° (¥¨¥Ã¥¸¥È¥ê¥¬) ¤ò»È¤Ã¤Æ
+フラグ (エッジトリガ) を使って
.B epoll
-¤ËÄɲ䵤ì¤Æ¤¤¤ë¤È¡¢
-ÍøÍѲÄǽ¤Ê¥Ç¡¼¥¿¤¬¥Õ¥¡¥¤¥ëÆþÎϥХåե¡¤Ë¤Þ¤À¸ºß¤¹¤ë¤Ë¤â¤«¤«¤ï¤é¤º
-¥¹¥Æ¥Ã¥×
+に追加されていると、
+利用可能なデータがファイル入力バッファにまだ存在するにもかかわらず
+ステップ
.B 5
-¤Î
+の
.BR epoll_wait (2)
-¤Î¸Æ¤Ó½Ð¤·¤Ç¥Ï¥ó¥°¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£
-¤½¤Î°ìÊý¤Ç¡¢¥ê¥â¡¼¥È¤ÎÀܳÀè (peer) ¤Ï´û¤ËÁ÷¤é¤ì¤¿¥Ç¡¼¥¿¤Ë
-´ð¤Å¤¤¤Æ±þÅú¤ò´üÂÔ¤·¤Æ¤¤¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
-¤³¤Î¤è¤¦¤Ê¤³¤È¤¬µ¯¤³¤ëÍýͳ¤Ï¡¢¥¨¥Ã¥¸¥È¥ê¥¬¥¤¥Ù¥ó¥ÈÇÛÁ÷¤Ç¤Ï¡¢
-¥â¥Ë¥¿¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¤Ç¥¤¥Ù¥ó¥È¤¬µ¯¤Ã¤¿¤È¤¤Ë¤Î¤ß¥¤¥Ù¥ó¥È¤¬
-ÇÛÁ÷¤µ¤ì¤ë¤¿¤á¤Ç¤¢¤ë¡£
+の呼び出しでハングする可能性がある。
+その一方で、リモートの接続先 (peer) は既に送られたデータに
+基づいて応答を期待しているかもしれない。
+このようなことが起こる理由は、エッジトリガイベント配送では、
+モニタしているファイルでイベントが起ったときにのみイベントが
+配送されるためである。
.\"O So, in step
.\"O .B 5
.\"O the caller might end up waiting for some data that is already present inside
.\"O the input buffer.
-¤·¤¿¤¬¤Ã¤Æ¡¢¥¹¥Æ¥Ã¥×
+したがって、ステップ
.B 5
-¤Ç¤Ï¡¢¸Æ¤Ó½Ð¤·Â¦¤Ï·ë²ÌŪ¤Ë
-ÆþÎϥХåե¡Æâ¤Ë¤¹¤Ç¸ºß¤¹¤ë¥Ç¡¼¥¿¤òÂԤĤ³¤È¤Ë¤Ê¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
+では、呼び出し側は結果的に
+入力バッファ内にすで存在するデータを待つことになるかもしれない。
.\"O In the above example, an event on
.\"O .I rfd
.\"O will be generated because of the write done in
.\"O .B 2
.\"O and the event is consumed in
.\"O .BR 3 .
-¾åµ¤ÎÎã¤Ç¤Ï¡¢
+上記の例では、
.B 2
-¤Ç¹Ô¤ï¤ì¤¿½ñ¤¹þ¤ß¤Ë¤è¤Ã¤Æ
+で行われた書き込みによって
.I rfd
-¤Ë´Ø¤¹¤ë¥¤¥Ù¥ó¥È¤¬À¸À®¤µ¤ì¡¢
+に関するイベントが生成され、
.B 3
-¤Ç¥¤¥Ù¥ó¥È¤¬¾ÃÈñ (consume) ¤µ¤ì¤ë¡£
+でイベントが消費 (consume) される。
.\"O Since the read operation done in
.\"O .B 4
.\"O does not consume the whole buffer data, the call to
.\"O .B 5
.\"O might block indefinitely.
.B 4
-¤Ç¹Ô¤ï¤ì¤ëÆɤ߹þ¤ßÁàºî¤Ç¤Ï¡¢Á´Éô¤Î¥Ð¥Ã¥Õ¥¡¥Ç¡¼¥¿¤ò¾ÃÈñ¤·¤Ê¤¤¤Î¤Ç¡¢
-¥¹¥Æ¥Ã¥×
+で行われる読み込み操作では、全部のバッファデータを消費しないので、
+ステップ
.B 5
-¤Ç¹Ô¤ï¤ì¤ë
+で行われる
.BR epoll_wait (2)
-¤Î¸Æ¤Ó½Ð¤·¤¬
-̵´ü¸Â¤ËÄä»ß (block) ¤¹¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
+の呼び出しが
+無期限に停止 (block) するかもしれない。
.\"O An application that employs the
.\"O .B EPOLLET
.\"O flag should use nonblocking file descriptors to avoid having a blocking
.\"O read or write starve a task that is handling multiple file descriptors.
.B EPOLLET
-¥Õ¥é¥°¤òºÎÍѤ¹¤ë¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç¤Ï¡¢
-¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï¥Ö¥í¥Ã¥¯¤·¤Ê¤¤ (nonblocking) ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò
-»È¤¦¤Ù¤¤Ç¤¢¤ë¡£
-¤³¤ì¤Ï¡¢¥Ö¥í¥Ã¥¯¤µ¤ì¤ëÆɤ߹þ¤ß¤ä½ñ¤¹þ¤ß¤Ë¤è¤Ã¤Æ¡¢
-Ê£¿ô¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò°·¤¦¥¿¥¹¥¯¤¬
-Ää»ß¤·¤Æ¤·¤Þ¤¦¤Î¤òÈò¤±¤ë¤¿¤á¤Ç¤¢¤ë¡£
+フラグを採用するアプリケーションでは、
+インタフェースはブロックしない (nonblocking) ファイルディスクリプタを
+使うべきである。
+これは、ブロックされる読み込みや書き込みによって、
+複数のファイルディスクリプタを扱うタスクが
+停止してしまうのを避けるためである。
.\"O The suggested way to use
.\"O .B epoll
.\"O as an edge-triggered
.\"O .RB ( EPOLLET )
.\"O interface is as follows:
.B epoll
-¤ò¥¨¥Ã¥¸¥È¥ê¥¬
+ã\82\92ã\82¨ã\83\83ã\82¸ã\83\88ã\83ªã\82¬
.RB ( EPOLLET )
-¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤È¤·¤Æ»È¤¦¤¿¤á¤ËÄó°Æ¤µ¤ì¤ëÊýË¡¤Ï°Ê²¼¤ÎÄ̤ê¤Ç¤¢¤ë¡£
+インタフェースとして使うために提案される方法は以下の通りである。
.RS
.TP 4
.B i
.\"O with nonblocking file descriptors; and
-¥Ö¥í¥Ã¥¯¤·¤Ê¤¤¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤È¶¦¤Ë»È¤¦¡£
+ブロックしないファイルディスクリプタと共に使う。
.TP
.B ii
.\"O by waiting for an event only after
.\"O return
.\"O .BR EAGAIN .
.BR read (2)
-¤Þ¤¿¤Ï
+または
.BR write (2)
-¤¬
+が
.B EAGAIN
-¤òÊÖ¤·¤¿¸å¤Ç¤Î¤ß¡¢¥¤¥Ù¥ó¥È¤òÂԤġ£
+を返した後でのみ、イベントを待つ。
.RE
.PP
.\"O By contrast, when used as a level-triggered interface
.\"O .BR poll (2),
.\"O and can be used wherever the latter is used since it shares the
.\"O same semantics.
-°ìÊý¡¢¥ì¥Ù¥ë¥È¥ê¥¬¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤È¤·¤Æ»È¤¦¾ì¹ç
- (¤³¤Á¤é¤¬¥Ç¥Õ¥©¥ë¥È¤Ç¤¢¤ë¡¢
+一方、レベルトリガインタフェースとして使う場合
+ (こちらがデフォルトである、
.B EPOLLET
-¤¬»ØÄꤵ¤ì¤Ê¤«¤Ã¤¿¾ì¹ç)¡¢
+が指定されなかった場合)、
.B epoll
-¤Ïñ¤Ë¹â®¤Ê
+は単に高速な
.BR poll (2)
-¤Ç¤¢¤ê¡¢»È¤¤Êý¤¬Æ±¤¸¤Ê¤Î¤Ç¡¢
+であり、使い方が同じなので、
.BR poll (2)
-¤¬»È¤ï¤ì¤Æ¤¤¤ë¤È¤³¤í¤Ç¤Ï¤É¤³¤Ç¤â»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
+が使われているところではどこでも使用することができる。
.\"O Since even with edge-triggered
.\"O .BR epoll ,
.\"O .B epoll
.\"O to disable the associated file descriptor after the receipt of an event with
.\"O .BR epoll_wait (2).
-¥¨¥Ã¥¸¥È¥ê¥¬¤ò»È¤Ã¤¿¾ì¹ç¤Ç¤â¡¢Ê£¿ô¤Î¥Ç¡¼¥¿¤ò¼õ¿®¤¹¤ë¤ÈÊ£¿ô¤Î
+エッジトリガを使った場合でも、複数のデータを受信すると複数の
.B epoll
-¥¤¥Ù¥ó¥È¤¬À¸À®¤µ¤ì¤ë¤Î¤Ç¡¢
-¸Æ¤Ó½Ð¤·Â¦¤Ë¤Ï
+イベントが生成されるので、
+呼び出し側には
.B EPOLLONESHOT
-¥Õ¥é¥°¤ò»ØÄꤹ¤ë¥ª¥×¥·¥ç¥ó¤¬¤¢¤ë¡£
-¤³¤Î¥Õ¥é¥°¤Ï
+フラグを指定するオプションがある。
+このフラグは
.B epoll
-¤ËÂФ·¤Æ¡¢
+に対して、
.BR epoll_wait (2)
-¤Ë¤è¤ë¥¤¥Ù¥ó¥È¤ò¼õ¿®¤·¤¿¸å¤Ç¡¢´ØÏ¢¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò̵¸ú¤Ë¤µ¤»¤ë¡£
+によるイベントを受信した後で、関連するファイルディスクリプタを無効にさせる。
.\"O When the
.\"O .B EPOLLONESHOT
.\"O flag is specified,
.\"O with
.\"O .BR EPOLL_CTL_MOD .
.B EPOLLONESHOT
-¥Õ¥é¥°¤¬»ØÄꤵ¤ì¤¿¾ì¹ç¡¢
+フラグが指定された場合、
.BR epoll_ctl (2)
-¤Ë
+に
.B EPOLL_CTL_MOD
-¤ò»ØÄꤷ¤Æ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òºÆÅÙ»ÈÍѤǤ¤ë¤è¤¦¤Ë¤¹¤ë¤Î¤Ï¡¢
-¸Æ¤Ó½Ð¤·Â¦¤ÎÀÕǤ¤Ç¤¢¤ë¡£
+を指定してファイルディスクリプタを再度使用できるようにするのは、
+呼び出し側の責任である。
.\"O .SS /proc interfaces
-.SS /proc ¥¤¥ó¥¿¥Õ¥§¡¼¥¹
+.SS /proc ã\82¤ã\83³ã\82¿ã\83\95ã\82§ã\83¼ã\82¹
.\"O The following interfaces can be used to limit the amount of
.\"O kernel memory consumed by epoll:
-epoll ¤¬¾ÃÈñ¤¹¤ë¥«¡¼¥Í¥ë¥á¥â¥ê¤ÎÎ̤òÀ©¸Â¤¹¤ë¤¿¤á¤Ë¡¢
-°Ê²¼¤Î¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤ò»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
+epoll が消費するカーネルメモリの量を制限するために、
+以下のインタフェースを使用することができる。
.TP
.\" Following was added in 2.6.28, but them removed in 2.6.29
.\" .TP
.\" that can be created per real user ID.
.TP
.\"O .IR /proc/sys/fs/epoll/max_user_watches " (since Linux 2.6.28)"
-.IR /proc/sys/fs/epoll/max_user_watches " (Linux 2.6.28 °Ê¹ß)"
+.IR /proc/sys/fs/epoll/max_user_watches " (Linux 2.6.28 以降)"
.\"O This specifies a limit on the total number of
.\"O file descriptors that a user can register across
.\"O all epoll instances on the system.
.\"O Each registered file descriptor costs roughly 90 bytes on a 32-bit kernel,
.\"O and roughly 160 bytes on a 64-bit kernel.
.\"O Currently,
-¤³¤Î¥Õ¥¡¥¤¥ë¤Ï¡¢¤¢¤ë¥æ¡¼¥¶¤¬¥·¥¹¥Æ¥à¾å¤ÎÁ´¤Æ¤Î epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤Ë
-ÅÐÏ¿¤Ç¤¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÎÁí¿ô¤Î¾å¸Â¤òµ¬Äꤹ¤ë¡£
-¤³¤Î¾å¸Â¤Ï¼Â¥æ¡¼¥¶ ID ñ°Ì¤Ç¤¢¤ë¡£
-ÅÐÏ¿¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿ 1 ¤Ä¤¬¾ÃÈñ¤¹¤ë¥á¥â¥êÎ̤ϡ¢
-32 ¥Ó¥Ã¥È¥«¡¼¥Í¥ë¤Ç¤ª¤è¤½ 90 ¥Ð¥¤¥È¡¢
-64 ¥Ó¥Ã¥È¥«¡¼¥Í¥ë¤Ç¤ª¤è¤½ 160 ¥Ð¥¤¥È¤Ç¤¢¤ë¡£
+このファイルは、あるユーザがシステム上の全ての epoll インスタンスに
+登録できるファイルディスクリプタの総数の上限を規定する。
+この上限は実ユーザ ID 単位である。
+登録されたファイルディスクリプタ 1 つが消費するメモリ量は、
+32 ビットカーネルでおよそ 90 バイト、
+64 ビットカーネルでおよそ 160 バイトである。
.\" 2.6.29 (in 2.6.28, the default was 1/32 of lowmem)
.\"O the default value for
.\"O .I max_user_watches
.\"O is 1/25 (4%) of the available low memory,
.\"O divided by the registration cost in bytes.
-.\"O motoki: low memory ¤ÎÌõ¤Ë¼«¿®¤Ê¤·¡£
-¸½ºß¤Î¤È¤³¤í¡¢
+.\"O motoki: low memory の訳に自信なし。
+現在のところ、
.I max_user_watches
-¤Î¥Ç¥Õ¥©¥ë¥ÈÃͤϡ¢ÍøÍѲÄǽ¤Ê¥á¥â¥ê²¼¸Â¤Î 1/25 (4%) ¤Ç¤¢¤ê¡¢
-ÅÐÏ¿¤Ç¾ÃÈñ¤µ¤ì¤ë¥á¥â¥êÎÌ (¥Ð¥¤¥Èñ°Ì) ¤Ç³ä¤Ã¤¿ÃͤȤʤ롣
+のデフォルト値は、利用可能なメモリ下限の 1/25 (4%) であり、
+登録で消費されるメモリ量 (バイト単位) で割った値となる。
.\"O .SS Example for Suggested Usage
-.SS ¤ª¤¹¤¹¤á¤Ê»ÈÍÑÎã
+.SS おすすめな使用例
.\"O While the usage of
.\"O .B epoll
.\"O when employed as a level-triggered interface does have the same
.\"O .BR poll (2),
.\"O the edge-triggered usage requires more clarification to avoid stalls
.\"O in the application event loop.
-¥ì¥Ù¥ë¥È¥ê¥¬¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤È¤·¤Æ»ÈÍѤ¹¤ë¤È¤¤Î
+レベルトリガインタフェースとして使用するときの
.B epoll
-¤Î»È¤¤Êý¤Ï
+の使い方は
.BR poll (2)
-¤ÈƱ¤¸¤Ç¤¢¤ë¡£
-¤·¤«¤·¥¨¥Ã¥¸¥È¥ê¥¬¤È¤·¤Æ»È¤¦¾ì¹ç¤Ï¡¢
-¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Î¥¤¥Ù¥ó¥È¥ë¡¼¥×¤Ç¥¹¥È¡¼¥ë (stall) ¤·¤Ê¤¤¤è¤¦¤Ë¡¢
-»È¤¤Êý¤ò¤è¤êÌÀ³Î¤Ë¤·¤Æ¤ª¤¯É¬Íפ¬¤¢¤ë¡£
+と同じである。
+しかしエッジトリガとして使う場合は、
+アプリケーションのイベントループでストール (stall) しないように、
+使い方をより明確にしておく必要がある。
.\"O In this example, listener is a
.\"O nonblocking socket on which
.\"O .BR listen (2)
.\"O .BR read (2)
.\"O or
.\"O .BR write (2).
-¤³¤ÎÎã¤Ç¤Ï¡¢¥ê¥¹¥Ê¤Ï¥Ö¥í¥Ã¥¯¤·¤Ê¤¤¥½¥±¥Ã¥È¤Ç¤¢¤ê¡¢
+この例では、リスナはブロックしないソケットであり、
.BR listen (2)
-¤¬¸Æ¤Ð¤ì¤Æ¤¤¤ë¡£
-´Ø¿ô
+が呼ばれている。
+関数
.I do_use_fd()
-¤Ï¡¢
+は、
.BR read (2)
-¤Þ¤¿¤Ï
+または
.BR write (2)
-¤Ë¤è¤Ã¤Æ
+によって
.B EAGAIN
-¤¬ÊÖ¤µ¤ì¤ë¤Þ¤Ç¤Ï¡¢¿·¤·¤¤½àÈ÷ºÑ¤ß¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò»È¤¦¡£
+が返されるまでは、新しい準備済みのファイルディスクリプタを使う。
.\"O An event-driven state machine application should, after having received
.\"O .BR EAGAIN ,
.\"O record its current state so that at the next call to
.\"O or
.\"O .BR write (2)
.\"O from where it stopped before.
-¥¤¥Ù¥ó¥È¶îÆ°¥¹¥Æ¡¼¥È¥Þ¥·¥ó¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ï¡¢
+イベント駆動ステートマシンアプリケーションは、
.B EAGAIN
-¤ò¼õ¿®¤·¤¿¸å¡¢¥«¥ì¥ó¥È¤Î¾õÂÖ¤òµÏ¿¤·¤Æ¤ª¤¯¤Ù¤¤Ç¤¢¤ë¡£
-¤³¤ì¤Ë¤è¤ê¡¢¼¡¤Î
+を受信した後、カレントの状態を記録しておくべきである。
+これにより、次の
.I do_use_fd()
-¸Æ¤Ó½Ð¤·¤Î¤È¤¤Ë¡¢°ÊÁ°¤ËÄä»ß¤·¤¿¤È¤³¤í¤«¤é
+呼び出しのときに、以前に停止したところから
.BR read (2)
-¤Þ¤¿¤Ï
+または
.BR write (2)
-¤ò·Ñ³¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
+を継続することができる。
.in +4n
.nf
.\"O .BR epoll_ctl (2)
.\"O with
.\"O .BR EPOLL_CTL_MOD .
-¥¨¥Ã¥¸¥È¥ê¥¬¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤È¤·¤Æ»È¤¦¾ì¹ç¡¢Àǽ¾å¤ÎÍýͳ¤Ë¤è¤ê¡¢
-°ìÅÙ
+エッジトリガインタフェースとして使う場合、性能上の理由により、
+一度
.RB ( EPOLLIN | EPOLLOUT )
-¤ò»ØÄꤷ¤Æ¤«¤é
+を指定してから
.RB ( EPOLL_CTL_ADD
-¤Ç) ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò
+で) ファイルディスクリプタを
.B epoll
-¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤ËÄɲ乤뤳¤È¤¬¤Ç¤¤ë¡£
-¤³¤ì¤Ë¤è¤ê¡¢
+インタフェースに追加することができる。
+これにより、
.BR epoll_ctl (2)
-¤Ë
+に
.B EPOLL_CTL_MOD
-¤ò»ØÄꤷ¤Æ¸Æ¤Ó½Ð¤¹¤³¤È¤Ç
+を指定して呼び出すことで
.B EPOLLIN
-¤È
+と
.B EPOLLOUT
-¤ÎϢ³Ū¤ÊÀÚ¤êÂؤ¨¤¬Èò¤±¤é¤ì¤ë¡£
+の連続的な切り替えが避けられる。
.\"O .SS Questions and Answers
-.SS ¼ÁÌä¤È²òÅú
+.SS 質問と解答
.TP 4
.B Q0
.\"O What is the key used to distinguish the file descriptors registered in an
.\"O .B epoll
.\"O set?
.B epoll
-½¸¹çÆâ¤ÎÅÐÏ¿¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¶èÊ̤¹¤ë¤Ë¤Ï¡¢
-²¿¤ò¥¡¼¤È¤·¤Æ»È¤¨¤Ð¤è¤¤¤«¡©
+集合内の登録されたファイルディスクリプタを区別するには、
+何をキーとして使えばよいか？
.TP
.B A0
.\"O The key is the combination of the file descriptor number and
.\"O the open file description
.\"O (also known as an "open file handle",
.\"O the kernel's internal representation of an open file).
-¥¡¼¤Ï¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿ÈÖ¹æ¤È¥ª¡¼¥×¥ó¥Õ¥¡¥¤¥ëµ½Ò (open file
-description) ¤ÎÁȤǤ¢¤ë (¥ª¡¼¥×¥ó¥Õ¥¡¥¤¥ëµ½Ò¤Ï "open file handle" ¤È¤â
-¸Æ¤Ð¤ì¡¢¥ª¡¼¥×¥ó¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤Î¥«¡¼¥Í¥ë¤ÎÆâÉôɽ¸½¤Ç¤¢¤ë)¡£
+キーはファイルディスクリプタ番号とオープンファイル記述 (open file
+description) の組である (オープンファイル記述は "open file handle" とも
+呼ばれ、オープンされたファイルのカーネルの内部表現である)。
.TP
.B Q1
.\"O What happens if you register the same file descriptor on an
.\"O .B epoll
.\"O instance twice?
-1 ¤Ä¤Î
+1 つの
.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤ËƱ¤¸¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò 2 ²óÅÐÏ¿¤¹¤ë¤È¤É¤¦¤Ê¤ë¤«¡©
+インスタンスに同じファイルディスクリプタを 2 回登録するとどうなるか？
.TP
.B A1
.\"O You will probably get
.\"O descriptor to the same
.\"O .B epoll
.\"O instance.
-¤¿¤Ö¤ó
+たぶん
.B EEXIST
-¤ò¼õ¤±¼è¤ë¤À¤í¤¦¡£
-¤·¤«¤·¤Ê¤¬¤é¡¢Æ±¤¸
+を受け取るだろう。
+しかしながら、同じ
.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤ËÂФ·¤ÆÊ£À½¤µ¤ì¤¿¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÄɲ乤뤳¤È¤Ï²Äǽ¤Ç¤¢¤ë
+インスタンスに対して複製されたディスクリプタを追加することは可能である
.RB ( dup (2),
.BR dup2 (2),
.BR fcntl (2)
.B F_DUPFD
-¤Ê¤É)¡£
+など)。
.\" But a descriptor duplicated by fork(2) can't be added to the
.\" set, because the [file *, fd] pair is already in the epoll set.
.\" That is a somewhat ugly inconsistency. On the one hand, a child process
.\"O if the duplicate file descriptors are registered with different
.\"O .I events
.\"O masks.
-Ê£À½¤·¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò°Û¤Ê¤ë
+複製したファイルディスクリプタを異なる
.I events
-¥Þ¥¹¥¯¤ÇÅÐÏ¿¤¹¤ì¤Ð¡¢¥¤¥Ù¥ó¥È¤ò¥Õ¥£¥ë¥¿¥ê¥ó¥°¤¹¤ë¤Î¤Ë
-¤³¤Îµ¡Ç½¤ÏÍÍѤʼêË¡¤Ç¤¢¤ë¡£
+マスクで登録すれば、イベントをフィルタリングするのに
+この機能は有用な手法である。
.TP
.B Q2
.\"O Can two
.\"O If so, are events reported to both
.\"O .B epoll
.\"O file descriptors?
-2 ¤Ä¤Î
+2 つの
.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤¬Æ±¤¸¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÂÔ¤Á¼õ¤±¤ë¤³¤È¤Ï²Äǽ¤«¡©
-¤â¤·²Äǽ¤Ç¤¢¤ì¤Ð¡¢¥¤¥Ù¥ó¥È¤ÏξÊý¤Î
+インスタンスが同じファイルディスクリプタを待ち受けることは可能か？
+もし可能であれば、イベントは両方の
.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÊó¹ð¤µ¤ì¤ë¤«¡©
+ファイルディスクリプタに報告されるか？
.TP
.B A2
.\"O Yes, and events would be reported to both.
.\"O However, careful programming may be needed to do this correctly.
-¥¤¥Ù¥ó¥È¤ÏξÊý¤ËÊó¹ð¤µ¤ì¤ë¡£
-¤·¤«¤·¤Ê¤¬¤é¡¢¤³¤ì¤òÀµ¤·¤¯°·¤¦¤Ë¤ÏÃí°Õ¿¼¤¯¥×¥í¥°¥é¥ß¥ó¥°¤¹¤ëɬÍפ¬
-¤¢¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
+イベントは両方に報告される。
+しかしながら、これを正しく扱うには注意深くプログラミングする必要が
+あるかもしれない。
.TP
.B Q3
.\"O Is the
.\"O .B epoll
.\"O file descriptor itself poll/epoll/selectable?
.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¼«¿È¤Ï poll/epoll/select ¤¬²Äǽ¤«¡©
+ファイルディスクリプタ自身は poll/epoll/select が可能か？
.TP
.B A3
.\"O Yes.
.\"O .B epoll
.\"O file descriptor has events waiting then it will
.\"O indicate as being readable.
-²Äǽ¤Ç¤¢¤ë¡£
+可能である。
.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ë½èÍýÂÔ¤Á¤Î¥¤¥Ù¥ó¥È¤¬¤¢¤ë¾ì¹ç¤Ï¡¢
-Æɤ߽Ф·²Äǽ¤À¤ÈÄÌÃΤµ¤ì¤ë¤³¤È¤À¤í¤¦¡£
+ファイルディスクリプタに処理待ちのイベントがある場合は、
+読み出し可能だと通知されることだろう。
.TP
.B Q4
.\"O What happens if one attempts to put an
.\"O .B epoll
.\"O file descriptor into its own file descriptor set?
.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¼«¿È¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿½¸¹ç¤Ë
-Æþ¤ì¤è¤¦¤È¤¹¤ë¤È¤É¤¦¤Ê¤ë¤«¡©
+ファイルディスクリプタを自身のファイルディスクリプタ集合に
+入れようとするとどうなるか？
.TP
.B A4
.\"O The
.\"O .B epoll
.\"O file descriptor set.
.BR epoll_ctl (2)
-¤Î¸Æ¤Ó½Ð¤·¤Ï
+の呼び出しは
.RB ( EINVAL
-¤Ç) ¼ºÇÔ¤¹¤ë¤À¤í¤¦¡£
-¤¿¤À¤·
+で) 失敗するだろう。
+ただし
.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¾¤Î
+ファイルディスクリプタを他の
.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿½¸¹ç¤ÎÆâÉô¤ËÄɲ乤뤳¤È¤Ï²Äǽ¤Ç¤¢¤ë¡£
+ファイルディスクリプタ集合の内部に追加することは可能である。
.TP
.B Q5
.\"O Can I send an
.\"O .B epoll
.\"O file descriptor over a UNIX domain socket to another process?
.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò UNIX ¥É¥á¥¤¥ó¥½¥±¥Ã¥È¤Ç¾¤Î¥×¥í¥»¥¹¤ËÁ÷¤ë¤³¤È¤Ï²Äǽ¤«¡©
+ファイルディスクリプタを UNIX ドメインソケットで他のプロセスに送ることは可能か？
.TP
.B A5
.\"O Yes, but it does not make sense to do this, since the receiving process
.\"O would not have copies of the file descriptors in the
.\"O .B epoll
.\"O set.
-²Äǽ¤À¤¬¡¢¤³¤ì¤ò¤¹¤ë¤³¤È¤Ë°ÕÌ£¤Ï¤Ê¤¤¡£
-¤Ê¤¼¤Ê¤é¡¢¼õ¿®Â¦¤Î¥×¥í¥»¥¹¤¬
+可能だが、これをすることに意味はない。
+なぜなら、受信側のプロセスが
.B epoll
-½¸¹çÆâ¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î¥³¥Ô¡¼¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¤«¤é¤Ç¤¢¤ë¡£
+集合内のファイルディスクリプタのコピーを持っていないからである。
.TP
.B Q6
.\"O Will closing a file descriptor cause it to be removed from all
.\"O .B epoll
.\"O sets automatically?
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¥¯¥í¡¼¥º¤¹¤ë¤È¡¢¤½¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÏÁ´¤Æ¤Î
+ファイルディスクリプタをクローズすると、そのファイルディスクリプタは全ての
.B epoll
-½¸¹ç¤«¤é¼«Æ°Åª¤Ëºï½ü¤µ¤ì¤ë¤«¡©
+集合から自動的に削除されるか？
.TP
.B A6
.\"O Yes, but be aware of the following point.
-ºï½ü¤µ¤ì¤ë¤¬¡¢°Ê²¼¤ÎÅÀ¤ËÃí°Õ¤¬É¬ÍפǤ¢¤ë¡£
+削除されるが、以下の点に注意が必要である。
.\"O A file descriptor is a reference to an open file description (see
.\"O .BR open (2)).
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¥ª¡¼¥×¥ó¥Õ¥¡¥¤¥ëµ½Ò
+ファイルディスクリプタはオープンファイル記述
.RB ( open (2)
-»²¾È) ¤Ø¤Î»²¾È¤Ç¤¢¤ë¡£
+参照) への参照である。
.\"O Whenever a descriptor is duplicated via
.\"O .BR dup (2),
.\"O .BR dup2 (2),
.\"O .BR fork (2),
.\"O a new file descriptor referring to the same open file description is
.\"O created.
-¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÎÊ£À½¤ò
+ディスクリプタの複製を
.BR dup (2),
.BR dup2 (2),
.BR fcntl (2)
-¤Î
+の
.B F_DUPFD
-¤ä
+や
.BR fork (2)
-·Ðͳ¤Ç¹Ô¤¦Å٤ˡ¢Æ±¤¸¥ª¡¼¥×¥ó¥Õ¥¡¥¤¥ëµ½Ò¤ò»²¾È¤¹¤ë¿·µ¬¤Î¥Õ¥¡¥¤¥ë
-¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬À¸À®¤µ¤ì¤ë¡£
+経由で行う度に、同じオープンファイル記述を参照する新規のファイル
+ディスクリプタが生成される。
.\"O An open file description continues to exist until all
.\"O file descriptors referring to it have been closed.
-¥ª¡¼¥×¥ó¥Õ¥¡¥¤¥ëµ½Ò¼«ÂΤϡ¢¼«¿È¤ò»²¾È¤¹¤ëÁ´¤Æ¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-¤¬¥¯¥í¡¼¥º¤µ¤ì¤ë¤Þ¤Ç¸ºß¤·Â³¤±¤ë¡£
+ã\82ªã\83¼ã\83\97ã\83³ã\83\95ã\82¡ã\82¤ã\83«è¨\98è¿°è\87ªä½\93ã\81¯ã\80\81è\87ªèº«ã\82\92å\8f\82ç\85§ã\81\99ã\82\8bå\85¨ã\81¦ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
+がクローズされるまで存在し続ける。
.\"O A file descriptor is removed from an
.\"O .B epoll
.\"O set only after all the file descriptors referring to the underlying
.\"O (or before if the descriptor is explicitly removed using
.\"O .BR epoll_ctl (2)
.\"O .BR EPOLL_CTL_DEL ).
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬
+ファイルディスクリプタが
.B epoll
-½¸¹ç¤«¤éºï½ü¤µ¤ì¤ë¤Î¤Ï¡¢Âбþ¤¹¤ë¥ª¡¼¥×¥ó¥Õ¥¡¥¤¥ëµ½Ò¤ò»²¾È¤·¤Æ¤¤¤ë
-Á´¤Æ¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬¥¯¥í¡¼¥º¤µ¤ì¤¿¸å¤Ç¤¢¤ë
+集合から削除されるのは、対応するオープンファイル記述を参照している
+全てのファイルディスクリプタがクローズされた後である
.RB ( epoll_ctl (2)
.B EPOLL_CTL_DEL
-¤ò»È¤Ã¤Æ¤½¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÌÀ¼¨Åª¤Ëºï½ü¤·¤¿¾ì¹ç¤Ë¤âºï½ü¤µ¤ì¤ë)¡£
+を使ってそのディスクリプタを明示的に削除した場合にも削除される)。
.\"O This means that even after a file descriptor that is part of an
.\"O .B epoll
.\"O set has been closed,
.\"O events may be reported for that file descriptor if other file
.\"O descriptors referring to the same underlying file description remain open.
-¤³¤Î¤³¤È¤Ï¡¢
+このことは、
.B epoll
-½¸¹ç¤Ë°¤·¤Æ¤¤¤ë¤¢¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¥¯¥í¡¼¥º¤·¤¿¸å¤Ç¤¢¤Ã¤Æ¤â¡¢
-Ʊ¤¸¥Õ¥¡¥¤¥ëµ½Ò¤ò»²¾È¤¹¤ë¾¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë´Ö¤Ï¡¢
-¥¯¥í¡¼¥º¤·¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿°¸¤Ë¥¤¥Ù¥ó¥È¤¬Êó¹ð¤µ¤ì¤ë²ÄǽÀ¤¬¤¢¤ë¤È
-¤¤¤¦¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
+集合に属しているあるファイルディスクリプタをクローズした後であっても、
+同じファイル記述を参照する他のファイルディスクリプタがオープンされている間は、
+クローズしたファイルディスクリプタ宛にイベントが報告される可能性があると
+いうことを意味する。
.TP
.B Q7
.\"O If more than one event occurs between
.\"O .BR epoll_wait (2)
.\"O calls, are they combined or reported separately?
-2 ¤Ä°Ê¾å¤Î¥¤¥Ù¥ó¥È¤¬
+2 つ以上のイベントが
.BR epoll_wait (2)
-¥³¡¼¥ë¤Î´Ö¤ËȯÀ¸¤·¤¿¾ì¹ç¡¢¤½¤ì¤é¤Ï¤Þ¤È¤á¤ÆÊó¹ð¤µ¤ì¤ë¤«¡¢
-¤½¤ì¤È¤âÊÌ¡¹¤ËÊó¹ð¤µ¤ì¤ë¤«¡©
+コールの間に発生した場合、それらはまとめて報告されるか、
+それとも別々に報告されるか？
.TP
.B A7
.\"O They will be combined.
-¤Þ¤È¤á¤ÆÊó¹ð¤µ¤ì¤ë¤À¤í¤¦¡£
+まとめて報告されるだろう。
.TP
.B Q8
.\"O Does an operation on a file descriptor affect the
.\"O already collected but not yet reported events?
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂФ¹¤ëÁàºî¤Ï¡¢
-´û¤Ë½¸¤á¤é¤ì¤Æ¤¤¤ë¤¬¤Þ¤ÀÊó¹ð¤µ¤ì¤Æ¤¤¤Ê¤¤¥¤¥Ù¥ó¥È¤Ë±Æ¶Á¤¹¤ë¤«¡©
+ファイルディスクリプタに対する操作は、
+既に集められているがまだ報告されていないイベントに影響するか？
.TP
.B A8
.\"O You can do two operations on an existing file descriptor.
.\"O Remove would be meaningless for
.\"O this case.
.\"O Modify will reread available I/O.
-´û¸¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂФ·¤Æ 2 ¤Ä¤ÎÁàºî¤ò¹Ô¤¦¤³¤È¤¬¤Ç¤¤ë¡£
-¤³¤Î¾ì¹ç¡¢ºï½ü¤Ë¤Ï°ÕÌ£¤¬¤Ê¤¤¡£
-Êѹ¹¤¹¤ë¤È¡¢»ÈÍѲÄǽ¤Ê I/O ¤¬ºÆ¤ÓÆɤ߹þ¤Þ¤ì¤ë¡£
+既存のファイルディスクリプタに対して 2 つの操作を行うことができる。
+この場合、削除には意味がない。
+変更すると、使用可能な I/O が再び読み込まれる。
.TP
.B Q9
.\"O Do I need to continuously read/write a file descriptor
.\"O .B EPOLLET
.\"O flag (edge-triggered behavior) ?
.B EPOLLET
-¥Õ¥é¥° (¥¨¥Ã¥¸¥È¥ê¥¬Æ°ºî) ¤ò»È¤Ã¤Æ¤¤¤ë¾ì¹ç¡¢
+フラグ (エッジトリガ動作) を使っている場合、
.B EAGAIN
-¤ò¼õ¤±¼è¤ë¤Þ¤Ç¡¢
-·Ñ³¤·¤Æ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÆɤ߽ñ¤¤¹¤ëɬÍפ¬¤¢¤ë¤«¡©
+を受け取るまで、
+継続してファイルディスクリプタを読み書きする必要があるか？
.TP
.B A9
.\"O Receiving an event from
.\"O should suggest to you that such
.\"O file descriptor is ready for the requested I/O operation.
.BR epoll_wait (2)
-¤«¤é¥¤¥Ù¥ó¥È¤ò¼õ¤±¼è¤ë¤³¤È¤Ï¡¢
-¤½¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬Í׵ᤵ¤ì¤¿ I/O Áàºî¤ËÂФ·¤Æ½àÈ÷ºÑ¤ß¤Ç¤¢¤ë¡¢
-¤È¤¤¤¦¤³¤È¤ò¥æ¡¼¥¶¤Ë¼¨¤¹¤â¤Î¤Ç¤¢¤ë¡£
+からイベントを受け取ることは、
+そのファイルディスクリプタが要求された I/O 操作に対して準備済みである、
+ということをユーザに示すものである。
.\"O You must consider it ready until the next (nonblocking)
.\"O read/write yields
.\"O .BR EAGAIN .
-¼¡¤Î (¥Ö¥í¥Ã¥¯¤·¤Ê¤¤) read/write ¤Ç
+次の (ブロックしない) read/write で
.B EAGAIN
-¤ò¼õ¤±¼è¤ë¤Þ¤Ç¤Ï¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï½àÈ÷ºÑ¤ß¤Ç¤¢¤ë¤È
-¹Í¤¨¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+を受け取るまではファイルディスクリプタは準備済みであると
+考えなければならない。
.\"O When and how you will use the file descriptor is entirely up to you.
-¤½¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¤¤¤Ä¤É¤Î¤è¤¦¤Ë»È¤¦¤«¤Ï¡¢
-Á´¤¯¥æ¡¼¥¶¤ËǤ¤µ¤ì¤Æ¤ë¡£
+そのファイルディスクリプタをいつどのように使うかは、
+全くユーザに任されてる。
.sp
.\"O For packet/token-oriented files (e.g., datagram socket,
.\"O terminal in canonical mode),
.\"O the only way to detect the end of the read/write I/O space
.\"O is to continue to read/write until
.\"O .BR EAGAIN .
-¥Ñ¥±¥Ã¥È»Ø¸þ¤ä¥È¡¼¥¯¥ó»Ø¸þ¤Î¥Õ¥¡¥¤¥ë (Î㤨¤Ð¡¢¥Ç¡¼¥¿¥°¥é¥à¥½¥±¥Ã¥È¡¢
-canonical ¥â¡¼¥É¤ÎüËö) ¤Ç¤Ï¡¢
-Æɤ߹þ¤ßÍÑ / ½ñ¤¹þ¤ßÍѤΠI/O ¶õ´Ö¤ÎËöÈø¤ò¸¡ÃΤ¹¤ëÍ£°ì¤ÎÊýË¡¤Ï
+パケット指向やトークン指向のファイル (例えば、データグラムソケット、
+canonical モードの端末) では、
+読み込み用 / 書き込み用の I/O 空間の末尾を検知する唯一の方法は
.B EAGAIN
-¤Ë¤Ê¤ë¤Þ¤Ç read/write ¤ò¹Ô¤¦¤³¤È¤Ç¤¢¤ë¡£
+になるまで read/write を行うことである。
.sp
.\"O For stream-oriented files (e.g., pipe, FIFO, stream socket), the
.\"O condition that the read/write I/O space is exhausted can also be detected by
.\"O checking the amount of data read from / written to the target file
.\"O descriptor.
-¥¹¥È¥ê¡¼¥à»Ø¸þ¤Î¥Õ¥¡¥¤¥ë (Î㤨¤Ð¡¢¥Ñ¥¤¥×¡¢FIFO¡¢¥¹¥È¥ê¡¼¥à¥½¥±¥Ã¥È) ¤Ç¤Ï¡¢
-Æɤ߹þ¤ßÍÑ / ½ñ¤¹þ¤ßÍѤΠI/O ¶õ´Ö¤¬»È¤¤¿Ô¤¯¤µ¤ì¤¿¾õÂ֤ϡ¢
-ÂоݤȤʤë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤«¤éÆɤ߹þ¤ó¤À¥Ç¡¼¥¿Î̤ޤ¿¤Ï
-½ñ¤¹þ¤ó¤À¥Ç¡¼¥¿Î̤ò¥Á¥§¥Ã¥¯¤¹¤ë¤³¤È¤Ç¤â¸¡ÃΤǤ¤ë¡£
+ストリーム指向のファイル (例えば、パイプ、FIFO、ストリームソケット) では、
+読み込み用 / 書き込み用の I/O 空間が使い尽くされた状態は、
+対象となるファイルディスクリプタから読み込んだデータ量または
+書き込んだデータ量をチェックすることでも検知できる。
.\"O For example, if you call
.\"O .BR read (2)
.\"O by asking to read a certain amount of data and
.\"O .BR write (2).
.\"O (Avoid this latter technique if you cannot guarantee that
.\"O the monitored file descriptor always refers to a stream-oriented file.)
-Î㤨¤Ð¡¢¤¢¤ëÆÃÄê¤ÎÎ̤Υǡ¼¥¿¤òÆɤ߹þ¤à¤¿¤á¤Ë
+例えば、ある特定の量のデータを読み込むために
.BR read (2)
-¤ò¸Æ¤ó¤À¤È¤¤Ë¡¢
+を呼んだときに、
.BR read (2)
-¤¬ÊÖ¤·¤¿¥Ð¥¤¥È¿ô¤¬¤½¤ì¤è¤ê¾¯¤Ê¤«¤Ã¤¿¾ì¹ç¡¢
-¤½¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÎÆɤ߹þ¤ßÍÑ I/O ¶õ´Ö¤¬
-»È¤¤¿Ô¤¯¤µ¤ì¤¿¤³¤È¤¬Ê¬¤«¤ë¡£
+が返したバイト数がそれより少なかった場合、
+そのファイルディスクリプタの読み込み用 I/O 空間が
+使い尽くされたことが分かる。
.BR write (2)
-¤ò»È¤Ã¤Æ½ñ¤¹þ¤ß¤ò¤¹¤ë¤È¤¤â¡¢Æ±¤¸¤³¤È¤¬¸À¤¨¤ë
-(´Æ»ë¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬¾ï¤Ë¥¹¥È¥ê¡¼¥à»Ø¸þ¤Î¥Õ¥¡¥¤¥ë¤ò
-»²¾È¤·¤Æ¤¤¤ë¤³¤È¤òÊݾڤǤ¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢¸å¼Ô¤Î¼êË¡¤Î»ÈÍѤòÈò¤±¤ë¤³¤È)¡£
+を使って書き込みをするときも、同じことが言える
+(監視しているファイルディスクリプタが常にストリーム指向のファイルを
+参照していることを保証できない場合には、後者の手法の使用を避けること)。
.\"O .SS Possible Pitfalls and Ways to Avoid Them
-.SS ¤¢¤ê¤¬¤Á¤ÊÍî¤È¤··ê¤È²óÈòÊýË¡
+.SS ありがちな落とし穴と回避方法
.TP
.\"O .B o Starvation (edge-triggered)
-.B o µ²²î (starvation) (¥¨¥Ã¥¸¥È¥ê¥¬)
+.B o 飢é¤\93 (starvation) (ã\82¨ã\83\83ã\82¸ã\83\88ã\83ªã\82¬)
.PP
.\"O If there is a large amount of I/O space,
.\"O it is possible that by trying to drain
.\"O it the other files will not get processed causing starvation.
.\"O (This problem is not specific to
.\"O .BR epoll .)
-Âç¤¤Ê I/O ¶õ´Ö¤¬¤¢¤ë¾ì¹ç¡¢
-¤½¤Î I/O ¶õ´Ö¤Î¥Ç¡¼¥¿¤òÁ´¤Æ½èÍý (drain) ¤·¤è¤¦¤È¤¹¤ë¤È¡¢
-¾¤Î¥Õ¥¡¥¤¥ë¤¬½èÍý¤µ¤ì¤º¡¢µ²²î¤òȯÀ¸¤µ¤»¤ë¤³¤È¤¬¤¢¤ë
-(¤³¤ÎÌäÂê¤Ï
+大きな I/O 空間がある場合、
+その I/O 空間のデータを全て処理 (drain) しようとすると、
+他のファイルが処理されず、飢餓を発生させることがある
+(この問題は
.B epoll
-¤Ë¸ÇͤΤâ¤Î¤Ç¤Ï¤Ê¤¤)¡£
+に固有のものではない)。
.PP
.\"O The solution is to maintain a ready list
.\"O and mark the file descriptor as ready
.\"O all the ready files.
.\"O This also supports ignoring subsequent events you
.\"O receive for file descriptors that are already ready.
-¤³¤ÎÌäÂê¤Î²ò·èË¡¤Ï¡¢½àÈ÷ºÑ¤ß¾õÂ֤Υꥹ¥È¤ò´ÉÍý¤·¤Æ¡¢
-´ØÏ¢¤¹¤ë data ¹½Â¤ÂΤÎÃæ¤Ç¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬
-ÍøÍѲÄǽ¤Ç¤¢¤ë¤È¥Þ¡¼¥¯¤¹¤ë¤³¤È¤Ç¤¢¤ë¡£
-¤½¤ì¤Ë¤è¤Ã¤Æ¡¢ÍøÍѲÄǽ¤Ê¤¹¤Ù¤Æ¤Î¥Õ¥¡¥¤¥ë¤ÎÃæ¤Ç
-¤É¤Î¥Õ¥¡¥¤¥ë¤ò½èÍý¤¹¤ëɬÍפ¬¤¢¤ë¤«¤ò²±¤¨¤ë¤³¤È¤¬¤Ç¤¡¢
-¤·¤«¤â½çÈ֤˽èÍý (round robin) ¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
-´û¤ËÍøÍѲÄǽ¤Ç¤¢¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂФ·¤Æ
-¤½¤ì°Ê¸å¤Ë¼õ¤±¼è¤ë¥¤¥Ù¥ó¥È¤ò̵»ë¤¹¤ë¤³¤È¤â¤Ç¤¤ë¡£
+この問題の解決法は、準備済み状態のリストを管理して、
+関連する data 構造体の中でファイルディスクリプタが
+利用可能であるとマークすることである。
+それによって、利用可能なすべてのファイルの中で
+どのファイルを処理する必要があるかを憶えることができ、
+しかも順番に処理 (round robin) することができる。
+既に利用可能であるファイルディスクリプタに対して
+それ以後に受け取るイベントを無視することもできる。
.TP
.\"O .B o If using an event cache...
-.B o ¥¤¥Ù¥ó¥È¥¥ã¥Ã¥·¥å¤ò»È¤Ã¤Æ¤¤¤ë¾ì¹ç
+.B o イベントキャッシュを使っている場合
.PP
.\"O If you use an event cache or store all the file descriptors returned from
.\"O .BR epoll_wait (2),
.\"O Suppose you receive 100 events from
.\"O .BR epoll_wait (2),
.\"O and in event #47 a condition causes event #13 to be closed.
-¥¤¥Ù¥ó¥È¥¥ã¥Ã¥·¥å¤ò»È¤Ã¤Æ¤¤¤ë¾ì¹ç¡¢
-¤Þ¤¿¤Ï
+イベントキャッシュを使っている場合、
+または
.BR epoll_wait (2)
-¤«¤éÊÖ¤µ¤ì¤¿Á´¤Æ¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò³ÊǼ¤·¤Æ¤¤¤ë¾ì¹ç¡¢
-¥¯¥í¡¼¥º¤µ¤ì¤¿¤³¤È¤òưŪ¤Ë¥Þ¡¼¥¯¤¹¤ë
-(¤Ä¤Þ¤êÁ°¤Î¥¤¥Ù¥ó¥È¤Î½èÍý¤Ë¤è¤Ã¤Æ¥Þ¡¼¥¯¤µ¤ì¤ë) ÊýË¡¤òÄ󶡤¹¤Ù¤¤Ç¤¢¤ë¡£
+から返された全てのファイルディスクリプタを格納している場合、
+クローズされたことを動的にマークする
+(つまり前のイベントの処理によってマークされる) 方法を提供すべきである。
.BR epoll_wait (2)
-¤«¤é 100 ¸Ä¤Î¥¤¥Ù¥ó¥È¤ò¼õ¤±¼è¤ê¡¢
-¥¤¥Ù¥ó¥È #47 ¤Ç¤Ï¤¢¤ë¾ò·ï¤Ç¥¤¥Ù¥ó¥È #13 ¤¬ÊĤ¸¤é¤ì¤ë¤È²¾Äꤹ¤ë¡£
+から 100 個のイベントを受け取り、
+イベント #47 ではある条件でイベント #13 が閉じられると仮定する。
.\"O If you remove the structure and
.\"O .BR close (2)
.\"O the file descriptor for event #13, then your
.\"O event cache might still say there are events waiting for that
.\"O file descriptor causing confusion.
-¥¤¥Ù¥ó¥È #13 ¤Î¹½Â¤ÂΤòºï½ü¤·¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò
+イベント #13 の構造体を削除しファイルディスクリプタを
.BR close (2)
-¤¹¤ë¤È¡¢¥¤¥Ù¥ó¥È¥¥ã¥Ã¥·¥å¤Ï¤½¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÂԤĥ¤¥Ù¥ó¥È¤¬
-¸ºß¤¹¤ë¤È¤¤¤Ã¤Æ¡¢º®Í𤬵¯¤¤ë¡£
+すると、イベントキャッシュはそのファイルディスクリプタを待つイベントが
+存在するといって、混乱が起きる。
.PP
.\"O One solution for this is to call, during the processing of event 47,
.\"O .BR epoll_ctl ( EPOLL_CTL_DEL )
.\"O event for file descriptor 13 in your batch processing,
.\"O you will discover the file descriptor had been
.\"O previously removed and there will be no confusion.
-¤³¤ÎÌäÂê¤ò²ò·è¤¹¤ë 1 ¤Ä¤ÎÊýË¡¤Ï¡¢¥¤¥Ù¥ó¥È 47 ¤Î½èÍý¤ò¤·¤Æ¤¤¤ë´Ö¤Ë¡¢
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿ 13 ¤òºï½ü¤·¤Æ
+この問題を解決する 1 つの方法は、イベント 47 の処理をしている間に、
+ファイルディスクリプタ 13 を削除して
.BR close (2)
-¤¹¤ë¤¿¤á¤Ë
+するために
.BR epoll_ctl ( EPOLL_CTL_DEL )
-¤ò¸Æ¤Ó½Ð¤·¡¢´ØÏ¢ÉÕ¤±¤é¤ì¤¿ data ¹½Â¤ÂΤòºï½üºÑ¤ß¤È¥Þ¡¼¥¯¤·¤Æ¡¢
-¥¯¥ê¡¼¥ó¥¢¥Ã¥×¥ê¥¹¥È¤Ë¥ê¥ó¥¯¤¹¤ë¤³¤È¤Ç¤¢¤ë¡£
-¥Ð¥Ã¥Á½èÍý¤ÎÃæ¤Ç¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿ 13 ¤Ë¤Ä¤¤¤Æ¤Î
-¾¤Î¥¤¥Ù¥ó¥È¤ò¸«¤Ä¤±¤¿¾ì¹ç¡¢
-¤½¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬°ÊÁ°¤Ëºï½ü¤µ¤ì¤¿¤â¤Î¤Ç¤¢¤ë¤Èʬ¤«¤ë¤Î¤Ç¡¢
-º®Íð¤Ïµ¯¤¤Ê¤¤¡£
+を呼び出し、関連付けられた data 構造体を削除済みとマークして、
+クリーンアップリストにリンクすることである。
+バッチ処理の中でファイルディスクリプタ 13 についての
+他のイベントを見つけた場合、
+そのファイルディスクリプタが以前に削除されたものであると分かるので、
+混乱は起きない。
.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
+.SH バージョン
.\"O The
.\"O .B epoll
.\"O API was introduced in Linux kernel 2.5.44.
.B epoll
-API ¤Ï Linux ¥«¡¼¥Í¥ë 2.5.44 ¤ËƳÆþ¤µ¤ì¤¿¡£
+API は Linux カーネル 2.5.44 に導入された。
.\"O .\" Its interface should be finalized in Linux kernel 2.5.66.
-.\" ¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï Linux ¥«¡¼¥Í¥ë 2.5.66 ¤Ç³ÎÄꤵ¤ì¤ë¤Ù¤¤Ç¤¢¤ë¡£
+.\" インタフェースは Linux カーネル 2.5.66 で確定されるべきである。
.\"O Support was added to glibc in version 2.3.2.
-glibc ¤Ç¤Î¥µ¥Ý¡¼¥È¤Ï¥Ð¡¼¥¸¥ç¥ó 2.3.2 ¤ÇÄɲ䵤줿¡£
+glibc でのサポートはバージョン 2.3.2 で追加された。
.\"O .SH CONFORMING TO
-.SH ½àµò
+.SH 準拠
.\"O The
.\"O .B epoll
.\"O API is Linux-specific.
.\"O and Solaris has
.\"O .IR /dev/poll .
.B epoll
-API ¤Ï Linux ¸ÇͤǤ¢¤ë¡£
-¾¤Î¥·¥¹¥Æ¥à¤Ç¤âƱÍͤε¡¹½¤¬Ä󶡤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤¬¤¢¤ë¡£
-Î㤨¤Ð¡¢FreeBSD ¤Î
+API は Linux 固有である。
+他のシステムでも同様の機構が提供されている場合がある。
+例えば、FreeBSD の
.I kqueue
-¤ä Solaris ¤Î
+や Solaris の
.I /dev/poll
-¤Ê¤É¤Ç¤¢¤ë¡£
+などである。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR epoll_create (2),
.BR epoll_create1 (2),
.BR epoll_ctl (2),
OSDN Git Service
