manページ  — SIGALTSTACK

sigaltstack – シグナルスタックコンテキストの設定や入手

ライブラリ 書式 解説 注 戻り値 エラー 関連項目 歴史

Standard C Library (libc, -lc)

#include <signal.h>

typedef struct sigaltstack {
        char    *ss_sp;
        size_t  ss_size;
        int     ss_flags;
} stack_t;

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

値 SIGSTKSZ は、代替スタック領域を割り当てる一般的なケースで使用する バイト数 / 文字数に定義されます。 代替スタックの割り当てには、一般的に以下のようなコードが使用されます。

if ((sigstk.ss_sp = malloc(SIGSTKSZ)) == NULL)
        /* error return */
sigstk.ss_size = SIGSTKSZ;
sigstk.ss_flags = 0;
if (sigaltstack(&sigstk,0) < 0)
        perror("sigaltstack");

デフォルトサイズ以外の特定量のスタックスペースを必要とする シグナルハンドラを使用するプログラムでは、別の方法が使用できます。 値 MINSIGSTKSZ は、代替スタックの実行にオペレーティングシステムが 必要とするバイト数 / 文字数に定義されています。 代替スタックのサイズを算出する場合は、プログラムでスタック要件に MINSIGSTKSZ を追加し、オペレーティングシステムのオーバヘッドを許容する必要があります。

シグナルスタックは、スタックの拡大傾向とアラインメント要件に従って 自動的に調整されます。 シグナルスタックは、ハードウェアで保護されることもされないこともあり、 通常のスタックのように自動的に ``拡大'' しません。 スタックがオーバフローし、スペースが保護されていない場合は、 予期せぬ結果となることがあります。

The sigaltstack function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

以下のうち 1 つが発生すると、 sigaltstack() システムコールは処理を失敗し、シグナルスタックコンテキストは変更されずに 残ります。

[EFAULT]
	ss か oss が、プロセスアドレス空間の有効な部分でないメモリを指しています。
[EINVAL]
	アクティブなスタックを無効にしようとしました。
[ENOMEM]
	代替スタック領域のサイズが MINSIGSTKSZ 以下になっています。

sigaltstack() の前バージョンである sigstack() システムコールは BSD 4.2 で登場しました。