|
|
sigreturn(2) System Calls Manual sigreturn(2) NAME
sigreturn - Returns from signal SYNOPSIS
#include <signal.h> int sigreturn( struct sigcontext *scp) ; PARAMETERS
Points to a sigcontext structure whose members contain the processor state to be restored. The contents of the sigcontext structure should have been previously obtained by entry to a signal handler or by the setjmp() or sigsetjmp() function. DESCRIPTION
The sigreturn() function restores the processor state of the calling process from a sigcontext structure. The sigcontext structure contains the state of all application-visible registers as well as the signal mask. The specific members of the sigcontext structure depend on the machine architecture. Each machine-dependent structure member is defined in the signal.h include file. The sigreturn() function is used internally by the system software to restore the processor state on return from a signal handler and from a longjmp() function, to restore the state saved by a previous setjmp() or sigsetjmp() function. NOTES
An application should only use sigreturn() with great caution. RETURN VALUES
Upon successful completion, the sigreturn() function does not return. Otherwise, a value of -1 is returned and errno may be set to indi- cate the error. ERRORS
If the sigreturn() function fails, the process context remains unchanged and errno is set to one of the following values: The scp parameter points to memory space that is not a valid part of the process address space. The sigcontext structure contains unsupported or illegal values. RELATED INFORMATION
Functions: setjmp(3), sigaction(2), sigvec(2) delim off sigreturn(2)