_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, 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 attributes:


+---------------+-------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-------------------+
|MT-Level | Async-Signal-Safe |
+---------------+-------------------+

SEE ALSO


attributes(5)


August 13, 2001 _LWP_SUSPEND(2)