PSIGNAL(3)                     Library Routines                     PSIGNAL(3)

NAME

       psignal, sys_siglist, sys_signame - system signal messages

SYNOPSIS

       #include <sys/signal.h>

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

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

DESCRIPTION

       The  psignal  function  locates  the descriptive message string for the
       given signal number sig and writes it to the standard error.

       If the argument s is non-NULL, it is written to the standard error file
       descriptor prior to the message string, immediately followed by a colon
       and a space.  If the  signal  number  is  not  recognized  (see  sigac����
       tion(2)), the string Unknown signal is produced.

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

SEE ALSO

       sigaction(2), perror(3)

HISTORY

       The psignal function appeared in 4.2BSD.



GNO                              27 July 1997                       PSIGNAL(3)