sigreturn.2: Add discussion of rt_sigreturn(2)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2015-02-19 11:00:59 +01:00
parent 166b65db90
commit d893db6462
1 changed files with 16 additions and 1 deletions

View File

@ -29,7 +29,7 @@
.\"
.TH SIGRETURN 2 2014-12-31 "Linux" "Linux Programmer's Manual"
.SH NAME
sigreturn \- return from signal handler and cleanup stack frame
sigreturn, rt_sigreturn \- return from signal handler and cleanup stack frame
.SH SYNOPSIS
.BI "int sigreturn(...);"
.SH DESCRIPTION
@ -120,6 +120,21 @@ the kernel passes control to the trampoline (rather than the signal handler),
and the trampoline code calls the signal handler (and then calls
.BR sigreturn ()
once the handler returns).
.\"
.SS C library/kernel ABI differences
The original Linux system call was named
.BR sigreturn ().
However, with the addition of real-time signals in Linux 2.2,
a new system call,
.BR rt_sigreturn ()
was added to support an enlarged
.IR sigset_t
type.
The GNU C library
hides these details from us, transparently employing
.BR rt_sigreturn ()
when the kernel provides it.
.\"
.SH SEE ALSO
.BR kill (2),
.BR restart_syscall (2),