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

_lwp_suspend( ) 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.

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

Zero is returned when successful. 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

target_lwpid cannot be found in the current process

If the following condition is detected, _lwp_suspend( ) fails and returns the corresponding value:

EDEADLK

Suspending target_lwpid will cause all LWPs in the process to be suspended.

SEE ALSO

_lwp_create(2)