SIGALTSTACK

名前

書式

int sigaltstack(const stack_t *ss, stack_t *oss);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

sigaltstack(): _BSD_SOURCE || _XOPEN_SOURCE >= 500  

説明

代替シグナルスタックを使う際の一般的な手順は、以下の通りである:

1.

代替シグナルスタックで使うメモリ領域を確保する。

2.

sigaltstack() を使って、 代替シグナルスタックの存在と場所をシステムに知らせる。

3.

sigaction(2) を使ってシグナルハンドラを確立する際、 SA_ONSTACK フラグを指定することにより、 そのシグナルハンドラを代替シグナルスタック上で実行することを システムに知らせる。 ss 引き数は、新しいシグナルスタックを指定するために使う。 また oss 引き数は、現在確立されている シグナルスタックの情報を取得するために使う。 この操作のうち 1 つだけを実行させるには、 使用しない引き数を NULL に指定すればよい。 引き数となる構造体は、以下のような型である:

typedef struct {
    void  *ss_sp;     /* スタックのベースアドレス */
    int    ss_flags;  /* フラグ */
    size_t ss_size;   /* スタックのバイト数 */
} stack_t;

新規の代替シグナルスタックを確立するには、 ss.ss_flags を 0 に設定し、 ss.ss_sp と ss.ss_size に スタックの開始アドレスとスタックサイズを指定する。 定数 SIGSTKSZ は、代替シグナルスタックが通常必要する サイズよりも充分大きく定義されている。 また定数 MINSIGSTKSZ は、 シグナルハンドラの実行に必要な最小サイズに定義されている。

代替スタックでシグナルハンドラが起動された場合には、 カーネルにより自動的に、ss.ss_sp で指定されたアドレスは 動作しているハードウェアアーキテクチャに適したアドレス境界に 調整される。

既存のスタックを無効にするには、 ss.ss_flags を SS_DISABLE に指定する。 この場合、ss の他のフィールドは無視される。

oss が NULL 以外の場合、 oss に代替シグナルスタックの情報が返される。 これは (実質的に) sigaltstack() の呼び出しより先に行われる。 oss.ss_sp と oss.ss_size フィールドに スタックの開始アドレスとスタックサイズが返される。 oss.ss_flags には以下のどちらかの値が返される:

SS_ONSTACK

プロセスが代替シグナルスタック上で実行されている (プロセスが既にそのシグナルスタック上で実行されている場合は、 それと同じシグナルスタックには変更できない点に注意すること)。

SS_DISABLE

代替シグナルスタックが現在無効になっている。

返り値

エラー

EFAULT

ss または oss のどちらが、NULL 以外で、 かつプロセスのアドレス空間の外を指している。

EINVAL

ss が NULL 以外で、ss_flags フィールドが SS_DISABLE 以外の 0 でない値になっている。

ENOMEM

新しい代替シグナルスタック (ss.ss_size) に指定したサイズが MINSTKSZ より小さい。

EPERM

代替シグナルスタックが有効であるときに変更を行おうとした (つまり、プロセスが既に現在の代替シグナルスタック上で実行されていた)。

準拠

注意

歴史

例

stack_t ss;

ss.ss_sp = malloc(SIGSTKSZ);
if (ss.ss_sp == NULL)
    /* ハンドルエラー */;
ss.ss_size = SIGSTKSZ;
ss.ss_flags = 0;
if (sigaltstack(&ss, NULL) == -1)
    /* ハンドルエラー */;

関連項目

Index

名前

書式

説明

返り値

エラー

準拠

注意

歴史

例

関連項目