.\"
.\"  epoll by Davide Libenzi ( efficient event notification retrieval )
.\"  Copyright (C) 2003  Davide Libenzi
.\"
.\"  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
.\"  (at your option) any later version.
.\"
.\"  This program is distributed in the hope that it will be useful,
.\"  but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"  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
.\"
.\"  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
.\"
.TH EPOLL_CTL 2 2002-10-23 "Linux" "Linux Programmer's Manual"
.SH ̾
epoll_ctl \- epoll ǥץΥ󥿥ե椹
.SH 
.B #include <sys/epoll.h>
.sp
.BI "int epoll_ctl(int " epfd ", int " op ", int " fd \
", struct epoll_event *" event );
.SH 
оݥեǥץ
.I fd
ؤ
.I op
μ¹Ԥ׵ᤷ
.B epoll
ǥץ
.I epfd
椹롣
.I event
ϥեǥץ
.I fd
˥󥯤줿֥Ȥ򵭽Ҥ롣
.I struct epoll_event
ϰʲΤ褦:
.sp
.in +4n
.nf
typedef union epoll_data {
    void *ptr;
    int fd;
    __uint32_t u32;
    __uint64_t u64;
} epoll_data_t;

struct epoll_event {
    __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" (ͥ 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 " (ͥ 2.6.2 ʹ)"
Ϣդ줿եǥץ
ư (One-Shot  behavior) ꤹ롣
ϥ٥Ȥ
.BR epoll_wait (2)
ˤäưФ줿塢
Ϣդ줿եǥץŪ˴졢
.B epoll
󥿥եˤäƥ٥Ȥ𤵤ʤʤ뤳Ȥ̣롣
٥ȥޥǥեǥץͭˤ뤿ˤϡ
.BR epoll_ctl ()

.B EPOLL_CTL_MOD
ꤷƸƤӽФʤФʤʤ
.PP
.B epoll
󥿥եϡ
.BR poll (2)
򥵥ݡȤƤΥեǥץ򥵥ݡȤ롣
.I op
˻Ǥͭͤϡʲ̤:
.RS
.TP
.B EPOLL_CTL_ADD
оݥեǥץ
.I fd

.B epoll
ǥץ
.I epfd
ɲä٥
.I event

.I fd
˥󥯤줿ե˴Ϣդ롣
.TP
.B EPOLL_CTL_MOD
٥
.I event
оݥեǥץ
.I fd
˴Ϣդ褦ѹ롣
.TP
.B EPOLL_CTL_DEL
оݥեǥץ
.I fd

.B epoll
եǥץ
.I epfd
롣
.I event
̵뤵ΤǡNULL ꤹ뤳ȤǤ
(âΡ֥ХפξϤ򻲾ȤΤ)
.RE
.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

.I epfd
¸ߤ롣
.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

.I epfd
¸ߤʤ
.TP
.B ENOMEM
׵ᤵ줿
.I op
򰷤Τ˽ʬʥ꤬ʤ
.TP
.B EPERM
оݥե
.I fd

.B epoll
򥵥ݡȤƤʤ
.SH 
.BR epoll_ctl ()
 Linux ȼǤꡢͥ 2.5.44 Ƴ줿
.\" 󥿥ե Linux ͥ 2.5.66 dzꤵ٤Ǥ롣
.SH Х
2.6.9 ΥͥǤϡ
.B EPOLL_CTL_DEL
κݡ
.I event
 (Ȥ̵뤵ǤäƤ) NULL Ǥʤݥ󥿤Ϥɬפä
ͥ 2.6.9 ʹߤǤϡ
.B EPOLL_CTL_DEL
Ȥݤ
.I event
 NULL Ǥ褦ˤʤäƤ롣
.SH Ϣ
.BR epoll_create (2),
.BR epoll_wait (2),
.BR poll (2),
.BR epoll (7)