diff options
Diffstat (limited to 'man2/sigaction.2')
-rw-r--r-- | man2/sigaction.2 | 34 |
1 files changed, 23 insertions, 11 deletions
diff --git a/man2/sigaction.2 b/man2/sigaction.2 index 2abe30ccc..5ea62ebb5 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -45,7 +45,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" -.TH SIGACTION 2 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH SIGACTION 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME sigaction, rt_sigaction \- examine and change a signal action .SH SYNOPSIS @@ -127,11 +127,15 @@ Some further details of the purpose of this field can be found in .I sa_handler specifies the action to be associated with .I signum -and may be +and is be one of the following: +.IP * 2 .B SIG_DFL -for the default action, +for the default action. +.IP * .B SIG_IGN -to ignore this signal, or a pointer to a signal handling function. +to ignore this signal. +.IP * +A pointer to a signal handling function. This function receives the signal number as its only argument. .PP If @@ -204,9 +208,13 @@ signal is generated in this case; on some other implementations, it is not. .TP .B SA_NODEFER -Do not prevent the signal from being received from within its own signal -handler. +Do not add the signal to the thread's signal mask while the +handler is executing, unless the signal is specified in +.IR act.sa_mask . +Consequently, a further instance of the signal may be delivered +to the thread while it is executing the handler. This flag is meaningful only when establishing a signal handler. +.IP .B SA_NOMASK is an obsolete, nonstandard synonym for this flag. .TP @@ -219,6 +227,7 @@ This flag is meaningful only when establishing a signal handler. .BR SA_RESETHAND Restore the signal action to the default upon entry to the signal handler. This flag is meaningful only when establishing a signal handler. +.IP .B SA_ONESHOT is an obsolete, nonstandard synonym for this flag. .TP @@ -292,7 +301,9 @@ on the user-space stack by the kernel; for details, see Further information about the .IR ucontext_t structure can be found in -.BR getcontext (3). +.BR getcontext (3) +and +.BR signal (7). Commonly, the handler function doesn't make any use of the third argument. .PP The @@ -762,10 +773,10 @@ Process breakpoint. .B TRAP_TRACE Process trace trap. .TP -.BR TRAP_BRANCH " (since Linux 2.4, IA64 only))" +.BR TRAP_BRANCH " (since Linux 2.4, IA64 only)" Process taken branch trap. .TP -.BR TRAP_HWBKPT " (since Linux 2.4, IA64 only))" +.BR TRAP_HWBKPT " (since Linux 2.4, IA64 only)" Hardware breakpoint/watchpoint. .RE .PP @@ -920,7 +931,7 @@ flag is compatible with the SVr4 flag of the same name. The .B SA_NODEFER flag is compatible with the SVr4 flag of the same name under kernels -1.3.9 and newer. +1.3.9 and later. On older kernels the Linux implementation allowed the receipt of any signal, not just the one we are installing (effectively overriding any @@ -1034,6 +1045,7 @@ prevents not only the delivered signal from being masked during execution of the handler, but also the signals specified in .IR sa_mask . This bug was fixed in kernel 2.6.14. +.\" commit 69be8f189653cd81aae5a74e26615b12871bb72e .SH EXAMPLES See .BR mprotect (2). @@ -1061,7 +1073,7 @@ See .BR core (5), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, |