_lwp_suspend(2)




NAME

     _lwp_suspend, _lwp_continue - continue or suspend LWP execu-
     tion


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  execu-
     tion  of  the  LWP  specified  by  target_lwp. On successful
     return from _lwp_suspend(), target_lwp is no longer  execut-
     ing.  Once  a  thread  is  suspended,  subsequent  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
           current process.


ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO

     _lwp_create(2), attributes(5)


Man(1) output converted with man2html