psignal

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

名前

psignal, psiginfo - シグナルの説明を表示する  

ライブラリ

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

書式

#include <signal.h>

void psignal(int sig, const char *s);
void psiginfo(const siginfo_t *pinfo, const char *s);

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

psignal():

    Since glibc 2.19:
            _DEFAULT_SOURCE
    glibc 2.19 and earlier:
        _BSD_SOURCE || _SVID_SOURCE

psiginfo():

    _POSIX_C_SOURCE >= 200809L
 

説明

psignal() 関数は、文字列 s、コロン、スペース、シグナル番号 sig を説明する文字列、終端の改行から構成されるメッセージを stderr に表示する。 文字列 s が NULL か空の場合、コロンとスペースは省略される。 sig が不正ならば、表示される メッセージは未知のシグナルを示す。

psiginfo() 関数は psignal() と同じだが、 pinfo に書かれたシグナルの情報を表示する点が異なる。 pinfo は有効な siginfo_t 構造体を指している必要がある。 psiginfo() は、 シグナルの説明だけでなく、 シグナルの送信元やそのシグナルに関連するその他の情報も表示する (例えば、ハードウェアが発生したシグナルの関連メモリーアドレス、 SIGCHLD の子プロセス ID、 kill(2) や sigqueue(3) を使って送信されたシグナルの送信元プロセスのユーザー ID とプロセス ID など)。  

返り値

関数 psignal() と psiginfo() は、値を返さない。  

属性

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

標準規格

POSIX.1-2008.  

歴史

glibc 2.10. POSIX.1-2008, 4.3BSD.  

バグ

Up to glibc 2.12, psiginfo() had the following bugs:
•
特定の状況で、末尾の改行が出力されない。
•
リアルタイムシグナルの場合に、追加の詳細情報が表示されない。
 

関連項目

sigaction(2), perror(3), strsignal(3), signal(7)


 

Index

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

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