PTHREAD_SETCANCELSTATE

名前

書式

#include <pthread.h>

int pthread_setcancelstate(int state, int *oldstate);
int pthread_setcanceltype(int type, int *oldtype);

-pthread でコンパイルしてリンクする。

説明

PTHREAD_CANCEL_ENABLE

スレッドは取り消し可能 (cancelable) である。 これが全ての新しく作成されるスレッドでのデフォルトの cancelability state である。これには最初のスレッドも含まれる。 スレッドの cancelability type により、取り消し可能なスレッドが 取り消し要求にいつ反応するかが決まる。

PTHREAD_CANCEL_DISABLE

スレッドは取り消しできない。取り消し要求を受信した際は、 取り消し可能に設定されるまでその要求はブロックされる。

pthread_setcanceltype() は、呼び出したスレッドの cancelability type に type で指定された値を設定する。 変更前のスレッドの cancelability type は oldtype が指すバッファーで返される。 type 引数には以下の値のいずれか一つを指定しなければならない。

PTHREAD_CANCEL_DEFERRED

そのスレッドが次に取り消しポイント (cancellation point) の関数を 呼び出すまで取り消し要求が遅延される。これが全ての新しく作成される スレッドでのデフォルトの cancelability type である。 これには最初のスレッドも含まれる。

Even with deferred cancellation, a cancellation point in an asynchronous signal handler may still be acted upon and the effect is as if it was an asynchronous cancellation.

PTHREAD_CANCEL_ASYNCHRONOUS

スレッドはいつでも取り消すことができる (通常はすぐにキャンセルされるが、 システムがそのことを保証しているわけではない)。

これらの関数により実行される「設定と取得」操作 (set-and-get operation) は、 同じ関数を呼び出したプロセス内の他のスレッドがあっても、 アトミックに行われる。  

返り値

エラー

EINVAL

state に無効な値が指定された。

pthread_setcanceltype() は以下のエラーで失敗する場合がある。

EINVAL

type に無効な値が指定された。

属性

準拠

注意

取り消し要求により中断されてはならない重要なアクションをスレッドが 実行する場合、短い時間だけ cancelability を無効にするのは有用である。 長い時間 cancelability を無効にしたり、長い時間停止 (block) される 可能性のある操作の前後で cancelability を無効にしたりする際には 注意すること。なぜなら、無効にしてしまうと、キャンセル要求に対して スレッドが応答しない状態になってしまうからである。  

非同期キャンセル

非同期で安全にキャンセルできる関数は async-cancel-safe functions と呼ばれる。 POSIX.1-2001 と POSIX.1-2008 で、非同期で安全にキャンセルできるように求められている関数は pthread_cancel(3), pthread_setcancelstate(), pthread_setcanceltype() だけである。 一般的には、それ以外のライブラリ関数は、非同期にキャンセルできるスレッドから安全に呼び出すことはできない。

非同期でのキャンセルが有効な数少ない状況としては、純粋に計算だけを行うループに入っているスレッドをキャンセルするといった場面がある。  

移植性に関する注意

例

関連項目

この文書について

Index

名前

書式

説明

返り値

エラー

属性

準拠

注意

非同期キャンセル

移植性に関する注意

例

関連項目

この文書について