#include <pthread.h>
int pthread_attr_setguardsize(pthread_attr_t *attr, size_t guardsize);
int pthread_attr_getguardsize(const pthread_attr_t *attr,
size_t *guardsize);
-pthread でコンパイルしてリンクする。
guardsize が 0 より大きい場合、 attr を使って新しく作成された各スレッドに対して、 システムはスレッドのスタックの末尾に少なくとも guardsize バイトの 追加領域を割り当てる。この追加領域はスタックに対するガード領域として 機能する (ただし「バグ」の節も参照)。
guardsize が 0 の場合、 attr を使って新しく作成されたスレッドはガード領域を持たない。
デフォルトの guard size はシステムのページサイズと同じである。
(pthread_attr_setstack(3) や pthread_attr_setstackaddr(3)を使って) attr でスタックアドレス属性が設定されている場合には、呼び出し側がそ のスレッドのスタックを割り当てていることを意味するので、guard size 属性 は無視される (すなわち、システムによるガード領域の作成は行われない)。 この場合、スタックオーバーフローが起こらないように対処するのはアプリ ケーション側の責任となる (おそらく mprotect(2) を使って、割り当て られたスタックの最後に手動でガード領域を定義することになるだろう)。
pthread_attr_getguardsize() は、 スレッド属性オブジェクト attr の guard size 属性を guardsize が指すバッファーに入れて返す。
| インターフェース | 属性 | 値 |
| pthread_attr_setguardsize(), pthread_attr_getguardsize() | Thread safety | MT-Safe |
多くのスレッドを作成するアプリケーションで、かつ、スタックオーバーフロー が決して発生しないことが分かっている場合には、guard size を 0 に設定 することで、メモリーを節約できることもある。
スレッドがスタックに大きなデータ構造を割り当てる場合には、 スタックオーバーフローを検出するためには、デフォルトサイズよりも 大きな guard size を選ぶ必要があるかもしれない。
廃止予定の LinuxThreads 実装では、 POSIX.1 で求められている通りの動作で、 ガード領域がスタックの末尾に追加の領域が割り当てられる。
[man1]
[man2]
[man3]
[man4]
[man5]
[man6]
[man7]
[man8]
[a]
[b]
[c]
[d]
[e]
[f]
[g]
[h]
[i]
[j]
[k]
[l]
[m]
[n]
[o]
[p]
[q]
[r]
[s]
[t]
[u]
[v]
[w]
[x]
[y]
[z]