The Open Group Base Specifications Issue 6
IEEE Std 1003.1, 2004 Edition
Copyright © 2001-2004 The IEEE and The Open Group, All Rights reserved.

#### 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);

The following sections are informative.

#### 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.

End of informative text.

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
[ Main Index | XBD | XCU | XSH | XRAT ]