.\" Copyright (c) 1983, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)psignal.3	6.2 (Berkeley) 04/19/91
.\"
.Dd 
.Dt PSIGNAL 3
.Os BSD 4.2
.Sh NAME
.Nm psignal ,
.Nm sys_siglist
.Nd system signal messages
.Sh SYNOPSIS
.Fd #include <sys/signal.h>
.Ft void
.Fn psignal "unsigned sig" "const char *s"
.Vt extern char *sys_siglist[];
.Sh DESCRIPTION
The
.Fn psignal
function locates the descriptive message
string for the given signal
.Fa sig
number
and writes it to the
.Em stderr .
.Pp
If the argument
.Fa s
is
.Pf non- Dv NULL
it is written to the
.Em stderr
prior to the message string.
The signal number should be from among those found in
.Aq Pa signal.h .
.Pp
The message strings can be accessed directly
using the external character array
.Va sys_siglist .
The defined variable
.Dv NSIG
contains a count of the messages in
.Va sys_siglist .
.Sh SEE ALSO
.Xr sigaction 2 ,
.Xr perror 3
.Sh HISTORY
The
.Fn psignal
function appeared in 
.Bx 4.2 .