Commit | Line | Data |
---|---|---|
d94af13c KM |
1 | .\" Copyright (c) 1983 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
c13828f9 | 5 | .\" @(#)psignal.3 6.1 (Berkeley) %G% |
d94af13c | 6 | .\" |
c13828f9 | 7 | .TH PSIGNAL 3 "" |
d94af13c KM |
8 | .UC 5 |
9 | .SH NAME | |
10 | psignal, sys_siglist \- system signal messages | |
11 | .SH SYNOPSIS | |
12 | .nf | |
13 | .B psignal(sig, s) | |
14 | .B unsigned sig; | |
15 | .B char *s; | |
16 | .PP | |
17 | .B char *sys_siglist[]; | |
18 | .fi | |
19 | .SH DESCRIPTION | |
20 | .I Psignal | |
21 | produces a short message | |
22 | on the standard error file | |
23 | describing the indicated signal. | |
24 | First the argument string | |
25 | .I s | |
26 | is printed, then a colon, then the name of the signal | |
27 | and a new-line. | |
28 | Most usefully, the argument string is the name | |
29 | of the program which incurred the signal. | |
30 | The signal number should be from among those found | |
31 | in | |
32 | .IR <signal.h> . | |
33 | .PP | |
34 | To simplify variant formatting | |
35 | of signal names, the vector of message strings | |
36 | .I sys_siglist | |
37 | is provided; | |
38 | the signal number | |
39 | can be used as an index in this table to get the | |
40 | signal name without the newline. | |
41 | The define NSIG defined in | |
42 | .RI < signal.h > | |
43 | is the number of messages provided for in the table; | |
44 | it should be checked because new | |
45 | signals may be added to the system before | |
46 | they are added to the table. | |
47 | .SH "SEE ALSO" | |
48 | sigvec(2), | |
49 | perror(3) |