strsignal

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

名前

strsignal, sigabbrev_np, sigdescr_np, sys_siglist - return string describing signal  

ライブラリ

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

書式

#include <string.h>

char *strsignal(int sig);
const char *sigdescr_np(int sig);
const char *sigabbrev_np(int sig);

[[deprecated]] extern const char *const sys_siglist[];

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

sigabbrev_np(), sigdescr_np():

    _GNU_SOURCE

strsignal():

    From glibc 2.10 to glibc 2.31:
        _POSIX_C_SOURCE >= 200809L
    Before glibc 2.10:
        _GNU_SOURCE

sys_siglist:

    Since glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 and earlier:
        _BSD_SOURCE
 

説明

The strsignal() function returns a string describing the signal number passed in the argument sig. The string can be used only until the next call to strsignal(). The string returned by strsignal() is localized according to the LC_MESSAGES category in the current locale.

The sigdescr_np() function returns a string describing the signal number passed in the argument sig. Unlike strsignal() this string is not influenced by the current locale.

The sigabbrev_np() function returns the abbreviated name of the signal, sig. For example, given the value SIGINT, it returns the string "INT".

The (deprecated) array sys_siglist holds the signal description strings indexed by signal number. The strsignal() or the sigdescr_np() function should be used instead of this array; see also VERSIONS.  

返り値

strsignal() 関数は、シグナルの適切な説明を返す。 もしシグナル番号が不正な場合は、未知のシグナル (unknown signal) を示す メッセージを返す。 (Linux はそうではないが)不正なシグナル番号に対して、 NULL を返すシステムもある。

The sigdescr_np() and sigabbrev_np() functions return the appropriate description string. The returned string is statically allocated and valid for the lifetime of the program. These functions return NULL for an invalid signal number.  

属性

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

標準規格

strsignal()
POSIX.1-2008.
sigdescr_np()
sigabbrev_np()
GNU.
sys_siglist
なし。
 

歴史

strsignal()
POSIX.1-2008. Solaris, BSD.
sigdescr_np()
sigabbrev_np()
glibc 2.32.
sys_siglist
Removed in glibc 2.32.
 

注意

sigdescr_np() and sigabbrev_np() are thread-safe and async-signal-safe.  

関連項目

psignal(3), strerror(3)


 

Index

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

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