NAME |LIBRARY |SYNOPSIS |DESCRIPTION |RETURN VALUE |ATTRIBUTES |STANDARDS |HISTORY |BUGS |SEE ALSO |COLOPHON | |
psignal(3) Library Functions Manualpsignal(3)psignal, psiginfo - print signal description
Standard C library (libc,-lc)
#include <signal.h>void psignal(intsig, const char *s);void psiginfo(const siginfo_t *pinfo, const char *s); Feature Test Macro Requirements for glibc (seefeature_test_macros(7)):psignal(): Since glibc 2.19: _DEFAULT_SOURCE glibc 2.19 and earlier: _BSD_SOURCE || _SVID_SOURCEpsiginfo(): _POSIX_C_SOURCE >= 200809L
Thepsignal() function displays a message onstderr consisting of the strings, a colon, a space, a string describing the signal numbersig, and a trailing newline. If the strings is NULL or empty, the colon and space are omitted. Ifsig is invalid, the message displayed will indicate an unknown signal. Thepsiginfo() function is likepsignal(), except that it displays information about the signal described bypinfo, which should point to a validsiginfo_t structure. As well as the signal description,psiginfo() displays information about the origin of the signal, and other information relevant to the signal (e.g., the relevant memory address for hardware-generated signals, the child process ID forSIGCHLD, and the user ID and process ID of the sender, for signals set usingkill(2) orsigqueue(3)).
Thepsignal() andpsiginfo() functions return no value.
For an explanation of the terms used in this section, seeattributes(7). ┌───────────────────────────────┬───────────────┬────────────────┐ │Interface│Attribute│Value│ ├───────────────────────────────┼───────────────┼────────────────┤ │psignal(),psiginfo() │ Thread safety │ MT-Safe locale │ └───────────────────────────────┴───────────────┴────────────────┘
POSIX.1-2008.
glibc 2.10. POSIX.1-2008, 4.3BSD.
Up to glibc 2.12,psiginfo() had the following bugs: • In some circumstances, a trailing newline is not printed. • Additional details are not displayed for real-time signals.
sigaction(2),perror(3),strsignal(3),signal(7)
This page is part of theman-pages (Linux kernel and C library user-space interface documentation) project. Information about the project can be found at ⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report for this manual page, see ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩. This page was obtained from the tarball man-pages-6.15.tar.gz fetched from ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on 2025-08-11. If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up- to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which isnot part of the original manual page), send a mail to man-pages@man7.orgLinux man-pages 6.15 2025-05-17psignal(3)Pages that refer to this page:strsignal(3), system_data_types(7)
HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | ![]() |