---

strsignal(3) — Linux manual page

strsignal(3) Library Functions Manual strsignal(3)

NAME top

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

LIBRARY top

 Standard C library (libc, -lc)

SYNOPSIS top

 #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[];
 Feature Test Macro Requirements for glibc (see
 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

DESCRIPTION top

 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.

RETURN VALUE top

 The strsignal() function returns the appropriate description
 string, or an unknown signal message if the signal number is
 invalid. On some systems (but not on Linux), NULL may instead be
 returned for an invalid signal number.
 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 top

 For an explanation of the terms used in this section, see
 attributes(7).
 ┌────────────────┬───────────────┬───────────────────────────────┐
 │ Interface │ Attribute │ Value │
 ├────────────────┼───────────────┼───────────────────────────────┤
 │ strsignal() │ Thread safety │ MT-Unsafe race:strsignal │
 │ │ │ locale │
 ├────────────────┼───────────────┼───────────────────────────────┤
 │ sigdescr_np(), │ Thread safety │ MT-Safe │
 │ sigabbrev_np() │ │ │
 └────────────────┴───────────────┴───────────────────────────────┘

STANDARDS top

 strsignal()
 POSIX.1-2008.
 sigdescr_np()
 sigabbrev_np()
 GNU.
 sys_siglist
 None.

HISTORY top

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

NOTES top

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

SEE ALSO top

 psignal(3), strerror(3)

COLOPHON top

 This page is part of the man-pages (Linux kernel and C library
 user-space interface documentation) project. Information about
 the project can be found at 
 ⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report
 for this manual page, see
 ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
 This page was obtained from the tarball man-pages-6.10.tar.gz
 fetched from
 ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
 2025年02月02日. If you discover any rendering problems in this HTML
 version of the page, or you believe there is a better or more up-
 to-date source for the page, or you have corrections or
 improvements to the information in this COLOPHON (which is not
 part of the original manual page), send a mail to
 man-pages@man7.org
Linux man-pages 6.10 2024年07月23日 strsignal(3)

---

Pages that refer to this page: psignal(3), strerror(3), signal(7)

---

---

---