#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:53+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages/man2/epoll_ctl.2:20 #, no-wrap msgid "EPOLL_CTL" msgstr "" #. type: TH #: man-pages/man2/epoll_ctl.2:20 #, no-wrap msgid "2014-07-08" msgstr "" #. type: TH #: man-pages/man2/epoll_ctl.2:20 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man2/epoll_ctl.2:20 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:21 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:23 msgid "epoll_ctl - control interface for an epoll descriptor" msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:23 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:25 msgid "B<#include Esys/epoll.hE>" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:28 msgid "" "BIB<, int >IB<, int >IB<, struct " "epoll_event *>IB<);>" msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:28 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:38 msgid "" "This system call performs control operations on the B(7) instance " "referred to by the file descriptor I. It requests that the operation " "I be performed for the target file descriptor, I." msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:42 msgid "Valid values for the I argument are :" msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:42 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:54 msgid "" "Register the target file descriptor I on the B instance referred " "to by the file descriptor I and associate the event I with the " "internal file linked to I." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:54 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:60 msgid "" "Change the event I associated with the target file descriptor I." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:60 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:71 msgid "" "Remove (deregister) the target file descriptor I from the B " "instance referred to by I. The I is ignored and can be NULL " "(but see BUGS below)." msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:79 msgid "" "The I argument describes the object linked to the file descriptor " "I. The I is defined as :" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:88 #, no-wrap msgid "" "typedef union epoll_data {\n" " void *ptr;\n" " int fd;\n" " uint32_t u32;\n" " uint64_t u64;\n" "} epoll_data_t;\n" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:93 #, no-wrap msgid "" "struct epoll_event {\n" " uint32_t events; /* Epoll events */\n" " epoll_data_t data; /* User data variable */\n" "};\n" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:100 msgid "" "The I member is a bit set composed using the following available " "event types:" msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:100 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:105 msgid "The associated file is available for B(2) operations." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:105 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:110 msgid "The associated file is available for B(2) operations." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:110 #, no-wrap msgid "B (since Linux 2.6.17)" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:116 msgid "" "Stream socket peer closed connection, or shut down writing half of " "connection. (This flag is especially useful for writing simple code to " "detect peer shutdown when using Edge Triggered monitoring.)" msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:116 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:121 msgid "There is urgent data available for B(2) operations." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:121 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:127 msgid "" "Error condition happened on the associated file descriptor. " "B(2) will always wait for this event; it is not necessary to " "set it in I." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:127 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:133 msgid "" "Hang up happened on the associated file descriptor. B(2) will " "always wait for this event; it is not necessary to set it in I." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:133 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:143 msgid "" "Sets the Edge Triggered behavior for the associated file descriptor. The " "default behavior for B is Level Triggered. See B(7) for more " "detailed information about Edge and Level Triggered event distribution " "architectures." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:143 #, no-wrap msgid "B (since Linux 2.6.2)" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:157 msgid "" "Sets the one-shot behavior for the associated file descriptor. This means " "that after an event is pulled out with B(2) the associated file " "descriptor is internally disabled and no other events will be reported by " "the B interface. The user must call B() with " "B to rearm the file descriptor with a new event mask." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:157 #, no-wrap msgid "B (since Linux 3.5)" msgstr "" #. commit 4d7e30d98939a0340022ccd49325a3d70f7e0238 #. type: Plain text #: man-pages/man2/epoll_ctl.2:178 msgid "" "If B and B are clear and the process has the " "B capability, ensure that the system does not enter " "\"suspend\" or \"hibernate\" while this event is pending or being processed. " " The event is considered as being \"processed\" from the time when it is " "returned by a call to B(2) until the next call to " "B(2) on the same B(7) file descriptor. See also BUGS." msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:178 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:187 msgid "" "When successful, B() returns zero. When an error occurs, " "B() returns -1 and I is set appropriately." msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:187 #, no-wrap msgid "ERRORS" msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:188 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:194 msgid "I or I is not a valid file descriptor." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:194 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:202 msgid "" "I was B, and the supplied file descriptor I is " "already registered with this epoll instance." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:202 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:215 msgid "" "I is not an B file descriptor, or I is the same as I, " "or the requested operation I is not supported by this interface." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:215 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:225 msgid "" "I was B or B, and I is not registered " "with this epoll instance." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:225 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:230 msgid "" "There was insufficient memory to handle the requested I control " "operation." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:230 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:240 msgid "" "The limit imposed by I was encountered " "while trying to register (B) a new file descriptor on an " "epoll instance. See B(7) for further details." msgstr "" #. type: TP #: man-pages/man2/epoll_ctl.2:240 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:246 msgid "The target file I does not support B." msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:246 #, no-wrap msgid "VERSIONS" msgstr "" #. To be precise: kernel 2.5.44. #. The interface should be finalized by Linux kernel 2.5.66. #. type: Plain text #: man-pages/man2/epoll_ctl.2:251 msgid "B() was added to the kernel in version 2.6." msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:251 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:255 msgid "" "B() is Linux-specific. Library support is provided in glibc " "starting with version 2.3.2." msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:255 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:260 msgid "" "The B interface supports all file descriptors that support B(2)." "" msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:260 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:274 msgid "" "In kernel versions before 2.6.9, the B operation required a " "non-null pointer in I, even though this argument is ignored. Since " "Linux 2.6.9, I can be specified as NULL when using B. " "Applications that need to be portable to kernels before 2.6.9 should specify " "a non-null pointer in I." msgstr "" #. commit a8159414d7e3af7233e7a5a82d1c5d85379bd75c (behavior change) #. https://lwn.net/Articles/520198/ #. type: Plain text #: man-pages/man2/epoll_ctl.2:301 msgid "" "If B is specified in I, but the caller does not have the " "B capability, then the B flag is I. This unfortunate behavior is necessary because no validity checks " "were performed on the I argument in the original implementation, and " "the addition of the B with a check that caused the call to fail " "if the caller did not have the B capability caused a " "breakage in at least one existing user-space application that happened to " "randomly (and uselessly) specify this bit. A robust application should " "therefore double check that it has the B capability if " "attempting to use the B flag." msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:301 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:306 msgid "B(2), B(2), B(2), B(7)" msgstr "" #. type: SH #: man-pages/man2/epoll_ctl.2:306 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: man-pages/man2/epoll_ctl.2:314 msgid "" "This page is part of release 3.70 of the Linux I project. A " "description of the project, information about reporting bugs, and the latest " "version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/" "." msgstr ""