_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(7) for descriptions of the following attributes:
+---------------+-------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-------------------+
|MT-Level | Async-Signal-Safe |
+---------------+-------------------+
SEE ALSO
attributes(7) August 13, 2001 _
LWP_SUSPEND(2)
