Scroll to navigation

SIGACTION(2) Linux Programmer's Manual SIGACTION(2)

名前

sigaction - シグナルの動作の確認と変更

書式

#include <signal.h>

int sigaction(int signum, const struct sigaction *act,
              struct sigaction *oldact);


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

sigaction(): _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE

siginfo_t: _POSIX_C_SOURCE >= 199309L

説明

sigaction() システムコールは、特定のシグナルを受信した際の プロセスの動作を変更するのに使用される (シグナルの概要については signal(7) を参照)。

signum には、 SIGKILLSIGSTOP 以外の有効なシグナルをどれでも指定できる。

act が NULL 以外であれば、シグナル signum の新しい動作 (action) として act が設定される。 oldact が NULL でなければ、今までの動作が oldact に格納される。

sigaction 構造体は以下のような感じに定義される。


struct sigaction {

void (*sa_handler)(int);
void (*sa_sigaction)(int, siginfo_t *, void *);
sigset_t sa_mask;
int sa_flags;
void (*sa_restorer)(void); };

アーキテクチャによっては共用体 (union) が用いられており、その場合には sa_handlersa_sigaction の両方を同時に割り当てることはできない。

sa_restorer 要素は廃止予定であり使用すべきではない。 POSIX には sa_restorer 要素に関する規定はない。

sa_handlersignum に対応する動作を指定するもので、 デフォルトの動作を行う SIG_DFL、 そのシグナルを無視する SIG_IGN、 シグナルハンドラ関数へのポインタが設定できる。 シグナルハンドラ関数の引き数は一つであり、シグナル番号が引き数として 渡される。

sa_flagsSA_SIGINFO が指定された場合、 (sa_handler ではなく) sa_sigaction により signum に対応するシグナルハンドラ関数が指定さ れる。指定される関数は、最初の引き数としてシグナル番号を、二番目の引き 数として siginfo_t へのポインタを、三番目の引き数として (void * にキャストした) ucontext_t へのポインタを受けとる。 (一般的には、 ハンドラ関数の三番目の引き数が使用されない。ucontext_t についての 詳しい情報は getcontext(3) を参照。)

sa_mask は、シグナル・ハンドラ実行中に禁止 (block) すべきシグナルのマスクを指定する (ハンドラ実行中のシグナルの禁止は、シグナル・ハンドラが起動されたスレッド のシグナルのマスクに追加することで行われる)。 さらに、 SA_NODEFER フラグが指定されていない場合は、ハンドラを起動するきっかけとなる シグナルにも sa_mask が適用される。

sa_flags はシグナル・ハンドラの動作を変更するためのフラグの集合を指定する。 sa_flags には、以下に示すフラグの (0 個以上の) 論理和をとったものを指定する。

signumSIGCHLD の場合、 子プロセスが停止したり (子プロセスが SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU を受けたとき) 再開したり (子プロセスが SIGCONT を受けたとき) したときに SIGCHLD の通知を受けない。 このフラグは、 SIGCHLD に対してハンドラを設定する際にのみ意味を持つ。
(Linux 2.6 以降) signumSIGCHLD の場合、子プロセスが終了したときに 子プロセスをゾンビプロセスに変化させない (waitpid(2) も参照)。 このフラグは、 SIGCHLD に対してハンドラを設定する際、もしくはそのシグナルの処理方法を SIG_DFL に設定する際にのみ意味を持つ。

SIGCHLD に対してハンドラを設定する際に SA_NOCLDWAIT フラグをセットした場合、 子プロセスが終了した際に SIGCHLD シグナルが生成されるかどうかは、 POSIX.1 では規定されていない。 Linux では、この状況で SIGCHLD シグナルは生成される。 いくつかの他の実装では生成されない。

それ自身のシグナル・ハンドラーの内部にいる時でも そのシグナルをマスクしないようにする。 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。 SA_NOMASK はこのフラグと同じ意味だが、廃止されており、非標準である。
sigaltstack(2) で提供される別のシグナル・スタックでシグナルハンドラを呼び出す。 別のシグナル・スタックが利用可能でなければ、デフォルトのスタックが 使用される。 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。
シグナルハンドラを設定する際に、シグナルの動作をデフォルトに戻す。 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。 SA_ONESHOT はこのフラグと同じ意味だが、廃止されており、非標準である。
いくつかのシステムコールをシグナルの通知の前後で再開できるようにして、 BSD シグナル方式 (semantics) と互換性のある動作を提供する。 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。 signal(7) に書かれているシステムコールの再開に関する議論を参照のこと。
シグナルハンドラは一つではなく、三つの引き数を持つ。この場合は sa_handler のかわりに sa_sigaction を設定しなければならない このフラグはシグナルハンドラを設定する際にのみ意味を持つ。

sa_sigaction のパラメータ siginfo_t は以下の要素を持つ構造体である:


siginfo_t {

int si_signo; /* Signal number */
int si_errno; /* An errno value */
int si_code; /* Signal code */
int si_trapno; /* Trap number that caused
hardware-generated signal
(unused on most architectures) */
pid_t si_pid; /* Sending process ID */
uid_t si_uid; /* Real user ID of sending process */
int si_status; /* Exit value or signal */
clock_t si_utime; /* User time consumed */
clock_t si_stime; /* System time consumed */
sigval_t si_value; /* Signal value */
int si_int; /* POSIX.1b signal */
void *si_ptr; /* POSIX.1b signal */
int si_overrun; /* Timer overrun count; POSIX.1b timers */
int si_timerid; /* Timer ID; POSIX.1b timers */
void *si_addr; /* Memory location which caused fault */
long si_band; /* Band event (was int in
glibc 2.3.2 and earlier) */
int si_fd; /* File descriptor */
short si_addr_lsb; /* Least significant bit of address
(since Linux 2.6.32) */ }

si_signo, si_errno, si_code は全てのシグナルに対して定義されている (si_errno は Linux では一般的には使用されない)。 構造体の残りの部分は、共用体 (union) になっているかもしれない。 その場合は該当するシグナルにおいて意味のあるフィールドのみを読み込む ことができる。

  • Signals sent with kill(2) and sigqueue(3) fill in si_pid and si_uid. In addition, signals sent with sigqueue(3) fill in si_int and si_ptr with the values specified by the sender of the signal; see sigqueue(3) for more details.
  • POSIX.1b タイマ (Linux 2.6 以降) は si_overrunsi_timerid を 設定する。 si_timerid フィールドはカーネルがタイマを特定するのに 使用する内部 ID であり、 timer_create(2) が返すタイマ ID と同じではない。 si_overrun フィールドはタイマが回り切った回数である。 これは timer_getoverrun(2) の呼び出しで取得できる情報と同じである。 これらのフィールドは非標準で Linux による拡張である。
  • Signals sent for message queue notification (see the description of SIGEV_SIGNAL in mq_notify(3)) fill in si_int/si_ptr, with the sigev_value supplied to mq_notify(3); si_pid, with the process ID of the message sender; and si_uid, with the real user ID of the message sender.
  • SIGCHLDsi_pid, si_uid, si_status, si_utime, si_stime を設定し、子プロセスに関する情報を提供する。 si_pid フィールドは子プロセスのプロセス ID で、 si_uid フィールドは子プロセスの実ユーザ ID である。 si_stime フィールドには、 (si_codeCLD_EXITED の場合は) 子プロセスの終了ステータスが、それ以外の場合は状態が変化する原因と なったシグナル番号が格納される。 si_utimesi_stime には子プロセスが使用したユーザ CPU 時間とシ ステム CPU 時間がそれぞれ格納される。(getrusage(2)time(2) と 異なり) これらのフィールドには wait 待ちの子プロセスにより使用された時 間は含まれない。 2.6 より前と 2.6.27 以降のカーネルでは、 これらのフィー ルドに格納される CPU 時間の単位は sysconf(_SC_CLK_TCK) である。 2.6.27 より前の 2.6 系のカーネルでは、バグがあり、 これらのフィールドの CPU 時間の単位が (カーネルのコンフィグで指定される) システムの jiffy で あった (time(7) 参照)。
  • SIGILL, SIGFPE, SIGSEGV, SIGBUS, and SIGTRAP fill in si_addr with the address of the fault. On some architectures, these signals also fill in the si_trapno filed. Some suberrors of SIGBUS, in particular BUS_MCEERR_AO and BUS_MCEERR_AR, also fill in si_addr_lsb. This field indicates the least significant bit of the reported address and therefore the extent of the corruption. For example, if a full page was corrupted, si_addr_lsb contains log2(sysconf(_SC_PAGESIZE)). BUS_MCERR_* and si_addr_lsb are Linux-specific extensions.
  • SIGIO/SIGPOLL (the two names are synonyms on Linux) fills in si_band and si_fd. The si_band event is a bit mask containing the same values as are filled in the revents field by poll(2). The si_fd field indicates the file descriptor for which the I/O event occurred.

si_code は、そのシグナルが送信された理由を示す値である (ビットマスクではない)。 以下のリストに、どのシグナルの場合でも si_code に入りうる値を、シグナルが生成された理由とともに記載する。

kill(2)
カーネルにより送信された
sigqueue(3)
POSIX タイマが満了した
POSIX メッセージキューの状態が変化した (Linux 2.6.6 以降)。 mq_notify(3)参照。
非同期 IO (AIO) が完了した
Queued SIGIO (only in kernels up to Linux 2.2; from Linux 2.4 onward SIGIO/SIGPOLL fills in si_code as described below).
tkill(2) または tgkill(2) (Linux 2.4.19 以降)

SIGILL シグナルの場合、 si_code には以下の値を指定できる:

不正な命令コード (opcode)
不正なオペランド
不正なアドレッシングモード
不正なトラップ
特権が必要な命令コード (opcode)
特権が必要なレジスタ
コプロセッサのエラー
内部スタックエラー

SIGFPE シグナルの場合、 si_code には以下の値を指定できる:

整数の 0 による除算
整数のオーバーフロー
浮動小数点の 0 による除算
浮動小数点のオーバーフロー
浮動小数点のアンダーフロー
浮動小数点の不正確な演算結果 (inexact result)
浮動小数点の不正な操作
範囲外の添字 (subscript)

SIGSEGV シグナルの場合、 si_code には以下の値を指定できる:

オブジェクトにマッピングされていないアドレス
マッピングされたオブジェクトに対するアクセス許可がない

SIGBUS シグナルの場合、 si_code には以下の値を指定できる:

不正なアドレス・アライメント (alignment)
存在しない物理アドレス
オブジェクト固有のハードウェアエラー
Hardware memory error consumed on a machine check; action required.
Hardware memory error detected in process but not consumed; action optional.

SIGTRAP シグナルの場合、 si_code には以下の値を指定できる:

プロセスのブレークポイント
プロセスのトレース・トラップ
process taken branch trap
hardware breakpoint/watchpoint

SIGCHLD シグナルの場合、 si_code には以下の値を指定できる:

子プロセスが終了した (exited)
子プロセスが kill された
子プロセスが異常終了した
トレース対象の子プロセスがトラップを上げた
子プロセスが停止 (stop) した
停止していた子プロセスが再開した (Linux 2.6.9 以降)

SIGIO/SIGPOLL シグナルの場合、 si_code には以下の値を 指定できる:

入力データが利用可能
出力バッファが利用可能
入力メッセージが利用可能
I/O エラー
高優先の入力が利用可能
デバイスが接続されていない

返り値

sigaction() は成功すれば 0 を返し、エラーならば -1 を返す。

エラー

actoldact が指しているメモリが正しいプロセスのアドレス空間にない。
無効なシグナルが指定された。補足 (catch) したり無視したりできない シグナルである SIGKILLSIGSTOP に対する動作を変更しようとした場合にも発生する。

準拠

POSIX.1-2001, SVr4.

注意

fork(2) 経由で作成された子プロセスは、親プロセスのシグナルの処理方法の コピーを継承する。 execve(2) の前後で、ハンドラが設定されているシグナルの処理方法はデフォルトにリセットされ、 無視が設定されているシグナルの処理方法は変更されずそのままとなる。

POSIX では、 kill(2)raise(3) で生成できないシグナル SIGFPE, SIGILL, SIGSEGV を無視 (ignore) した場合、その後の動作は未定義である。 ゼロによる整数割り算の結果は未定義となる。 アーキテクチャーによっては、このとき SIGFPE シグナルが生成される。 (同様に負の最大整数を -1 で割ると SIGFPE が生成されるかもしれない) このシグナルを無視すると無限ループに陥るかもしれない。

POSIX.1-1990 では SIGCHLDSIG_IGN を設定することを認めていない。 POSIX.1-2001 では認められており、 SIGCHLD を無視することでゾンビプロセスの生成を防止することができる (wait(2) を参照)。 さらに、BSD と SystemV では SIGCHLD を無視した際の動作が異なっている。 そのため、完全に移植性がある方法で、終了した子プロセスがゾンビにならないこと を保証するには、 SIGCHLD シグナルを補足し、 wait(2) などを実行するしかない。

POSIX.1-1990 の仕様では SA_NOCLDSTOP のみが定義されている。 POSIX.1-2001 では SA_NOCLDWAIT, SA_RESETHAND, SA_NODEFER, SA_SIGINFO が追加された。 UNIX の古い実装で動かすアプリケーションで、 他の sa_flags フラグを使用すると移植性が下がる。

SA_RESETHAND フラグは SVr4 の同じ名前のフラグと互換性がある。

SA_NODEFER フラグは 1.3.9 以降のカーネルでは同じ名前の SVr4 のフラグと互換性がある。 ぞれ以前の Linux カーネルの実装では、このフラグを設定しているシグナル だけでなく、どのシグナルでも受けることを許していた (実際には sa_mask の設定により無効にできる)。

sigaction() の二番目の引き数に NULL を指定して呼び出すと、現在のシグナルハンドラを確認する ことができる。また、二番目と三番目の引き数を NULL にて呼び出すことで、 指定されたシグナルが現在のマシンで使えるかどうかチェックできる。

SIGKILLSIGSTOP を (sa_mask に指定して) 禁止することはできない。 禁止しようとしても黙って無視される。

シグナル集合の操作に関する詳細は sigsetops(3) を参照のこと。

シグナルハンドラ内から安全に呼び出すことができる、 async-signal-safe functions (非同期シングルで安全な関数) の リストについては signal(7) を参照。

非公式

SA_SIGINFO が導入される前は、 struct sigcontext 型の二番目の引き数と一緒に sa_handler を使用することで、 いくつかの追加の情報を入手することができた。 詳細については Linux カーネルソースの関連部分を見てほしい。 現在はこの使用法は廃止されている。

バグ

2.6.13 以前のカーネルでは、 sa_flagsSA_NODEFER を指定した場合、 ハンドラが実行中に配送されたシグナル自身がマスクされなくなるだけでなく、 sa_mask に指定されたシグナルもマスクされなくなる。 このバグは、カーネル 2.6.14 で修正された。

mprotect(2) 参照。

関連項目

kill(1), kill(2), killpg(2), pause(2), sigaltstack(2), signal(2), signalfd(2), sigpending(2), sigprocmask(2), sigsuspend(2), wait(2), raise(3), siginterrupt(3), sigqueue(3), sigsetops(3), sigvec(3), core(5), signal(7)

この文書について

この man ページは Linux man-pages プロジェクトのリリース 3.51 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。

2013-02-12 Linux