_lwp_suspend(2)

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also

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)

SunOS 5.10  Last Revised 13 Aug 2001

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also