| SIGNAL(2) | Linux Programmer's Manual | SIGNAL(2) |
名前¶
signal - ANSI C シグナル操作
書式¶
#include <signal.h>
typedef void (*sighandler_t)(int);
sighandler_t signal(int signum, sighandler_t sighandler);
説明¶
signal() の動作は Unix のバージョンにより異なる。 また、歴史的に見て Linux のバージョンによっても異なっている。 このシステムコールの使用は避け、 代わりに sigaction(2) を使用すること。 下記の「移植性」を参照。
signal() はシグナル signum の処理方法を handler に設定する。 handler には、 SIG_IGN、 SIG_DFL、 プログラマが定義した関数 (「シグナル・ハンドラ」) のアドレスの いずれかを指定する。
シグナル signum がプロセスに配送されると、以下のいずれかが発生する。
- *
- 処理方法が SIG_IGN に設定されている場合、そのシグナルは無視される。
- *
- 処理方法が SIG_DFL に設定されている場合、シグナルに関連づけられた デフォルトの動作が行われる (signal(7) 参照)。
- *
- 処理方法として関数が設定されている場合、 まず最初に処理方法が SIG_DFL にリセットされるかそのシグナルのブロックが実行された後、 signum を引き数として handler が呼び出される。 ハンドラが起動される際にシグナルがブロックされた場合、 ハンドラが返る際にそのシグナルのブロックが解除される。
シグナル SIGKILL と SIGSTOP は捕捉できず、無視することもできない。
返り値¶
signal() は、今までのシグナル・ハンドラの値を返す。エラーの場合は SIG_ERR を返す。
エラー¶
- EINVAL
- signum が不正である。
準拠¶
C89, C99, POSIX.1-2001.
注意¶
マルチスレッドプロセスにおける signal() の結果は、指定されていない。
POSIX によると、 kill(2) や raise(3) で生成できない SIGFPE, SIGILL, SIGSEGV シグナルを無視した後の動作は未定義である。 0 による整数割り算の結果は未定義となる。 ある種のアーキテクチャでは、これは SIGFPE シグナルを生成する。 (同様に負の最大整数を -1 で割ると SIGFPE が生成されるかもしれない。) このシグナルを無視すると無限ループに陥るかもしれない。
SIGCHLD の動作として SIG_IGN を設定した場合の詳細な動作については、 sigaction(2) を参照すること。
シグナル・ハンドラ内から安全に呼び出すことができる、 async-signal-safe functions (非同期シングルで安全な関数) の リストについては signal(7) を参照。
sighandler_t の使用は GNU
拡張である。
各種バージョンの libc
でこの型は定義済みである;
libc4 と libc5 では SignalHandler
を定義している。 glibc
では sig_t
を定義しており、
_GNU_SOURCE
が定義されている場合には
sighandler_t
も定義されている。
このような型を使用しないと、
signal()
の宣言は読みにくいものとなる。
void ( *signal(int signum, void (*handler)(int)) ) (int);
移植性¶
移植性のある signal() の使い方は、シグナルの処理方法を SIG_DFL か SIG_IGN に設定する方法だけである。 シグナル・ハンドラを設定するのに signal() を使ったときの動作はシステムにより異なる (POSIX.1 は明示的にこの違いを認めている)。 移植性が必要なときはこのシステムコールを使用しないこと。
POSIX.1 は、 sigaction(2) を規定することで移植性に関する混乱を解決した。 sigaction(2) はシグナル・ハンドラが起動される際の挙動を明示的に制御できる。 signal() の代わりにこのインターフェイスを使うこと。
オリジナルの Unix システムでは、 signal() を使って設定されたハンドラがシグナルの配送により起動されると、 そのシグナルの処理方法は SIG_DFL にリセットされ、システムは同じシグナルがさらに生成されても シグナルの配送をブロックしなかった。 System V でも、 signal() に対してこれらの挙動を規定している。 こうした挙動はまずく、ハンドラがハンドラ自身を再設定する機会が 来るより前に、同じシグナルがまた配送される可能性がある。 さらに、同じシグナルが立て続けに配送されると、同じシグナルが ハンドラを繰り返し起動されることになる。
BSD では、シグナル処理の挙動を変更することで、この状況を改善した (しかし、残念なことに、 signal() を使ってハンドラを設定する際に挙動が黙って変更される)。 BSD では、シグナルハンドラが起動された際、 シグナルの処理方法はリセットされず、 ハンドラの実行中は、同じシグナルのさらなる生成は配送がブロックされる。
Linux での状況は以下の通りである。
- カーネルの signal() システムコールは System V 方式を提供している。
- デフォルトでは、glibc 2
以降では、 signal()
ラッパー関数はカーネルのシステムコールを起動しない。
代わりに、ラッパー関数は
BSD
方式を示すフラグを使って
sigaction(2) を呼び出す。
機能検査マクロ
_BSD_SOURCE
を定義していれば、このデフォルトの動作となる。
デフォルトでは、
_BSD_SOURCE
が定義される。
_BSD_SOURCE は _GNU_SOURCE
が定義された場合には暗黙のうちに定義され、
もちろん明示的に定義することもできる。
glibc 2 以降では、機能検査マクロ _BSD_SOURCE が定義されていなければ、 signal() は System V 方式となる。 (gcc(1) が標準指定モード (-std=xxx or -ansi) で起動された場合、もしくは _POSIX_SOURCE, _XOPEN_SOURCE, _SVID_SOURCE といった他の様々な機能検査マクロが定義された場合、 デフォルトの _BSD_SOURCE の暗黙の定義は行われない。 feature_test_macros(7) を参照のこと。)
- Linux の libc4 と libc5 の signal() 関数は System V 方式である。 libc5 システムにおいて <signal.h> のかわりに <bsd/signal.h> をインクルードすると、 signal() は __bsd_signal() に再定義され、 signal() は BSD 方式となる。
関連項目¶
kill(1), alarm(2), kill(2), killpg(2), pause(2), sigaction(2), signalfd(2), sigpending(2), sigprocmask(2), sigqueue(2), sigsuspend(2), bsd_signal(3), raise(3), siginterrupt(3), sigsetops(3), sigvec(3), sysv_signal(3), feature_test_macros(7), signal(7)
| 2008-07-11 | Linux |