diff options
Diffstat (limited to 'man2/sigreturn.2')
-rw-r--r-- | man2/sigreturn.2 | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/man2/sigreturn.2 b/man2/sigreturn.2 new file mode 100644 index 000000000..2d9c697b5 --- /dev/null +++ b/man2/sigreturn.2 @@ -0,0 +1,64 @@ +.\" Copyright (C) 1995, Thomas K. Dyas <tdyas@eden.rutgers.edu> +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.\" Created Sat Aug 21 1995 Thomas K. Dyas <tdyas@eden.rutgers.edu> +.\" Modified Tue Oct 22 22:09:03 1996 by Eric S. Raymond <esr@thyrsus.com> +.\" +.TH SIGRETURN 2 1995-08-21 "Linux 1.3.20" "Linux Programmer's Manual" +.SH NAME +sigreturn \- return from signal handler and cleanup stack frame +.SH SYNOPSIS +.BI "int sigreturn(unsigned long " __unused ); +.SH DESCRIPTION +When the Linux kernel creates the stack frame for a signal handler, a +call to +.B sigreturn +is inserted into the stack frame so that the the signal handler will +call +.B sigreturn +upon return. This inserted call to +.B sigreturn +cleans up the stack so that the process can restart from where it was +interrupted by the signal. +.SH "RETURN VALUE" +.B sigreturn +never returns. +.SH WARNING +The +.B sigreturn +call is used by the kernel to implement signal handlers. It should +.B never +be called directly. Better yet, the specific use of the +.I __unused +argument varies depending on the architecture. +.SH "CONFORMING TO" +.B sigreturn +is specific to Linux and should not be used in programs intended to be +portable. +.SH FILES +/usr/src/linux/arch/i386/kernel/signal.c +.br +/usr/src/linux/arch/alpha/kernel/entry.S +.SH "SEE ALSO" +.BR kill (2), +.BR signal (2), +.BR signal (7) |