unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

_lwp_suspend(2)                  System Calls                  _lwp_suspend(2)



NAME
       _lwp_suspend, _lwp_continue - continue or suspend LWP execution

SYNOPSIS
       #include <sys/lwp.h>

       int _lwp_suspend(lwpid_t target_lwp);

       int _lwp_continue(lwpid_t target_lwp);

DESCRIPTION
       The  _lwp_suspend()  function immediately suspends the execution of the
       LWP specified by target_lwp. On successful return from  _lwp_suspend(),
       target_lwp  is  no longer executing. Once a thread is suspended, subse-
       quent calls to _lwp_suspend() have no affect.

       The _lwp_continue() function resumes the execution of a suspended  LWP.
       Once  a suspended LWP is continued, subsequent calls to _lwp_continue()
       have no effect.

       A suspended LWP will not be awakened by  a  signal.  The  signal  stays
       pending until the execution of the LWP is resumed by _lwp_continue().

RETURN VALUES
       Upon  successful  completion, 0 is returned. A non-zero value indicates
       an error.

ERRORS
       If the following condition occurs, _lwp_suspend()  and  _lwp_continue()
       fail and return the corresponding value:

       ESRCH           The  target_lwpid  argument cannot be found in the cur-
                       rent process.



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


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE MT-LevelAsync-Signal-Safe


SEE ALSO
       attributes(5)



SunOS 5.10                        13 Aug 2001                  _lwp_suspend(2)