NAME |LIBRARY |SYNOPSIS |DESCRIPTION |ATTRIBUTES |STANDARDS |HISTORY |SEE ALSO |COLOPHON | |
gsignal(3) Library Functions Manualgsignal(3)gsignal, ssignal - software signal facility
Standard C library (libc,-lc)
#include <signal.h>typedef typeof(void (int)) *sighandler_t;[[deprecated]] int gsignal(intsignum);[[deprecated]] sighandler_t ssignal(intsignum, sighandler_taction); Feature Test Macro Requirements for glibc (seefeature_test_macros(7)):gsignal(),ssignal(): Since glibc 2.19: _DEFAULT_SOURCE glibc 2.19 and earlier: _SVID_SOURCE
Don't use these functions under Linux. Due to a historical mistake, under Linux these functions are aliases forraise(3) andsignal(2), respectively. Elsewhere, on System V-like systems, these functions implement software signaling, entirely independent of the classicalsignal(2) andkill(2) functions. The functionssignal() defines the action to take when the software signal with numbersignum is raised using the functiongsignal(), and returns the previous such action orSIG_DFL. The functiongsignal() does the following: if no action (or the actionSIG_DFL) was specified forsignum, then it does nothing and returns 0. If the actionSIG_IGNwas specified forsignum, then it does nothing and returns 1. Otherwise, it resets the action toSIG_DFLand calls the action function with argumentsignum, and returns the value returned by that function. The range of possible valuessignum varies (often 1–15 or 1–17).
For an explanation of the terms used in this section, seeattributes(7). ┌──────────────────────────────┬───────────────┬─────────────────┐ │Interface│Attribute│Value│ ├──────────────────────────────┼───────────────┼─────────────────┤ │gsignal() │ Thread safety │ MT-Safe │ ├──────────────────────────────┼───────────────┼─────────────────┤ │ssignal() │ Thread safety │ MT-Safe sigintr │ └──────────────────────────────┴───────────────┴─────────────────┘
None.
AIX, DG/UX, HP-UX, SCO, Solaris, Tru64. They are called obsolete under most of these systems, and are broken under glibc. Some systems also havegsignal_r() andssignal_r().
kill(2),signal(2),raise(3)
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-17gsignal(3)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. | ![]() |