makecontext(2)makecontext(2)NAMEmakecontext(), swapcontext() - manipulate user contexts
SYNOPSIS
Deprecated
Deprecated
DESCRIPTION
The function modifies the context specified by ucp, which has been ini‐
tialized using When this context is resumed using or program execution
continues by calling passing it the arguments that follow argc in the
call.
Before a call is made to the context being modified should have a stack
allocated for it. The value of argc must match the number of integer
arguments passed to otherwise the behavior is undefined.
The uc_link member is used to determine the context that will be
resumed when the context being modified by returns. The uc_link member
should be initialized prior to the call to
The function saves the current context in the context structure pointed
to by oucp and sets the context to the context structure pointed to by
ucp.
RETURN VALUE
On successful completion, returns 0. Otherwise, −1 is returned and is
set to indicate the error.
WARNINGS
and are deprecated and should be used only by legacy applications.
Context APIs are not recommended due to possible compatibility problems
from release to release, because context APIs are very architecture-
specific. The context APIs "expose" the architecture to the applica‐
tion, such that the application may not be compatible with all
releases.
If you must use context APIs, be aware of the following:
· Do not copy the context yourself. It is not contiguous. The con‐
text may have pointers that may point back to the original context
rather than in the copied context; hence, it will be broken.
· The size of the context will vary in length from release to release.
ERRORS
The and functions will fail if:
[ENOMEM] The ucp argument does not have enough
stack left to complete the operation.
SEE ALSOexit(2), getcontext(2), sigaction(2), sigprocmask(2), <ucontext.h>.
Deprecated makecontext(2)