xref: /original-bsd/lib/libc/gen/psignal.3 (revision cfa2a17a)
1.\" Copyright (c) 1983, 1991 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)psignal.3	6.2 (Berkeley) 04/19/91
7.\"
8.Dd
9.Dt PSIGNAL 3
10.Os BSD 4.2
11.Sh NAME
12.Nm psignal ,
13.Nm sys_siglist
14.Nd system signal messages
15.Sh SYNOPSIS
16.Fd #include <sys/signal.h>
17.Ft void
18.Fn psignal "unsigned sig" "const char *s"
19.Vt extern char *sys_siglist[];
20.Sh DESCRIPTION
21The
22.Fn psignal
23function locates the descriptive message
24string for the given signal
25.Fa sig
26number
27and writes it to the
28.Em stderr .
29.Pp
30If the argument
31.Fa s
32is
33.Pf non- Dv NULL
34it is written to the
35.Em stderr
36prior to the message string.
37The signal number should be from among those found in
38.Aq Pa signal.h .
39.Pp
40The message strings can be accessed directly
41using the external character array
42.Va sys_siglist .
43The defined variable
44.Dv NSIG
45contains a count of the messages in
46.Va sys_siglist .
47.Sh SEE ALSO
48.Xr sigaction 2 ,
49.Xr perror 3
50.Sh HISTORY
51The
52.Fn psignal
53function appeared in
54.Bx 4.2 .
55