.\"
.TH TIMERFD_CREATE 2 2009-03-10 Linux "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O timerfd_create, timerfd_settime, timerfd_gettime \-
.\"O timers that notify via file descriptors
timerfd_create, timerfd_settime, timerfd_gettime \-
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿·Ðͳ¤ÇÄÌÃΤ¹¤ë¥¿¥¤¥Þ¡¼
+ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿çµ\8cç\94±ã\81§é\80\9aç\9f¥ã\81\99ã\82\8bã\82¿ã\82¤ã\83\9eã\83¼
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.B #include <sys/timerfd.h>
.sp
.BI "int timerfd_gettime(int " fd ", struct itimerspec *" curr_value );
.fi
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O These system calls create and operate on a timer
.\"O that delivers timer expiration notifications via a file descriptor.
.\"O They provide an alternative to the use of
.\"O .BR poll (2),
.\"O and
.\"O .BR epoll (7).
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢ËþλÄÌÃΤò¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿·Ðͳ¤ÇÇÛÁ÷¤¹¤ë
-¥¿¥¤¥Þ¡¼¤ÎÀ¸À®¤ÈÁàºî¤ò¹Ô¤¦¡£
-¤³¤ì¤é¤Ï¡¢
+これらのシステムコールは、満了通知をファイルディスクリプタ経由で配送する
+タイマーの生成と操作を行う。
+これらは、
.BR setitimer (2)
-¤ä
+や
.BR timer_create (2)
-¤òÍѤ¤¤ëÊýË¡¤ÎÂå¤ï¤ê¤È¤Ê¤ë¤â¤Î¤Ç¤¢¤ê¡¢¤³¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò
+を用いる方法の代わりとなるものであり、このファイルディスクリプタを
.BR select (2),
.BR poll (2),
.BR epoll (7)
-¤Ç´Æ»ë¤Ç¤¤ë¤È¤¤¤¦ÍøÅÀ¤¬¤¢¤ë¡£
+で監視できるという利点がある。
.\"O The use of these three system calls is analogous to the use of
.\"O .BR timer_create (2),
.\"O since that functionality is provided by
.\"O .BR read (2),
.\"O as described below.)
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò»È¤¦¤Î¤Ï¡¢¤½¤ì¤¾¤ì
+これらのシステムコールを使うのは、それぞれ
.BR timer_create (2),
.BR timer_settime (2),
.BR timer_gettime (2)
-¤ò»È¤¦¤Î¤ÈƱÍͤǤ¢¤ë
+を使うのと同様である
.RB ( timer_getoverrun (2)
-¤ËÂбþ¤¹¤ë¤â¤Î¤Ï¤Ê¤¯¡¢°Ê²¼¤ÇÀâÌÀ¤¹¤ë¤è¤¦¤Ë
-¤³¤Îµ¡Ç½¤Ï
+に対応するものはなく、以下で説明するように
+この機能は
.BR read (2)
-¤Ë¤è¤êÄ󶡤µ¤ì¤ë)¡£
+により提供される)。
.\"
.SS timerfd_create()
.\"O .BR timerfd_create ()
.\"O creates a new timer object,
.\"O and returns a file descriptor that refers to that timer.
.BR timerfd_create ()
-¤Ï¿·µ¬¤Î¥¿¥¤¥Þ¡¼¥ª¥Ö¥¸¥§¥¯¥È¤òÀ¸À®¤·¡¢¤½¤Î¥¿¥¤¥Þ¡¼¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë
-¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
+は新規のタイマーオブジェクトを生成し、そのタイマーを参照するファイル
+ディスクリプタを返す。
.\"O The
.\"O .I clockid
.\"O argument specifies the clock that is used to mark the progress
.\"O The current value of each of these clocks can be retrieved using
.\"O .BR clock_gettime (2).
.I clockid
-°ú¤¿ô¤Ï¡¢¥¿¥¤¥Þ¡¼¤Î¿ÊĽ¤ò´ÉÍý¤¹¤ë¤¿¤á¤Î¥¯¥í¥Ã¥¯¤ò»ØÄꤹ¤ë¤â¤Î¤Ç¡¢
+引き数は、タイマーの進捗を管理するためのクロックを指定するもので、
.B CLOCK_REALTIME
-¤«
+か
.B CLOCK_MONOTONIC
-¤Î¤¤¤º¤ì¤«¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+のいずれかでなければならない。
.B CLOCK_REALTIME
-¤Ï¥·¥¹¥Æ¥àÁ´ÂΤǻÈÍѤµ¤ì¤ë¥¯¥í¥Ã¥¯¤Ç¡¢¤³¤Î¥¯¥í¥Ã¥¯¤ÏÊѹ¹²Äǽ¤Ç¤¢¤ë¡£
+はシステム全体で使用されるクロックで、このクロックは変更可能である。
.B CLOCK_MONOTONIC
-¤ÏÊѹ¹¤µ¤ì¤ë¤³¤È¤Î¤Ê¤¤¥¯¥í¥Ã¥¯¤Ç¡¢(¥·¥¹¥Æ¥à»þ¹ï¤Î¼êÆ°¤Ç¤ÎÊѹ¹¤Ê¤É¤Î)
-¥·¥¹¥Æ¥à¥¯¥í¥Ã¥¯¤ÎÉÔϢ³¤ÊÊѲ½¤Î±Æ¶Á¤ò¼õ¤±¤Ê¤¤¡£
-¤³¤ì¤é¤Î¥¯¥í¥Ã¥¯¤Î¸½ºß¤ÎÃͤÏ
+は変更されることのないクロックで、(システム時刻の手動での変更などの)
+システムクロックの不連続な変化の影響を受けない。
+これらのクロックの現在の値は
.BR clock_gettime (2)
-¤ò»È¤Ã¤Æ¼èÆÀ¤Ç¤¤ë¡£
+を使って取得できる。
.\"O Starting with Linux 2.6.27, the following values may be bitwise ORed in
.\"O .IR flags
.\"O to change the behavior of
.\"O .BR timerfd_create ():
-Linux 2.6.27 °Ê¹ß¤Ç¤Ï¡¢
-°Ê²¼¤ÎÃͤΤ¤¤¯¤Ä¤«¤ò¥Ó¥Ã¥Èñ°Ì¤ÎÏÀÍýÏ (OR) ¤Ç»ØÄꤹ¤ë¤³¤È¤Ç¡¢
+Linux 2.6.27 以降では、
+以下の値のいくつかをビット単位の論理和 (OR) で指定することで、
.BR timerfd_create ()
-¤Î¿¶Éñ¤¤¤òÊѹ¹¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
+の振舞いを変更することができる。
.TP 14
.B TFD_NONBLOCK
.\"O Set the
.\"O Using this flag saves extra calls to
.\"O .BR fcntl (2)
.\"O to achieve the same result.
-¿·¤·¤¯À¸À®¤µ¤ì¤ë¥ª¡¼¥×¥ó¥Õ¥¡¥¤¥ëµ½Ò (open file description) ¤Î
+新しく生成されるオープンファイル記述 (open file description) の
.B O_NONBLOCK
-¥Õ¥¡¥¤¥ë¥¹¥Æ¡¼¥¿¥¹¥Õ¥é¥°¤ò¥»¥Ã¥È¤¹¤ë¡£
-¤³¤Î¥Õ¥é¥°¤ò»È¤¦¤³¤È¤Ç¡¢
+ファイルステータスフラグをセットする。
+このフラグを使うことで、
.B O_NONBLOCK
-¤ò¥»¥Ã¥È¤¹¤ë¤¿¤á¤Ë
+をセットするために
.BR fcntl (2)
-¤òÄɲäǸƤӽФ¹É¬Íפ¬¤Ê¤¯¤Ê¤ë¡£
+を追加で呼び出す必要がなくなる。
.TP
.B TFD_CLOEXEC
.\"O Set the close-on-exec
.\"O flag in
.\"O .BR open (2)
.\"O for reasons why this may be useful.
-¿·¤·¤¤¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂФ·¤Æ
+新しいファイルディスクリプタに対して
close-on-exec
.RB ( FD_CLOEXEC )
-¥Õ¥é¥°¤ò¥»¥Ã¥È¤¹¤ë¡£
-¤³¤Î¥Õ¥é¥°¤¬Ìò¤ËΩ¤ÄÍýͳ¤Ë¤Ä¤¤¤Æ¤Ï¡¢
+フラグをセットする。
+このフラグが役に立つ理由については、
.BR open (2)
-¤Î
+の
.B O_CLOEXEC
-¥Õ¥é¥°¤ÎÀâÌÀ¤ò»²¾È¤Î¤³¤È¡£
+フラグの説明を参照のこと。
.PP
.\"O In Linux versions up to and including 2.6.26,
.\"O .I flags
.\"O must be specified as zero.
-¥Ð¡¼¥¸¥ç¥ó 2.6.26 °ÊÁ°¤Î Linux ¤Ç¤Ï¡¢
+バージョン 2.6.26 以前の Linux では、
.I flags
-°ú¤¿ô¤Ï̤»ÈÍѤǤ¢¤ê¡¢0 ¤ò»ØÄꤷ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+引き数は未使用であり、0 を指定しなければならない。
.SS timerfd_settime()
.\"O .BR timerfd_settime ()
.\"O arms (starts) or disarms (stops)
.\"O the timer referred to by the file descriptor
.\"O .IR fd .
.BR timerfd_settime ()
-¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
+ã\81¯ã\80\81ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
.I fd
-¤Ë¤è¤ê»²¾È¤µ¤ì¤ë¥¿¥¤¥Þ¡¼¤ò³«»Ï¤·¤¿¤êÄä»ß¤·¤¿¤ê¤¹¤ë¡£
+により参照されるタイマーを開始したり停止したりする。
.\"O The
.\"O .I new_value
.\"O each of which is in turn a structure of type
.\"O .IR timespec :
.I new_value
-°ú¤¿ô¤Ï¡¢¥¿¥¤¥Þ¡¼¤ÎËþλ»þ´Ö (expiration) ¤Î½é´üÃÍ¤È´Ö³Ö (interval) ¤ò
-»ØÄꤹ¤ë¡£¤³¤Î°ú¤¿ô¤Ç»ÈÍѤµ¤ì¤Æ¤¤¤ë
-.\"Omotoki: itimer structure ¤Ï itimerspec structure ¤Î´Ö°ã¤¤¤À¤í¤¦¡£
+引き数は、タイマーの満了時間 (expiration) の初期値と間隔 (interval) を
+指定する。この引き数で使用されている
+.\"Omotoki: itimer structure は itimerspec structure の間違いだろう。
.I itimerspec
-¹½Â¤ÂÎ¤Ë¤Ï 2 ¤Ä¤Î¥Õ¥£¡¼¥ë¥É¤¬¤¢¤ê¡¢³Æ¥Õ¥£¡¼¥ë¥É¤Ï
+構造体には 2 つのフィールドがあり、各フィールドは
.I timespec
-·¿¤Î¹½Â¤ÂΤǤ¢¤ë¡£
+型の構造体である。
.in +4n
.nf
.\"O .I new_value.it_value
.\"O to zero disarms the timer.
.I new_value.it_value
-¤Ï¥¿¥¤¥Þ¡¼¤ÎËþλ»þ´Ö¤Î½é´üÃͤò¡¢ÉäȥʥÎÉäǻØÄꤹ¤ë¡£
+はタイマーの満了時間の初期値を、秒とナノ秒で指定する。
.I new_value.it_value
-¤Î¥Õ¥£¡¼¥ë¥É¤Î¤¦¤Á¾¯¤Ê¤¯¤È¤â°ìÊý¤Ë 0 °Ê³°¤ÎÃͤòÀßÄꤹ¤ë¤È¡¢
-¥¿¥¤¥Þ¡¼¤¬³«»Ï¤µ¤ì¤ë¡£
-ξÊý¤Î¥Õ¥£¡¼¥ë¥É¤Ë 0 ¤òÀßÄꤹ¤ë¤È¡¢¥¿¥¤¥Þ¡¼¤¬Ää»ß¤¹¤ë¡£
+のフィールドのうち少なくとも一方に 0 以外の値を設定すると、
+タイマーが開始される。
+両方のフィールドに 0 を設定すると、タイマーが停止する。
.\"O Setting one or both fields of
.\"O .I new_value.it_interval
.\"O are zero, the timer expires just once, at the time specified by
.\"O .IR new_value.it_value .
.I new_value.it_interval
-¤Ï¥¿¥¤¥Þ¡¼¤Î°ì²óÌܤÎËþλ¸å¤Ë·«¤êÊÖ¤·¥¿¥¤¥Þ¡¼¤ÎËþλ´Ö³Ö¤ò¡¢ÉäȥʥÎÉäǻØÄꤹ¤ë¡£
+はタイマーの一回目の満了後に繰り返しタイマーの満了間隔を、秒とナノ秒で指定する。
.I new_value.it_interval
-¤Î¥Õ¥£¡¼¥ë¥É¤Î¤¦¤Á¾¯¤Ê¤¯¤È¤â°ìÊý¤Ë 0 °Ê³°¤ÎÃͤòÀßÄꤹ¤ë¤È¡¢
-·«¤êÊÖ¤·¥¿¥¤¥Þ¡¼¤¬Í¸ú¤Ë¤Ê¤ë¡£
-ξÊý¤Î¥Õ¥£¡¼¥ë¥É¤Ë 0 ¤òÀßÄꤷ¤¿¾ì¹ç¡¢¥¿¥¤¥Þ¡¼¤Ï
+のフィールドのうち少なくとも一方に 0 以外の値を設定すると、
+繰り返しタイマーが有効になる。
+両方のフィールドに 0 を設定した場合、タイマーは
.I new_value.it_value
-¤Ç»ØÄꤵ¤ì¤¿»þ´Ö¸å¤Ë¡¢°ì²ó¤À¤±Ëþλ¤·¤ÆÄä»ß¤¹¤ë¡£
+で指定された時間後に、一回だけ満了して停止する。
.\"O The
.\"O .I flags
.\"O clock reaches the value specified in
.\"O .IR new_value.it_value ).
.I flags
-°ú¤¿ô¤Ë¤Ï 0 ¤«
+引き数には 0 か
.B TFD_TIMER_ABSTIME
-¤ò»ØÄꤹ¤ë¡£
-0 ¤ÏÁêÂлþ¹ï¥¿¥¤¥Þ¡¼¤ò°ÕÌ£¤·¡¢
+を指定する。
+0 は相対時刻タイマーを意味し、
.I new_value.it_interval
-¤Ç¤Ï
+では
.I clockid
-¤Ç»ØÄꤵ¤ì¤¿¥¯¥í¥Ã¥¯¤Î¸½ºß¤ÎÃͤ«¤é¤ÎÁêÂÐŪ¤Ê»þ¹ï¤ò»ØÄꤹ¤ë¡£
+で指定されたクロックの現在の値からの相対的な時刻を指定する。
.B TFD_TIMER_ABSTIME
-¤ÏÀäÂлþ¹ï¥¿¥¤¥Þ¡¼¤ò°ÕÌ£¤·¡¢
+は絶対時刻タイマーを意味し、
.I new_value.it_interval
-¤Ç¤Ï
+では
.I clockid
-¤Ç»ØÄꤵ¤ì¤¿¥¯¥í¥Ã¥¯¤ÎÀäÂлþ¹ï¤ò»ØÄꤹ¤ë¡£¤Ä¤Þ¤ê¡¢
-¥¯¥í¥Ã¥¯¤ÎÃͤ¬
+で指定されたクロックの絶対時刻を指定する。つまり、
+クロックの値が
.I new_value.it_interval
-¤Ç»ØÄꤵ¤ì¤¿»þ¹ï¤Ë㤷¤¿¤é¡¢¥¿¥¤¥Þ¡¼¤¬Ëþλ¤¹¤ë¡£
+で指定された時刻に達したら、タイマーが満了する。
.\"O The
.\"O .I old_value
.\"O .BR timerfd_gettime ()
.\"O following.
.I old_value
-°ú¤¿ô¤òÄ̤¸¤Æ¡¢
+引き数を通じて、
.BR timerfd_settime ()
-¤ò¸Æ¤Ó½Ð¤·¤¿»þÅÀ¤Ç¤Î¥¿¥¤¥Þ¡¼¤ÎÀßÄê¤òÊÝ»ý¤·¤¿¹½Â¤ÂΤ¬ÊÖ¤µ¤ì¤ë¡£
-²¼µ¤Î
+を呼び出した時点でのタイマーの設定を保持した構造体が返される。
+下記の
.BR timerfd_gettime ()
-¤ÎÀâÌÀ¤ò»²¾È¡£
+の説明を参照。
.\"
.SS timerfd_gettime()
.\"O .BR timerfd_gettime ()
.\"O referred to by the file descriptor
.\"O .IR fd .
.BR timerfd_gettime ()
-¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
+ã\81¯ã\80\81ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
.I fd
-¤Ç»²¾È¤µ¤ì¤ë¥¿¥¤¥Þ¡¼¤Î¸½ºß¤ÎÀßÄ꤬Æþ¤Ã¤¿
+で参照されるタイマーの現在の設定が入った
.I itimerspec
-¹½Â¤ÂΤò¡¢
+構造体を、
.I curr_value
-¤Ë³ÊǼ¤·¤ÆÊÖ¤¹¡£
+に格納して返す。
.\"O The
.\"O .I it_value
.\"O .BR TFD_TIMER_ABSTIME
.\"O flag was specified when setting the timer.
.I it_value
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¥¿¥¤¥Þ¡¼¤¬¼¡¤ËËþλ¤¹¤ë¤Þ¤Ç¤Î»Ä¤ê»þ´Ö¤òÊÖ¤¹¡£
-¤³¤Î¹½Â¤ÂΤÎξÊý¤Î¥Õ¥£¡¼¥ë¥É¤¬ 0 ¤Ç¤¢¤ì¤Ð¡¢¥¿¥¤¥Þ¡¼¤Ï¸½ºßÄä»ß¤·¤Æ¤¤¤ë¡£
-¥¿¥¤¥Þ¡¼ÀßÄê»þ¤Ë
+フィールドは、タイマーが次に満了するまでの残り時間を返す。
+この構造体の両方のフィールドが 0 であれば、タイマーは現在停止している。
+タイマー設定時に
.B TFD_TIMER_ABSTIME
-¥Õ¥é¥°¤¬»ØÄꤵ¤ì¤¿¤«¤Ë´Ø¤ï¤é¤º¡¢¤³¤Î¥Õ¥£¡¼¥ë¥É¤Ï¾ï¤ËÁêÂÐÃͤ¬³ÊǼ¤µ¤ì¤ë¡£
+フラグが指定されたかに関わらず、このフィールドは常に相対値が格納される。
.\"O The
.\"O .I it_interval
.\"O then the timer is set to expire just once, at the time specified by
.\"O .IR curr_value.it_value .
.I it_interval
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¥¿¥¤¥Þ¡¼¤Î´Ö³Ö¤òÊÖ¤¹¡£
-¤³¤Î¹½Â¤ÂΤÎξÊý¤Î¥Õ¥£¡¼¥ë¥É¤¬ 0 ¤Ç¤¢¤ì¤Ð¡¢¥¿¥¤¥Þ¡¼¤Ï
+フィールドは、タイマーの間隔を返す。
+この構造体の両方のフィールドが 0 であれば、タイマーは
.I new_value.it_value
-¤Ç»ØÄꤵ¤ì¤¿»þ´Ö¸å¤Ë°ì²ó¤À¤±Ëþλ¤·¤ÆÄä»ß¤¹¤ë¤è¤¦¤ËÀßÄꤵ¤ì¤Æ¤¤¤ë¡£
+で指定された時間後に一回だけ満了して停止するように設定されている。
.\"O .SS Operating on a timer file descriptor
-.SS ¥¿¥¤¥Þ¡¼¡¦¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂФ¹¤ëÁàºî
+.SS タイマー・ファイルディスクリプタに対する操作
.\"O The file descriptor returned by
.\"O .BR timerfd_create ()
.\"O supports the following operations:
.BR timerfd_create ()
-¤¬ÊÖ¤¹¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï°Ê²¼¤ÎÁàºî¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¡£
+が返すファイルディスクリプタは以下の操作をサポートしている。
.TP
.BR read (2)
.\"O If the timer has already expired one or more times since
.\"O (The returned value is in host byte order,
.\"O i.e., the native byte order for integers on the host machine.)
.BR timerfd_settime ()
-¤ò»È¤Ã¤Æ¥¿¥¤¥Þ¡¼¤ÎÀßÄ꤬ºÇ¸åÊѹ¹¤µ¤ì¤Æ°Ê¹ß¡¢¤Þ¤¿¤Ï
+を使ってタイマーの設定が最後変更されて以降、または
.BR read (2)
-¤Î¸Æ¤Ó½Ð¤·¤ËºÇ¸å¤ËÀ®¸ù¤·¤Æ°Ê¹ß¤Ë¡¢¥¿¥¤¥Þ¡¼¤ÎËþ뤬°ì²ó°Ê¾åȯÀ¸¤·¤Æ¤¤¤ì¤Ð¡¢
+の呼び出しに最後に成功して以降に、タイマーの満了が一回以上発生していれば、
.BR read (2)
-¤ËÅϤµ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤Ë¡¢¥¿¥¤¥Þ¡¼Ëþλ²ó¿ô¤ò¼¨¤¹ 8 ¥Ð¥¤¥È¤Î unsigned ·¿¤ÎÀ°¿ô
+に渡されたバッファに、タイマー満了回数を示す 8 バイトの unsigned 型の整数
.RI ( uint64_t )
-¤¬ÊÖ¤µ¤ì¤ë
-(ÊÖ¤µ¤ì¤ëÃͤϥۥ¹¥È¥Ð¥¤¥È¥ª¡¼¥À¡¢¤Ä¤Þ¤ê¤½¤Î¥Û¥¹¥È¥Þ¥·¥ó¤Ë¤ª¤±¤ë
-À°¿ô¤ÎÄ̾ï¤Î¥Ð¥¤¥È¥ª¡¼¥À¤Ç¤¢¤ë)¡£
+が返される
+(返される値はホストバイトオーダ、つまりそのホストマシンにおける
+整数の通常のバイトオーダである)。
.IP
.\"O If no timer expirations have occurred at the time of the
.\"O .BR read (2),
.\"O .B O_NONBLOCK
.\"O flag).
.BR read (2)
-¤ò¹Ô¤Ã¤¿»þÅÀ¤Ç¥¿¥¤¥Þ¡¼¤ÎËþλ¤¬È¯À¸¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¡¢
+を行った時点でタイマーの満了が発生していなければ、
.BR read (2)
-¤ÏÄä»ß (block) ¤¹¤ë¡¢¤â¤·¤¯¤Ï¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬
-ÈóÄä»ß (nonblocking) ¤ËÀßÄꤵ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ï¥¨¥é¡¼
+は停止 (block) する、もしくはファイルディスクリプタが
+é\9d\9eå\81\9cæ¢ (nonblocking) ã\81«è¨å®\9aã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bå ´å\90\88ã\81¯ã\82¨ã\83©ã\83¼
.B EAGAIN
-¤Ç¼ºÇÔ¤¹¤ë (ÈóÄä»ß¥â¡¼¥É¤Ë¤¹¤ë¤Ë¤Ï¡¢
+で失敗する (非停止モードにするには、
.BR fcntl (2)
-¤Î
+の
.B F_SETFL
-Ì¿Îá¤Ç
+命令で
.B O_NONBLOCK
-¥Õ¥é¥°¤ò¥»¥Ã¥È¤¹¤ë)¡£
+フラグをセットする)。
.IP
.\"O A
.\"O .BR read (2)
.\"O will fail with the error
.\"O .B EINVAL
.\"O if the size of the supplied buffer is less than 8 bytes.
-ÅϤµ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤Î¥µ¥¤¥º¤¬ 8 ¥Ð¥¤¥È̤Ëþ¤Î¾ì¹ç¡¢
+渡されたバッファのサイズが 8 バイト未満の場合、
.BR read (2)
-¤Ï¥¨¥é¡¼
+ã\81¯ã\82¨ã\83©ã\83¼
.B EINVAL
-¤Ç¼ºÇÔ¤¹¤ë¡£
+で失敗する。
.TP
.\"O .BR poll "(2), " select "(2) (and similar)"
-.BR poll "(2), " select "(2) (¤ÈƱÍͤÎÁàºî)"
+.BR poll "(2), " select "(2) (と同様の操作)"
.\"O The file descriptor is readable
.\"O (the
.\"O .BR select (2)
.\"O .B POLLIN
.\"O flag)
.\"O if one or more timer expirations have occurred.
-°ì¤Ä°Ê¾å¤Î¥¿¥¤¥Þ¡¼Ëþλ¤¬È¯À¸¤·¤Æ¤¤¤ì¤Ð¡¢
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÏÆɤ߽Ф·²Äǽ¤È¤Ê¤ë
+一つ以上のタイマー満了が発生していれば、
+ファイルディスクリプタは読み出し可能となる
.RB ( select (2)
-¤Î
+の
.I readfds
-°ú¤¿ô¤ä
+引き数や
.BR poll (2)
-¤Î
+の
.B POLLIN
-¥Õ¥é¥°)¡£
+フラグ)。
.IP
.\"O The file descriptor also supports the other file-descriptor
.\"O multiplexing APIs:
.\"O .BR ppoll (2),
.\"O and
.\"O .BR epoll (7).
-¤³¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¡¢Â¾¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿Â¿½Å API ¤Ç¤¢¤ë
+このファイルディスクリプタは、他のファイルディスクリプタ多重 API である
.BR pselect (2),
.BR ppoll (2),
.BR epoll (7)
-¤â¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¡£
+もサポートしている。
.TP
.BR close (2)
.\"O When the file descriptor is no longer required it should be closed.
.\"O When all file descriptors associated with the same timer object
.\"O have been closed,
.\"O the timer is disarmed and its resources are freed by the kernel.
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬¤½¤ì°Ê¹ß¤ÏɬÍפʤ¯¤Ê¤Ã¤¿ºÝ¤Ë¤Ï¡¢¥¯¥í¡¼¥º¤¹¤Ù¤¤Ç¤¢¤ë¡£
-Ʊ¤¸ timer ¥ª¥Ö¥¸¥§¥¯¥È¤Ë´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬Á´¤Æ
-¥¯¥í¡¼¥º¤µ¤ì¤ë¤È¡¢¤½¤Î¥¿¥¤¥Þ¡¼¤Ï²ò½ü¤µ¤ì¡¢
-¤½¤Î¥ª¥Ö¥¸¥§¥¯¥ÈÍѤλñ¸»¤¬¥«¡¼¥Í¥ë¤Ë¤è¤ê²òÊü¤µ¤ì¤ë¡£
+ファイルディスクリプタがそれ以降は必要なくなった際には、クローズすべきである。
+同じ timer オブジェクトに関連付けられたファイルディスクリプタが全て
+クローズされると、そのタイマーは解除され、
+そのオブジェクト用の資源がカーネルにより解放される。
.\"
.\"O .SS fork(2) semantics
-.SS fork(2) ¤Ç¤Î°·¤¤
+.SS fork(2) での扱い
.\"O After a
.\"O .BR fork (2),
.\"O the child inherits a copy of the file descriptor created by
.\"O in the child will return information about
.\"O expirations of the timer.
.BR fork (2)
-¤¬¹Ô¤ï¤ì¤ë¤È¡¢»Ò¥×¥í¥»¥¹¤Ï
+が行われると、子プロセスは
.BR timerfd_create ()
-¤Ë¤è¤êÀ¸À®¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î¥³¥Ô¡¼¤ò
-·Ñ¾µ¤¹¤ë¡£¤½¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¡¢¿Æ¥×¥í¥»¥¹¤ÎÂбþ¤¹¤ë
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÈƱ¤¸¥¿¥¤¥Þ¡¼¥ª¥Ö¥¸¥§¥¯¥È¤ò»²¾È¤·¤Æ¤ª¤ê¡¢
-»Ò¥×¥í¥»¥¹¤Î
+により生成されたファイルディスクリプタのコピーを
+継承する。そのファイルディスクリプタは、親プロセスの対応する
+ファイルディスクリプタと同じタイマーオブジェクトを参照しており、
+子プロセスの
.BR read (2)
-¤Ç¤âƱ¤¸¥¿¥¤¥Þ¡¼¤ÎËþλ¤Ë´Ø¤¹¤ë¾ðÊó¤¬ÊÖ¤µ¤ì¤ë¡£
+でも同じタイマーの満了に関する情報が返される。
.\"
.\"O .SS execve(2) semantics
-.SS execve(2) ¤Ç¤Î°·¤¤
+.SS execve(2) での扱い
.\"O A file descriptor created by
.\"O .BR timerfd_create ()
.\"O is preserved across
.\"O .BR execve (2),
.\"O and continues to generate timer expirations if the timer was armed.
.BR execve (2)
-¤ÎÁ°¸å¤Ç
+の前後で
.BR timerfd_create ()
-¤Ë¤è¤êÀ¸À®¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÏÊÝ»ý¤µ¤ì¡¢
-¥¿¥¤¥Þ¡¼¤¬³«»Ï¤µ¤ì¤Æ¤¤¤¿¾ì¹ç¤Ë¤Ï¥¿¥¤¥Þ¡¼¤ÎËþλ¤¬È¯À¸¤·Â³¤±¤ë¡£
+により生成されたファイルディスクリプタは保持され、
+タイマーが開始されていた場合にはタイマーの満了が発生し続ける。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O On success,
.\"O .BR timerfd_create ()
.\"O returns a new file descriptor.
.\"O On error, \-1 is returned and
.\"O .I errno
.\"O is set to indicate the error.
-À®¸ù¤¹¤ë¤È¡¢
+成功すると、
.BR timerfd_create ()
-¤Ï¿·¤·¤¤¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
+は新しいファイルディスクリプタを返す。
+エラーの場合、\-1 を返し、
.I errno
-¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃͤòÀßÄꤹ¤ë¡£
+にエラーを示す値を設定する。
.\"O .BR timerfd_settime ()
.\"O and
.\"O .I errno
.\"O to indicate the error.
.BR timerfd_settime ()
-¤È
+と
.BR timerfd_gettime ()
-¤ÏÀ®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
+は成功すると 0 を返す。
+エラーの場合、\-1 を返し、
.I errno
-¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃͤòÀßÄꤹ¤ë¡£
+にエラーを示す値を設定する。
.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
.\"O .BR timerfd_create ()
.\"O can fail with the following errors:
.BR timerfd_create ()
-¤Ï°Ê²¼¤Î¥¨¥é¡¼¤Ç¼ºÇÔ¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£
+は以下のエラーで失敗する可能性がある。
.TP
.B EINVAL
.\"O The
.\"O nor
.\"O .BR CLOCK_REALTIME ;
.I clockid
-°ú¤¿ô¤¬
+引き数が
.B CLOCK_MONOTONIC
-¤Ç¤â
+でも
.B CLOCK_REALTIME
-¤Ç¤â¤Ê¤¤¡£
+でもない。
.TP
.B EINVAL
.\"O .I flags
.\"O .I flags
.\"O is nonzero.
.I flags
-¤¬Ìµ¸ú¤Ç¤¢¤ë¡£¤â¤·¤¯¤Ï¡¢Linux 2.6.26 °ÊÁ°¤Î¾ì¹ç¤Ï
+が無効である。もしくは、Linux 2.6.26 以前の場合は
.I flags
-¤¬ 0 °Ê³°¤Ç¤¢¤ë¡£
+が 0 以外である。
.TP
.B EMFILE
.\"O The per-process limit of open file descriptors has been reached.
-¥ª¡¼¥×¥óºÑ¤ß¤Î¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î¿ô¤¬¥×¥í¥»¥¹¤¢¤¿¤ê¤Î¾å¸Â¤Ë
-㤷¤Æ¤¤¤¿¡£
+オープン済みのファイルディスクリプタの数がプロセスあたりの上限に
+達していた。
.TP
.B ENFILE
.\"O The system-wide limit on the total number of open files has been
.\"O reached.
-¥ª¡¼¥×¥óºÑ¤ß¤Î¥Õ¥¡¥¤¥ëÁí¿ô¤¬¥·¥¹¥Æ¥àÁ´ÂΤξå¸Â¤Ë㤷¤Æ¤¤¤¿¡£
+オープン済みのファイル総数がシステム全体の上限に達していた。
.TP
.B ENODEV
.\"O Could not mount (internal) anonymous inode device.
-(¥«¡¼¥Í¥ëÆâ¤Î) ̵̾ inode ¥Ç¥Ð¥¤¥¹¤ò¥Þ¥¦¥ó¥È¤Ç¤¤Ê¤«¤Ã¤¿¡£
+(カーネル内の) 無名 inode デバイスをマウントできなかった。
.TP
.B ENOMEM
.\"O There was insufficient kernel memory to create the timer.
-¥¿¥¤¥Þ¡¼¤òºîÀ®¤¹¤ë¤Î¤Ë½½Ê¬¤Ê¥«¡¼¥Í¥ë¥á¥â¥ê¤¬¤Ê¤«¤Ã¤¿¡£
+タイマーを作成するのに十分なカーネルメモリがなかった。
.PP
.\"O .BR timerfd_settime ()
.\"O and
.\"O .BR timerfd_gettime ()
.\"O can fail with the following errors:
.BR timerfd_settime ()
-¤È
+と
.BR timerfd_gettime ()
-¤Ï°Ê²¼¤Î¥¨¥é¡¼¤Ç¼ºÇÔ¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£
+は以下のエラーで失敗する可能性がある。
.TP
.B EBADF
.\"O .I fd
.\"O is not a valid file descriptor.
.I fd
-¤¬Í¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
+が有効なファイルディスクリプタでない。
.TP
.B EFAULT
.\"O .IR new_value ,
.IR new_value ,
.IR old_value ,
.I curr_value
-¤¬Í¸ú¤Ê¥Ý¥¤¥ó¥¿¤Ç¤Ï¤Ê¤¤¡£
+が有効なポインタではない。
.TP
.B EINVAL
.\"O .I fd
.\"O is not a valid timerfd file descriptor.
.I fd
-¤¬Í¸ú¤Ê timerfd ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
+が有効な timerfd ファイルディスクリプタでない。
.PP
.\"O .BR timerfd_settime ()
.\"O can also fail with the following errors:
.BR timerfd_settime ()
-¤Ï°Ê²¼¤Î¥¨¥é¡¼¤Ç¼ºÇÔ¤¹¤ë¤³¤È¤â¤¢¤ë¡£
+は以下のエラーで失敗することもある。
.TP
.B EINVAL
.\"O .I new_value
.\"O .I tv_nsec
.\"O falls outside the range zero to 999,999,999).
.I new_value
-¤¬Å¬Àڤ˽é´ü²½¤µ¤ì¤Æ¤¤¤Ê¤¤
+が適切に初期化されていない
.RI ( tv_nsec
-¤Î°ì¤Ä¤¬ 0 ¤«¤é 999,999,999 ¤Þ¤Ç¤ÎÈϰϤËÆþ¤Ã¤Æ¤¤¤Ê¤¤)¡£
+の一つが 0 から 999,999,999 までの範囲に入っていない)。
.TP
.B EINVAL
.\" This case only checked since 2.6.29, and 2.2.2[78].some-stable-version.
.\"O .I flags
.\"O is invalid.
.I flags
-¤¬Ìµ¸ú¤Ç¤¢¤ë¡£
+が無効である。
.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
+.SH バージョン
.\"O These system calls are available on Linux since kernel 2.6.25.
.\"O Library support is provided by glibc since version 2.8.
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥«¡¼¥Í¥ë 2.6.25 °Ê¹ß¤Î Linux ¤ÇÍøÍѲÄǽ¤Ç¤¢¤ë¡£
-¥é¥¤¥Ö¥é¥ê¦¤Î¥µ¥Ý¡¼¥È¤Ï¥Ð¡¼¥¸¥ç¥ó 2.8 °Ê¹ß¤Î glibc ¤ÇÄ󶡤µ¤ì¤Æ¤¤¤ë¡£
+これらのシステムコールはカーネル 2.6.25 以降の Linux で利用可能である。
+ライブラリ側のサポートはバージョン 2.8 以降の glibc で提供されている。
.\"O .SH CONFORMING TO
-.SH ½àµò
+.SH 準拠
.\"O These system calls are Linux-specific.
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ¸ÇͤǤ¢¤ë¡£
+これらのシステムコールは Linux 固有である。
.\"O .SH EXAMPLE
-.SH Îã
+.SH 例
.\"O The following program creates a timer and then monitors its progress.
.\"O The program accepts up to three command-line arguments.
.\"O The first argument specifies the number of seconds for
.\"O The third argument specifies the number of times the program should
.\"O allow the timer to expire before terminating.
.\"O The second and third command-line arguments are optional.
-°Ê²¼¤Î¥×¥í¥°¥é¥à¤Ï¡¢¥¿¥¤¥Þ¡¼¤òºîÀ®¤·¡¢¤½¤Î¿ÊĽ¤ò¥â¥Ë¥¿¡¼¤¹¤ë¤â¤Î¤Ç¤¢¤ë¡£
-¤³¤Î¥×¥í¥°¥é¥à¤ÏºÇÂç¤Ç 3 ¸Ä¤Î¥³¥Þ¥ó¥É¥é¥¤¥ó°ú¤¿ô¤ò¼è¤ê¡¢
-Âè°ì°ú¤¿ô¤Ç¤Ï¥¿¥¤¥Þ¡¼¤ÎËþλ»þ´Ö¤Î½é´üÃÍ (Éÿôñ°Ì) ¤ò¡¢
-ÂèÆó°ú¤¿ô¤Ç¤Ï¥¿¥¤¥Þ¡¼¤Î´Ö³Ö (Éÿôñ°Ì) ¤ò¡¢
-Âè»°°ú¤¿ô¤Ç¤Ï¥¿¥¤¥Þ¡¼¤¬²¿²óËþλ¤·¤¿¤é¥×¥í¥°¥é¥à¤¬½ªÎ»¤¹¤ë¤«¤ò»ØÄꤹ¤ë¡£
-ÂèÆó°ú¤¿ô¤ÈÂè»°°ú¤¿ô¤Ï¾Êά²Äǽ¤Ç¤¢¤ë¡£
+以下のプログラムは、タイマーを作成し、その進捗をモニターするものである。
+このプログラムは最大で 3 個のコマンドライン引き数を取り、
+第一引き数ではタイマーの満了時間の初期値 (秒数単位) を、
+第二引き数ではタイマーの間隔 (秒数単位) を、
+第三引き数ではタイマーが何回満了したらプログラムが終了するかを指定する。
+第二引き数と第三引き数は省略可能である。
.\"O The following shell session demonstrates the use of the program:
-°Ê²¼¤Î¥·¥§¥ë¤Î¥»¥Ã¥·¥ç¥ó¤Ï¤³¤Î¥×¥í¥°¥é¥à¤Î»ÈÍÑÎã¤ò¼¨¤·¤¿¤â¤Î¤Ç¤¢¤ë¡£
+以下のシェルのセッションはこのプログラムの使用例を示したものである。
.in +4n
.nf
.fi
.in
.\"O .SS Program source
-.SS ¥×¥í¥°¥é¥à¤Î¥½¡¼¥¹
+.SS ã\83\97ã\83ã\82°ã\83©ã\83 ã\81®ã\82½ã\83¼ã\82¹
\&
.nf
.\" The commented out code here is what we currently need until
}
.fi
.\"O .SH BUGS
-.SH ¥Ð¥°
+.SH ã\83\90ã\82°
.\"O Currently,
.\"O .\" 2.6.29
.\"O .BR timerfd_create ()
.\"O supports fewer types of clock IDs than
.\"O .BR timer_create (2).
-¸½ºß¤Î¤È¤³¤í¡¢
+現在のところ、
.\" 2.6.29
.BR timerfd_create ()
-¤¬Âбþ¤·¤Æ¤¤¤ë clockid ¤Î¼ïÎà¤Ï
+が対応している clockid の種類は
.BR timer_create (2)
-¤è¤ê¤â¾¯¤Ê¤¤¡£
+よりも少ない。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR eventfd (2),
.BR poll (2),
.BR read (2),
OSDN Git Service
