home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | CONFORMING TO | SEE ALSO | COLOPHONThe Linux Programming Interface


STRSIGNAL(3)                  Linux Programmer's Manual                  STRSIGNAL(3)

NAME         top

       strsignal - return string describing signal

SYNOPSIS         top

       #include <string.h>

       char *strsignal(int sig);

       extern const char * const sys_siglist[];

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       strsignal():
           Since glibc 2.10:
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Before glibc 2.10:
               _GNU_SOURCE

DESCRIPTION         top

       The strsignal() function returns a string describing the signal number passed
       in the argument sig.  The string can only be used until the next call to
       strsignal().

       The array sys_siglist holds the signal description strings indexed by signal
       number.  The strsignal() function should be used if possible instead of this
       array.

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), a NULL pointer may be returned instead for an invalid signal
       number.

CONFORMING TO         top

       POSIX.1-2008.  Present on Solaris and the BSDs.

SEE ALSO         top

       psignal(3), strerror(3)

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

GNU                                   2010-09-15                         STRSIGNAL(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable counter