(split) LDP: Update original to LDP v3.40.

[linuxjm/LDP_man-pages.git] / original / man2 / sigaction.2

diff --git a/original/man2/sigaction.2 b/original/man2/sigaction.2
index b7251cc..80d03a6 100644 (file)
--- a/original/man2/sigaction.2
+++ b/original/man2/sigaction.2
@@ -42,7 +42,7 @@
 .\" 2010-06-11 Andi Kleen, add hwpoison signal extensions
 .\" 2010-06-11 mtk, improvements to discussion of various siginfo_t fields.
 .\"
-.TH SIGACTION 2 2010-06-16 "Linux" "Linux Programmer's Manual"
+.TH SIGACTION 2 2012-04-26 "Linux" "Linux Programmer's Manual"
 .SH NAME
 sigaction \- examine and change a signal action
 .SH SYNOPSIS
@@ -142,6 +142,11 @@ pointer to a
 as its second argument and a pointer to a
 .I ucontext_t
 (cast to \fIvoid\ *\fP) as its third argument.
+(Commonly, the handler function doesn't make any use of the third argument.
+See
+.BR getcontext (2)
+for further information about
+.IR ucontext_t .)
 .PP
 .I sa_mask
 specifies a mask of signals which should be blocked
@@ -290,16 +295,16 @@ read the fields that are meaningful for the given signal:
 Signals sent with
 .BR kill (2)
 and
-.BR sigqueue (2)
+.BR sigqueue (3)
 fill in
 .IR si_pid " and " si_uid .
 In addition, signals sent with
-.BR sigqueue (2)
+.BR sigqueue (3)
 fill in
 .IR si_int " and " si_ptr
-with the values specified by the sender the signal;
+with the values specified by the sender of the signal;
 see
-.BR sigqueue (2)
+.BR sigqueue (3)
 for more details.
 .IP *
 Signals sent by POSIX.1b timers (since Linux 2.6) fill in
@@ -416,7 +421,8 @@ and
 .I si_addr_lsb
 are Linux-specific extensions.
 .IP *
-.BR SIGPOLL / SIGIO
+.BR SIGIO / SIGPOLL
+(the two names are synonyms on Linux)
 fills in
 .IR si_band " and " si_fd .
 The
@@ -439,14 +445,12 @@ for any signal, along with reason that the signal was generated.
 .TP 15
 .B SI_USER
 .BR kill (2)
-or
-.BR raise (3)
 .TP
 .B SI_KERNEL
 Sent by the kernel.
 .TP
 .B SI_QUEUE
-.BR sigqueue (2)
+.BR sigqueue (3)
 .TP
 .B SI_TIMER
 POSIX timer expired
@@ -459,7 +463,13 @@ POSIX message queue state changed (since Linux 2.6.6); see
 AIO completed
 .TP
 .B SI_SIGIO
-queued SIGIO
+Queued
+.B SIGIO
+(only in kernels up to Linux 2.2; from Linux 2.4 onward
+.BR SIGIO / SIGPOLL
+fills in
+.I si_code
+as described below).
 .TP
 .B SI_TKILL
 .BR tkill (2)
@@ -621,7 +631,7 @@ stopped child has continued (since Linux 2.6.9)
 The following values can be placed in
 .I si_code
 for a
-.B SIGPOLL
+.BR SIGIO / SIGPOLL
 signal:
 .RS 4
 .TP 15
@@ -784,11 +794,11 @@ See
 .BR signalfd (2),
 .BR sigpending (2),
 .BR sigprocmask (2),
-.BR sigqueue (2),
 .BR sigsuspend (2),
 .BR wait (2),
 .BR raise (3),
 .BR siginterrupt (3),
+.BR sigqueue (3),
 .BR sigsetops (3),
 .BR sigvec (3),
 .BR core (5),