*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> sigreturn (2)              



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()

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)

[ Back ]
 Similar pages
Name OS Title
sigreturn FreeBSD return from signal
sigreturn OpenBSD return from signal
sigreturn NetBSD return from signal
strsignal Linux return string describing signal
sigreturn Linux return from signal handler and cleanup stack frame
pxfsigaddset IRIX Adds an individual signal to the specified signal set
pxfsigdelset IRIX Deletes an individual signal in the specified signal set
pxfsigismember IRIX Determines if the specified signal is a member of the specified signal set
sigsetops IRIX signal set
pause OpenBSD stop until signal
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service