Index for Section 2

Alphabetical listing for S

Bottom of page

sigreturn(2)
NAME
  sigreturn - Return from a signal

SYNOPSIS
  #include <signal.h>

  int sigreturn(
	  struct sigcontext *scp );

PARAMETERS
  scp	  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 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 indicate the
  error.

ERRORS
  If the sigreturn() function fails, the process context remains unchanged
  and errno is set to one of the following values:

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

  [EINVAL]
	  The sigcontext structure contains unsupported or illegal values.

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

Index for Section 2

Alphabetical listing for S

Top of page