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

  man pages->OpenBSD man pages -> sigreturn (2)              



NAME    [Toc]    [Back]

     sigreturn - return from signal

SYNOPSIS    [Toc]    [Back]

     #include <signal.h>

     sigreturn(struct sigcontext *scp);

DESCRIPTION    [Toc]    [Back]

     sigreturn()  allows  users  to  atomically  unmask,   switch
stacks, and return
     from  a signal context.  The processes signal mask and stack
status are
     restored from the context.  The system call does not return;
the users
     stack  pointer, frame pointer, argument pointer, and processor status
     longword are restored from the context.   Execution  resumes
at the specified
  pc.   This  system call is used by the trampoline code
and longjmp(3)
     when returning from a signal  to  the  previously  executing

     Note that sigcontext contains machine dependent information.

NOTES    [Toc]    [Back]

     This system call is not available in 4.2 BSD hence it should
not be used
     if backward compatibility is needed.

RETURN VALUES    [Toc]    [Back]

     If  successful, the system call does not return.  Otherwise,
a value of -1
     is returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

     sigreturn() will fail and the process  context  will  remain
unchanged if
     one of the following occurs.

     [EFAULT]       scp points to memory that is not a valid part
of the process
 address space.

     [EINVAL]      The process  status  longword  is  invalid  or
would improperly
                   raise the privilege level of the process.

SEE ALSO    [Toc]    [Back]

     sigaction(2), setjmp(3)

HISTORY    [Toc]    [Back]

     The sigreturn() function call appeared in 4.3BSD.

OpenBSD      3.6                           June      4,      1993
[ Back ]
 Similar pages
Name OS Title
sigreturn Tru64 Return from a 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
sigsuspend HP-UX wait for a signal
pause FreeBSD stop until signal
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service