_lwp_continue(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)