Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ sigreturn(2) — NEWS-os 4.2.1R

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

sigvec(2)

setjmp(3)

SIGRETURN(2)  —  NEWS-OS Programmer’s Manual

NAME

sigreturn − return from signal

SYNOPSIS

#include <signal.h>

sigreturn(scp);
struct sigcontext ∗scp;

DESCRIPTION

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 user registers 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 program. 

NOTES

This system call is not available in NEWS-OS 2.x (4.2BSD), hence it should not be used if backward compatibility is needed. 

RETURN VALUE

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

ERRORS

sigreturn will fail and the process context will remain unchanged if the following occurs. 

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

SEE ALSO

sigvec(2), setjmp(3)

NEWS-OSRelease 4.2.1R

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026