名前

gsignal, ssignal -ソフトウェア・シグナル機能

書式

#include <signal.h>
typedef void (*sighandler_t)(int);
int gsignal(int signum );
sighandler_t ssignal(int signum , sighandler_t action );

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

説明

Linux ではこれらの関数を使用しないこと。過去に間違いがあり、Linux では gsignal() と ssignal() はそれぞれ raise(3) と signal(2) の別名になっている。

一方、System V 風のシステムでは、これらの関数で、従来の signal(2) や kill(2) の関数群とは完全に独立な、ソフトウェア・シグナリングを実現している。 ssignal() 関数は、番号 signum のソフトウェア・シグナルが gsignal() 関数を使って発生された時にとるべきアクションを定義する。 gsignal() の返り値は、一つ前に指定されていたアクション、もしくは SIG_DFL である。 gsignal() は以下のような動作を行う: signum に対してアクションが指定されていないか、アクション SIG_DFL が指定されていた場合、何もせずに 0 を返す。 signum に対してアクション SIG_IGN が指定されていた場合、何もせずに 1 を返す。それ以外の場合、アクションを SIG_DFL にリセットし、引き数に signum を指定してアクション関数を呼び出して、アクション関数の返り値を返す。 signum がとり得る値の範囲は実装により異なる (多くの場合 1〜15 か 1〜17 である)。

準拠

これらの関数は、AIX, DG/UX, HP-UX, SCO, Solaris, Tru64 で使用可能である。これらのシステムのほとんどで廃止されたことになっており、 Linux の libc および glibc では正しく実装されていない。 gsignal_r() と ssignal_r() が実装されているシステムもある。

関連項目

kill(2), signal(2), raise(3)

この文書について

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