NAME    [Toc]    [Back]

       sigreturn - Return from a signal

SYNOPSIS    [Toc]    [Back]

       #include <signal.h>

       int sigreturn(
               struct sigcontext *scp );

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       The  sigreturn()  function restores the processor state of
       the calling process from a sigcontext structure.  The sigcontext
  structure  contains the state of all applicationvisible
 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    [Toc]    [Back]

       An  application should use sigreturn() with great caution.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the sigreturn() function  does
       not return. Otherwise, a value of -1 is returned and errno
       may be set to indicate the error.

ERRORS    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

       Functions: sigaction(2), sigvec(2), setjmp(3)



                                                     sigreturn(2)