_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

_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.

Museum