From 7a414038ea197ccb75284b53b8fe937037d9b039 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 5 Oct 2008 07:23:58 +0200 Subject: [PATCH] signal.7: Add overview of interfaces for sending signals. (kill(), killpg(), tgkill(), sigqueue(), raise(), etc.) Signed-off-by: Michael Kerrisk --- man7/signal.7 | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/man7/signal.7 b/man7/signal.7 index a300b101f..1c98416b8 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -40,7 +40,7 @@ .\" Added section on system call restarting (SA_RESTART) .\" Added section on stop/cont signals interrupting syscalls. .\" -.TH SIGNAL 7 2008-08-21 "Linux" "Linux Programmer's Manual" +.TH SIGNAL 7 2008-10-05 "Linux" "Linux Programmer's Manual" .SH NAME signal \- list of available signals .SH DESCRIPTION @@ -89,6 +89,32 @@ During an .BR execve (2), the dispositions of handled signals are reset to the default; the dispositions of ignored signals are left unchanged. +.SS Sending a Signal +The following system calls and library functions allow +the caller to send a signal: +.TP 12 +.BR raise (3) +Sends a signal to the calling thread. +.TP +.BR kill (2) +Sends a signal to a specified process, +to all members of a specified process group, +or to all processes on the system. +.TP +.BR killpg (2) +Sends a signal to all of the members of a specified process group. +.TP +.BR pthread_kill (3) +Sends a signal to a specified POSIX thread in the same process as +the caller. +.TP +.BR tgkill (2) +Sends a signal to a specified thread within a specific process. +(This is the system call used to implement +.BR pthread_kill (3).) +.TP +.BR sigqueue (2) +Sends a real-time signal with accompanying data to a specified process. .SS "Signal Mask and Pending Signals" A signal may be .IR blocked ,