NAME

psignal, psiginfo, sys_siglist, sys_signame — system signal messages

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <signal.h>

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

psiginfo(const siginfo_t *si, 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 (sigaction(2)), the string “Unknown signal” is produced.

The psiginfo() function produces the same output as the psignal() function, only it uses the signal number information from the si argument.

The message strings can be accessed directly using the external array sys_siglist, indexed by recognized signal numbers. The external array sys_signame is used similarly and contains short, upper-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), setlocale(3), strsignal(3)

HISTORY

The psignal() function appeared in 4.2BSD. The psiginfo() function appeared in NetBSD 6.0.