LDP: Update original to LDP v3.76

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

diff --git a/original/man2/sigaction.2 b/original/man2/sigaction.2
index f37f65d..ce516eb 100644 (file)
--- a/original/man2/sigaction.2
+++ b/original/man2/sigaction.2
@@ -44,7 +44,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 2014-04-27 "Linux" "Linux Programmer's Manual"
+.TH SIGACTION 2 2014-12-31 "Linux" "Linux Programmer's Manual"
 .SH NAME
 sigaction \- examine and change a signal action
 .SH SYNOPSIS
@@ -116,10 +116,12 @@ and
 .PP
 The
 .I sa_restorer
-element is obsolete and should not be used.
-POSIX does not specify a
+field is not intended for application use.
+(POSIX does not specify a
 .I sa_restorer
-element.
+field.)
+Some further details of purpose of this field can be found in
+.BR sigreturn (2).
 .PP
 .I sa_handler
 specifies the action to be associated with
@@ -238,6 +240,15 @@ See
 .BR signal (7)
 for a discussion of system call restarting.
 .TP
+.BR SA_RESTORER
+.IR "Not intended for application use" .
+This flag is used by C libraries to indicate that the
+.IR sa_restorer
+field contains the address of a "signal trampoline".
+See
+.BR sigreturn (2)
+for more details.
+.TP
 .BR SA_SIGINFO " (since Linux 2.2)"
 The signal handler takes three arguments, not one.
 In this case,
@@ -254,7 +265,7 @@ The
 .I siginfo_t
 argument to
 .I sa_sigaction
-is a struct with the following elements:
+is a struct with the following fields:
 .sp
 .in +4n
 .nf
@@ -266,7 +277,7 @@ siginfo_t {
                              hardware-generated signal
                              (unused on most architectures) */
 .\" FIXME
-.\" The siginfo_t 'si_trapno' filed seems to be used only on SPARC and Alpha;
+.\" The siginfo_t 'si_trapno' field seems to be used only on SPARC and Alpha;
 .\" this page could use a little more detail on its purpose there.
     pid_t    si_pid;      /* Sending process ID */
     uid_t    si_uid;      /* Real user ID of sending process */
@@ -800,6 +811,7 @@ See
 .BR signal (2),
 .BR signalfd (2),
 .BR sigpending (2),
+.BR sigreturn (2),
 .BR sigprocmask (2),
 .BR sigsuspend (2),
 .BR wait (2),
@@ -811,7 +823,7 @@ See
 .BR core (5),
 .BR signal (7)
 .SH COLOPHON
-This page is part of release 3.75 of the Linux
+This page is part of release 3.76 of the Linux
 .I man-pages
 project.
 A description of the project,