1 .\" Copyright (c) 2008 Linux Foundation, written by Michael Kerrisk
2 .\" <mtk.manpages@gmail.com>
4 .\" %%%LICENSE_START(VERBATIM)
5 .\" Permission is granted to make and distribute verbatim copies of this
6 .\" manual provided the copyright notice and this permission notice are
7 .\" preserved on all copies.
9 .\" Permission is granted to copy and distribute modified versions of this
10 .\" manual under the conditions for verbatim copying, provided that the
11 .\" entire resulting derived work is distributed under the terms of a
12 .\" permission notice identical to this one.
14 .\" Since the Linux kernel and libraries are constantly changing, this
15 .\" manual page may be incorrect or out-of-date. The author(s) assume no
16 .\" responsibility for errors or omissions, or for damages resulting from
17 .\" the use of the information contained herein. The author(s) may not
18 .\" have taken the same level of care in the production of this manual,
19 .\" which is licensed free of charge, as they might when working
22 .\" Formatted or processed versions of this manual, if unaccompanied by
23 .\" the source, must acknowledge the copyright and authors of this work.
26 .\"*******************************************************************
28 .\" This file was generated with po4a. Translate the source file.
30 .\"*******************************************************************
32 .\" Japanese Version Copyright (c) 2012 Akihiro MOTOKI
33 .\" all rights reserved.
34 .\" Translated 2012-06-04, Akihiro MOTOKI <amotoki@gmail.com>
36 .TH PTHREAD_CLEANUP_PUSH_DEFER_NP 3 2008\-12\-04 Linux "Linux Programmer's Manual"
38 pthread_cleanup_push_defer_np, pthread_cleanup_pop_restore_np \-
39 cancelability type を保持したままでスレッドのキャンセルクリーンアップハンドラの push/pop を行う
42 \fB#include <pthread.h>\fP
44 \fBvoid pthread_cleanup_push_defer_np(void (*\fP\fIroutine\fP\fB)(void *),\fP
45 \fB void *\fP\fIarg\fP\fB);\fP
46 \fBvoid pthread_cleanup_pop_restore_np(int \fP\fIexecute\fP\fB);\fP
49 \fI\-pthread\fP を付けてコンパイルとリンクを行う。
51 これらの関数は \fBpthread_cleanup_push\fP(3) と \fBpthread_cleanup_pop\fP(3)
52 と同じだが、このページで説明する点が異なる。
54 \fBpthread_cleanup_push\fP(3) と同様に、
55 \fBpthread_cleanup_push_defer_np\fP() は \fIroutine\fP をそのスレッドの
56 クリーンアップハンドラのスタックに追加する。これに加えて、
57 \fBpthread_cleanup_push_defer_np\fP() は現在の cancelability type も
58 保存し、cancelability type は "deferred" に設定する
59 (\fBpthread_setcanceltype\fP(3) 参照)。
60 これにより、この関数が呼び出される前のスレッドの cancelability type が
61 "asynchronous" であったとしても、キャンセルクリーンアップが行われること
64 \fBpthread_cleanup_pop\fP(3) と同様に、
65 \fBpthread_cleanup_pop_restore_np\fP() はそのスレッドのキャンセル
66 クリーンアップハンドラのスタックから一番上にあるクリーンアップハンドラ
67 を取り出す。これに加えて、そのスレッドの cancelability type を、対応
68 する \fBpthread_cleanup_push_defer_np\fP() が呼ばれた時点の値に戻す。
70 呼び出し側では、これらの関数の呼び出しが同じ関数の中で対となり、かつ
71 文法的に同じネストレベル (nesting level) になることを保証しなければ
72 ならない。 \fBpthread_cleanup_push\fP(3) で説明されている他の制限も
79 pthread_cleanup_push_defer_np(routine, arg);
80 pthread_cleanup_pop_restore_np(execute);
84 と以下は等価である (但し、上の方がより簡潔で効率的である)。
86 .\" As far as I can see, LinuxThreads reverses the two substeps
87 .\" in the push and pop below.
92 pthread_cleanup_push(routine, arg);
93 pthread_setcanceltype(PTHREAD_CANCEL_DEFERRED, &oldtype);
95 pthread_setcanceltype(oldtype, NULL);
96 pthread_cleanup_pop(execute);
100 .\" Available since glibc 2.0
102 これらの関数は非標準の GNU による拡張である。
103 そのため、名前に "_np" (nonportable; 移植性がない) という接尾辞が
106 \fBpthread_cancel\fP(3), \fBpthread_cleanup_push\fP(3),
107 \fBpthread_setcancelstate\fP(3), \fBpthread_testcancel\fP(3), \fBpthreads\fP(7)
109 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
110 である。プロジェクトの説明とバグ報告に関する情報は
111 http://www.kernel.org/doc/man\-pages/ に書かれている。