|
|
#include <ucontext.h>int getcontext(ucontext_t *ucp);
int setcontext(const ucontext_t *ucp);
getcontext initializes the structure pointed to by ucp to the current user context of the calling "thread". The user context is defined by ucontext(5) and includes the contents of the calling "thread"'s machine registers, signal mask and execution stack.
setcontext restores the user context pointed to by ucp. The call to setcontext does not return; program execution resumes at the point specified by the context structure passed to setcontext. The context structure should have been one created either by a prior call to getcontext or makecontext or passed as the third argument to a signal handler [see sigaction(2)]. If the context structure was one created with getcontext, program execution continues as if the corresponding call of getcontext had just returned. If the context structure was one created with makecontext, program execution continues with the function specified to makecontext.
An equivalent getcontext routine is provided in libc to handle floating point contexts for Pentium III processors; the behavior of setcontext has also been enhanced to handle floating point context changes during signal handling. See ``Pentium III extended floating point support'' in New features for more information.