2 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\" References consulted:
7 .\" Linux libc source code
8 .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
10 .\" Modified Sat Jul 24 18:45:17 1993 by Rik Faith (faith@cs.unc.edu)
11 .TH psignal 3 (date) "Linux man-pages (unreleased)"
13 psignal, psiginfo \- print signal description
16 .RI ( libc ", " \-lc )
19 .B #include <signal.h>
21 .BI "void psignal(int " sig ", const char *" s );
22 .BI "void psiginfo(const siginfo_t *" pinfo ", const char *" s );
26 Feature Test Macro Requirements for glibc (see
27 .BR feature_test_macros (7)):
34 glibc 2.19 and earlier:
35 _BSD_SOURCE || _SVID_SOURCE
40 _POSIX_C_SOURCE >= 200809L
45 function displays a message on \fIstderr\fP
46 consisting of the string \fIs\fP, a colon, a space, a string
47 describing the signal number \fIsig\fP, and a trailing newline.
48 If the string \fIs\fP is NULL or empty, the colon and space are omitted.
49 If \fIsig\fP is invalid,
50 the message displayed will indicate an unknown signal.
56 except that it displays information about the signal described by
58 which should point to a valid
61 As well as the signal description,
63 displays information about the origin of the signal,
64 and other information relevant to the signal
65 (e.g., the relevant memory address for hardware-generated signals,
66 the child process ID for
68 and the user ID and process ID of the sender, for signals set using
77 functions return no value.
79 For an explanation of the terms used in this section, see
85 Interface Attribute Value
91 T} Thread safety MT-Safe locale
102 had the following bugs:
104 In some circumstances, a trailing newline is not printed.
105 .\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12107
106 .\" Reportedly now fixed; check glibc 2.13
108 Additional details are not displayed for real-time signals.
109 .\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12108
110 .\" Reportedly now fixed; check glibc 2.13