Scroll to navigation

GSIGNAL(3) Linux Programmer's Manual GSIGNAL(3)

名前

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():
Since glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_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 である)。

属性

この節で使用されている用語の説明については、 attributes(7) を参照。

インターフェース 属性
gsignal() Thread safety MT-Safe
ssignal() Thread safety MT-Safe sigintr

準拠

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

関連項目

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

この文書について

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

2020-04-11