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        [email protected]  Linux man-pages 6.10            2024-07-23                   strsignal(3) 

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

HTML rendering created 2025-02-02 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.