unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.9)
Page:
Section:
Apropos / Subsearch:
optional field



System Calls                                  _lwp_makecontext(2)



NAME
     _lwp_makecontext - initialize an LWP context

SYNOPSIS
     #include <sys/types.h>
     #include <sys/lwp.h>
     #include <ucontext.h>

     void      _lwp_makecontext(ucontext_t       *ucp,       void
     (*start_routine)(void  *), void *arg, void *private, caddr_t
     stack_base, size_t stack_size);

DESCRIPTION
     The _lwp_makecontext() function initializes the user context
     structure  pointed to by ucp. The user context is defined by
     ucontext(3HEAD). The resulting user context can be  used  by
     _lwp_create(2)  for  specifying the initial state of the new
     LWP. The user context is set up to start executing the func-
     tion  start_routine with a single argument, arg, and to call
     _lwp_exit(2) if start_routine returns. The new LWP will  use
     the  storage  starting  at  stack_base  and  continuing  for
     stack_size bytes as an execution stack. The initial value in
     LWP-private   memory   will   be   set   to   private   (see
     _lwp_setprivate(2)). The signal mask in the user context  is
     not initialized.

  ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|


SEE ALSO
     _lwp_create(2),      _lwp_exit(2),       _lwp_setprivate(2),
     ucontext(3HEAD), attributes(5)

NOTES
     The _lwp_makecontext() function  is  obsolete  and  will  be
     removed in a future release.











SunOS 5.9           Last change: 29 Jan 2003                    1