This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

PSIGNAL(3)               BSD Library Functions Manual               PSIGNAL(3)

NAME
     psignal, strsignal, sys_siglist, sys_signame -- system signal messages

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <signal.h>

     void
     psignal(unsigned sig, const char *s);

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

     #include <string.h>

     char *
     strsignal(int sig);

DESCRIPTION
     The psignal() and strsignal() functions locate the descriptive message string for a signal number.

     The strsignal() function accepts a signal number argument sig and returns a pointer to the correspond-ing corresponding
     ing message string.

     The psignal() function accepts a signal number argument sig and writes it to the standard error.  If
     the argument s is non-NULL and does not point to the null character, s is written to the standard error
     file descriptor prior to the message string, immediately followed by a colon and a space.  If the sig-nal signal
     nal number is not recognized (sigaction(2)), the string ``Unknown signal'' is produced.

     The message strings can be accessed directly through the external array sys_siglist, indexed by recog-nized recognized
     nized signal numbers.  The external array sys_signame is used similarly and contains short, lower-case
     abbreviations for signals which are useful for recognizing signal names in user input.  The defined
     variable NSIG contains a count of the strings in sys_siglist and sys_signame.

SEE ALSO
     sigaction(2), perror(3), strerror(3)

HISTORY
     The psignal() function appeared in 4.2BSD.

BSD                            February 27, 1995                           BSD