hpux man page for makecontext

makecontext(2)							System Calls Manual						    makecontext(2)

NAME
       makecontext(), swapcontext() - manipulate user contexts

SYNOPSIS
       Deprecated

       Deprecated

DESCRIPTION
       The  function  modifies the context specified by ucp, which has been initialized using When this context is resumed using or program execu-
       tion 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 inte-
       ger 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 architec-
       ture-specific.  The context APIs "expose" the architecture to the application, such that the application may not  be  compatible  with  all
       releases.

       If you must use context APIs, be aware of the following:

       o  Do  not  copy  the  context  yourself.  It is not contiguous.  The context may have pointers that may point back to the original context
	  rather than in the copied context; hence, it will be broken.

       o  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 ALSO
       exit(2), getcontext(2), sigaction(2), sigprocmask(2), <ucontext.h>.

								    Deprecated							    makecontext(2)