ヘッダ -> ヘッダー

[linuxjm/LDP_man-pages.git] / po4a / epoll / po / ja.po

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2015-01-23 22:24+0900\n"
"PO-Revision-Date: 2015-01-25 07:15+0900\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: build/C/man7/epoll.7:21
#, no-wrap
msgid "EPOLL"
msgstr "EPOLL"

#. type: TH
#: build/C/man7/epoll.7:21
#, no-wrap
msgid "2015-01-10"
msgstr "2015-01-10"

#. type: TH
#: build/C/man7/epoll.7:21 build/C/man2/epoll_create.2:24
#: build/C/man2/epoll_ctl.2:20 build/C/man2/epoll_wait.2:22
#: build/C/man2/poll.2:31
#, no-wrap
msgid "Linux"
msgstr "Linux"

#. type: TH
#: build/C/man7/epoll.7:21 build/C/man2/epoll_create.2:24
#: build/C/man2/epoll_ctl.2:20 build/C/man2/epoll_wait.2:22
#: build/C/man2/poll.2:31
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr "Linux Programmer's Manual"

#. type: SH
#: build/C/man7/epoll.7:22 build/C/man2/epoll_create.2:25
#: build/C/man2/epoll_ctl.2:21 build/C/man2/epoll_wait.2:23
#: build/C/man2/poll.2:32
#, no-wrap
msgid "NAME"
msgstr "名前"

#. type: Plain text
#: build/C/man7/epoll.7:24
msgid "epoll - I/O event notification facility"
msgstr "epoll - I/O イベント通知機能"

#. type: SH
#: build/C/man7/epoll.7:24 build/C/man2/epoll_create.2:27
#: build/C/man2/epoll_ctl.2:23 build/C/man2/epoll_wait.2:25
#: build/C/man2/poll.2:34
#, no-wrap
msgid "SYNOPSIS"
msgstr "書式"

#. type: Plain text
#: build/C/man7/epoll.7:26 build/C/man2/epoll_ctl.2:25
msgid "B<#include E<lt>sys/epoll.hE<gt>>"
msgstr "B<#include E<lt>sys/epoll.hE<gt>>"

#. type: SH
#: build/C/man7/epoll.7:26 build/C/man2/epoll_create.2:34
#: build/C/man2/epoll_ctl.2:28 build/C/man2/epoll_wait.2:35
#: build/C/man2/poll.2:47
#, no-wrap
msgid "DESCRIPTION"
msgstr "説明"

#. type: Plain text
#: build/C/man7/epoll.7:40
msgid "The B<epoll> API performs a similar task to B<poll>(2): monitoring multiple file descriptors to see if I/O is possible on any of them.  The B<epoll> API can be used either as an edge-triggered or a level-triggered interface and scales well to large numbers of watched file descriptors.  The following system calls are provided to create and manage an B<epoll> instance:"
msgstr ""
"B<epoll> API は B<poll>(2) と同様の処理を行う、つまり、複数のファイルディスク\n"
"リプタを監視し、その中のいずれかが入出力可能な状態であるかを確認する。\n"
"B<epoll> API は、エッジトリガーインターフェースとレベルトリガーインターフェースの\n"
"いずれとしても使用することができ、監視するファイルディスクリプターの数が多い\n"
"場合にも使用できる。 B<epoll> インスタンスの作成や管理を行うために\n"
"以下のシステムコールが提供されている:"

#. type: IP
#: build/C/man7/epoll.7:40 build/C/man7/epoll.7:49 build/C/man7/epoll.7:57
#: build/C/man2/epoll_wait.2:59 build/C/man2/epoll_wait.2:61
#: build/C/man2/epoll_wait.2:63 build/C/man2/poll.2:134
#: build/C/man2/poll.2:136 build/C/man2/poll.2:138
#, no-wrap
msgid "*"
msgstr "*"

#. type: Plain text
#: build/C/man7/epoll.7:49
msgid "B<epoll_create>(2)  creates an B<epoll> instance and returns a file descriptor referring to that instance.  (The more recent B<epoll_create1>(2)  extends the functionality of B<epoll_create>(2).)"
msgstr ""
"B<epoll_create>(2) は B<epoll> インスタンスを作成し、そのインスタンスを参照する\n"
"ファイルディスクリプターを返す。(もっと新しい B<epoll_create1>(2) では、\n"
"B<epoll_create>(2) の機能が拡張されている)。"

#. type: Plain text
#: build/C/man7/epoll.7:57
msgid "Interest in particular file descriptors is then registered via B<epoll_ctl>(2).  The set of file descriptors currently registered on an B<epoll> instance is sometimes called an I<epoll> set."
msgstr "特定のファイルディスクリプターに対する監視内容を B<epoll_ctl>(2)  で登録する。 B<epoll> インスタンスに現在登録されているファイルディスクリプターの集合は I<epoll> 集合と呼ばれることもある。"

#. type: Plain text
#: build/C/man7/epoll.7:61
msgid "B<epoll_wait>(2)  waits for I/O events, blocking the calling thread if no events are currently available."
msgstr ""
"B<epoll_wait>(2) は I/O イベントを待つ。\n"
"現在利用可能な状態のイベントがなければ、呼び出したスレッドを停止する。"

#. type: SS
#: build/C/man7/epoll.7:61
#, no-wrap
msgid "Level-triggered and edge-triggered"
msgstr "レベルトリガーとエッジトリガー"

#. type: Plain text
#: build/C/man7/epoll.7:70
msgid "The B<epoll> event distribution interface is able to behave both as edge-triggered (ET) and as level-triggered (LT).  The difference between the two mechanisms can be described as follows.  Suppose that this scenario happens:"
msgstr "B<epoll> イベント配送 (distribution) インターフェースは、 エッジトリガー (ET) としてもレベルトリガー (LT) としても動作させることができる。 二つの配送機構の違いは、次のように説明できる。 このようなシナリオが起こったとしよう:"

#. type: IP
#: build/C/man7/epoll.7:70
#, no-wrap
msgid "1."
msgstr "1."

#. type: Plain text
#: build/C/man7/epoll.7:76
msgid "The file descriptor that represents the read side of a pipe (I<rfd>)  is registered on the B<epoll> instance."
msgstr "パイプの読み込み側を表すファイルディスクリプター (I<rfd>)  が B<epoll> インスタンスに登録される。"

#. type: IP
#: build/C/man7/epoll.7:76
#, no-wrap
msgid "2."
msgstr "2."

#. type: Plain text
#: build/C/man7/epoll.7:78
msgid "A pipe writer writes 2 kB of data on the write side of the pipe."
msgstr "パイプへ書き込むプログラムが 2 kB のデータをパイプの書き込み側へ書き込む。"

#. type: IP
#: build/C/man7/epoll.7:78
#, no-wrap
msgid "3."
msgstr "3."

#. type: Plain text
#: build/C/man7/epoll.7:84
msgid "A call to B<epoll_wait>(2)  is done that will return I<rfd> as a ready file descriptor."
msgstr "B<epoll_wait>(2)  を呼び出すと、読み込み可能 (ready) なファイルディスクリプターとして I<rfd> が返る。"

#. type: IP
#: build/C/man7/epoll.7:84
#, no-wrap
msgid "4."
msgstr "4."

#. type: Plain text
#: build/C/man7/epoll.7:87
msgid "The pipe reader reads 1 kB of data from I<rfd>."
msgstr "パイプから読み出すプログラムが、1 kB のデータを I<rfd> から読み出す。"

#. type: IP
#: build/C/man7/epoll.7:87
#, no-wrap
msgid "5."
msgstr "5."

#. type: Plain text
#: build/C/man7/epoll.7:91
msgid "A call to B<epoll_wait>(2)  is done."
msgstr "B<epoll_wait>(2)  の呼び出しが行われる。"

#. type: Plain text
#: build/C/man7/epoll.7:126
msgid "If the I<rfd> file descriptor has been added to the B<epoll> interface using the B<EPOLLET> (edge-triggered)  flag, the call to B<epoll_wait>(2)  done in step B<5> will probably hang despite the available data still present in the file input buffer; meanwhile the remote peer might be expecting a response based on the data it already sent.  The reason for this is that edge-triggered mode delivers events only when changes occur on the monitored file descriptor.  So, in step B<5> the caller might end up waiting for some data that is already present inside the input buffer.  In the above example, an event on I<rfd> will be generated because of the write done in B<2> and the event is consumed in B<3>.  Since the read operation done in B<4> does not consume the whole buffer data, the call to B<epoll_wait>(2)  done in step B<5> might block indefinitely."
msgstr "I<rfd> ファイルディスクリプターが B<EPOLLET> フラグ (エッジトリガー) を使って B<epoll> に追加されていると、 利用可能なデータがファイル入力バッファーにまだ存在するにもかかわらず ステップ B<5> の B<epoll_wait>(2)  の呼び出しでハングする可能性がある。 その一方で、リモートの接続先 (peer) は既に送られたデータに 基づいて応答を期待しているかもしれない。 このようなことが起こる理由は、エッジトリガーイベント配送では、 モニタしているファイルでイベントが起ったときにのみイベントが 配送されるためである。 したがって、ステップ B<5> では、呼び出し側は結果的に 入力バッファー内にすで存在するデータを待つことになるかもしれない。 上記の例では、 B<2> で行われた書き込みによって I<rfd> に関するイベントが生成され、 B<3> でイベントが消費 (consume) される。 B<4> で行われる読み込み操作では、全部のバッファーデータを消費しないので、 ステップ B<5> で行われる B<epoll_wait>(2)  の呼び出しが 無期限に停止 (block) するかもしれない。"

#. type: Plain text
#: build/C/man7/epoll.7:136
msgid "An application that employs the B<EPOLLET> flag should use nonblocking file descriptors to avoid having a blocking read or write starve a task that is handling multiple file descriptors.  The suggested way to use B<epoll> as an edge-triggered (B<EPOLLET>)  interface is as follows:"
msgstr "B<EPOLLET> フラグを採用するアプリケーションでは、 インターフェースはブロックしない (nonblocking) ファイルディスクリプターを 使うべきである。 これは、ブロックされる読み込みや書き込みによって、 複数のファイルディスクリプターを扱うタスクが 停止してしまうのを避けるためである。 B<epoll> をエッジトリガー (B<EPOLLET>)  インターフェースとして使うために提案される方法は以下の通りである。"

#. type: TP
#: build/C/man7/epoll.7:137
#, no-wrap
msgid "B<i>"
msgstr "B<i>"

#. type: Plain text
#: build/C/man7/epoll.7:140
msgid "with nonblocking file descriptors; and"
msgstr "ブロックしないファイルディスクリプターと共に使う。"

#. type: TP
#: build/C/man7/epoll.7:140
#, no-wrap
msgid "B<ii>"
msgstr "B<ii>"

#. type: Plain text
#: build/C/man7/epoll.7:148
msgid "by waiting for an event only after B<read>(2)  or B<write>(2)  return B<EAGAIN>."
msgstr "B<read>(2)  または B<write>(2)  が B<EAGAIN> を返した後でのみ、イベントを待つ。"

#. type: Plain text
#: build/C/man7/epoll.7:159
msgid "By contrast, when used as a level-triggered interface (the default, when B<EPOLLET> is not specified), B<epoll> is simply a faster B<poll>(2), and can be used wherever the latter is used since it shares the same semantics."
msgstr ""
"一方、レベルトリガーインターフェースとして使う場合\n"
" (こちらがデフォルトである、\n"
"B<EPOLLET> が指定されなかった場合)、\n"
"B<epoll> は単に高速な B<poll>(2) であり、使い方が同じなので、\n"
"B<poll>(2) が使われているところではどこでも使用することができる。"

#. type: Plain text
#: build/C/man7/epoll.7:176
msgid "Since even with edge-triggered B<epoll>, multiple events can be generated upon receipt of multiple chunks of data, the caller has the option to specify the B<EPOLLONESHOT> flag, to tell B<epoll> to disable the associated file descriptor after the receipt of an event with B<epoll_wait>(2).  When the B<EPOLLONESHOT> flag is specified, it is the caller's responsibility to rearm the file descriptor using B<epoll_ctl>(2)  with B<EPOLL_CTL_MOD>."
msgstr "エッジトリガーを使った場合でも、複数のデータを受信すると複数の B<epoll> イベントが生成されるので、 呼び出し側には B<EPOLLONESHOT> フラグを指定するオプションがある。 このフラグは B<epoll> に対して、 B<epoll_wait>(2)  によるイベントを受信した後で、関連するファイルディスクリプターを無効にさせる。 B<EPOLLONESHOT> フラグが指定された場合、 B<epoll_ctl>(2)  に B<EPOLL_CTL_MOD> を指定してファイルディスクリプターを再度使用できるようにするのは、 呼び出し側の責任である。"

#. type: SS
#: build/C/man7/epoll.7:176
#, no-wrap
msgid "Interaction with autosleep"
msgstr "autosleep との関係"

#. type: Plain text
#: build/C/man7/epoll.7:188
msgid "If the system is in B<autosleep> mode via I</sys/power/autosleep> and an event happens which wakes the device from sleep, the device driver will only keep the device awake until that event is queued.  To keep the device awake until the event has been processed, it is necessary to use the B<epoll>(7)  B<EPOLLWAKEUP> flag."
msgstr "システムが I</sys/power/autosleep> 経由で B<autosleep> モードになっていて、 デバイスをスリープ状態から起こすイベントが発生した場合、 そのイベントがキューに入るまでは、デバイスドライバーはデバイスを起こしたままにしておくだけである。 イベントが処理されるまでデバイスを起こしたままにしておくには、 B<epoll>(7) B<EPOLLWAKEUP> フラグを使う必要がある。"

#. type: Plain text
#: build/C/man7/epoll.7:207
msgid "When the B<EPOLLWAKEUP> flag is set in the B<events> field for a I<struct epoll_event>, the system will be kept awake from the moment the event is queued, through the B<epoll_wait>(2)  call which returns the event until the subsequent B<epoll_wait>(2)  call.  If the event should keep the system awake beyond that time, then a separate I<wake_lock> should be taken before the second B<epoll_wait>(2)  call."
msgstr "B<EPOLLWAKEUP> フラグが I<struct epoll_event> の B<events> フィールドでセットされた場合、 イベントがキューに入った瞬間から、B<epoll_wait>(2) がそのイベントを返し次の B<epoll_wait>(2) の呼び出しが行われるまでの間、システムは起きたままの状態になる。 イベントが上記の時間の範囲を超えてシステムを起きたままの状態にしておく必要がある場合は、 2 番目の B<epoll_wait>(2) の呼び出しの前に別の I<wake_lock> を取る必要がある。"

#. type: SS
#: build/C/man7/epoll.7:207
#, no-wrap
msgid "/proc interfaces"
msgstr "/proc インターフェース"

#.  Following was added in 2.6.28, but them removed in 2.6.29
#.  .TP
#.  .IR /proc/sys/fs/epoll/max_user_instances " (since Linux 2.6.28)"
#.  This specifies an upper limit on the number of epoll instances
#.  that can be created per real user ID.
#. type: Plain text
#: build/C/man7/epoll.7:215
msgid "The following interfaces can be used to limit the amount of kernel memory consumed by epoll:"
msgstr "epoll が消費するカーネルメモリーの量を制限するために、 以下のインターフェースを使用することができる。"

#. type: TP
#: build/C/man7/epoll.7:215
#, no-wrap
msgid "I</proc/sys/fs/epoll/max_user_watches> (since Linux 2.6.28)"
msgstr "I</proc/sys/fs/epoll/max_user_watches> (Linux 2.6.28 以降)"

#.  2.6.29 (in 2.6.28, the default was 1/32 of lowmem)
#. type: Plain text
#: build/C/man7/epoll.7:229
msgid "This specifies a limit on the total number of file descriptors that a user can register across all epoll instances on the system.  The limit is per real user ID.  Each registered file descriptor costs roughly 90 bytes on a 32-bit kernel, and roughly 160 bytes on a 64-bit kernel.  Currently, the default value for I<max_user_watches> is 1/25 (4%) of the available low memory, divided by the registration cost in bytes."
msgstr "このファイルは、あるユーザーがシステム上の全ての epoll インスタンスに 登録できるファイルディスクリプターの総数の上限を規定する。 この上限は実ユーザー ID 単位である。 登録されたファイルディスクリプター 1 つが消費するメモリー量は、 32 ビットカーネルでおよそ 90 バイト、 64 ビットカーネルでおよそ 160 バイトである。 現在のところ、 I<max_user_watches> のデフォルト値は、利用可能なメモリー下限の 1/25 (4%) であり、 登録で消費されるメモリー量 (バイト単位) で割った値となる。"

#. type: SS
#: build/C/man7/epoll.7:229
#, no-wrap
msgid "Example for suggested usage"
msgstr "おすすめな使用例"

#. type: Plain text
#: build/C/man7/epoll.7:258
msgid "While the usage of B<epoll> when employed as a level-triggered interface does have the same semantics as B<poll>(2), the edge-triggered usage requires more clarification to avoid stalls in the application event loop.  In this example, listener is a nonblocking socket on which B<listen>(2)  has been called.  The function I<do_use_fd()> uses the new ready file descriptor until B<EAGAIN> is returned by either B<read>(2)  or B<write>(2).  An event-driven state machine application should, after having received B<EAGAIN>, record its current state so that at the next call to I<do_use_fd()> it will continue to B<read>(2)  or B<write>(2)  from where it stopped before."
msgstr "レベルトリガーインターフェースとして使用するときの B<epoll> の使い方は B<poll>(2)  と同じである。 しかしエッジトリガーとして使う場合は、 アプリケーションのイベントループでストール (stall) しないように、 使い方をより明確にしておく必要がある。 この例では、リスナはブロックしないソケットであり、 B<listen>(2)  が呼ばれている。 関数 I<do_use_fd()> は、 B<read>(2)  または B<write>(2)  によって B<EAGAIN> が返されるまでは、新しい準備済みのファイルディスクリプターを使う。 イベント駆動ステートマシンアプリケーションは、 B<EAGAIN> を受信した後、カレントの状態を記録しておくべきである。 これにより、次の I<do_use_fd()> 呼び出しのときに、以前に停止したところから B<read>(2)  または B<write>(2)  を継続することができる。"

#. type: Plain text
#: build/C/man7/epoll.7:264
#, no-wrap
msgid ""
"#define MAX_EVENTS 10\n"
"struct epoll_event ev, events[MAX_EVENTS];\n"
"int listen_sock, conn_sock, nfds, epollfd;\n"
msgstr ""
"#define MAX_EVENTS 10\n"
"struct epoll_event ev, events[MAX_EVENTS];\n"
"int listen_sock, conn_sock, nfds, epollfd;\n"

#. type: Plain text
#: build/C/man7/epoll.7:267
#, no-wrap
msgid ""
"/* Code to set up listening socket, \\(aqlisten_sock\\(aq,\n"
"   (socket(), bind(), listen()) omitted */\n"
msgstr ""
"/* Code to set up listening socket, \\(aqlisten_sock\\(aq,\n"
"   (socket(), bind(), listen()) omitted */\n"

#. type: Plain text
#: build/C/man7/epoll.7:273
#, no-wrap
msgid ""
"epollfd = epoll_create1(0);\n"
"if (epollfd == -1) {\n"
"    perror(\"epoll_create1\");\n"
"    exit(EXIT_FAILURE);\n"
"}\n"
msgstr ""
"epollfd = epoll_create1(0);\n"
"if (epollfd == -1) {\n"
"    perror(\"epoll_create1\");\n"
"    exit(EXIT_FAILURE);\n"
"}\n"

#. type: Plain text
#: build/C/man7/epoll.7:280
#, no-wrap
msgid ""
"ev.events = EPOLLIN;\n"
"ev.data.fd = listen_sock;\n"
"if (epoll_ctl(epollfd, EPOLL_CTL_ADD, listen_sock, &ev) == -1) {\n"
"    perror(\"epoll_ctl: listen_sock\");\n"
"    exit(EXIT_FAILURE);\n"
"}\n"
msgstr ""
"ev.events = EPOLLIN;\n"
"ev.data.fd = listen_sock;\n"
"if (epoll_ctl(epollfd, EPOLL_CTL_ADD, listen_sock, &ev) == -1) {\n"
"    perror(\"epoll_ctl: listen_sock\");\n"
"    exit(EXIT_FAILURE);\n"
"}\n"

#. type: Plain text
#: build/C/man7/epoll.7:287
#, no-wrap
msgid ""
"for (;;) {\n"
"    nfds = epoll_wait(epollfd, events, MAX_EVENTS, -1);\n"
"    if (nfds == -1) {\n"
"        perror(\"epoll_pwait\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""
"for (;;) {\n"
"    nfds = epoll_wait(epollfd, events, MAX_EVENTS, -1);\n"
"    if (nfds == -1) {\n"
"        perror(\"epoll_pwait\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"

#. type: Plain text
#: build/C/man7/epoll.7:309
#, no-wrap
msgid ""
"    for (n = 0; n E<lt> nfds; ++n) {\n"
"        if (events[n].data.fd == listen_sock) {\n"
"            conn_sock = accept(listen_sock,\n"
"                            (struct sockaddr *) &local, &addrlen);\n"
"            if (conn_sock == -1) {\n"
"                perror(\"accept\");\n"
"                exit(EXIT_FAILURE);\n"
"            }\n"
"            setnonblocking(conn_sock);\n"
"            ev.events = EPOLLIN | EPOLLET;\n"
"            ev.data.fd = conn_sock;\n"
"            if (epoll_ctl(epollfd, EPOLL_CTL_ADD, conn_sock,\n"
"                        &ev) == -1) {\n"
"                perror(\"epoll_ctl: conn_sock\");\n"
"                exit(EXIT_FAILURE);\n"
"            }\n"
"        } else {\n"
"            do_use_fd(events[n].data.fd);\n"
"        }\n"
"    }\n"
"}\n"
msgstr ""
"    for (n = 0; n E<lt> nfds; ++n) {\n"
"        if (events[n].data.fd == listen_sock) {\n"
"            conn_sock = accept(listen_sock,\n"
"                            (struct sockaddr *) &local, &addrlen);\n"
"            if (conn_sock == -1) {\n"
"                perror(\"accept\");\n"
"                exit(EXIT_FAILURE);\n"
"            }\n"
"            setnonblocking(conn_sock);\n"
"            ev.events = EPOLLIN | EPOLLET;\n"
"            ev.data.fd = conn_sock;\n"
"            if (epoll_ctl(epollfd, EPOLL_CTL_ADD, conn_sock,\n"
"                        &ev) == -1) {\n"
"                perror(\"epoll_ctl: conn_sock\");\n"
"                exit(EXIT_FAILURE);\n"
"            }\n"
"        } else {\n"
"            do_use_fd(events[n].data.fd);\n"
"        }\n"
"    }\n"
"}\n"

#. type: Plain text
#: build/C/man7/epoll.7:328
msgid "When used as an edge-triggered interface, for performance reasons, it is possible to add the file descriptor inside the B<epoll> interface (B<EPOLL_CTL_ADD>)  once by specifying (B<EPOLLIN>|B<EPOLLOUT>).  This allows you to avoid continuously switching between B<EPOLLIN> and B<EPOLLOUT> calling B<epoll_ctl>(2)  with B<EPOLL_CTL_MOD>."
msgstr "エッジトリガーインターフェースとして使う場合、性能上の理由により、 一度 (B<EPOLLIN>|B<EPOLLOUT>)  を指定してから (B<EPOLL_CTL_ADD> で) ファイルディスクリプターを B<epoll> インターフェースに追加することができる。 これにより、 B<epoll_ctl>(2)  に B<EPOLL_CTL_MOD> を指定して呼び出すことで B<EPOLLIN> と B<EPOLLOUT> の連続的な切り替えが避けられる。"

#. type: SS
#: build/C/man7/epoll.7:328
#, no-wrap
msgid "Questions and answers"
msgstr "質問と解答"

#. type: TP
#: build/C/man7/epoll.7:329
#, no-wrap
msgid "B<Q0>"
msgstr "B<Q0>"

#. type: Plain text
#: build/C/man7/epoll.7:334
msgid "What is the key used to distinguish the file descriptors registered in an B<epoll> set?"
msgstr "B<epoll> 集合内の登録されたファイルディスクリプターを区別するには、 何をキーとして使えばよいか？"

#. type: TP
#: build/C/man7/epoll.7:334
#, no-wrap
msgid "B<A0>"
msgstr "B<A0>"

#. type: Plain text
#: build/C/man7/epoll.7:340
msgid "The key is the combination of the file descriptor number and the open file description (also known as an \"open file handle\", the kernel's internal representation of an open file)."
msgstr "キーはファイルディスクリプター番号とオープンファイル記述 (open file description) の組である (オープンファイル記述は \"open file handle\" とも 呼ばれ、オープンされたファイルのカーネルの内部表現である)。"

#. type: TP
#: build/C/man7/epoll.7:340
#, no-wrap
msgid "B<Q1>"
msgstr "B<Q1>"

#. type: Plain text
#: build/C/man7/epoll.7:345
msgid "What happens if you register the same file descriptor on an B<epoll> instance twice?"
msgstr "1 つの B<epoll> インスタンスに同じファイルディスクリプターを 2 回登録するとどうなるか？"

#. type: TP
#: build/C/man7/epoll.7:345
#, no-wrap
msgid "B<A1>"
msgstr "B<A1>"

#.  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
#.  cannot add the duplicate file descriptor to the epoll set.  (In every
#.  other case that I can think of, descriptors duplicated by fork have
#.  similar semantics to descriptors duplicated by dup() and friends.)  On
#.  the other hand, the very fact that the child has a duplicate of the
#.  descriptor means that even if the parent closes its descriptor, then
#.  epoll_wait() in the parent will continue to receive notifications for
#.  that descriptor because of the duplicated descriptor in the child.
#.  See http://thread.gmane.org/gmane.linux.kernel/596462/
#.  "epoll design problems with common fork/exec patterns"
#.  mtk, Feb 2008
#. type: Plain text
#: build/C/man7/epoll.7:376
msgid "You will probably get B<EEXIST>.  However, it is possible to add a duplicate (B<dup>(2), B<dup2>(2), B<fcntl>(2)  B<F_DUPFD>)  descriptor to the same B<epoll> instance.  This can be a useful technique for filtering events, if the duplicate file descriptors are registered with different I<events> masks."
msgstr "たぶん B<EEXIST> を受け取るだろう。 しかしながら、同じ B<epoll> インスタンスに対して複製されたディスクリプターを追加することは可能である (B<dup>(2), B<dup2>(2), B<fcntl>(2)  B<F_DUPFD> など)。 複製したファイルディスクリプターを異なる I<events> マスクで登録すれば、イベントをフィルタリングするのに この機能は有用な手法である。"

#. type: TP
#: build/C/man7/epoll.7:376
#, no-wrap
msgid "B<Q2>"
msgstr "B<Q2>"

#. type: Plain text
#: build/C/man7/epoll.7:384
msgid "Can two B<epoll> instances wait for the same file descriptor? If so, are events reported to both B<epoll> file descriptors?"
msgstr "2 つの B<epoll> インスタンスが同じファイルディスクリプターを待ち受けることは可能か？ もし可能であれば、イベントは両方の B<epoll> ファイルディスクリプターに報告されるか？"

#. type: TP
#: build/C/man7/epoll.7:384
#, no-wrap
msgid "B<A2>"
msgstr "B<A2>"

#. type: Plain text
#: build/C/man7/epoll.7:388
msgid "Yes, and events would be reported to both.  However, careful programming may be needed to do this correctly."
msgstr "イベントは両方に報告される。 しかしながら、これを正しく扱うには注意深くプログラミングする必要が あるかもしれない。"

#. type: TP
#: build/C/man7/epoll.7:388
#, no-wrap
msgid "B<Q3>"
msgstr "B<Q3>"

#. type: Plain text
#: build/C/man7/epoll.7:393
msgid "Is the B<epoll> file descriptor itself poll/epoll/selectable?"
msgstr "B<epoll> ファイルディスクリプター自身は poll/epoll/select が可能か？"

#. type: TP
#: build/C/man7/epoll.7:393
#, no-wrap
msgid "B<A3>"
msgstr "B<A3>"

#. type: Plain text
#: build/C/man7/epoll.7:400
msgid "Yes.  If an B<epoll> file descriptor has events waiting, then it will indicate as being readable."
msgstr "可能である。 B<epoll> ファイルディスクリプターに処理待ちのイベントがある場合は、 読み出し可能だと通知されることだろう。"

#. type: TP
#: build/C/man7/epoll.7:400
#, no-wrap
msgid "B<Q4>"
msgstr "B<Q4>"

#. type: Plain text
#: build/C/man7/epoll.7:405
msgid "What happens if one attempts to put an B<epoll> file descriptor into its own file descriptor set?"
msgstr "B<epoll> ファイルディスクリプターを自身のファイルディスクリプター集合に 入れようとするとどうなるか？"

#. type: TP
#: build/C/man7/epoll.7:405
#, no-wrap
msgid "B<A4>"
msgstr "B<A4>"

#. type: Plain text
#: build/C/man7/epoll.7:416
msgid "The B<epoll_ctl>(2)  call will fail (B<EINVAL>).  However, you can add an B<epoll> file descriptor inside another B<epoll> file descriptor set."
msgstr "B<epoll_ctl>(2)  の呼び出しは (B<EINVAL> で) 失敗するだろう。 ただし B<epoll> ファイルディスクリプターを他の B<epoll> ファイルディスクリプター集合の内部に追加することは可能である。"

#. type: TP
#: build/C/man7/epoll.7:416
#, no-wrap
msgid "B<Q5>"
msgstr "B<Q5>"

#. type: Plain text
#: build/C/man7/epoll.7:421
msgid "Can I send an B<epoll> file descriptor over a UNIX domain socket to another process?"
msgstr "B<epoll> ファイルディスクリプターを UNIX ドメインソケットで他のプロセスに送ることは可能か？"

#. type: TP
#: build/C/man7/epoll.7:421
#, no-wrap
msgid "B<A5>"
msgstr "B<A5>"

#. type: Plain text
#: build/C/man7/epoll.7:427
msgid "Yes, but it does not make sense to do this, since the receiving process would not have copies of the file descriptors in the B<epoll> set."
msgstr "可能だが、これをすることに意味はない。 なぜなら、受信側のプロセスが B<epoll> 集合内のファイルディスクリプターのコピーを持っていないからである。"

#. type: TP
#: build/C/man7/epoll.7:427
#, no-wrap
msgid "B<Q6>"
msgstr "B<Q6>"

#. type: Plain text
#: build/C/man7/epoll.7:432
msgid "Will closing a file descriptor cause it to be removed from all B<epoll> sets automatically?"
msgstr "ファイルディスクリプターをクローズすると、そのファイルディスクリプターは全ての B<epoll> 集合から自動的に削除されるか？"

#. type: TP
#: build/C/man7/epoll.7:432
#, no-wrap
msgid "B<A6>"
msgstr "B<A6>"

#. type: Plain text
#: build/C/man7/epoll.7:460
msgid "Yes, but be aware of the following point.  A file descriptor is a reference to an open file description (see B<open>(2)).  Whenever a descriptor is duplicated via B<dup>(2), B<dup2>(2), B<fcntl>(2)  B<F_DUPFD>, or B<fork>(2), a new file descriptor referring to the same open file description is created.  An open file description continues to exist until all file descriptors referring to it have been closed.  A file descriptor is removed from an B<epoll> set only after all the file descriptors referring to the underlying open file description have been closed (or before if the descriptor is explicitly removed using B<epoll_ctl>(2)  B<EPOLL_CTL_DEL>).  This means that even after a file descriptor that is part of an B<epoll> set has been closed, events may be reported for that file descriptor if other file descriptors referring to the same underlying file description remain open."
msgstr "削除されるが、以下の点に注意が必要である。 ファイルディスクリプターはオープンファイル記述 (B<open>(2)  参照) への参照である。 ディスクリプターの複製を B<dup>(2), B<dup2>(2), B<fcntl>(2)  の B<F_DUPFD> や B<fork>(2)  経由で行う度に、同じオープンファイル記述を参照する新規のファイル ディスクリプターが生成される。 オープンファイル記述自体は、自身を参照する全てのファイルディスクリプター がクローズされるまで存在し続ける。 ファイルディスクリプターが B<epoll> 集合から削除されるのは、対応するオープンファイル記述を参照している 全てのファイルディスクリプターがクローズされた後である (B<epoll_ctl>(2)  B<EPOLL_CTL_DEL> を使ってそのディスクリプターを明示的に削除した場合にも削除される)。 このことは、 B<epoll> 集合に属しているあるファイルディスクリプターをクローズした後であっても、 同じファイル記述を参照する他のファイルディスクリプターがオープンされている間は、 クローズしたファイルディスクリプター宛にイベントが報告される可能性があると いうことを意味する。"

#. type: TP
#: build/C/man7/epoll.7:460
#, no-wrap
msgid "B<Q7>"
msgstr "B<Q7>"

#. type: Plain text
#: build/C/man7/epoll.7:465
msgid "If more than one event occurs between B<epoll_wait>(2)  calls, are they combined or reported separately?"
msgstr "2 つ以上のイベントが B<epoll_wait>(2)  コールの間に発生した場合、それらはまとめて報告されるか、 それとも別々に報告されるか？"

#. type: TP
#: build/C/man7/epoll.7:465
#, no-wrap
msgid "B<A7>"
msgstr "B<A7>"

#. type: Plain text
#: build/C/man7/epoll.7:468
msgid "They will be combined."
msgstr "まとめて報告されるだろう。"

#. type: TP
#: build/C/man7/epoll.7:468
#, no-wrap
msgid "B<Q8>"
msgstr "B<Q8>"

#. type: Plain text
#: build/C/man7/epoll.7:472
msgid "Does an operation on a file descriptor affect the already collected but not yet reported events?"
msgstr "ファイルディスクリプターに対する操作は、 既に集められているがまだ報告されていないイベントに影響するか？"

#. type: TP
#: build/C/man7/epoll.7:472
#, no-wrap
msgid "B<A8>"
msgstr "B<A8>"

#. type: Plain text
#: build/C/man7/epoll.7:478
msgid "You can do two operations on an existing file descriptor.  Remove would be meaningless for this case.  Modify will reread available I/O."
msgstr "既存のファイルディスクリプターに対して 2 つの操作を行うことができる。 この場合、削除には意味がない。 変更すると、使用可能な I/O が再び読み込まれる。"

#. type: TP
#: build/C/man7/epoll.7:478
#, no-wrap
msgid "B<Q9>"
msgstr "B<Q9>"

#. type: Plain text
#: build/C/man7/epoll.7:486
msgid "Do I need to continuously read/write a file descriptor until B<EAGAIN> when using the B<EPOLLET> flag (edge-triggered behavior) ?"
msgstr "B<EPOLLET> フラグ (エッジトリガー動作) を使っている場合、 B<EAGAIN> を受け取るまで、 継続してファイルディスクリプターを読み書きする必要があるか？"

#. type: TP
#: build/C/man7/epoll.7:486
#, no-wrap
msgid "B<A9>"
msgstr "B<A9>"

#. type: Plain text
#: build/C/man7/epoll.7:496
msgid "Receiving an event from B<epoll_wait>(2)  should suggest to you that such file descriptor is ready for the requested I/O operation.  You must consider it ready until the next (nonblocking)  read/write yields B<EAGAIN>.  When and how you will use the file descriptor is entirely up to you."
msgstr "B<epoll_wait>(2)  からイベントを受け取ることは、 そのファイルディスクリプターが要求された I/O 操作に対して準備済みである、 ということをユーザーに示すものである。 次の (ブロックしない) read/write で B<EAGAIN> を受け取るまではファイルディスクリプターは準備済みであると 考えなければならない。 そのファイルディスクリプターをいつどのように使うかは、 全くユーザーに任されてる。"

#. type: Plain text
#: build/C/man7/epoll.7:502
msgid "For packet/token-oriented files (e.g., datagram socket, terminal in canonical mode), the only way to detect the end of the read/write I/O space is to continue to read/write until B<EAGAIN>."
msgstr "パケット指向やトークン指向のファイル (例えば、データグラムソケット、 canonical モードの端末) では、 読み込み用 / 書き込み用の I/O 空間の末尾を検知する唯一の方法は B<EAGAIN> になるまで read/write を行うことである。"

#. type: Plain text
#: build/C/man7/epoll.7:518
msgid "For stream-oriented files (e.g., pipe, FIFO, stream socket), the condition that the read/write I/O space is exhausted can also be detected by checking the amount of data read from / written to the target file descriptor.  For example, if you call B<read>(2)  by asking to read a certain amount of data and B<read>(2)  returns a lower number of bytes, you can be sure of having exhausted the read I/O space for the file descriptor.  The same is true when writing using B<write>(2).  (Avoid this latter technique if you cannot guarantee that the monitored file descriptor always refers to a stream-oriented file.)"
msgstr "ストリーム指向のファイル (例えば、パイプ、FIFO、ストリームソケット) では、 読み込み用 / 書き込み用の I/O 空間が使い尽くされた状態は、 対象となるファイルディスクリプターから読み込んだデータ量または 書き込んだデータ量をチェックすることでも検知できる。 例えば、ある特定の量のデータを読み込むために B<read>(2)  を呼んだときに、 B<read>(2)  が返したバイト数がそれより少なかった場合、 そのファイルディスクリプターの読み込み用 I/O 空間が 使い尽くされたことが分かる。 B<write>(2)  を使って書き込みをするときも、同じことが言える (監視しているファイルディスクリプターが常にストリーム指向のファイルを 参照していることを保証できない場合には、後者の手法の使用を避けること)。"

#. type: SS
#: build/C/man7/epoll.7:518
#, no-wrap
msgid "Possible pitfalls and ways to avoid them"
msgstr "ありがちな落とし穴と回避方法"

#. type: TP
#: build/C/man7/epoll.7:519
#, no-wrap
msgid "B<o Starvation (edge-triggered)>"
msgstr "B<o 飢餓 (starvation) (エッジトリガー)>"

#. type: Plain text
#: build/C/man7/epoll.7:527
msgid "If there is a large amount of I/O space, it is possible that by trying to drain it the other files will not get processed causing starvation.  (This problem is not specific to B<epoll>.)"
msgstr "大きな I/O 空間がある場合、 その I/O 空間のデータを全て処理 (drain) しようとすると、 他のファイルが処理されず、飢餓を発生させることがある (この問題は B<epoll> に固有のものではない)。"

#. type: Plain text
#: build/C/man7/epoll.7:535
msgid "The solution is to maintain a ready list and mark the file descriptor as ready in its associated data structure, thereby allowing the application to remember which files need to be processed but still round robin amongst all the ready files.  This also supports ignoring subsequent events you receive for file descriptors that are already ready."
msgstr "この問題の解決法は、準備済み状態のリストを管理して、 関連する data 構造体の中でファイルディスクリプターが 利用可能であるとマークすることである。 それによって、利用可能なすべてのファイルの中で どのファイルを処理する必要があるかを憶えることができ、 しかも順番に処理 (round robin) することができる。 既に利用可能であるファイルディスクリプターに対して それ以後に受け取るイベントを無視することもできる。"

#. type: TP
#: build/C/man7/epoll.7:535
#, no-wrap
msgid "B<o If using an event cache...>"
msgstr "B<o イベントキャッシュを使っている場合>"

#. type: Plain text
#: build/C/man7/epoll.7:551
msgid "If you use an event cache or store all the file descriptors returned from B<epoll_wait>(2), then make sure to provide a way to mark its closure dynamically (i.e., caused by a previous event's processing).  Suppose you receive 100 events from B<epoll_wait>(2), and in event #47 a condition causes event #13 to be closed.  If you remove the structure and B<close>(2)  the file descriptor for event #13, then your event cache might still say there are events waiting for that file descriptor causing confusion."
msgstr "イベントキャッシュを使っている場合、 または B<epoll_wait>(2)  から返された全てのファイルディスクリプターを格納している場合、 クローズされたことを動的にマークする (つまり前のイベントの処理によってマークされる) 方法を提供すべきである。 B<epoll_wait>(2)  から 100 個のイベントを受け取り、 イベント #47 ではある条件でイベント #13 が閉じられると仮定する。 イベント #13 の構造体を削除しファイルディスクリプターを B<close>(2)  すると、イベントキャッシュはそのファイルディスクリプターを待つイベントが 存在するといって、混乱が起きる。"

#. type: Plain text
#: build/C/man7/epoll.7:562
msgid "One solution for this is to call, during the processing of event 47, B<epoll_ctl>(B<EPOLL_CTL_DEL>)  to delete file descriptor 13 and B<close>(2), then mark its associated data structure as removed and link it to a cleanup list.  If you find another event for file descriptor 13 in your batch processing, you will discover the file descriptor had been previously removed and there will be no confusion."
msgstr "この問題を解決する 1 つの方法は、イベント 47 の処理をしている間に、 ファイルディスクリプター 13 を削除して B<close>(2)  するために B<epoll_ctl>(B<EPOLL_CTL_DEL>)  を呼び出し、関連付けられた data 構造体を削除済みとマークして、 クリーンアップリストにリンクすることである。 バッチ処理の中でファイルディスクリプター 13 についての 他のイベントを見つけた場合、 そのファイルディスクリプターが以前に削除されたものであると分かるので、 混乱は起きない。"

#. type: SH
#: build/C/man7/epoll.7:562 build/C/man2/epoll_create.2:108
#: build/C/man2/epoll_ctl.2:256 build/C/man2/epoll_wait.2:187
#: build/C/man2/poll.2:330
#, no-wrap
msgid "VERSIONS"
msgstr "バージョン"

#.  Its interface should be finalized in Linux kernel 2.5.66.
#. type: Plain text
#: build/C/man7/epoll.7:568
msgid "The B<epoll> API was introduced in Linux kernel 2.5.44.  Support was added to glibc in version 2.3.2."
msgstr "B<epoll> API は Linux カーネル 2.5.44 に導入された。 glibc でのサポートはバージョン 2.3.2 で追加された。"

#. type: SH
#: build/C/man7/epoll.7:568 build/C/man2/epoll_create.2:118
#: build/C/man2/epoll_ctl.2:261 build/C/man2/epoll_wait.2:197
#: build/C/man2/poll.2:347
#, no-wrap
msgid "CONFORMING TO"
msgstr "準拠"

#. type: Plain text
#: build/C/man7/epoll.7:577
msgid "The B<epoll> API is Linux-specific.  Some other systems provide similar mechanisms, for example, FreeBSD has I<kqueue>, and Solaris has I</dev/poll>."
msgstr "B<epoll> API は Linux 固有である。 他のシステムでも同様の機構が提供されている場合がある。 例えば、FreeBSD の I<kqueue> や Solaris の I</dev/poll> などである。"

#. type: SH
#: build/C/man7/epoll.7:577 build/C/man2/epoll_create.2:144
#: build/C/man2/epoll_ctl.2:311 build/C/man2/epoll_wait.2:242
#: build/C/man2/poll.2:397
#, no-wrap
msgid "SEE ALSO"
msgstr "関連項目"

#. type: Plain text
#: build/C/man7/epoll.7:582
msgid "B<epoll_create>(2), B<epoll_create1>(2), B<epoll_ctl>(2), B<epoll_wait>(2)"
msgstr "B<epoll_create>(2), B<epoll_create1>(2), B<epoll_ctl>(2), B<epoll_wait>(2)"

#. type: SH
#: build/C/man7/epoll.7:582 build/C/man2/epoll_create.2:149
#: build/C/man2/epoll_ctl.2:316 build/C/man2/epoll_wait.2:246
#: build/C/man2/poll.2:402
#, no-wrap
msgid "COLOPHON"
msgstr "この文書について"

#. type: Plain text
#: build/C/man7/epoll.7:590 build/C/man2/epoll_create.2:157
#: build/C/man2/epoll_ctl.2:324 build/C/man2/epoll_wait.2:254
#: build/C/man2/poll.2:410
msgid "This page is part of release 3.78 of the Linux I<man-pages> 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 ""
"この man ページは Linux I<man-pages> プロジェクトのリリース 3.78 の一部\n"
"である。プロジェクトの説明とバグ報告に関する情報は\n"
"http://www.kernel.org/doc/man-pages/ に書かれている。"

#. type: TH
#: build/C/man2/epoll_create.2:24
#, no-wrap
msgid "EPOLL_CREATE"
msgstr "EPOLL_CREATE"

#. type: TH
#: build/C/man2/epoll_create.2:24
#, no-wrap
msgid "2012-04-15"
msgstr "2012-04-15"

#. type: Plain text
#: build/C/man2/epoll_create.2:27
msgid "epoll_create, epoll_create1 - open an epoll file descriptor"
msgstr "epoll_create, epoll_create1 - epoll ファイルディスクリプターをオープンする"

#. type: Plain text
#: build/C/man2/epoll_create.2:30 build/C/man2/epoll_wait.2:28
#, no-wrap
msgid "B<#include E<lt>sys/epoll.hE<gt>>\n"
msgstr "B<#include E<lt>sys/epoll.hE<gt>>\n"

#. type: Plain text
#: build/C/man2/epoll_create.2:33
#, no-wrap
msgid ""
"B<int epoll_create(int >I<size>B<);>\n"
"B<int epoll_create1(int >I<flags>B<);>\n"
msgstr ""
"B<int epoll_create(int >I<size>B<);>\n"
"B<int epoll_create1(int >I<flags>B<);>\n"

#. type: Plain text
#: build/C/man2/epoll_create.2:42
msgid "B<epoll_create>()  creates an B<epoll>(7)  instance.  Since Linux 2.6.8, the I<size> argument is ignored, but must be greater than zero; see NOTES below."
msgstr ""
"B<epoll_create>()は B<epoll>(7) インスタンスを作成する。\n"
"Linux 2.6.8 以降では、I<size> 引き数は無視されるが、 0 より大きな値で\n"
"なければならない。下記の「注意」を参照。"

#. type: Plain text
#: build/C/man2/epoll_create.2:55
msgid "B<epoll_create>()  returns a file descriptor referring to the new epoll instance.  This file descriptor is used for all the subsequent calls to the B<epoll> interface.  When no longer required, the file descriptor returned by B<epoll_create>()  should be closed by using B<close>(2).  When all file descriptors referring to an epoll instance have been closed, the kernel destroys the instance and releases the associated resources for reuse."
msgstr "B<epoll_create>()  は、新しい epoll インスタンスを参照するファイルディスクリプターを返す。 このファイルディスクリプターは、その後の B<epoll> インターフェースの呼び出しに使われる。 もう必要でなくなった場合は、 B<epoll_create>()  で返されたファイルディスクリプターは B<close>(2)  を使ってクローズされるべきである。 ある epoll インスタンスを参照する全てのファイルディスクリプターがクローズされると、 カーネルはそのインスタンスを破壊して、対応するリソースを解放し、 再使用できるようにする。"

#. type: SS
#: build/C/man2/epoll_create.2:55
#, no-wrap
msgid "epoll_create1()"
msgstr "epoll_create1()"

#. type: Plain text
#: build/C/man2/epoll_create.2:67
msgid "If I<flags> is 0, then, other than the fact that the obsolete I<size> argument is dropped, B<epoll_create1>()  is the same as B<epoll_create>().  The following value can be included in I<flags> to obtain different behavior:"
msgstr "B<epoll_create1>()  は、 I<flags> が 0 の場合、現在では使われていない I<size> 引き数がなくなっている点を除けば B<epoll_create>()  と同じである。 I<flags> に以下の値をビット毎の論理和 (OR) で指定することで、 異なる動作をさせることができる。"

#. type: TP
#: build/C/man2/epoll_create.2:67
#, no-wrap
msgid "B<EPOLL_CLOEXEC>"
msgstr "B<EPOLL_CLOEXEC>"

#. type: Plain text
#: build/C/man2/epoll_create.2:77
msgid "Set the close-on-exec (B<FD_CLOEXEC>)  flag on the new file descriptor.  See the description of the B<O_CLOEXEC> flag in B<open>(2)  for reasons why this may be useful."
msgstr "新しいファイルディスクリプターに対して close-on-exec (B<FD_CLOEXEC>)  フラグをセットする。 このフラグが役に立つ理由については、 B<open>(2)  の B<O_CLOEXEC> フラグの説明を参照のこと。"

#. type: SH
#: build/C/man2/epoll_create.2:77 build/C/man2/epoll_ctl.2:185
#: build/C/man2/epoll_wait.2:150 build/C/man2/poll.2:301
#, no-wrap
msgid "RETURN VALUE"
msgstr "返り値"

#. type: Plain text
#: build/C/man2/epoll_create.2:84
msgid "On success, these system calls return a nonnegative file descriptor.  On error, -1 is returned, and I<errno> is set to indicate the error."
msgstr "成功すると、これらのシステムコールは 非負のファイルディスクリプターを返す。 エラーの場合、-1 を返し、 I<errno> にエラーを示す値を設定する。"

#. type: SH
#: build/C/man2/epoll_create.2:84 build/C/man2/epoll_ctl.2:194
#: build/C/man2/epoll_wait.2:162 build/C/man2/poll.2:311
#, no-wrap
msgid "ERRORS"
msgstr "エラー"

#. type: TP
#: build/C/man2/epoll_create.2:85 build/C/man2/epoll_create.2:89
#: build/C/man2/epoll_ctl.2:209 build/C/man2/epoll_wait.2:179
#: build/C/man2/poll.2:320
#, no-wrap
msgid "B<EINVAL>"
msgstr "B<EINVAL>"

#. type: Plain text
#: build/C/man2/epoll_create.2:89
msgid "I<size> is not positive."
msgstr "I<size> が正でない。"

#. type: Plain text
#: build/C/man2/epoll_create.2:94
msgid "(B<epoll_create1>())  Invalid value specified in I<flags>."
msgstr "(B<epoll_create1>())  I<flags> に無効な値が指定された。"

#. type: TP
#: build/C/man2/epoll_create.2:94
#, no-wrap
msgid "B<EMFILE>"
msgstr "B<EMFILE>"

#. type: Plain text
#: build/C/man2/epoll_create.2:102
msgid "The per-user limit on the number of epoll instances imposed by I</proc/sys/fs/epoll/max_user_instances> was encountered.  See B<epoll>(7)  for further details."
msgstr "I</proc/sys/fs/epoll/max_user_instances> によって指定されている、epoll インスタンスのユーザー単位の制限に達した。 更なる詳細については B<epoll>(7)  を参照のこと。"

#. type: TP
#: build/C/man2/epoll_create.2:102
#, no-wrap
msgid "B<ENFILE>"
msgstr "B<ENFILE>"

#. type: Plain text
#: build/C/man2/epoll_create.2:105
msgid "The system limit on the total number of open files has been reached."
msgstr "オープンされたファイルの総数がシステム制限に達した。"

#. type: TP
#: build/C/man2/epoll_create.2:105 build/C/man2/epoll_ctl.2:232
#: build/C/man2/poll.2:327
#, no-wrap
msgid "B<ENOMEM>"
msgstr "B<ENOMEM>"

#. type: Plain text
#: build/C/man2/epoll_create.2:108
msgid "There was insufficient memory to create the kernel object."
msgstr "カーネルオブジェクトを作成するのに十分なメモリーがなかった。"

#. type: Plain text
#: build/C/man2/epoll_create.2:112
msgid "B<epoll_create>()  was added to the kernel in version 2.6.  Library support is provided in glibc starting with version 2.3.2."
msgstr ""
"B<epoll_create>() はカーネル 2.6 で追加された。\n"
"ライブラリによるサポートは glibc バージョン 2.3.2 以降で提供されている。"

#.  To be precise: kernel 2.5.44.
#.  The interface should be finalized by Linux kernel 2.5.66.
#. type: Plain text
#: build/C/man2/epoll_create.2:118
msgid "B<epoll_create1>()  was added to the kernel in version 2.6.27.  Library support is provided in glibc starting with version 2.9."
msgstr ""
"B<epoll_create1>() はカーネル 2.6.27 で追加された。\n"
"ライブラリによるサポートは glibc バージョン 2.9 以降で提供されている。"

#. type: Plain text
#: build/C/man2/epoll_create.2:121
msgid "B<epoll_create>()  is Linux-specific."
msgstr "B<epoll_create>() は Linux 独自である。"

#. type: SH
#: build/C/man2/epoll_create.2:121 build/C/man2/epoll_ctl.2:265
#: build/C/man2/epoll_wait.2:200 build/C/man2/poll.2:353
#, no-wrap
msgid "NOTES"
msgstr "注意"

#. type: Plain text
#: build/C/man2/epoll_create.2:144
msgid "In the initial B<epoll_create>()  implementation, the I<size> argument informed the kernel of the number of file descriptors that the caller expected to add to the B<epoll> instance.  The kernel used this information as a hint for the amount of space to initially allocate in internal data structures describing events.  (If necessary, the kernel would allocate more space if the caller's usage exceeded the hint given in I<size>.)  Nowadays, this hint is no longer required (the kernel dynamically sizes the required data structures without needing the hint), but I<size> must still be greater than zero, in order to ensure backward compatibility when new B<epoll> applications are run on older kernels."
msgstr ""
"初期の B<epoll_create>() の実装では、I<size> 引き数は、呼び出し元が B<epoll>\n"
"インスタンスに追加しようとするファイルディスクリプター数をカーネルに教えるのに\n"
"使われていた。カーネルはこの情報をイベントの情報を格納する内部データ構造に最\n"
"初に割り当てる大きさを決める際のヒントとして使用していた (I<size> で渡された\n"
"ヒントよりも使用量が大きくなった場合には、必要に応じてカーネルは追加で領域を\n"
"割り当てる)。\n"
"\n"
"現在では、このヒントはもはや必要なくなっている (カーネルはヒントなしで必要な\n"
"データ構造のサイズを動的に変更する) が、今も I<size> には 0 より大きい値を\n"
"指定しなければならない。これは、B<epoll> を使うアプリケーションが古いカーネル\n"
"で実行される際の後方互換性を保証するためである。"

#. type: Plain text
#: build/C/man2/epoll_create.2:149
msgid "B<close>(2), B<epoll_ctl>(2), B<epoll_wait>(2), B<epoll>(7)"
msgstr "B<close>(2), B<epoll_ctl>(2), B<epoll_wait>(2), B<epoll>(7)"

#. type: TH
#: build/C/man2/epoll_ctl.2:20
#, no-wrap
msgid "EPOLL_CTL"
msgstr "EPOLL_CTL"

#. type: TH
#: build/C/man2/epoll_ctl.2:20
#, no-wrap
msgid "2014-12-31"
msgstr "2014-12-31"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:23
msgid "epoll_ctl - control interface for an epoll descriptor"
msgstr "epoll_ctl - epoll ディスクリプターのインターフェースを操作する"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:28
msgid "B<int epoll_ctl(int >I<epfd>B<, int >I<op>B<, int >I<fd>B<, struct epoll_event *>I<event>B<);>"
msgstr "B<int epoll_ctl(int >I<epfd>B<, int >I<op>B<, int >I<fd>B<, struct epoll_event *>I<event>B<);>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:38
msgid "This system call performs control operations on the B<epoll>(7)  instance referred to by the file descriptor I<epfd>.  It requests that the operation I<op> be performed for the target file descriptor, I<fd>."
msgstr ""
"このシステムコールは、ファイルディスクリプター I<epfd> が参照する B<epoll>(7)\n"
"インスタンスに対する操作を行う。 対象のファイルディスクリプター I<fd> に対して、\n"
"操作 I<op> の実行が要求される。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:42
msgid "Valid values for the I<op> argument are:"
msgstr "I<op> 引き数に指定できる有効な値は以下の通りである。"

#. type: TP
#: build/C/man2/epoll_ctl.2:42
#, no-wrap
msgid "B<EPOLL_CTL_ADD>"
msgstr "B<EPOLL_CTL_ADD>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:54
msgid "Register the target file descriptor I<fd> on the B<epoll> instance referred to by the file descriptor I<epfd> and associate the event I<event> with the internal file linked to I<fd>."
msgstr "対象のファイルディスクリプター I<fd> をファイルディスクリプター I<epfd> が参照する B<epoll> インスタンスに登録し、イベント I<event> を I<fd> に結び付けられた内部ファイルに関連付ける。"

#. type: TP
#: build/C/man2/epoll_ctl.2:54
#, no-wrap
msgid "B<EPOLL_CTL_MOD>"
msgstr "B<EPOLL_CTL_MOD>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:60
msgid "Change the event I<event> associated with the target file descriptor I<fd>."
msgstr "イベント I<event> を対象のファイルディスクリプター I<fd> に関連付けるように変更する。"

#. type: TP
#: build/C/man2/epoll_ctl.2:60
#, no-wrap
msgid "B<EPOLL_CTL_DEL>"
msgstr "B<EPOLL_CTL_DEL>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:71
msgid "Remove (deregister) the target file descriptor I<fd> from the B<epoll> instance referred to by I<epfd>.  The I<event> is ignored and can be NULL (but see BUGS below)."
msgstr "対象のファイルディスクリプター I<fd> を I<epfd> が参照する B<epoll> インスタンスから削除する。 I<event> 引き数は無視されるので、NULL にすることもできる (但し、下記の「バグ」を参照)。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:79
msgid "The I<event> argument describes the object linked to the file descriptor I<fd>.  The I<struct epoll_event> is defined as:"
msgstr "I<event> 引き数は、ファイルディスクリプター I<fd> にリンクされたオブジェクトを表す。 I<struct epoll_event> は以下のように定義される。"

#. type: Plain text
#: build/C/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 ""
"typedef union epoll_data {\n"
"    void        *ptr;\n"
"    int          fd;\n"
"    uint32_t     u32;\n"
"    uint64_t     u64;\n"
"} epoll_data_t;\n"

#. type: Plain text
#: build/C/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 ""
"struct epoll_event {\n"
"    uint32_t     events;      /* epoll イベント */\n"
"    epoll_data_t data;        /* ユーザーデータ変数 */\n"
"};\n"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:100
msgid "The I<events> member is a bit set composed using the following available event types:"
msgstr "I<events> メンバは、以下のような使用可能なイベントタイプを使って構成された ビットセットである。"

#. type: TP
#: build/C/man2/epoll_ctl.2:100
#, no-wrap
msgid "B<EPOLLIN>"
msgstr "B<EPOLLIN>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:105
msgid "The associated file is available for B<read>(2)  operations."
msgstr "関連付けられたファイルに対して、 B<read>(2)  操作が可能である。"

#. type: TP
#: build/C/man2/epoll_ctl.2:105
#, no-wrap
msgid "B<EPOLLOUT>"
msgstr "B<EPOLLOUT>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:110
msgid "The associated file is available for B<write>(2)  operations."
msgstr "関連付けられたファイルに対して、 B<write>(2)  操作が可能である。"

#. type: TP
#: build/C/man2/epoll_ctl.2:110
#, no-wrap
msgid "B<EPOLLRDHUP> (since Linux 2.6.17)"
msgstr "B<EPOLLRDHUP\">(LinuxB<2.6.17>以降)\""

#. type: Plain text
#: build/C/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 "ストリームソケットの他端が、コネクションの close 、 またはコネクションの書き込み側の shutdown を行った。 (このフラグを使うと、エッジトリガーの監視を行う場合に、 通信のもう一端が閉じられたことを検知するコードを 非常に簡潔に書くことができる。)"

#. type: TP
#: build/C/man2/epoll_ctl.2:116
#, no-wrap
msgid "B<EPOLLPRI>"
msgstr "B<EPOLLPRI>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:121
msgid "There is urgent data available for B<read>(2)  operations."
msgstr "B<read>(2)  操作が可能な緊急 (urgent) データがある。"

#. type: TP
#: build/C/man2/epoll_ctl.2:121
#, no-wrap
msgid "B<EPOLLERR>"
msgstr "B<EPOLLERR>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:127
msgid "Error condition happened on the associated file descriptor.  B<epoll_wait>(2)  will always wait for this event; it is not necessary to set it in I<events>."
msgstr "関連付けられたファイルディスクリプターにエラー条件が起こった。 B<epoll_wait>(2)  は常にこのイベントを待つので、 I<events> に設定する必要はない。"

#. type: TP
#: build/C/man2/epoll_ctl.2:127
#, no-wrap
msgid "B<EPOLLHUP>"
msgstr "B<EPOLLHUP>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:133
msgid "Hang up happened on the associated file descriptor.  B<epoll_wait>(2)  will always wait for this event; it is not necessary to set it in I<events>."
msgstr "関連付けられたファイルディスクリプターにハングアップが起こった。 B<epoll_wait>(2)  は常にこのイベントを待つので、 I<events> に設定する必要はない。"

#. type: TP
#: build/C/man2/epoll_ctl.2:133
#, no-wrap
msgid "B<EPOLLET>"
msgstr "B<EPOLLET>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:143
msgid "Sets the Edge Triggered behavior for the associated file descriptor.  The default behavior for B<epoll> is Level Triggered.  See B<epoll>(7)  for more detailed information about Edge and Level Triggered event distribution architectures."
msgstr "関連付けられたファイルディスクリプターに エッジトリガー動作 (Edge Triggered behavior) を設定する。 B<epoll> のデフォルトの動作は、レベルトリガー (Level Triggered) である。 エッジトリガーとレベルトリガーによるイベント分配機構 (event distribution architectures) についての詳細な情報は、 B<epoll>(7)  を参照すること。"

#. type: TP
#: build/C/man2/epoll_ctl.2:143
#, no-wrap
msgid "B<EPOLLONESHOT> (since Linux 2.6.2)"
msgstr "B<EPOLLONESHOT> (Linux 2.6.2 以降)"

#. type: Plain text
#: build/C/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<epoll_wait>(2)  the associated file descriptor is internally disabled and no other events will be reported by the B<epoll> interface.  The user must call B<epoll_ctl>()  with B<EPOLL_CTL_MOD> to rearm the file descriptor with a new event mask."
msgstr "関連付けられたファイルディスクリプターに 一撃動作 (One-Shot behavior) を設定する。 これはイベントが B<epoll_wait>(2)  によって引き出された後、 関連付けられたファイルディスクリプターが内部的に破棄され、 B<epoll> インターフェースによってイベントが報告されなくなることを意味する。 新しいイベントマスクでファイルディスクリプターを再度有効にするためには、 B<epoll_ctl>()  に B<EPOLL_CTL_MOD> を指定して呼び出さなければならない。 I<op> 引き数に指定できる有効な値は、以下の通り:"

#. type: TP
#: build/C/man2/epoll_ctl.2:157
#, no-wrap
msgid "B<EPOLLWAKEUP> (since Linux 3.5)"
msgstr "B<EPOLLWAKEUP> (Linux 3.5 以降)"

#.  commit 4d7e30d98939a0340022ccd49325a3d70f7e0238
#. type: Plain text
#: build/C/man2/epoll_ctl.2:185
msgid "If B<EPOLLONESHOT> and B<EPOLLET> are clear and the process has the B<CAP_BLOCK_SUSPEND> 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<epoll_wait>(2)  until the next call to B<epoll_wait>(2)  on the same B<epoll>(7)  file descriptor, the closure of that file descriptor, the removal of the event file descriptor with B<EPOLL_CTL_DEL>, or the clearing of B<EPOLLWAKEUP> for the event file descriptor with B<EPOLL_CTL_MOD>.  See also BUGS."
msgstr "B<EPOLLONESHOT> と B<EPOLLET> がクリアされており、 プロセスが B<CAP_BLOCK_SUSPEND> ケーパビリティを持っている場合、 イベントが処理待ちか処理中かにかかわらず、必ずシステムが \"suspend\" や \"hibernate\" に入らないようにすること。 B<epoll_wait>(2) の呼び出しが返った時点から、 同じ B<epoll>(7) ファイルディスクリプターに対して B<epoll_wait>(2) が次に呼び出されるか、 そのファイルディスクリプターが閉じられるか、 イベントファイルディスクリプターが B<EPOLL_CTL_DEL> で削除されるか、 B<EPOLL_CTL_MOD> でイベントファイルディスクリプターの B<EPOLLWAKEUP> がクリアされるか、 のいずれかになるまで、イベントは「処理中」であるとみなされる。 「バグ」の節も参照のこと。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:194
msgid "When successful, B<epoll_ctl>()  returns zero.  When an error occurs, B<epoll_ctl>()  returns -1 and I<errno> is set appropriately."
msgstr "成功した場合、 B<epoll_ctl>()  は 0 を返す。 エラーが起こった場合、 B<epoll_ctl>()  は -1 を返し、 I<errno> を適切に設定する。"

#. type: TP
#: build/C/man2/epoll_ctl.2:195 build/C/man2/epoll_wait.2:163
#, no-wrap
msgid "B<EBADF>"
msgstr "B<EBADF>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:201
msgid "I<epfd> or I<fd> is not a valid file descriptor."
msgstr "I<epfd> か I<fd> が有効なファイルディスクリプターでない。"

#. type: TP
#: build/C/man2/epoll_ctl.2:201
#, no-wrap
msgid "B<EEXIST>"
msgstr "B<EEXIST>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:209
msgid "I<op> was B<EPOLL_CTL_ADD>, and the supplied file descriptor I<fd> is already registered with this epoll instance."
msgstr "I<op> が B<EPOLL_CTL_ADD> であり、かつ与えられたファイルディスクリプター I<fd> がこの epoll インスタンスに既に登録されている。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:222
msgid "I<epfd> is not an B<epoll> file descriptor, or I<fd> is the same as I<epfd>, or the requested operation I<op> is not supported by this interface."
msgstr "I<epfd> が B<epoll> ファイルディスクリプターでない。 または I<fd> が I<epfd> と同一である。 または要求された操作 I<op> がこのインターフェースでサポートされていない。"

#. type: TP
#: build/C/man2/epoll_ctl.2:222
#, no-wrap
msgid "B<ENOENT>"
msgstr "B<ENOENT>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:232
msgid "I<op> was B<EPOLL_CTL_MOD> or B<EPOLL_CTL_DEL>, and I<fd> is not registered with this epoll instance."
msgstr "I<op> が B<EPOLL_CTL_MOD> または B<EPOLL_CTL_DEL> で、かつ I<fd> がこの epoll インスタンスに登録されていない。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:237
msgid "There was insufficient memory to handle the requested I<op> control operation."
msgstr "要求された I<op> 制御操作を扱うのに十分なメモリーがない。"

#. type: TP
#: build/C/man2/epoll_ctl.2:237
#, no-wrap
msgid "B<ENOSPC>"
msgstr "B<ENOSPC>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:247
msgid "The limit imposed by I</proc/sys/fs/epoll/max_user_watches> was encountered while trying to register (B<EPOLL_CTL_ADD>)  a new file descriptor on an epoll instance.  See B<epoll>(7)  for further details."
msgstr "epoll インスタンスに新しいファイルディスクリプターを登録 (B<EPOLL_CTL_ADD>)  しようとした際に、 I</proc/sys/fs/epoll/max_user_watches> で決まる上限に達した。 詳細は B<epoll>(7)  を参照。"

#. type: TP
#: build/C/man2/epoll_ctl.2:247
#, no-wrap
msgid "B<EPERM>"
msgstr "B<EPERM>"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:256
msgid "The target file I<fd> does not support B<epoll>.  This error can occur if I<fd> refers to, for example, a regular file or a directory."
msgstr "対象ファイル I<fd> が B<epoll> に対応していない。 このエラーは I<fd> が例えば通常ファイルやディレクトリを参照している場合にも起こり得る。"

#.  To be precise: kernel 2.5.44.
#.  The interface should be finalized by Linux kernel 2.5.66.
#. type: Plain text
#: build/C/man2/epoll_ctl.2:261
msgid "B<epoll_ctl>()  was added to the kernel in version 2.6."
msgstr "B<epoll_ctl>()  はカーネル 2.6 で追加された。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:265
msgid "B<epoll_ctl>()  is Linux-specific.  Library support is provided in glibc starting with version 2.3.2."
msgstr ""
"B<epoll_ctl>()  は Linux 独自である。\n"
"ライブラリによるサポートは glibc バージョン 2.3.2 以降で提供されている。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:270
msgid "The B<epoll> interface supports all file descriptors that support B<poll>(2)."
msgstr "B<epoll> インターフェースは、 B<poll>(2)  に対応している全てのファイルディスクリプターに対応している。"

#. type: SH
#: build/C/man2/epoll_ctl.2:270 build/C/man2/epoll_wait.2:217
#: build/C/man2/poll.2:393
#, no-wrap
msgid "BUGS"
msgstr "バグ"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:284
msgid "In kernel versions before 2.6.9, the B<EPOLL_CTL_DEL> operation required a non-null pointer in I<event>, even though this argument is ignored.  Since Linux 2.6.9, I<event> can be specified as NULL when using B<EPOLL_CTL_DEL>.  Applications that need to be portable to kernels before 2.6.9 should specify a non-null pointer in I<event>."
msgstr "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 でないポインターを指定すべきである。"

#.  commit a8159414d7e3af7233e7a5a82d1c5d85379bd75c (behavior change)
#.  https://lwn.net/Articles/520198/
#. type: Plain text
#: build/C/man2/epoll_ctl.2:311
msgid "If B<EPOLLWAKEUP> is specified in I<flags>, but the caller does not have the B<CAP_BLOCK_SUSPEND> capability, then the B<EPOLLWAKEUP> flag is I<silently ignored>.  This unfortunate behavior is necessary because no validity checks were performed on the I<flags> argument in the original implementation, and the addition of the B<EPOLLWAKEUP> with a check that caused the call to fail if the caller did not have the B<CAP_BLOCK_SUSPEND> 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<CAP_BLOCK_SUSPEND> capability if attempting to use the B<EPOLLWAKEUP> flag."
msgstr "I<flags> に B<EPOLLWAKEUP> が指定されたが、呼び出し元が B<CAP_BLOCK_SUSPEND> ケーパビリティを持っていない場合、 B<EPOLLWAKEUP> フラグは I<黙って無視される>。 元の実装では I<flags> 引き数に対する正当性チェックが実行されていないため、 この残念な動作は必要である。 また、 呼び出し元が B<CAP_BLOCK_SUSPEND> ケーパビリティを持っていなかった場合に呼び出しを失敗させるようにチェックを B<EPOLLWAKEUP> に追加すると、 少なくともひとつは動かなくなる既存のユーザー空間アプリケーションがあった。 そのアプリケーションはたまたま (しかも意味もなく) このビットを指定していた。 したがって、信頼性が求められるアプリケーションでは、 B<EPOLLWAKEUP> フラグを使おうする場合には B<CAP_BLOCK_SUSPEND> ケーパビリティを持っているかも確認するようにすべきである。"

#. type: Plain text
#: build/C/man2/epoll_ctl.2:316
msgid "B<epoll_create>(2), B<epoll_wait>(2), B<poll>(2), B<epoll>(7)"
msgstr "B<epoll_create>(2), B<epoll_wait>(2), B<poll>(2), B<epoll>(7)"

#. type: TH
#: build/C/man2/epoll_wait.2:22
#, no-wrap
msgid "EPOLL_WAIT"
msgstr "EPOLL_WAIT"

#. type: TH
#: build/C/man2/epoll_wait.2:22
#, no-wrap
msgid "2014-08-19"
msgstr "2014-08-19"

#. type: Plain text
#: build/C/man2/epoll_wait.2:25
msgid "epoll_wait, epoll_pwait - wait for an I/O event on an epoll file descriptor"
msgstr "epoll_wait, epoll_pwait - epoll ファイルディスクリプターの I/O イベントを待つ"

#. type: Plain text
#: build/C/man2/epoll_wait.2:34
#, no-wrap
msgid ""
"B<int epoll_wait(int >I<epfd>B<, struct epoll_event *>I<events>B<,>\n"
"B<               int >I<maxevents>B<, int >I<timeout>B<);>\n"
"B<int epoll_pwait(int >I<epfd>B<, struct epoll_event *>I<events>B<,>\n"
"B<               int >I<maxevents>B<, int >I<timeout>B<,>\n"
"B<               const sigset_t *>I<sigmask>B<);>\n"
msgstr ""
"B<int epoll_wait(int >I<epfd>B<, struct epoll_event *>I<events>B<,>\n"
"B<               int >I<maxevents>B<, int >I<timeout>B<);>\n"
"B<int epoll_pwait(int >I<epfd>B<, struct epoll_event *>I<events>B<,>\n"
"B<               int >I<maxevents>B<, int >I<timeout>B<,>\n"
"B<               const sigset_t *>I<sigmask>B<);>\n"

#. type: Plain text
#: build/C/man2/epoll_wait.2:52
msgid "The B<epoll_wait>()  system call waits for events on the B<epoll>(7)  instance referred to by the file descriptor I<epfd>.  The memory area pointed to by I<events> will contain the events that will be available for the caller.  Up to I<maxevents> are returned by B<epoll_wait>().  The I<maxevents> argument must be greater than zero."
msgstr ""
"B<epoll_wait>() システムコールは、ファイルディスクリプター I<epfd> で参照される\n"
"B<epoll>(7) インスタンスに対するイベントを待つ。 I<events> が指すメモリー領域には、\n"
"呼び出し側が利用可能なイベントが格納される。最大 I<maxevents> 個のイベントが\n"
"B<epoll_wait>() によって返される。\n"
"I<maxevents> 引き数は 0 より大きくなければならない。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:59
msgid "The I<timeout> argument specifies the number of milliseconds that B<epoll_wait>()  will block.  The call will block until either:"
msgstr "I<timeout> 引き数は B<epoll_wait>() が停止する時間をミリ秒で指定する。 B<epoll_wait>() の呼び出しは以下のいずれかになるまで停止する。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:61
msgid "a file descriptor delivers an event;"
msgstr "ファイルディスクリプターがイベントを配送した"

#. type: Plain text
#: build/C/man2/epoll_wait.2:63 build/C/man2/poll.2:138
msgid "the call is interrupted by a signal handler; or"
msgstr "呼び出しがシグナルハンドラーにより割り込まれた"

#. type: Plain text
#: build/C/man2/epoll_wait.2:65 build/C/man2/poll.2:140
msgid "the timeout expires."
msgstr "タイムアウトが満了する"

#. type: Plain text
#: build/C/man2/epoll_wait.2:80
msgid "Note that the I<timeout> interval will be rounded up to the system clock granularity, and kernel scheduling delays mean that the blocking interval may overrun by a small amount.  Specifying a I<timeout> of -1 causes B<epoll_wait>()  to block indefinitely, while specifying a I<timeout> equal to zero cause B<epoll_wait>()  to return immediately, even if no events are available."
msgstr "I<timeout> 時間はシステムクロックの粒度に切り上げられ、カーネルのスケジューリング遅延により少しだけ長くなる可能性がある点に注意すること。 I<timeout> を -1 に指定すると、 B<epoll_wait>() は無限に停止する。 I<timeout> を 0 に指定すると、 B<epoll_wait>() は利用可能なイベントがなくても、すぐに返る。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:84
msgid "The I<struct epoll_event> is defined as:"
msgstr "I<struct epoll_event> は以下のように定義される。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:93
#, 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 ""
"typedef union epoll_data {\n"
"    void    *ptr;\n"
"    int      fd;\n"
"    uint32_t u32;\n"
"    uint64_t u64;\n"
"} epoll_data_t;\n"

#. type: Plain text
#: build/C/man2/epoll_wait.2:98
#, no-wrap
msgid ""
"struct epoll_event {\n"
"    uint32_t     events;    /* Epoll events */\n"
"    epoll_data_t data;      /* User data variable */\n"
"};\n"
msgstr ""
"struct epoll_event {\n"
"    uint32_t     events;    /* epoll イベント */\n"
"    epoll_data_t data;      /* ユーザーデータ変数 */\n"
"};\n"

#. type: Plain text
#: build/C/man2/epoll_wait.2:109
msgid "The I<data> of each returned structure will contain the same data the user set with an B<epoll_ctl>(2)  (B<EPOLL_CTL_ADD>, B<EPOLL_CTL_MOD>)  while the I<events> member will contain the returned event bit field."
msgstr "返される構造体の I<data> メンバには、ユーザーが B<epoll_ctl>(2)  (B<EPOLL_CTL_ADD>, B<EPOLL_CTL_MOD>)  で指定したデータが格納される。 一方、 I<events> メンバには返された利用可能なイベントのビットフィールドが格納される。"

#. type: SS
#: build/C/man2/epoll_wait.2:109
#, no-wrap
msgid "epoll_pwait()"
msgstr "epoll_pwait()"

#. type: Plain text
#: build/C/man2/epoll_wait.2:123
msgid "The relationship between B<epoll_wait>()  and B<epoll_pwait>()  is analogous to the relationship between B<select>(2)  and B<pselect>(2): like B<pselect>(2), B<epoll_pwait>()  allows an application to safely wait until either a file descriptor becomes ready or until a signal is caught."
msgstr "B<epoll_wait>()  と B<epoll_pwait>()  の関係は、 B<select>(2)  と B<pselect>(2)  の関係と同様である。 B<pselect>(2)  同様、 B<epoll_pwait>()  を使うと、アプリケーションは、ファイルディスクリプターが準備できた状態になるか、 シグナルが捕捉されるまで、安全に待つことができる。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:127
msgid "The following B<epoll_pwait>()  call:"
msgstr "以下の B<epoll_pwait>()  の呼び出しは、"

#. type: Plain text
#: build/C/man2/epoll_wait.2:130
#, no-wrap
msgid "    ready = epoll_pwait(epfd, &events, maxevents, timeout, &sigmask);\n"
msgstr "    ready = epoll_pwait(epfd, &events, maxevents, timeout, &sigmask);\n"

#. type: Plain text
#: build/C/man2/epoll_wait.2:135 build/C/man2/poll.2:250
msgid "is equivalent to I<atomically> executing the following calls:"
msgstr "次の呼び出しを I<atomic> に実行するのと等価である。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:138
#, no-wrap
msgid "    sigset_t origmask;\n"
msgstr "    sigset_t origmask;\n"

#. type: Plain text
#: build/C/man2/epoll_wait.2:142
#, no-wrap
msgid ""
"    sigprocmask(SIG_SETMASK, &sigmask, &origmask);\n"
"    ready = epoll_wait(epfd, &events, maxevents, timeout);\n"
"    sigprocmask(SIG_SETMASK, &origmask, NULL);\n"
msgstr ""
"    sigprocmask(SIG_SETMASK, &sigmask, &origmask);\n"
"    ready = epoll_wait(epfd, &events, maxevents, timeout);\n"
"    sigprocmask(SIG_SETMASK, &origmask, NULL);\n"

#. type: Plain text
#: build/C/man2/epoll_wait.2:150
msgid "The I<sigmask> argument may be specified as NULL, in which case B<epoll_pwait>()  is equivalent to B<epoll_wait>()."
msgstr "I<sigmask> 引き数には NULL を指定してもよい。 その場合には、 B<epoll_pwait>()  は B<epoll_wait>()  と等価となる。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:162
msgid "When successful, B<epoll_wait>()  returns the number of file descriptors ready for the requested I/O, or zero if no file descriptor became ready during the requested I<timeout> milliseconds.  When an error occurs, B<epoll_wait>()  returns -1 and I<errno> is set appropriately."
msgstr "成功した場合、 B<epoll_wait>()  は要求された I/O に対して準備ができているファイルディスクリプターの数を返す。 また要求された I<timeout> ミリ秒の間にファイルディスクリプターが準備できない場合は、0 を返す。 エラーが起こった場合、 B<epoll_wait>()  は -1 を返し、 I<errno> を適切に設定する。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:167
msgid "I<epfd> is not a valid file descriptor."
msgstr "I<epfd> が有効なファイルディスクリプターでない。"

#. type: TP
#: build/C/man2/epoll_wait.2:167 build/C/man2/poll.2:312
#, no-wrap
msgid "B<EFAULT>"
msgstr "B<EFAULT>"

#. type: Plain text
#: build/C/man2/epoll_wait.2:172
msgid "The memory area pointed to by I<events> is not accessible with write permissions."
msgstr "I<events> で指されるメモリー領域に書き込み権限でアクセスできない。"

#. type: TP
#: build/C/man2/epoll_wait.2:172 build/C/man2/poll.2:316
#, no-wrap
msgid "B<EINTR>"
msgstr "B<EINTR>"

#. type: Plain text
#: build/C/man2/epoll_wait.2:179
msgid "The call was interrupted by a signal handler before either (1) any of the requested events occurred or (2) the I<timeout> expired; see B<signal>(7)."
msgstr "(1) 要求されたどのイベントも発生せず、かつ (2) I<timeout> の期限が切れる前に、システムコールがシグナルハンドラーによって割り込まれた。 B<signal>(7) 参照。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:187
msgid "I<epfd> is not an B<epoll> file descriptor, or I<maxevents> is less than or equal to zero."
msgstr "I<epfd> が B<epoll> ファイルディスクリプターでない。 または I<maxevents> が 0 以下である。"

#.  To be precise: kernel 2.5.44.
#.  The interface should be finalized by Linux kernel 2.5.66.
#. type: Plain text
#: build/C/man2/epoll_wait.2:193
msgid "B<epoll_wait>()  was added to the kernel in version 2.6.  Library support is provided in glibc starting with version 2.3.2."
msgstr ""
"B<epoll_wait>() はカーネル 2.6 で追加された。\n"
"ライブラリによるサポートは glibc バージョン 2.3.2 以降で提供されている。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:197
msgid "B<epoll_pwait>()  was added to Linux in kernel 2.6.19.  Library support is provided in glibc starting with version 2.6."
msgstr ""
"B<epoll_pwait>() はカーネル 2.6.19 で Linux に追加された。\n"
"ライブラリによるサポートは glibc バージョン 2.6 以降で提供されている。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:200
msgid "B<epoll_wait>()  is Linux-specific."
msgstr "B<epoll_wait>() は Linux 独自である。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:210
msgid "While one thread is blocked in a call to B<epoll_pwait>(), it is possible for another thread to add a file descriptor to the waited-upon B<epoll> instance.  If the new file descriptor becomes ready, it will cause the B<epoll_wait>()  call to unblock."
msgstr ""
"あるスレッドが B<epoll_pwait>() を呼び出して停止されている間に、\n"
"別のスレッドが wait 中の B<epoll> インストールにファイルディスクリプターを\n"
"追加することがある。新しいファイルディスクリプターでイベントが発生すると、\n"
"B<epoll_wait>() の呼び出しによる停止が解除されることになる。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:217
msgid "For a discussion of what may happen if a file descriptor in an B<epoll> instance being monitored by B<epoll_wait>()  is closed in another thread, see B<select>(2)."
msgstr "B<epoll_wait>() で監視中の B<epoll> インスタンス内のファイルディスクリプターが別のスレッドによってクローズされた場合に何が起こるかの議論については、 B<select>(2) を参照してほしい。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:229
msgid "In kernels before 2.6.37, a I<timeout> value larger than approximately I<LONG_MAX / HZ> milliseconds is treated as -1 (i.e., infinity).  Thus, for example, on a system where the I<sizeof(long)> is 4 and the kernel I<HZ> value is 1000, this means that timeouts greater than 35.79 minutes are treated as infinity."
msgstr "バージョン 2.6.37 より前のカーネルでは、おおよそ I<LONG_MAX / HZ> ミリ秒より大きい I<timeout> 値は -1 (つまり無限大) として扱われる。したがって、例えば、I<sizeof(long)> が 4 で、カーネルの I<HZ> の値が 1000 のシステムでは、 35.79 分よりも大きなタイムアウトは無限大として扱われるということである。"

#. type: SS
#: build/C/man2/epoll_wait.2:229 build/C/man2/poll.2:366
#, no-wrap
msgid "C library/kernel ABI differences"
msgstr "C ライブラリとカーネル ABI の違い"

#. type: Plain text
#: build/C/man2/epoll_wait.2:242
msgid "The raw B<epoll_pwait>()  system call has a sixth argument, I<size_t sigsetsize>, which specifies the size in bytes of the I<sigmask> argument.  The glibc B<epoll_pwait>()  wrapper function specifies this argument as a fixed value (equal to I<sizeof(sigset_t)>)."
msgstr "素の B<epoll_pwait>() システムコールは 6 番目の引き数 I<size_t sigsetsize> を取る。 この引き数は I<sigmask> 引き数のバイト単位のサイズを指定する。 glibc の B<epoll_pwait>() ラッパー関数は、この引き数に固定値 (I<sizeof(sigset_t)> と同じ) を指定する。"

#. type: Plain text
#: build/C/man2/epoll_wait.2:246
msgid "B<epoll_create>(2), B<epoll_ctl>(2), B<epoll>(7)"
msgstr "B<epoll_create>(2), B<epoll_ctl>(2), B<epoll>(7)"

#. type: TH
#: build/C/man2/poll.2:31
#, no-wrap
msgid "POLL"
msgstr "POLL"

#. type: TH
#: build/C/man2/poll.2:31
#, no-wrap
msgid "2014-09-06"
msgstr "2014-09-06"

#. type: Plain text
#: build/C/man2/poll.2:34
msgid "poll, ppoll - wait for some event on a file descriptor"
msgstr "poll, ppoll - ファイルディスクリプターにおけるイベントを待つ"

#. type: Plain text
#: build/C/man2/poll.2:37
#, no-wrap
msgid "B<#include E<lt>poll.hE<gt>>\n"
msgstr "B<#include E<lt>poll.hE<gt>>\n"

#. type: Plain text
#: build/C/man2/poll.2:39
#, no-wrap
msgid "B<int poll(struct pollfd *>I<fds>B<, nfds_t >I<nfds>B<, int >I<timeout>B<);>\n"
msgstr "B<int poll(struct pollfd *>I<fds>B<, nfds_t >I<nfds>B<, int >I<timeout>B<);>\n"

#. type: Plain text
#: build/C/man2/poll.2:43
#, no-wrap
msgid ""
"B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
"B<#include E<lt>signal.hE<gt>>\n"
"B<#include E<lt>poll.hE<gt>>\n"
msgstr ""
"B<#define _GNU_SOURCE>         /* feature_test_macros(7) 参照 */\n"
"B<#include E<lt>signal.hE<gt>>\n"
"B<#include E<lt>poll.hE<gt>>\n"

#. type: Plain text
#: build/C/man2/poll.2:46
#, no-wrap
msgid ""
"B<int ppoll(struct pollfd *>I<fds>B<, nfds_t >I<nfds>B<, >\n"
"B<        const struct timespec *>I<timeout_ts>B<, const sigset_t *>I<sigmask>B<);>\n"
msgstr ""
"B<int ppoll(struct pollfd *>I<fds>B<, nfds_t >I<nfds>B<, >\n"
"B<        const struct timespec *>I<timeout_ts>B<, const sigset_t *>I<sigmask>B<);>\n"

#. type: Plain text
#: build/C/man2/poll.2:53
msgid "B<poll>()  performs a similar task to B<select>(2): it waits for one of a set of file descriptors to become ready to perform I/O."
msgstr "B<poll>()  は B<select>(2)  と同様の仕事を行う、つまり、ファイルディスクリプター集合のいずれか一つが I/O を実行可能な状態になるのを待つ。"

#. type: Plain text
#: build/C/man2/poll.2:57
msgid "The set of file descriptors to be monitored is specified in the I<fds> argument, which is an array of structures of the following form:"
msgstr "監視するファイルディスクリプター集合は、 I<fds> 引き数で指定する。 I<fds> は、以下の型の構造体の配列である。"

#. type: Plain text
#: build/C/man2/poll.2:65
#, no-wrap
msgid ""
"struct pollfd {\n"
"    int   fd;         /* file descriptor */\n"
"    short events;     /* requested events */\n"
"    short revents;    /* returned events */\n"
"};\n"
msgstr ""
"struct pollfd {\n"
"    int   fd;         /* file descriptor */\n"
"    short events;     /* requested events */\n"
"    short revents;    /* returned events */\n"
"};\n"

#. type: Plain text
#: build/C/man2/poll.2:72
msgid "The caller should specify the number of items in the I<fds> array in I<nfds>."
msgstr "I<nfds> には、 I<fds> 配列の要素数を指定する。"

#. type: Plain text
#: build/C/man2/poll.2:88
msgid "The field I<fd> contains a file descriptor for an open file.  If this field is negative, then the corresponding I<events> field is ignored and the I<revents> field returns zero.  (This provides an easy way of ignoring a file descriptor for a single B<poll>()  call: simply negate the I<fd> field.  Note, however, that this technique can't be used to ignore file descriptor 0.)"
msgstr "I<fd> フィールドには、オープンされたファイルのファイルディスクリプターが入る。 このフィールドが負の場合、対応する I<events> フィールドは無視され、 I<revents> には 0 が返される。(この機能により、一つの B<poll>() の呼び出しで簡単にあるファイルディスクリプターを無視することができる。 単に I<fd> フィールドの符号を反転するだけでよい。 ただし、この方法はファイルディスクリプター 0 を無視するのには使用できない点に注意すること。)"

#. type: Plain text
#: build/C/man2/poll.2:103
msgid "The field I<events> is an input parameter, a bit mask specifying the events the application is interested in for the file descriptor I<fd>.  This field may be specified as zero, in which case the only events that can be returned in I<revents> are B<POLLHUP>, B<POLLERR>, and B<POLLNVAL> (see below)."
msgstr "構造体の I<events> 要素は入力パラメーターで、 ファイルディスクリプター I<fd> に関して、 アプリケーションが興味を持っているイベントのビットマスクを指定する。 このフィールドには 0 を指定することもでき、 その場合 I<revents> で返されるイベントは B<POLLHUP>, B<POLLERR>, B<POLLNVAL> だけである (下記参照)。"

#. type: Plain text
#: build/C/man2/poll.2:122
msgid "The field I<revents> is an output parameter, filled by the kernel with the events that actually occurred.  The bits returned in I<revents> can include any of those specified in I<events>, or one of the values B<POLLERR>, B<POLLHUP>, or B<POLLNVAL>.  (These three bits are meaningless in the I<events> field, and will be set in the I<revents> field whenever the corresponding condition is true.)"
msgstr "I<revents> 要素は出力パラメーターで、実際に起こったイベントがカーネルにより設定される。 I<revents> で返されるビット列には、 I<events> で指定したもののどれか、もしくは B<POLLERR>, B<POLLHUP>, B<POLLNVAL> のうちの一つが含まれる (B<POLLERR>, B<POLLHUP>, B<POLLNVAL> の 3つのビットは I<events> に指定しても意味がなく、対応した状態が真の場合に I<revents> に設定される)。"

#. type: Plain text
#: build/C/man2/poll.2:127
msgid "If none of the events requested (and no error) has occurred for any of the file descriptors, then B<poll>()  blocks until one of the events occurs."
msgstr "どのファイルディスクリプターにも要求したイベントが発生しておらず、 エラーも起こらない場合、 B<poll>()  はイベントのうちいずれか一つが発生するまで停止 (block) する。"

#. type: Plain text
#: build/C/man2/poll.2:134
msgid "The I<timeout> argument specifies the number of milliseconds that B<poll>()  should block waiting for a file descriptor to become ready.  The call will block until either:"
msgstr "I<timeout> 引き数は、 ファイルディスクリプターが利用可能になるまで B<poll>() が停止する時間をミリ秒で指定する。 B<poll>() の呼び出しは以下のいずれかになるまで停止する。"

#. type: Plain text
#: build/C/man2/poll.2:136
msgid "a file descriptor becomes ready;"
msgstr "ファイルディスクリプターが利用可能になる"

#. type: Plain text
#: build/C/man2/poll.2:154
msgid "Note that the I<timeout> interval will be rounded up to the system clock granularity, and kernel scheduling delays mean that the blocking interval may overrun by a small amount.  Specifying a negative value in I<timeout> means an infinite timeout.  Specifying a I<timeout> of zero causes B<poll>()  to return immediately, even if no file descriptors are ready."
msgstr "I<timeout> 時間はシステムクロックの粒度に切り上げられ、 カーネルのスケジューリング遅延により少しだけ長くなる可能性がある点に注意すること。 I<timeout> に負の値を指定した場合、タイムアウト時間が無限大を意味する。 I<timeout> を 0 に指定した場合、I/O 可能なファイルディスクリプターがない場合であっても、 B<poll>() はすぐに返る。"

#. type: Plain text
#: build/C/man2/poll.2:160
msgid "The bits that may be set/returned in I<events> and I<revents> are defined in I<E<lt>poll.hE<gt>>:"
msgstr "I<events> に指定したり、 I<revents> で返されるビットは I<E<lt>poll.hE<gt>> で定義されている:"

#. type: TP
#: build/C/man2/poll.2:161
#, no-wrap
msgid "B<POLLIN>"
msgstr "B<POLLIN>"

#. type: Plain text
#: build/C/man2/poll.2:164
msgid "There is data to read."
msgstr "読み出し可能なデータがある。"

#. type: TP
#: build/C/man2/poll.2:164
#, no-wrap
msgid "B<POLLPRI>"
msgstr "B<POLLPRI>"

#. type: Plain text
#: build/C/man2/poll.2:168
msgid "There is urgent data to read (e.g., out-of-band data on TCP socket; pseudoterminal master in packet mode has seen state change in slave)."
msgstr "読み出し可能な緊急データ (urgent data) がある (例えば、TCP ソケットの帯域外 (out-of-band data) データを受信した場合や、 パケットモードの擬似端末のマスタがスレーブ側の変化を見つけたとき)。"

#. type: TP
#: build/C/man2/poll.2:168
#, no-wrap
msgid "B<POLLOUT>"
msgstr "B<POLLOUT>"

#. type: Plain text
#: build/C/man2/poll.2:174
msgid "Writing is now possible, though a write larger that the available space in a socket or pipe will still block (unless B<O_NONBLOCK> is set)."
msgstr "書き込みが可能になった。ただし、ソケットやパイプで利用可能な空間よりも大きなデータを書き込んだ場合には (B<O_NONBLOCK> がセットされている場合以外は) やはり停止することになる。"

#. type: TP
#: build/C/man2/poll.2:174
#, no-wrap
msgid "B<POLLRDHUP> (since Linux 2.6.17)"
msgstr "B<POLLRDHUP> (Linux 2.6.17 以降)"

#. type: Plain text
#: build/C/man2/poll.2:185
msgid "Stream socket peer closed connection, or shut down writing half of connection.  The B<_GNU_SOURCE> feature test macro must be defined (before including I<any> header files)  in order to obtain this definition."
msgstr "ストリームソケットの他端が、コネクションを close したか、 コネクションの書き込み側を shutdown した。 この定義を有効にするには、 (「どの」ヘッダーファイルをインクルードするよりも前に)  B<_GNU_SOURCE> 機能検査マクロを定義しなければならない。"

#. type: TP
#: build/C/man2/poll.2:185
#, no-wrap
msgid "B<POLLERR>"
msgstr "B<POLLERR>"

#. type: Plain text
#: build/C/man2/poll.2:188
msgid "Error condition (output only)."
msgstr "エラー状態 (出力の場合のみ)。"

#. type: TP
#: build/C/man2/poll.2:188
#, no-wrap
msgid "B<POLLHUP>"
msgstr "B<POLLHUP>"

#. type: Plain text
#: build/C/man2/poll.2:191
msgid "Hang up (output only)."
msgstr "ハングアップした (出力の場合のみ)。"

#. type: TP
#: build/C/man2/poll.2:191
#, no-wrap
msgid "B<POLLNVAL>"
msgstr "B<POLLNVAL>"

#. type: Plain text
#: build/C/man2/poll.2:196
msgid "Invalid request: I<fd> not open (output only)."
msgstr "不正な要求: I<fd> がオープンされていない (出力の場合のみ)。"

#. type: Plain text
#: build/C/man2/poll.2:202
msgid "When compiling with B<_XOPEN_SOURCE> defined, one also has the following, which convey no further information beyond the bits listed above:"
msgstr "B<_XOPEN_SOURCE> を定義してコンパイルした場合には、以下の定義も行われる。 ただし、上記のリストにあるビット以上の情報が得られる訳ではない。"

#. type: TP
#: build/C/man2/poll.2:203
#, no-wrap
msgid "B<POLLRDNORM>"
msgstr "B<POLLRDNORM>"

#. type: Plain text
#: build/C/man2/poll.2:207
msgid "Equivalent to B<POLLIN>."
msgstr "B<POLLIN> と同じ。"

#. type: TP
#: build/C/man2/poll.2:207
#, no-wrap
msgid "B<POLLRDBAND>"
msgstr "B<POLLRDBAND>"

#.  POLLRDBAND is used in the DECnet protocol.
#. type: Plain text
#: build/C/man2/poll.2:211
msgid "Priority band data can be read (generally unused on Linux)."
msgstr "優先帯域データ (priority band data) が読み出し可能である (普通は Linux では使用されない)。"

#. type: TP
#: build/C/man2/poll.2:211
#, no-wrap
msgid "B<POLLWRNORM>"
msgstr "B<POLLWRNORM>"

#. type: Plain text
#: build/C/man2/poll.2:215
msgid "Equivalent to B<POLLOUT>."
msgstr "B<POLLOUT> と同じ。"

#. type: TP
#: build/C/man2/poll.2:215
#, no-wrap
msgid "B<POLLWRBAND>"
msgstr "B<POLLWRBAND>"

#. type: Plain text
#: build/C/man2/poll.2:218
msgid "Priority data may be written."
msgstr "優先帯域データ (priority data) が書き込み可能である。"

#. type: Plain text
#: build/C/man2/poll.2:222
msgid "Linux also knows about, but does not use B<POLLMSG>."
msgstr "Linux では B<POLLMSG> も定義されているが、使用されていない。"

#. type: SS
#: build/C/man2/poll.2:222
#, no-wrap
msgid "ppoll()"
msgstr "ppoll()"

#. type: Plain text
#: build/C/man2/poll.2:236
msgid "The relationship between B<poll>()  and B<ppoll>()  is analogous to the relationship between B<select>(2)  and B<pselect>(2): like B<pselect>(2), B<ppoll>()  allows an application to safely wait until either a file descriptor becomes ready or until a signal is caught."
msgstr "B<poll>()  と B<ppoll>()  の関係は B<select>(2)  と B<pselect>(2)  の関係と同じようなものである: B<pselect>(2)  と同様に、 B<ppoll>()  を使うと、アプリケーションはファイルディスクリプターの状態変化 もしくはシグナルの捕捉を安全に待つことができる。"

#. type: Plain text
#: build/C/man2/poll.2:242
msgid "Other than the difference in the precision of the I<timeout> argument, the following B<ppoll>()  call:"
msgstr "I<timeout> 引き数の精度の違いを除くと、以下の B<ppoll>()  の呼び出しは、"

#. type: Plain text
#: build/C/man2/poll.2:245
#, no-wrap
msgid "    ready = ppoll(&fds, nfds, timeout_ts, &sigmask);\n"
msgstr "    ready = ppoll(&fds, nfds, timeout_ts, &sigmask);\n"

#. type: Plain text
#: build/C/man2/poll.2:254
#, no-wrap
msgid ""
"    sigset_t origmask;\n"
"    int timeout;\n"
msgstr ""
"    sigset_t origmask;\n"
"    int timeout;\n"

#. type: Plain text
#: build/C/man2/poll.2:260
#, no-wrap
msgid ""
"    timeout = (timeout_ts == NULL) ? -1 :\n"
"              (timeout_ts.tv_sec * 1000 + timeout_ts.tv_nsec / 1000000);\n"
"    sigprocmask(SIG_SETMASK, &sigmask, &origmask);\n"
"    ready = poll(&fds, nfds, timeout);\n"
"    sigprocmask(SIG_SETMASK, &origmask, NULL);\n"
msgstr ""
"    timeout = (timeout_ts == NULL) ? -1 :\n"
"              (timeout_ts.tv_sec * 1000 + timeout_ts.tv_nsec / 1000000);\n"
"    sigprocmask(SIG_SETMASK, &sigmask, &origmask);\n"
"    ready = poll(&fds, nfds, timeout);\n"
"    sigprocmask(SIG_SETMASK, &origmask, NULL);\n"

#. type: Plain text
#: build/C/man2/poll.2:267
msgid "See the description of B<pselect>(2)  for an explanation of why B<ppoll>()  is necessary."
msgstr "なぜ B<ppoll>()  が必要なのかについての説明は B<pselect>(2)  の説明を参照のこと。"

#. type: Plain text
#: build/C/man2/poll.2:279
msgid "If the I<sigmask> argument is specified as NULL, then no signal mask manipulation is performed (and thus B<ppoll>()  differs from B<poll>()  only in the precision of the I<timeout> argument)."
msgstr "I<sigmask> 引き数に NULL が指定された場合、シグナルマスクの操作は行われない (したがって、 B<ppoll>()  の B<poll>()  との違いは I<timeout> 引き数の精度だけとなる)。"

#. type: Plain text
#: build/C/man2/poll.2:286
msgid "The I<timeout_ts> argument specifies an upper limit on the amount of time that B<ppoll>()  will block.  This argument is a pointer to a structure of the following form:"
msgstr "I<timeout> 引き数は B<ppoll>()  が停止する時間の上限を指定するものである。 この引き数には以下の型の構造体へのポインターを指定する。"

#. type: Plain text
#: build/C/man2/poll.2:293
#, no-wrap
msgid ""
"struct timespec {\n"
"    long    tv_sec;         /* seconds */\n"
"    long    tv_nsec;        /* nanoseconds */\n"
"};\n"
msgstr ""
"struct timespec {\n"
"    long    tv_sec;         /* seconds */\n"
"    long    tv_nsec;        /* nanoseconds */\n"
"};\n"

#. type: Plain text
#: build/C/man2/poll.2:301
msgid "If I<timeout_ts> is specified as NULL, then B<ppoll>()  can block indefinitely."
msgstr "I<timeout_ts> に NULL が指定された場合、 B<ppoll> は無限に停止することがあり得る。"

#. type: Plain text
#: build/C/man2/poll.2:311
msgid "On success, a positive number is returned; this is the number of structures which have nonzero I<revents> fields (in other words, those descriptors with events or errors reported).  A value of 0 indicates that the call timed out and no file descriptors were ready.  On error, -1 is returned, and I<errno> is set appropriately."
msgstr "成功した場合は正の数を返す。この数は 0 以外の I<revents> 要素を持つ構造体の数である (別の言い方をすると、これらのディスクリプター にはイベントかエラー報告がある)。 値 0 は、タイムアウトとなり、どのファイルディスクリプターでもイベントが 発生しなかったことを示す。エラーの場合は -1 が返され、 I<errno> が適切に設定される。"

#. type: Plain text
#: build/C/man2/poll.2:316
msgid "The array given as argument was not contained in the calling program's address space."
msgstr "引き数として指定した配列が、呼び出したプロセスのアドレス空間に 含まれていない。"

#. type: Plain text
#: build/C/man2/poll.2:320
msgid "A signal occurred before any requested event; see B<signal>(7)."
msgstr "要求されたイベントのどれかが起こる前にシグナルが発生した。 B<signal>(7)  参照。"

#. type: Plain text
#: build/C/man2/poll.2:327
msgid "The I<nfds> value exceeds the B<RLIMIT_NOFILE> value."
msgstr "I<nfds> の値が B<RLIMIT_NOFILE> を超えた。"

#. type: Plain text
#: build/C/man2/poll.2:330
msgid "There was no space to allocate file descriptor tables."
msgstr "ファイルディスクリプターテーブルを確保するためのメモリーがない。"

#.  library call was introduced in libc 5.4.28
#. type: Plain text
#: build/C/man2/poll.2:340
msgid "The B<poll>()  system call was introduced in Linux 2.1.23.  On older kernels that lack this system call, the glibc (and the old Linux libc)  B<poll>()  wrapper function provides emulation using B<select>(2)."
msgstr ""
"B<poll>() システムコールは Linux 2.1.23 で導入された。\n"
"このシステムコールが存在しない古いカーネルでは、\n"
"glibc (や古い Linux libc) は B<select>(2) を使用して B<poll>() \n"
"ラッパー関数のエミュレーションを行う。"

#. type: Plain text
#: build/C/man2/poll.2:347
msgid "The B<ppoll>()  system call was added to Linux in kernel 2.6.16.  The B<ppoll>()  library call was added in glibc 2.4."
msgstr "B<ppoll>()  システムコールは カーネル 2.6.16 で Linux に追加された。 B<ppoll>()  ライブラリコールは glibc 2.4 に追加された。"

#.  NetBSD 3.0 has a pollts() which is like Linux ppoll().
#. type: Plain text
#: build/C/man2/poll.2:353
msgid "B<poll>()  conforms to POSIX.1-2001.  B<ppoll>()  is Linux-specific."
msgstr "B<poll>()  は POSIX.1-2001 に準拠している。 B<ppoll>()  は Linux 固有である。"

#. type: Plain text
#: build/C/man2/poll.2:361
msgid "Some implementations define the nonstandard constant B<INFTIM> with the value -1 for use as a I<timeout> for B<poll>().  This constant is not provided in glibc."
msgstr "いくつかの実装では、値 -1 を持った非標準の定数 B<INFTIM> が定義されており、 B<poll>()  の I<timeout> の指定に使用できる。 この定数は glibc では定義されていない。"

#. type: Plain text
#: build/C/man2/poll.2:366
msgid "For a discussion of what may happen if a file descriptor being monitored by B<poll>()  is closed in another thread, see B<select>(2)."
msgstr "B<poll>() で監視中のファイルディスクリプターが別のスレッドによってクローズされた場合に何が起こるかの議論については、 B<select>(2) を参照してほしい。"

#. type: Plain text
#: build/C/man2/poll.2:380
msgid "The Linux B<ppoll>()  system call modifies its I<timeout_ts> argument.  However, the glibc wrapper function hides this behavior by using a local variable for the timeout argument that is passed to the system call.  Thus, the glibc B<ppoll>()  function does not modify its I<timeout_ts> argument."
msgstr "Linux の B<ppoll>()  システムコールは I<timeout_ts> 引き数を変更する。 しかし、glibc のラッパー関数は、システムコールに渡す timeout 引き数 としてローカル変数を使うことでこの動作を隠蔽している。 このため、glibc の B<ppoll>()  関数では I<timeout_ts> 引き数は変更されない。"

#. type: Plain text
#: build/C/man2/poll.2:393
msgid "The raw B<ppoll>()  system call has a fifth argument, I<size_t sigsetsize>, which specifies the size in bytes of the I<sigmask> argument.  The glibc B<ppoll>()  wrapper function specifies this argument as a fixed value (equal to I<sizeof(sigset_t)>)."
msgstr "素の B<ppoll>() システムコールは 5 番目の引き数 I<size_t sigsetsize> をとる。 この引き数は I<sigmask> 引き数のバイト単位のサイズを指定する。 glibc の B<ppoll>() ラッパー関数は、この引き数に固定値 (I<sizeof(sigset_t)> と同じ) を指定する。"

#. type: Plain text
#: build/C/man2/poll.2:397
msgid "See the discussion of spurious readiness notifications under the BUGS section of B<select>(2)."
msgstr "B<select>(2)  の「バグ」の節に書かれている、誤った準備完了通知 (spurious readiness notifications) についての議論を参照のこと。"

#. type: Plain text
#: build/C/man2/poll.2:402
msgid "B<restart_syscall>(2), B<select>(2), B<select_tut>(2), B<time>(7)"
msgstr "B<restart_syscall>(2), B<select>(2), B<select_tut>(2), B<time>(7)"