release/man2/epoll_create.2

   1 .\"
   2 .\"  epoll by Davide Libenzi ( efficient event notification retrieval )
   3 .\"  Copyright (C) 2003  Davide Libenzi
   4 .\"
   5 .\"  This program is free software; you can redistribute it and/or modify
   6 .\"  it under the terms of the GNU General Public License as published by
   7 .\"  the Free Software Foundation; either version 2 of the License, or
   8 .\"  (at your option) any later version.
   9 .\"
  10 .\"  This program is distributed in the hope that it will be useful,
  11 .\"  but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\"  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 .\"  GNU General Public License for more details.
  14 .\"
  15 .\"  You should have received a copy of the GNU General Public License
  16 .\"  along with this program; if not, write to the Free Software
  17 .\"  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  18 .\"
  19 .\"  Davide Libenzi <davidel@xmailserver.org>
  20 .\"
  21 .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
  22 .\" Modified 2005-04-04 by Marko Kohtala <marko.kohtala@gmail.com>
  23 .\" 2008-10-10, mtk: add description of epoll_create1()
  24 .\"
  25 .\" Japanese Version Copyright (c) 2004-2005 Yuichi SATO
  26 .\"         all rights reserved.
  27 .\" Translated Wed Jun  9 05:02:07 JST 2004
  28 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  29 .\" Updated & Modified Wed Dec 29 07:12:00 JST 2004 by Yuichi SATO
  30 .\" Updated & Modified Tue Apr 19 06:51:12 JST 2005 by Yuichi SATO
  31 .\" Updated 2009-03-05 by Kentaro Shirakata <argrath@ub32.org>
  32 .\"
  33 .\"WORD:        backing store   ¥Ð¥Ã¥¥ó¥°¥¹¥È¥¢
  34 .\"
  35 .TH EPOLL_CREATE 2 2009-01-17 "Linux" "Linux Programmer's Manual"
  36 .SH Ì¾Á°
  37 epoll_create, epoll_create1 \- epoll ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¥ª¡¼¥×¥ó¤¹¤ë
  38 .SH ½ñ¼°
  39 .nf
  40 .B #include <sys/epoll.h>
  41 .sp
  42 .BI "int epoll_create(int " size );
  43 .BI "int epoll_create1(int " flags );
  44 .fi
  45 .SH ÀâÌÀ
  46 .BR epoll_create ()
  47 ¤Ï¡¢
  48 .I size
  49 ¸Ä¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÝ»ý¤Ç¤¤ëÂç¤¤µ¤Î¥¤¥Ù¥ó¥È¥Ð¥Ã¥¥ó¥°
  50 ¥¹¥È¥¢¤Î³ä¤êÅö¤Æ¤ò¥«¡¼¥Í¥ë¤ËÂÐ¤·¤ÆÍ×µá¤¹¤ë¤³¤È¤Ë¤è¤ê¡¢
  51 epoll ¡Ö¥¤¥ó¥¹¥¿¥ó¥¹¡×¤òºîÀ®¤¹¤ë¡£
  52 .I size
  53 ¤Ï¥Ð¥Ã¥¥ó¥°¥¹¥È¥¢¤ÎºÇÂç¥µ¥¤¥º¤Ç¤Ï¤Ê¤¯¡¢
  54 ÆâÉô¹½Â¤¤ÎÂç¤¤µ¤ò¤É¤Î°Ì¤Ë¤¹¤ë¤«¤ò¥«¡¼¥Í¥ë¤ËÃÎ¤é¤»¤ë¥Ò¥ó¥È¤Ç¤·¤«¤Ê¤¤¡£
  55 (¸½ºß¤Ï
  56 .I size
  57 ¤ÏÌµ»ë¤µ¤ì¤ë¡£²¼µ¤Î¡ÖÃí°Õ¡×¤ò»²¾È¡£)
  58
  59 .BR epoll_create ()
  60 ¤Ï¡¢¿·¤·¤¤ epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
  61 ¤³¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¡¢¤½¤Î¸å¤Î
  62 .B epoll
  63 ¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Î¸Æ¤Ó½Ð¤·¤Ë»È¤ï¤ì¤ë¡£
  64 ¤â¤¦É¬Í×¤Ç¤Ê¤¯¤Ê¤Ã¤¿¾ì¹ç¤Ï¡¢
  65 .BR epoll_create ()
  66 ¤ÇÊÖ¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï
  67 .BR close (2)
  68 ¤ò»È¤Ã¤Æ¥¯¥í¡¼¥º¤µ¤ì¤ë¤Ù¤¤Ç¤¢¤ë¡£
  69 ¤¢¤ë epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤ò»²¾È¤¹¤ëÁ´¤Æ¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬¥¯¥í¡¼¥º¤µ¤ì¤ë¤È¡¢
  70 ¥«¡¼¥Í¥ë¤Ï¤½¤Î¥¤¥ó¥¹¥¿¥ó¥¹¤òÇË²õ¤·¤Æ¡¢ÂÐ±þ¤¹¤ë¥ê¥½¡¼¥¹¤ò²òÊü¤·¡¢
  71 ºÆ»ÈÍÑ¤Ç¤¤ë¤è¤¦¤Ë¤¹¤ë¡£
  72
  73 .BR epoll_create1 ()
  74 ¤Ï¡¢
  75 .I flags
  76 ¤¬ 0 ¤Î¾ì¹ç¡¢¸½ºß¤Ç¤Ï»È¤ï¤ì¤Æ¤¤¤Ê¤¤
  77 .I size
  78 °ú¤¿ô¤¬¤Ê¤¯¤Ê¤Ã¤Æ¤¤¤ëÅÀ¤ò½ü¤±¤Ð
  79 .BR epoll_create ()
  80 ¤ÈÆ±¤¸¤Ç¤¢¤ë¡£
  81 .I flags
  82 ¤Ë°Ê²¼¤ÎÃÍ¤ò¥Ó¥Ã¥ÈËè¤ÎÏÀÍýÏÂ (OR) ¤Ç»ØÄê¤¹¤ë¤³¤È¤Ç¡¢
  83 °Û¤Ê¤ëÆ°ºî¤ò¤µ¤»¤ë¤³¤È¤¬¤Ç¤¤ë¡£
  84 .TP
  85 .B EPOLL_CLOEXEC
  86 ¿·¤·¤¤¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂÐ¤·¤Æ
  87 close-on-exec
  88 .RB ( FD_CLOEXEC )
  89 ¥Õ¥é¥°¤ò¥»¥Ã¥È¤¹¤ë¡£
  90 ¤³¤Î¥Õ¥é¥°¤¬Ìò¤ËÎ©¤ÄÍýÍ³¤Ë¤Ä¤¤¤Æ¤Ï¡¢
  91 .BR open (2)
  92 ¤Î
  93 .B O_CLOEXEC
  94 ¥Õ¥é¥°¤ÎÀâÌÀ¤ò»²¾È¤Î¤³¤È¡£
  95 .SH ÊÖ¤êÃÍ
  96 À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï
  97 ÈóÉé¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
  98 ¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
  99 .I errno
 100 ¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃÍ¤òÀßÄê¤¹¤ë¡£
 101 .SH ¥¨¥é¡¼
 102 .TP
 103 .B EINVAL
 104 .I size
 105 ¤¬Àµ¤Ç¤Ê¤¤¡£
 106 .TP
 107 .B EINVAL
 108 .RB ( epoll_create1 ())
 109 .I flags
 110 ¤ËÌµ¸ú¤ÊÃÍ¤¬»ØÄê¤µ¤ì¤¿¡£
 111 .TP
 112 .B EMFILE
 113 .I /proc/sys/fs/epoll/max_user_instances
 114 ¤Ë¤è¤Ã¤Æ»ØÄê¤µ¤ì¤Æ¤¤¤ë¡¢epoll ¥¤¥ó¥¹¥¿¥ó¥¹¤Î¥æ¡¼¥¶¡¼Ã±°Ì¤ÎÀ©¸Â¤ËÃ£¤·¤¿¡£
 115 ¹¹¤Ê¤ë¾ÜºÙ¤Ë¤Ä¤¤¤Æ¤Ï
 116 .BR epoll (7)
 117 ¤ò»²¾È¤Î¤³¤È¡£
 118 .TP
 119 .B ENFILE
 120 ¥ª¡¼¥×¥ó¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤ÎÁí¿ô¤¬¥·¥¹¥Æ¥àÀ©¸Â¤ËÃ£¤·¤¿¡£
 121 .TP
 122 .B ENOMEM
 123 ¥«¡¼¥Í¥ë¥ª¥Ö¥¸¥§¥¯¥È¤òºîÀ®¤¹¤ë¤Î¤Ë½½Ê¬¤Ê¥á¥â¥ê¤¬¤Ê¤«¤Ã¤¿¡£
 124 .SH ½àµò
 125 .BR epoll_create ()
 126 ¤Ï Linux ÆÈ¼«¤Ç¤¢¤ê¡¢¥«¡¼¥Í¥ë 2.5.44 ¤ÇÆ³Æþ¤µ¤ì¤¿¡£
 127 .\" ¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï Linux ¥«¡¼¥Í¥ë 2.5.66 ¤Ç³ÎÄê¤µ¤ì¤ë¤Ù¤¤Ç¤¢¤ë¡£
 128 .SH Ãí°Õ
 129 Linux 2.6.8 °Ê¹ß¤Ç¤Ï¡¢
 130 .I size
 131 °ú¤¿ô¤Ï»ÈÍÑ¤µ¤ì¤Ê¤¤
 132 (¥«¡¼¥Í¥ë¤Ï¡¢Æ°Åª¤ËÉ¬Í×¤Ê¥Ç¡¼¥¿¹½Â¤¤ÎÂç¤¤µ¤ò·èÄê¤·¡¢
 133 ºÇ½é¤Î¥Ò¥ó¥È¤òÉ¬Í×¤·¤Ê¤¤)¡£
 134 .SH ´ØÏ¢¹àÌÜ
 135 .BR close (2),
 136 .BR epoll_ctl (2),
 137 .BR epoll_wait (2),
 138 .BR epoll (7)