Проект OpenNet: MAN getcontext (3) Библиотечные вызовы (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

getcontext (3)

getcontext (2) ( Solaris man: Системные вызовы )

getcontext (2) ( Русские man: Системные вызовы )

getcontext (2) ( Linux man: Системные вызовы )

>> getcontext (3) ( FreeBSD man: Библиотечные вызовы )

getcontext (3) ( POSIX man: Библиотечные вызовы )

BSD mandoc

NAME



getcontext , setcontext

 - get and set user thread context

LIBRARY

Lb libc

SYNOPSIS

#include <ucontext.h>
int getcontext (ucontext_t *ucp);
int setcontext (const ucontext_t *ucp);

DESCRIPTION

The getcontext ();
function saves the current thread's execution context in the structure pointed to by Fa ucp . This saved context may then later be restored by calling setcontext (.);

The setcontext ();
function makes a previously saved thread context the current thread context, i.e., the current context is lost and setcontext ();
does not return. Instead, execution continues in the context specified by Fa ucp , which must have been previously initialized by a call to getcontext (,);
makecontext(3), or by being passed as an argument to a signal handler (see sigaction(2)).

If Fa ucp was initialized by getcontext (,);
then execution continues as if the original getcontext ();
call had just returned (again).

If Fa ucp was initialized by makecontext(3), execution continues with the invocation of the function specified to makecontext(3). When that function returns, Fa ucp->uc_link determines what happens next: if Fa ucp->uc_link is NULL the process exits; otherwise, setcontext (ucp->uc_link);
is implicitly invoked.

If Fa ucp was initialized by the invocation of a signal handler, execution continues at the point the thread was interrupted by the signal.