signal.7: Add overview of interfaces for sending signals.

(kill(), killpg(), tgkill(), sigqueue(), raise(), etc.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2008-10-05 07:23:58 +02:00
parent cd7b18e735
commit 7a414038ea
1 changed files with 27 additions and 1 deletions

View File

@ -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 ,