.\" Translated on Fri Jan 14 16:50:24 JST 2000
.\" by WAKABAYASHI, Takeyasu <twakaba@eco.toyama-u.ac.jp>
.\"
-.\"WORD: predicate ½Ò¸ì
-.\"WORD: atomically °ì©¤Ç
+.\"WORD: predicate 述語
+.\"WORD: atomically 一息で
.\" .TH PTHREAD_COND 3 LinuxThreads
.\" .SH NAME
.\" pthread_cond_init, pthread_cond_destroy, pthread_cond_signal, pthread_cond_broadcast, pthread_cond_wait, pthread_cond_timedwait \- operations on conditions
.SH NAME
-pthread_cond_init, pthread_cond_destroy, pthread_cond_signal, pthread_cond_broadcast, pthread_cond_wait, pthread_cond_timedwait \- ¾ò·ïÊÑ¿ô¤ÎÁàºî
+pthread_cond_init, pthread_cond_destroy, pthread_cond_signal, pthread_cond_broadcast, pthread_cond_wait, pthread_cond_timedwait \- 条件変数の操作
-.SH ½ñ¼°
+.SH 書式
.B #include <pthread.h>
.BI "pthread_cond_t " cond " = PTHREAD_COND_INITIALIZER;"
.\" operations on conditions are: signal the condition (when the
.\" predicate becomes true), and wait for the condition, suspending the
.\" thread execution until another thread signals the condition.
-.SH ÀâÌÀ
+.SH 説明
-¾ò·ï(¡Ö¾ò·ïÊÑ¿ô¡×¤Î¾Êά) ¤Ï¡¢¶¦Í¥Ç¡¼¥¿¤ËÂФ¹¤ë¤¢¤ë½Ò¸ì¤¬Ëþ¤¿¤µ¤ì¤ë
-¤Þ¤Ç¡¢¥¹¥ì¥Ã¥É¤¬¼Â¹Ô¤òÄä»ß¤·¥×¥í¥»¥Ã¥µ¤ò¼êÊü¤¹¤³¤È¤ò²Äǽ¤Ë¤¹¤ëƱ´ü
-ÁõÃ֤Ǥ¢¤ë¡£¾ò·ï¤ËÂФ¹¤ë´ðËÜŪ¤ÊÁàºî¤Ï¡¢(½Ò¸ì¤¬¿¿¤Ë¤Ê¤Ã¤¿¾ì¹ç¤Ë)
-¾ò·ï¤òÁ÷¿®¤¹¤ë¤³¤È¤È¡¢Â¾¤Î¥¹¥ì¥Ã¥É¤¬¾ò·ï¤òÁ÷¿®¤¹¤ë¤Þ¤Ç¥¹¥ì¥Ã¥É¤Î¼Â¹Ô
-¤òÄä»ß¤·¤Æ¾ò·ï¤òÂԤĤ³¤È¤Ç¤¢¤ë¡£
+条件(「条件変数」の省略) は、共有データに対するある述語が満たされる
+まで、スレッドが実行を停止しプロセッサを手放すことを可能にする同期
+装置である。条件に対する基本的な操作は、(述語が真になった場合に)
+条件を送信することと、他のスレッドが条件を送信するまでスレッドの実行
+を停止して条件を待つことである。
.\" A condition variable must always be associated with a mutex, to avoid
.\" the race condition where a thread prepares to wait on a condition
.\" variable and another thread signals the condition just before the
.\" first thread actually waits on it.
-¾ò·ïÊÑ¿ô¤Ï¤¤¤Ä¤Ç¤â mutex ¤È·ë¤Ó¤Ä¤±¤é¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£¤³¤ì¤Ï¡¢
-¤¢¤ë¥¹¥ì¥Ã¥É¤¬¾ò·ïÊÑ¿ô¤òÂԤȤ¦¤È¤·¤Æ¤¤¤ë»þ¤Ë¡¢Â¾¤Î¥¹¥ì¥Ã¥É¤¬¡¢
-Àè¤Î¥¹¥ì¥Ã¥É¤¬¼ÂºÝ¤Ë¾ò·ïÊÑ¿ô¤ËÂФ·¤ÆÂÔµ¡¤¹¤ë¤½¤ÎľÁ°¤Ë¾ò·ï¤òÁ÷¿®¤¹¤ë¡¢
-¤È¤¤¤¦¶¥¹ç¾ò·ï¤òÈò¤±¤ë¤¿¤á¤Ç¤¢¤ë¡£
+条件変数はいつでも mutex と結びつけられていなければならない。これは、
+あるスレッドが条件変数を待とうとしている時に、他のスレッドが、
+先のスレッドが実際に条件変数に対して待機するその直前に条件を送信する、
+という競合条件を避けるためである。
.\" .B "pthread_cond_init"
.\" initializes the condition variable
.\" parameter is actually
.\" ignored.
.B "pthread_cond_init"
-¤Ï¡¢¾ò·ïÊÑ¿ô
+は、条件変数
.IR "cond"
-¤ò
+を
.IR "cond_attr"
-¤Ç»ØÄꤵ¤ì¤¿¾ò·ï°À¡¢¤Þ¤¿¤Ï
+で指定された条件属性、または
.I "cond_attr"
-¤¬
+が
.BR "NULL"
-¤Ç¤¢¤ì¤Ð¡¢¥Ç¥Õ¥©¥ë¥È¤Î°À¤Ç½é´ü²½¤¹¤ë¡£
-LinuxThreads ¤Î¼ÂÁõ¤Ï¡¢¤¤¤«¤Ê¤ë¾ò·ïÊÑ¿ô¤Î°À¤Ë¤âÂбþ¤·¤Æ¤¤¤Ê¤¤¡£
-¤«¤¯¤·¤Æ¡¢
+であれば、デフォルトの属性で初期化する。
+LinuxThreads の実装は、いかなる条件変数の属性にも対応していない。
+かくして、
.I "cond_attr"
-¥Ñ¥é¥á¥¿¤Ï¡¢¼Â¤Î¤È¤³¤í̵»ë¤µ¤ì¤ë¡£
+パラメタは、実のところ無視される。
.\" Variables of type
.\" .B "pthread_cond_t"
.\" can also be initialized
.\" statically, using the constant
.\" .BR "PTHREAD_COND_INITIALIZER" .
-·¿
+型
.B "pthread_cond_t"
-¤ÎÊÑ¿ô¤Ï¡¢Äê¿ô
+の変数は、定数
.BR "PTHREAD_COND_INITIALIZER"
-¤ò»È¤Ã¤ÆÀÅŪ¤Ë½é´ü²½¤¹¤ë¤³¤È¤â¤Ç¤¤ë¡£
+を使って静的に初期化することもできる。
.\" .B "pthread_cond_signal"
.\" restarts one of the threads that are waiting on
.\" exactly one
.\" is restarted, but it is not specified which.
.B "pthread_cond_signal"
-¤Ï¡¢¾ò·ïÊÑ¿ô
+は、条件変数
.IR "cond"
-¤ËÈ÷¤¨¤ÆÂÔµ¡¤·¤Æ¤¤¤ë¥¹¥ì¥Ã¥É¤Î°ì¤Ä¤Î¼Â¹Ô¤òºÆ³«¤µ¤»¤ë¡£
+に備えて待機しているスレッドの一つの実行を再開させる。
.IR "cond"
-¤òÂԤäƤ¤¤ë¥¹¥ì¥Ã¥É¤¬¤Ê¤±¤ì¤Ð¡¢²¿¤âµ¯¤³¤é¤Ê¤¤¡£
-Ê£¿ô¤Î¥¹¥ì¥Ã¥É¤¬
+を待っているスレッドがなければ、何も起こらない。
+複数のスレッドが
.IR "cond"
-¤òÂԤäƤ¤¤ì¤Ð¡¢¤¿¤À°ì¤Ä¤Î¤â¤Î¤À¤±¤¬ºÆ³«¤µ¤ì¤ë¤¬¡¢¤É¤ì¤Ç¤¢¤ë¤«¤Ï
-¤ï¤«¤é¤Ê¤¤¡£
+を待っていれば、ただ一つのものだけが再開されるが、どれであるかは
+わからない。
.\" .B "pthread_cond_broadcast"
.\" restarts all the threads that are waiting on
.\" waiting on
.\" .IR "cond" .
.B "pthread_cond_broadcast"
-¤Ï
+は
.IR "cond"
-¤ËÈ÷¤¨¤ÆÂÔµ¡¤·¤Æ¤¤¤ëÁ´¤Æ¤Î¥¹¥ì¥Ã¥É¤Î¼Â¹Ô¤òºÆ³«¤µ¤»¤ë¡£
+に備えて待機している全てのスレッドの実行を再開させる。
.IR "cond"
-¤òÂԤäƤ¤¤ë¥¹¥ì¥Ã¥É¤¬¤Ê¤±¤ì¤Ð¡¢²¿¤âµ¯¤³¤é¤Ê¤¤¡£
+を待っているスレッドがなければ、何も起こらない。
.\" .B "pthread_cond_wait"
.\" atomically unlocks the
.\" (as per
.\" .BR "pthread_lock_mutex" ).
.\"O
-.\"O pthread_unlock_mutex ¤ª¤è¤Ó pthread_lock_mutex ¤È¤¤¤¦´Ø¿ô¤Ï
-.\"O ¤Ï¸ºß¤·¤Ê¤¤(¥Ø¥Ã¥À¤Î grep ¤È ¥é¥¤¥Ö¥é¥ê¤Î nm ¤Ç³Îǧ)¡£
-.\"O ¤½¤ì¤¾¤ì¡¢pthread_mutex_unlock ¤ª¤è¤Ó pthread_mutex_lock¤Î¸í¤ê
-.\"O ¤È»×¤ï¤ì¤ë¡£
+.\"O pthread_unlock_mutex および pthread_lock_mutex という関数は
+.\"O は存在しない(ヘッダの grep と ライブラリの nm で確認)。
+.\"O それぞれ、pthread_mutex_unlock および pthread_mutex_lockの誤り
+.\"O と思われる。
.B "pthread_cond_wait"
-¤Ï
+は
(
.BR "pthread_mutex_unlock"
-¤Ë¤è¤ë)
+による)
.I "mutex"
-¤Î¥¢¥ó¥í¥Ã¥¯¤È¾ò·ïÊÑ¿ô
+のアンロックと条件変数
.I "cond"
-¤ÎÁ÷¿®¤ËÂФ¹¤ëÂÔµ¡¤ò°ì©¤Ç¹Ô¤¦¡£¾ò·ïÊÑ¿ô¤¬Á÷¿®¤µ¤ì¤ë¤Þ¤Ç
-¥¹¥ì¥Ã¥É¤Î¼Â¹Ô¤ÏÄä»ß¤µ¤ì¡¢CPU »þ´Ö¤ò¾ÃÈñ¤¹¤ë¤³¤È¤Ï¤Ê¤¤¡£
+の送信に対する待機を一息で行う。条件変数が送信されるまで
+スレッドの実行は停止され、CPU 時間を消費することはない。
.I "mutex"
-¤Ï¡¢
+は、
.BR "pthread_cond_wait"
-¤Î³«»Ï»þÅÀ¤Ç¡¢¤³¤ì¤ò¸Æ¤Ó½Ð¤¹¥¹¥ì¥Ã¥É¤Ë¤è¤Ã¤Æ¥í¥Ã¥¯¤µ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð
-¤Ê¤é¤Ê¤¤¡£
-¸Æ¤Ó½Ð¤·Â¦¤Î¥¹¥ì¥Ã¥É¤ËÌá¤ëÁ°¤Ë
+の開始時点で、これを呼び出すスレッドによってロックされていなければ
+ならない。
+呼び出し側のスレッドに戻る前に
.B "pthread_cond_wait"
-¤Ï
+は
.I "mutex"
-¤ò
+を
(
.BR "pthread_mutex_lock"
-¤Ë¤è¤Ã¤Æ)ºÆ¤Ó³ÍÆÀ¤¹¤ë¡£
+によって)再び獲得する。
.\" Unlocking the mutex and suspending on the condition variable is done
.\" atomically. Thus, if all threads always acquire the mutex before
.\" signaling the condition, this guarantees that the condition cannot be
.\" signaled (and thus ignored) between the time a thread locks the mutex
.\" and the time it waits on the condition variable.
-.\"O `the time a thread locks the mutex' ¤Ï
-.\"O `the time a thread unlocks the mutex' ¤Î¸í¤ê¤È»×¤ï¤ì¤ë¡£
-mutex ¤Î¥¢¥ó¥í¥Ã¥¯¤È¾ò·ïÊÑ¿ô¤ËÂФ¹¤ëÂÔµ¡¤Ï°ì©¤Ë¹Ô¤ï¤ì¤ë¡£½¾¤Ã¤Æ¡¢
-Á´¤Æ¤Î¥¹¥ì¥Ã¥É¤¬¾ò·ï¤òÁ÷¿®¤¹¤ëÁ°¤Ë¾ï¤Ë mutex ¤ò³ÍÆÀ¤¹¤ë¤Î¤Ê¤é¤Ð¡¢
-¥¹¥ì¥Ã¥É¤¬ mutex ¤ò¥¢¥ó¥í¥Ã¥¯¤¹¤ë»þÅÀ¤È¡¢¤½¤ì¤¬¾ò·ïÊÑ¿ô¤òÂԤĻþÅÀ
-¤È¤ÎÃæ´Ö¤Î»þÅÀ¤Ç¡¢¾ò·ï¤ÎÁ÷¿®¤¬¹Ô¤Ê¤ï¤ì¤ë(½¾¤Ã¤Æ̵»ë¤µ¤ì¤ë)¤³¤È¤¬
-ÉÔ²Äǽ¤È¤Ê¤ë¤³¤È¤¬Êݾڤµ¤ì¤ë¡£
+.\"O `the time a thread locks the mutex' は
+.\"O `the time a thread unlocks the mutex' の誤りと思われる。
+mutex のアンロックと条件変数に対する待機は一息に行われる。従って、
+全てのスレッドが条件を送信する前に常に mutex を獲得するのならば、
+スレッドが mutex をアンロックする時点と、それが条件変数を待つ時点
+との中間の時点で、条件の送信が行なわれる(従って無視される)ことが
+不可能となることが保証される。
.\" .B "pthread_cond_timedwait"
.\" atomically unlocks
.\" of 0
.\" corresponds to 00:00:00 GMT, January 1, 1970.
.B "pthread_cond_timedwait"
-¤Ï
+は
.B "pthread_cond_wait"
-¤ÈƱ¤¸¤¯¡¢°ì©¤Ç
+と同じく、一息で
.I "mutex"
-¤Î¥¢¥ó¥í¥Ã¥¯¤È
+のアンロックと
.IR "cond"
-¤Ø¤ÎÂÔµ¡¤ò¹Ô¤¦¡£¤·¤«¤·¤Þ¤¿¡¢ÂÔ¤Á»þ´Ö¤ÎŤµ¤ÎÀßÄê¤â¹Ô¤¦¡£
+への待機を行う。しかしまた、待ち時間の長さの設定も行う。
.I "cond"
-¤¬
+が
.IR "abstime"
-¤Ç»ØÄꤵ¤ì¤¿»þ´ÖÆâ¤ËÁ÷¿®¤µ¤ì¤Ê¤«¤Ã¤¿¤Î¤Ê¤é¤Ð¡¢
+で指定された時間内に送信されなかったのならば、
mutex
.I "mutex"
-¤¬ºÆ³ÍÆÀ¤µ¤ì
+が再獲得され
.B "pthread_cond_timedwait"
-¤Ï¡¢¥¨¥é¡¼
+ã\81¯ã\80\81ã\82¨ã\83©ã\83¼
.BR "ETIMEDOUT"
-¤òÊÖ¤¹¡£
+を返す。
.I "abstime"
-¥Ñ¥é¥á¥¿¤Ï
+パラメタは
.BR "time" (2)
-¤È
+と
.BR "gettimeofday" (2)
-¤Îµ¯ÅÀ¤òƱ¤¸¤¯¤¹¤ëÀäÂлþ´Ö¤ò»ØÄꤹ¤ë¡£¤¹¤Ê¤ï¤Á
-0 ¤Î
+の起点を同じくする絶対時間を指定する。すなわち
+0 の
.I "abstime"
-¤Ï 00:00:00 GMT, January 1, 1970 ¤ËÁêÅö¤¹¤ë¡£
+は 00:00:00 GMT, January 1, 1970 に相当する。
.\" .B "pthread_cond_destroy"
.\" destroys a condition variable, freeing the
.\" the condition has no waiting threads.
.B "pthread_cond_destroy"
-¤Ï¾ò·ïÊÑ¿ô¤òÇ˲õ¤·¡¢¤½¤ì¤¬ÊÝ»ý¤·¤Æ¤¤¤ë²ÄǽÀ¤Î¤¢¤ë»ñ¸»¤ò³«Êü¤¹¤ë¡£
+は条件変数を破壊し、それが保持している可能性のある資源を開放する。
.BR "pthread_cond_destroy"
-¤Î³«»Ï»þÅÀ¤Ç¡¢¤¤¤«¤Ê¤ë¥¹¥ì¥Ã¥É¤â¤½¤Î¾ò·ïÊÑ¿ô¤òÂԤäƤ¤¤Æ¤Ï¤¤¤±¤Ê¤¤¡£
-LinuxThreads ¤Î¼ÂÁõ¤Ç¤Ï¡¢¤¤¤«¤Ê¤ë»ñ¸»¤â¾ò·ïÊÑ¿ô¤ËÉտ路¤Æ¤¤¤Ê¤¤¡£
-½¾¤Ã¤Æ¡¢
+の開始時点で、いかなるスレッドもその条件変数を待っていてはいけない。
+LinuxThreads の実装では、いかなる資源も条件変数に付随していない。
+従って、
.B "pthread_cond_destroy"
-¤Ï¡¢¾ò·ï¤¬ÂÔµ¡¥¹¥ì¥Ã¥É¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¤³¤È¤ò³Î¤«¤á¤ë°Ê³°¤Ë
-²¿¤â¤·¤Ê¤¤¡£
+は、条件が待機スレッドを持っていないことを確かめる以外に
+何もしない。
.\" .SH CANCELLATION
.\" .B "pthread_cond_wait"
.\" .I "mutex"
.\" is locked when
.\" they are called.
-.SH ¼è¤ê¾Ã¤·
+.SH 取り消し
.B "pthread_cond_wait"
-¤ª¤è¤Ó
+および
.B "pthread_cond_timedwait"
-¤Ï¡¢¼è¤ê¾Ã¤·¥Ý¥¤¥ó¥È¤Ç¤¢¤ë¡£¤³¤Î¤¤¤º¤ì¤«¤Î´Ø¿ô¤ÇÄä»ß¤·¤Æ¤¤¤ë
-¥¹¥ì¥Ã¥É¤¬¼è¤ê¾Ã¤µ¤ì¤ë¤È¡¢¥¹¥ì¥Ã¥É¤Ïľ¤Á¤Ë¼Â¹Ô¤òºÆ³«¤·¡¢
+は、取り消しポイントである。このいずれかの関数で停止している
+スレッドが取り消されると、スレッドは直ちに実行を再開し、
.B "pthread_cond_wait"
-¤È
+と
.BR "pthread_cond_timedwait"
-¤Î
+の
.I "mutex"
-°ú¿ô¤òºÆ¥í¥Ã¥¯¤·¡¢ºÇ¸å¤Ë¼è¤ê¾Ã¤·¤ò¼Â¹Ô¤¹¤ë¡£
-·ë²Ì¤È¤·¤Æ¡¢¥¯¥ê¡¼¥ó¥¢¥Ã¥×¥Ï¥ó¥É¥é¤¬¸Æ¤Ó½Ð¤µ¤ì¤ëºÝ¤Ë
+引数を再ロックし、最後に取り消しを実行する。
+結果として、クリーンアップハンドラが呼び出される際に
.I "mutex"
-¤¬¥í¥Ã¥¯¤µ¤ì¤Æ¤¤¤ë¤³¤È¤òÊݾڤµ¤ì¤ë¡£
+がロックされていることを保証される。
.\" .SH "ASYNC-SIGNAL SAFETY"
.\" The condition functions are not async-signal safe, and should not be
.\" .B "pthread_cond_broadcast"
.\" from a signal
.\" handler may deadlock the calling thread.
-.SH ÈóƱ´ü¥·¥°¥Ê¥ë¤ËÂФ¹¤ë°ÂÁ´À
+.SH 非同期シグナルに対する安全性
-¾ò·ï´Ø¿ô¤ÏÈóƱ´ü¥·¥°¥Ê¥ë¤ËÂФ·¤Æ°ÂÁ´¤Ç¤Ï¤Ê¤¤¡£¤è¤Ã¤Æ¡¢
-¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤«¤é¸Æ¤Ó½Ð¤¹¤Ù¤¤Ç¤Ï¤Ê¤¤¡£Æäˡ¢
+条件関数は非同期シグナルに対して安全ではない。よって、
+シグナルハンドラから呼び出すべきではない。特に、
.B "pthread_cond_signal"
-¤Þ¤¿¤Ï
+または
.B "pthread_cond_broadcast"
-¤Î¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤«¤é¤Î¸Æ¤Ó½Ð¤·¤Ï¡¢¸Æ¤Ó½Ð¤·¥¹¥ì¥Ã¥É¤ò
-¥Ç¥Ã¥É¥í¥Ã¥¯¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£
+のシグナルハンドラからの呼び出しは、呼び出しスレッドを
+デッドロックする可能性がある。
.\" .SH "RETURN VALUE"
.\" All condition variable functions return 0 on success and a non-zero
.\" error code on error.
-.SH ÊÖ¤êÃÍ
+.SH 返り値
-Á´¤Æ¤Î¾ò·ïÊÑ¿ô´Ø¿ô¤Ï¡¢À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤·¡¢¥¨¥é¡¼¤Ê¤é¤ÐÈó¥¼¥í¤Î
-¥¨¥é¡¼¥³¡¼¥É¤òÊÖ¤¹¡£
+全ての条件変数関数は、成功すると 0 を返し、エラーならば非ゼロの
+エラーコードを返す。
.\" .SH ERRORS
.\" .BR "pthread_cond_init" ,
.\" and
.\" .B "pthread_cond_wait"
.\" never return an error code.
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
.BR "pthread_cond_init" ,
.BR "pthread_cond_signal" ,
.BR "pthread_cond_broadcast" ,
-¤ª¤è¤Ó
+および
.B "pthread_cond_wait"
-¤Ï¡¢·è¤·¤Æ¥¨¥é¡¼¥³¡¼¥É¤òÊÖ¤µ¤Ê¤¤¡£
+は、決してエラーコードを返さない。
.\" The
.\" .B "pthread_cond_timedwait"
.\" the condition variable was not signaled until the timeout specified by
.\" .I "abstime"
.B "pthread_cond_timedwait"
-¤Ï¡¢¥¨¥é¡¼¤ËºÝ¤·¤Æ¼¡¤Î¥¨¥é¡¼¥³¡¼¥É¤òÊÖ¤¹:
+は、エラーに際して次のエラーコードを返す:
.RS
.TP
.B "ETIMEDOUT"
-¾ò·ïÊÑ¿ô¤¬
+条件変数が
.I "abstime"
-¤Ç»ØÄꤵ¤ì¤¿»þ¸Â¤Þ¤Ç¤ËÁ÷¿®¤µ¤ì¤Ê¤«¤Ã¤¿¡£
+で指定された時限までに送信されなかった。
.\" .TP
.\" .B "EINTR"
.TP
.B "EINTR"
.B "pthread_cond_timedwait"
-¤¬¥·¥°¥Ê¥ë¤Ë¤è¤Ã¤Æ³ä¤ê¹þ¤Þ¤ì¤¿¡£
+がシグナルによって割り込まれた。
.RE
.\" The
.\" .IR "cond" .
.\" .RE
.B "pthread_cond_destroy"
-´Ø¿ô¤Ï¡¢¥¨¥é¡¼¤ËºÝ¤·¤Æ¼¡¤Î¥¨¥é¡¼¥³¡¼¥É¤òÊÖ¤¹:
+関数は、エラーに際して次のエラーコードを返す:
.RS
.TP
.B "EBUSY"
-¤¤¤º¤ì¤«¤Î¥¹¥ì¥Ã¥É¤¬¸½ºß
+いずれかのスレッドが現在
.IR "cond"
-¤ËÂФ·¤ÆÂÔµ¡¤·¤Æ¤¤¤ë¡£
+に対して待機している。
.RE
.\" .SH AUTHOR
.\" .BR "pthread_mutex_unlock" (3),
.\" .BR "gettimeofday" (2),
.\" .BR "nanosleep" (2).
-.SH Ãø¼Ô
+.SH 著者
Xavier Leroy <Xavier.Leroy@inria.fr>
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR "pthread_condattr_init" (3),
.BR "pthread_mutex_lock" (3),
.BR "pthread_mutex_unlock" (3),
.\" .I "x"
.\" becomes greater than
.\" .IR "y" .
-.SH Îã
+.SH 例
-Æó¤Ä¤Î¶¦ÍÊÑ¿ô
+二つの共有変数
.I "x"
-¤È
+と
.IR "y"
-¤¬¤¢¤Ã¤Æ¡¢mutex
+があって、mutex
.IR "mut"
-¤Ë¤è¤êÊݸ¤ì¤Æ¤¤¤ë¤È¤·¤è¤¦¡£¹¹¤Ë¡¢¾ò·ïÊÑ¿ô
+により保護されているとしよう。更に、条件変数
.I "cond"
-¤¬¤¢¤Ã¤Æ¡¢
+があって、
.I "x"
-¤¬
+が
.IR "y"
-¤è¤êÂ礤¯¤Ê¤ì¤Ð¡¢Á÷¿®¤µ¤ì¤ë¤È¤·¤è¤¦¡£
+より大きくなれば、送信されるとしよう。
.RS
.ft 3
.\" .I "y"
.\" is performed as follows:
.I "x"
-¤¬
+が
.I "y"
-¤è¤êÂ礤¯¤Ê¤ë¤Þ¤ÇÂԤĤˤϡ¢
-¼¡¤Î¤è¤¦¤Ë¤¹¤ì¤ÐÎɤ¤:
+より大きくなるまで待つには、
+次のようにすれば良い:
.RS
.ft 3
while (x <= y) {
pthread_cond_wait(&cond, &mut);
}
-/* x ¤È y ¤ÎÁàºî */
+/* x と y の操作 */
pthread_mutex_unlock(&mut);
.ft
.LP
.\" .I "y"
.\" should signal the condition if needed:
.I "x"
-¤ò
+を
.I "y"
-¤è¤ê¤âÂ礤¯¤¹¤ë¤è¤¦¤Ê
+よりも大きくするような
.I "x"
-¤È
+と
.I "y"
-¤ÎÁàºî¤ÏɬÍפ˱þ¤¸¤Æ¡¢¾ò·ï¤òÁ÷¿®¤»¤Í¤Ð¤Ê¤é¤Ê¤¤:
+の操作は必要に応じて、条件を送信せねばならない:
.RS
.ft 3
.nf
.sp
pthread_mutex_lock(&mut);
-/* x ¤È y ¤òÊѹ¹¤¹¤ë */
+/* x と y を変更する */
if (x > y) pthread_cond_broadcast(&cond);
pthread_mutex_unlock(&mut);
.ft
.\" .BR "pthread_cond_broadcast" .
.\" In doubt, use
.\" .BR "pthread_cond_broadcast" .
-µ¯Æ°¤¹¤Ù¤¥¹¥ì¥Ã¥É¤¬ºÇÂç¸Â°ì¤Ä¤Ç¤¢¤ë¤³¤È¤¬³Î¼Â¤Ê¤é¤Ð
-(Î㤨¤Ð¡¢
+起動すべきスレッドが最大限一つであることが確実ならば
+(例えば、
.I "x"
-¤È
+と
.IR "y"
-¤òÄ̤¸¤Æ¸òή¤¹¤ë¥¹¥ì¥Ã¥É¤¬Æó¤Ä¤·¤«¤Ê¤¤¤Î¤Ê¤é¤Ð)¡¢
+を通じて交流するスレッドが二つしかないのならば)、
.B "pthread_cond_signal"
-¤ò
+を
.BR "pthread_cond_broadcast"
-¤Î¡¢¾¯¤·¤Ð¤«¤ê¸úΨŪ¤ÊÂåÂØʪ¤È¤·¤Æ»ÈÍѤǤ¤ë¡£
-µ¿Ìä¤Î¤¢¤ë¾ì¹ç¤Ë¤Ï
+の、少しばかり効率的な代替物として使用できる。
+疑問のある場合には
.BR "pthread_cond_broadcast"
-¤ò»ÈÍѤ»¤è¡£
+を使用せよ。
.\" To wait for
.\" .I "x"
.\" with a timeout of 5
.\" seconds, do:
.I "x"
-¤¬
+が
.I "y"
-¤è¤êÂ礤¯¤Ê¤ë¤Î¤ò¸ÞÉäλþ¸Â¤òÀߤ±¤ÆÂԤĤˤϼ¡¤Î¤è¤¦¤Ë¤¹¤ë:
+より大きくなるのを五秒の時限を設けて待つには次のようにする:
.\" .RS
.\" .ft 3
retcode = pthread_cond_timedwait(&cond, &mut, &timeout);
}
if (retcode == ETIMEDOUT) {
- /* ¥¿¥¤¥à¥¢¥¦¥È */
+ /* タイムアウト */
} else {
- /* x ¤È y ¤ÎÁàºî */
+ /* x と y の操作 */
}
pthread_mutex_unlock(&mut);
.ft
OSDN Git Service
