NAME

ucontext.h - user context

SYNOPSIS

^[XSI] #include <ucontext.h>

DESCRIPTION

The <ucontext.h> header shall define the mcontext_t type through typedef.

The <ucontext.h> header shall define the ucontext_t type as a structure that shall include at least the following members:

ucontext_t *uc_link     Pointer to the context that is resumed 
                        when this context returns. 
sigset_t    uc_sigmask  The set of signals that are blocked when this 
                        context is active. 
stack_t     uc_stack    The stack used by this context. 
mcontext_t  uc_mcontext A machine-specific representation of the saved 
                        context. 

The types sigset_t and stack_t shall be defined as in <signal.h>.

The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.

[OB]
int  getcontext(ucontext_t *);
void makecontext(ucontext_t *, void (*)(void), int, ...);
int  setcontext(const ucontext_t *);
int  swapcontext(ucontext_t *restrict, const ucontext_t *restrict);

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

<signal.h>, the System Interfaces volume of IEEE Std 1003.1-2001, getcontext(), makecontext(), sigaction(), sigprocmask(), sigaltstack()

CHANGE HISTORY

First released in Issue 4, Version 2.

Issue 6

IEEE Std 1003.1-2001/Cor 2-2004, item XBD/TC2/D6/28 is applied, updating the getcontext(), makecontext(), setcontext(), and swapcontext() functions to be obsolescent.