OSDN Git Service

(split) DP: release pages (catch up to 3.50).
[linuxjm/LDP_man-pages.git] / release / man2 / epoll_ctl.2
index 6ea27c3..3a31a0f 100644 (file)
@@ -1,7 +1,7 @@
-.\"
-.\"  epoll by Davide Libenzi ( efficient event notification retrieval )
 .\"  Copyright (C) 2003  Davide Libenzi
+.\"  Davide Libenzi <davidel@xmailserver.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_SW_3_PARA)
 .\"  This program is free software; you can redistribute it and/or modify
 .\"  it under the terms of the GNU General Public License as published by
 .\"  the Free Software Foundation; either version 2 of the License, or
 .\"  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 .\"  GNU General Public License for more details.
 .\"
-.\"  You should have received a copy of the GNU General Public License
-.\"  along with this program; if not, write to the Free Software
-.\"  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+.\" You should have received a copy of the GNU General Public
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
-.\"  Davide Libenzi <davidel@xmailserver.org>
+.\"*******************************************************************
 .\"
-.\" Japanese Version Copyright (c) 2004-2005 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated 2004-06-15, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated & Modified 2004-12-29, Yuichi SATO
-.\" Updated & Modified 2005-04-20, Yuichi SATO
-.\" Updated & Modified 2005-09-06, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2006-07-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.36
-.\" Updated 2009-02-23, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.19
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH EPOLL_CTL 2 2010-08-29 "Linux" "Linux Programmer's Manual"
-.SH Ì¾Á°
-epoll_ctl \- epoll ¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤òÁàºî¤¹¤ë
-.SH ½ñ¼°
-.B #include <sys/epoll.h>
+.\"*******************************************************************
+.TH EPOLL_CTL 2 2012\-04\-15 Linux "Linux Programmer's Manual"
+.SH 名前
+epoll_ctl \- epoll ディスクリプタのインタフェースを操作する
+.SH 書式
+\fB#include <sys/epoll.h>\fP
 .sp
-.BI "int epoll_ctl(int " epfd ", int " op ", int " fd \
-", struct epoll_event *" event );
-.SH ÀâÌÀ
-¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I epfd
-¤¬»²¾È¤¹¤ë epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤ËÂФ¹¤ëÁàºî¤ò¹Ô¤¦¡£
-ÂоݤΥե¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤ËÂФ·¤Æ¡¢Áàºî
-.I op
-¤Î¼Â¹Ô¤¬Í׵ᤵ¤ì¤ë¡£
+\fBint epoll_ctl(int \fP\fIepfd\fP\fB, int \fP\fIop\fP\fB, int \fP\fIfd\fP\fB, struct
+epoll_event *\fP\fIevent\fP\fB);\fP
+.SH 説明
+このシステムコールは、ファイルディスクリプタ \fIepfd\fP が参照する \fBepoll\fP(7)
+インスタンスに対する操作を行う。 対象のファイルディスクリプタ \fIfd\fP に対して、
+操作 \fIop\fP の実行が要求される。
 
-.I op
-°ú¤­¿ô¤Ë»ØÄê¤Ç¤­¤ëÍ­¸ú¤ÊÃͤϰʲ¼¤ÎÄ̤ê¤Ç¤¢¤ë¡£
-.TP
-.B EPOLL_CTL_ADD
-ÂоݤΥե¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤ò¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I epfd
-¤¬»²¾È¤¹¤ë
-.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤ËÅÐÏ¿¤·¡¢¥¤¥Ù¥ó¥È
-.I event
-¤ò
-.I fd
-¤Ë·ë¤ÓÉÕ¤±¤é¤ì¤¿ÆâÉô¥Õ¥¡¥¤¥ë¤Ë´ØÏ¢ÉÕ¤±¤ë¡£
-.TP
-.B EPOLL_CTL_MOD
-¥¤¥Ù¥ó¥È
-.I event
-¤òÂоݤΥե¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤Ë´ØÏ¢ÉÕ¤±¤ë¤è¤¦¤ËÊѹ¹¤¹¤ë¡£
-.TP
-.B EPOLL_CTL_DEL
-ÂоݤΥե¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤ò
-.I epfd
-¤¬»²¾È¤¹¤ë
-.B epoll
-¥¤¥ó¥¹¥¿¥ó¥¹¤«¤éºï½ü¤¹¤ë¡£
-.I event
-°ú¤­¿ô¤Ï̵»ë¤µ¤ì¤ë¤Î¤Ç¡¢NULL ¤Ë¤¹¤ë¤³¤È¤â¤Ç¤­¤ë
-(⤷¡¢²¼µ­¤Î¡Ö¥Ð¥°¡×¤ò»²¾È)¡£
+\fIop\fP 引き数に指定できる有効な値は以下の通りである。
+.TP 
+\fBEPOLL_CTL_ADD\fP
+対象のファイルディスクリプタ \fIfd\fP をファイルディスクリプタ \fIepfd\fP が参照する \fBepoll\fP インスタンスに登録し、イベント
+\fIevent\fP を \fIfd\fP に結び付けられた内部ファイルに関連付ける。
+.TP 
+\fBEPOLL_CTL_MOD\fP
+イベント \fIevent\fP を対象のファイルディスクリプタ \fIfd\fP に関連付けるように変更する。
+.TP 
+\fBEPOLL_CTL_DEL\fP
+対象のファイルディスクリプタ \fIfd\fP を \fIepfd\fP が参照する \fBepoll\fP インスタンスから削除する。 \fIevent\fP
+引き数は無視されるので、NULL にすることもできる (但し、下記の「バグ」を参照)。
 .PP
-.I event
-°ú¤­¿ô¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤Ë¥ê¥ó¥¯¤µ¤ì¤¿¥ª¥Ö¥¸¥§¥¯¥È¤òɽ¤¹¡£
-.I struct epoll_event
-¤Ï°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤ë:
+\fIevent\fP 引き数は、ファイルディスクリプタ \fIfd\fP にリンクされたオブジェクトを表す。 \fIstruct epoll_event\fP
+は以下のように定義される:
 .sp
 .in +4n
 .nf
@@ -97,172 +61,92 @@ typedef union epoll_data {
 } epoll_data_t;
 
 struct epoll_event {
-    uint32_t     events;      /* epoll ¥¤¥Ù¥ó¥È */
-    epoll_data_t data;        /* ¥æ¡¼¥¶¥Ç¡¼¥¿ÊÑ¿ô */
+    uint32_t     events;      /* epoll イベント */
+    epoll_data_t data;        /* ユーザデータ変数 */
 };
 .fi
 .in
 
-.I events
-¥á¥ó¥Ð¤Ï¡¢°Ê²¼¤Î¤è¤¦¤Ê»ÈÍѲÄǽ¤Ê¥¤¥Ù¥ó¥È¥¿¥¤¥×¤ò»È¤Ã¤Æ¹½À®¤µ¤ì¤¿
-¥Ó¥Ã¥È¥»¥Ã¥È¤Ç¤¢¤ë¡£
-.TP
-.B EPOLLIN
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¤ËÂФ·¤Æ¡¢
-.BR read (2)
-Áàºî¤¬²Äǽ¤Ç¤¢¤ë¡£
-.TP
-.B EPOLLOUT
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¤ËÂФ·¤Æ¡¢
-.BR write (2)
-Áàºî¤¬²Äǽ¤Ç¤¢¤ë¡£
-.TP
-.BR EPOLLRDHUP" (Linux 2.6.17 °Ê¹ß)"
-¥¹¥È¥ê¡¼¥à¥½¥±¥Ã¥È¤Î¾ü¤¬¡¢¥³¥Í¥¯¥·¥ç¥ó¤Î close ¡¢
-¤Þ¤¿¤Ï¥³¥Í¥¯¥·¥ç¥ó¤Î½ñ¤­¹þ¤ß¦¤Î shutdown ¤ò¹Ô¤Ã¤¿¡£
-(¤³¤Î¥Õ¥é¥°¤ò»È¤¦¤È¡¢¥¨¥Ã¥¸¥È¥ê¥¬¤Î´Æ»ë¤ò¹Ô¤¦¾ì¹ç¤Ë¡¢
-ÄÌ¿®¤Î¤â¤¦°ìü¤¬ÊĤ¸¤é¤ì¤¿¤³¤È¤ò¸¡ÃΤ¹¤ë¥³¡¼¥É¤ò
-Èó¾ï¤Ë´Ê·é¤Ë½ñ¤¯¤³¤È¤¬¤Ç¤­¤ë¡£)
-.TP
-.B EPOLLPRI
-.BR read (2)
-Áàºî¤¬²Äǽ¤Ê¶ÛµÞ (urgent) ¥Ç¡¼¥¿¤¬¤¢¤ë¡£
-.TP
-.B EPOLLERR
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ë¥¨¥é¡¼¾ò·ï¤¬µ¯¤³¤Ã¤¿¡£
-.BR epoll_wait (2)
-¤Ï¾ï¤Ë¤³¤Î¥¤¥Ù¥ó¥È¤òÂԤĤΤǡ¢
-.I events
-¤ËÀßÄꤹ¤ëɬÍפϤʤ¤¡£
-.TP
-.B EPOLLHUP
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ë¥Ï¥ó¥°¥¢¥Ã¥×¤¬µ¯¤³¤Ã¤¿¡£
-.BR epoll_wait (2)
-¤Ï¾ï¤Ë¤³¤Î¥¤¥Ù¥ó¥È¤òÂԤĤΤǡ¢
-.I events
-¤ËÀßÄꤹ¤ëɬÍפϤʤ¤¡£
-.TP
-.B EPOLLET
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ë
-¥¨¥Ã¥¸¥È¥ê¥¬Æ°ºî (Edge Triggered behavior) ¤òÀßÄꤹ¤ë¡£
-.B epoll
-¤Î¥Ç¥Õ¥©¥ë¥È¤ÎÆ°ºî¤Ï¡¢¥ì¥Ù¥ë¥È¥ê¥¬ (Level Triggered) ¤Ç¤¢¤ë¡£
-¥¨¥Ã¥¸¥È¥ê¥¬¤È¥ì¥Ù¥ë¥È¥ê¥¬¤Ë¤è¤ë¥¤¥Ù¥ó¥ÈʬÇÛµ¡¹½
-(event distribution architectures) ¤Ë¤Ä¤¤¤Æ¤Î¾ÜºÙ¤Ê¾ðÊó¤Ï¡¢
-.BR epoll (7)
-¤ò»²¾È¤¹¤ë¤³¤È¡£
-.TP
-.BR EPOLLONESHOT " (Linux 2.6.2 °Ê¹ß)"
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ë
-°ì·âÆ°ºî (One-Shot  behavior) ¤òÀßÄꤹ¤ë¡£
-¤³¤ì¤Ï¥¤¥Ù¥ó¥È¤¬
-.BR epoll_wait (2)
-¤Ë¤è¤Ã¤Æ°ú¤­½Ð¤µ¤ì¤¿¸å¡¢
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬ÆâÉôŪ¤ËÇË´þ¤µ¤ì¡¢
-.B epoll
-¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ë¤è¤Ã¤Æ¥¤¥Ù¥ó¥È¤¬Êó¹ð¤µ¤ì¤Ê¤¯¤Ê¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
-¿·¤·¤¤¥¤¥Ù¥ó¥È¥Þ¥¹¥¯¤Ç¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òºÆÅÙÍ­¸ú¤Ë¤¹¤ë¤¿¤á¤Ë¤Ï¡¢
-.BR epoll_ctl ()
-¤Ë
-.B EPOLL_CTL_MOD
-¤ò»ØÄꤷ¤Æ¸Æ¤Ó½Ð¤µ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.I op
-°ú¤­¿ô¤Ë»ØÄê¤Ç¤­¤ëÍ­¸ú¤ÊÃͤϡ¢°Ê²¼¤ÎÄ̤ê:
-.SH ÊÖ¤êÃÍ
-À®¸ù¤·¤¿¾ì¹ç¡¢
-.BR epoll_ctl ()
-¤Ï 0 ¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¡¢
-.BR epoll_ctl ()
-¤Ï \-1 ¤òÊÖ¤·¡¢
-.I errno
-¤òŬÀÚ¤ËÀßÄꤹ¤ë¡£
-.SH ¥¨¥é¡¼
-.TP
-.B EBADF
-.I epfd
-¤«
-.I fd
-¤¬Í­¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
-.TP
-.B EEXIST
-.I op
-¤¬
-.B EPOLL_CTL_ADD
-¤Ç¤¢¤ê¡¢¤«¤ÄÍ¿¤¨¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤¬¤³¤Î epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤Ë´û¤ËÅÐÏ¿¤µ¤ì¤Æ¤¤¤ë¡£
-.TP
-.B EINVAL
-.I epfd
-¤¬
-.B epoll
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
-¤Þ¤¿¤Ï
-.I fd
-¤¬
-.I epfd
-¤ÈƱ°ì¤Ç¤¢¤ë¡£
-¤Þ¤¿¤ÏÍ׵ᤵ¤ì¤¿Áàºî
-.I op
-¤¬¤³¤Î¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-.TP
-.B ENOENT
-.I op
-¤¬
-.B EPOLL_CTL_MOD
-¤Þ¤¿¤Ï
-.B EPOLL_CTL_DEL
-¤Ç¡¢¤«¤Ä
-.I fd
-¤¬¤³¤Î epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤ËÅÐÏ¿¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-.TP
-.B ENOMEM
-Í׵ᤵ¤ì¤¿
-.I op
-À©¸æÁàºî¤ò°·¤¦¤Î¤Ë½½Ê¬¤Ê¥á¥â¥ê¤¬¤Ê¤¤¡£
-.TP
-.B ENOSPC
-epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤Ë¿·¤·¤¤¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÅÐÏ¿
-.RB ( EPOLL_CTL_ADD )
-¤·¤è¤¦¤È¤·¤¿ºÝ¤Ë¡¢
-.I /proc/sys/fs/epoll/max_user_watches
-¤Ç·è¤Þ¤ë¾å¸Â¤Ë㤷¤¿¡£
-¾ÜºÙ¤Ï
-.BR epoll (7)
-¤ò»²¾È¡£
-.TP
-.B EPERM
-Âоݥե¡¥¤¥ë
-.I fd
-¤¬
-.B epoll
-¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¡£
-.SH ½àµò
-.BR epoll_ctl ()
-¤Ï Linux Æȼ«¤Ç¤¢¤ê¡¢¥«¡¼¥Í¥ë 2.5.44 ¤ÇƳÆþ¤µ¤ì¤¿¡£
-.\" ¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï Linux ¥«¡¼¥Í¥ë 2.5.66 ¤Ç³ÎÄꤵ¤ì¤ë¤Ù¤­¤Ç¤¢¤ë¡£
-.SH È÷¹Í
-.B epoll
-¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï¡¢
-.BR poll (2)
-¤ËÂбþ¤·¤Æ¤¤¤ëÁ´¤Æ¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂбþ¤·¤Æ¤¤¤ë¡£
-.SH ¥Ð¥°
-Linux 2.6.9 ¤è¤êÁ°¤Ç¤Ï¡¢
-.B EPOLL_CTL_DEL
-Áàºî¤ÎºÝ¡¢°ú¤­¿ô
-.I event
-¤Ë (¤¿¤È¤¨Ìµ»ë¤µ¤ì¤ë¾ì¹ç¤Ç¤¢¤Ã¤Æ¤â) NULL ¤Ç¤Ê¤¤¥Ý¥¤¥ó¥¿¤òÅϤ¹É¬Íפ¬¤¢¤Ã¤¿¡£
-¥«¡¼¥Í¥ë 2.6.9 °Ê¹ß¤Ç¤Ï¡¢
-.B EPOLL_CTL_DEL
-¤ò»È¤¦ºÝ¤Ë
-.I event
-¤Ë NULL ¤ò»ØÄê¤Ç¤­¤ë¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤ë¡£
-2.6.9 ¤è¤êÁ°¤Î¥«¡¼¥Í¥ë¤Ø¤Î°Ü¿¢À­¤¬É¬Íפʥ¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç¤Ï¡¢
-.I event
-¤Ë NULL ¤Ç¤Ê¤¤¥Ý¥¤¥ó¥¿¤ò»ØÄꤹ¤Ù¤­¤Ç¤¢¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR epoll_create (2),
-.BR epoll_wait (2),
-.BR poll (2),
-.BR epoll (7)
+\fIevents\fP メンバは、以下のような使用可能なイベントタイプを使って構成された ビットセットである。
+.TP 
+\fBEPOLLIN\fP
+関連付けられたファイルに対して、 \fBread\fP(2)  操作が可能である。
+.TP 
+\fBEPOLLOUT\fP
+関連付けられたファイルに対して、 \fBwrite\fP(2)  操作が可能である。
+.TP 
+\fBEPOLLRDHUP"\fP(Linux\fB2.6.17\fP以降)"
+ストリームソケットの他端が、コネクションの close 、 またはコネクションの書き込み側の shutdown を行った。
+(このフラグを使うと、エッジトリガの監視を行う場合に、 通信のもう一端が閉じられたことを検知するコードを 非常に簡潔に書くことができる。)
+.TP 
+\fBEPOLLPRI\fP
+\fBread\fP(2)  操作が可能な緊急 (urgent) データがある。
+.TP 
+\fBEPOLLERR\fP
+関連付けられたファイルディスクリプタにエラー条件が起こった。 \fBepoll_wait\fP(2)  は常にこのイベントを待つので、 \fIevents\fP
+に設定する必要はない。
+.TP 
+\fBEPOLLHUP\fP
+関連付けられたファイルディスクリプタにハングアップが起こった。 \fBepoll_wait\fP(2)  は常にこのイベントを待つので、 \fIevents\fP
+に設定する必要はない。
+.TP 
+\fBEPOLLET\fP
+関連付けられたファイルディスクリプタに エッジトリガ動作 (Edge Triggered behavior) を設定する。 \fBepoll\fP
+のデフォルトの動作は、レベルトリガ (Level Triggered) である。 エッジトリガとレベルトリガによるイベント分配機構 (event
+distribution architectures) についての詳細な情報は、 \fBepoll\fP(7)  を参照すること。
+.TP 
+\fBEPOLLONESHOT\fP (Linux 2.6.2 以降)
+関連付けられたファイルディスクリプタに 一撃動作 (One\-Shot behavior) を設定する。 これはイベントが
+\fBepoll_wait\fP(2)  によって引き出された後、 関連付けられたファイルディスクリプタが内部的に破棄され、 \fBepoll\fP
+インタフェースによってイベントが報告されなくなることを意味する。 新しいイベントマスクでファイルディスクリプタを再度有効にするためには、
+\fBepoll_ctl\fP()  に \fBEPOLL_CTL_MOD\fP を指定して呼び出さなければならない。 \fIop\fP
+引き数に指定できる有効な値は、以下の通り:
+.SH 返り値
+成功した場合、 \fBepoll_ctl\fP()  は 0 を返す。 エラーが起こった場合、 \fBepoll_ctl\fP()  は \-1 を返し、
+\fIerrno\fP を適切に設定する。
+.SH エラー
+.TP 
+\fBEBADF\fP
+\fIepfd\fP か \fIfd\fP が有効なファイルディスクリプタでない。
+.TP 
+\fBEEXIST\fP
+\fIop\fP が \fBEPOLL_CTL_ADD\fP であり、かつ与えられたファイルディスクリプタ \fIfd\fP がこの epoll
+インスタンスに既に登録されている。
+.TP 
+\fBEINVAL\fP
+\fIepfd\fP が \fBepoll\fP ファイルディスクリプタでない。 または \fIfd\fP が \fIepfd\fP と同一である。 または要求された操作
+\fIop\fP がこのインタフェースでサポートされていない。
+.TP 
+\fBENOENT\fP
+\fIop\fP が \fBEPOLL_CTL_MOD\fP または \fBEPOLL_CTL_DEL\fP で、かつ \fIfd\fP がこの epoll
+インスタンスに登録されていない。
+.TP 
+\fBENOMEM\fP
+要求された \fIop\fP 制御操作を扱うのに十分なメモリがない。
+.TP 
+\fBENOSPC\fP
+epoll インスタンスに新しいファイルディスクリプタを登録 (\fBEPOLL_CTL_ADD\fP)  しようとした際に、
+\fI/proc/sys/fs/epoll/max_user_watches\fP で決まる上限に達した。 詳細は \fBepoll\fP(7)  を参照。
+.TP 
+\fBEPERM\fP
+対象ファイル \fIfd\fP が \fBepoll\fP をサポートしていない。
+.SH バージョン
+.\" To be precise: kernel 2.5.44.
+.\" The interface should be finalized by Linux kernel 2.5.66.
+\fBepoll_ctl\fP()  はカーネル 2.6 で追加された。
+.SH 準拠
+\fBepoll_ctl\fP()  は Linux 独自である。
+ライブラリによるサポートは glibc バージョン 2.3.2 以降で提供されている。
+.SH 注意
+\fBepoll\fP インタフェースは、 \fBpoll\fP(2)  に対応している全てのファイルディスクリプタに対応している。
+.SH バグ
+Linux 2.6.9 より前では、 \fBEPOLL_CTL_DEL\fP 操作の際、引き数 \fIevent\fP に (たとえ無視される場合であっても)
+NULL でないポインタを渡す必要があった。 カーネル 2.6.9 以降では、 \fBEPOLL_CTL_DEL\fP を使う際に \fIevent\fP に
+NULL を指定できるようになっている。 2.6.9 より前のカーネルへの移植性が必要なアプリケーションでは、 \fIevent\fP に NULL
+でないポインタを指定すべきである。
+.SH 関連項目
+\fBepoll_create\fP(2), \fBepoll_wait\fP(2), \fBpoll\fP(2), \fBepoll\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。