1 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
3 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\" References consulted:
6 .\" Linux libc source code
7 .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
9 .\" Modified Sat Jul 24 18:45:17 1993 by Rik Faith (faith@cs.unc.edu)
10 .TH PSIGNAL 3 2021-03-22 "Linux man-pages (unreleased)"
12 psignal, psiginfo \- print signal description
15 .RI ( libc ", " \-lc )
18 .B #include <signal.h>
20 .BI "void psignal(int " sig ", const char *" s );
21 .BI "void psiginfo(const siginfo_t *" pinfo ", const char *" s );
25 Feature Test Macro Requirements for glibc (see
26 .BR feature_test_macros (7)):
33 Glibc 2.19 and earlier:
34 _BSD_SOURCE || _SVID_SOURCE
39 _POSIX_C_SOURCE >= 200809L
44 function displays a message on \fIstderr\fP
45 consisting of the string \fIs\fP, a colon, a space, a string
46 describing the signal number \fIsig\fP, and a trailing newline.
47 If the string \fIs\fP is NULL or empty, the colon and space are omitted.
48 If \fIsig\fP is invalid,
49 the message displayed will indicate an unknown signal.
55 except that it displays information about the signal described by
57 which should point to a valid
60 As well as the signal description,
62 displays information about the origin of the signal,
63 and other information relevant to the signal
64 (e.g., the relevant memory address for hardware-generated signals,
65 the child process ID for
67 and the user ID and process ID of the sender, for signals set using
76 functions return no value.
80 function was added to glibc in version 2.10.
82 For an explanation of the terms used in this section, see
90 Interface Attribute Value
94 T} Thread safety MT-Safe locale
100 POSIX.1-2008, 4.3BSD.
102 In glibc versions up to 2.12,
104 had the following bugs:
106 In some circumstances, a trailing newline is not printed.
107 .\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12107
108 .\" Reportedly now fixed; check glibc 2.13
110 Additional details are not displayed for real-time signals.
111 .\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12108
112 .\" Reportedly now fixed; check glibc 2.13