sigset

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

sigset, sighold, sigrelse, sigignore - System V 版シグナル API  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <signal.h>

typedef typeof(void (int))  *sighandler_t;

[[deprecated]] sighandler_t sigset(int sig, sighandler_t disp);

[[deprecated]] int sighold(int sig);
[[deprecated]] int sigrelse(int sig);
[[deprecated]] int sigignore(int sig);

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

sigset(), sighold(), sigrelse(), sigignore():


    _XOPEN_SOURCE >= 500
 

説明

これらの関数は、昔ながらの System V 版シグナル API を使用しているプログラム に対して互換性のあるインターフェースを glibc で提供するものである。 この API は過去のものであり、新しいアプリケーションでは POSIX シグナル API (sigaction(2), sigprocmask(2) など) を使用すべきである。

関数 sigset() はシグナル sig のシグナルハンドラーの動作を変更する。 disp 引数には、シグナルハンドラー関数のアドレスか、 以下の定数のいずれか一つを指定できる。

SIG_DFL
sig の動作をデフォルトにリセットする。
SIG_IGN
sig を無視する。
SIG_HOLD
そのプロセスのシグナルマスクに sig を追加するが、 sig の動作は変更しない。

disp にシグナルハンドラーのアドレスが指定された場合、 シグナルハンドラーの実行中は、そのプロセスのシグナルマスクに sig が追加される。

disp に SIG_HOLD 以外の値が指定された場合、 そのプロセスのシグナルマスクから sig が削除される。

シグナル SIGKILL と SIGSTOP に対する動作は変更できない。

関数 sighold() は、呼び出し元プロセスのシグナルマスクに sig を追加する。

関数 sigrelse() は、呼び出し元プロセスのシグナルマスクから sig を削除する。

関数 sigignore() は、 sig の動作を SIG_IGN に設定する。  

返り値

sigset() は成功すると、 呼び出し前に sig がブロックされていた場合には SIG_HOLD を返し、 ブロックされていなかった場合には 変更前のそのシグナルの動作を返す。 エラーの場合、 sigset() は -1 を返し、 errno にエラーを示す値をセットする。 但し、以下の「バグ」の節も参照のこと。

関数 sighold(), sigrelse(), sigignore() は成功すると 0 を返す。エラーの場合、-1 を返し、 errno にエラーを示す値をセットする。  

エラー

sigset() に関しては、 sigaction(2) と sigprocmask(2) の「エラー」の節を参照。

sighold() と sigrelse() に関しては、 sigprocmask(2) の「エラー」の節を参照。

sigignore() に関しては、 sigaction(2) の「エラー」の節を参照。  

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
sigset(), sighold(), sigrelse(), sigignore() Thread safetyMT-Safe
 

標準規格

POSIX.1-2008.
sighandler_t
GNU. POSIX.1 uses the same type but without a typedef.
 

歴史

glibc 2.1. SVr4, POSIX.1-2001. POSIX.1-2008 marks these functions as obsolete, recommending the use of sigaction(2), sigprocmask(2), pthread_sigmask(3), and sigsuspend(2) instead.  

注意

関数 sigset() は信頼性のあるシグナル処理機構を提供する (sa_mask を 0 で sigaction(2) を呼び出したときと同様)。

System V では、関数 signal() が提供する処理機構は信頼性のないものである (sa_mask を SA_RESETHAND | SA_NODEFER として sigaction(2) を呼び出したときと同様)。 BSD では、 signal() は信頼性のある処理機構を提供する。 POSIX.1-2001 では、 signal() のこの点は規定しないままとなっている。 さらなる詳細については signal(2) を参照。

BSD と System V のどちらのシステムでも シグナルを待つために、 sigpause(3) という名前の関数が提供されているが、 この関数の引数は両方のシステムで異なる。 詳細は sigpause(3) を参照。  

バグ

Before glibc 2.2, sigset() did not unblock sig if disp was specified as a value other than SIG_HOLD.

Before glibc 2.5, sigset() does not correctly return the previous disposition of the signal in two cases. First, if disp is specified as SIG_HOLD, then a successful sigset() always returns SIG_HOLD. Instead, it should return the previous disposition of the signal (unless the signal was blocked, in which case SIG_HOLD should be returned). Second, if the signal is currently blocked, then the return value of a successful sigset() should be SIG_HOLD. Instead, the previous disposition of the signal is returned. These problems have been fixed since glibc 2.5.  

関連項目

kill(2), pause(2), sigaction(2), signal(2), sigprocmask(2), raise(3), sigpause(3), sigvec(3), signal(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
歴史
注意
バグ
関連項目

This document was created by man2html, using the manual pages.