_lwp_wait(2) [netbsd man page]

_LWP_WAIT(2)						      BSD System Calls Manual						      _LWP_WAIT(2)

NAME

     _lwp_wait -- wait for light-weight process termination

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <lwp.h>

     int
     _lwp_wait(lwpid_t wlwp, lwpid_t *rlwp);

DESCRIPTION

     _lwp_wait() suspends execution of the calling LWP until the LWP specified by wlwp terminates.  The specified LWP must not be detached.  If
     wlwp is 0, then _lwp_wait() waits for any undetached LWP in the current process.

     If rlwp is not NULL, then it points to the location where the LWP ID of the exited LWP is stored.

RETURN VALUES

     Upon successful completion, _lwp_wait() returns a value of 0.  Otherwise, an error code is returned to indicate the error.

ERRORS

     _lwp_wait() will fail if:

     [ESRCH]	No undetached LWP can be found in the current process corresponding to that specified by wlwp.

     [EDEADLK]	The calling LWP is the only LWP in the process.

     [EDEADLK]	The LWP ID specified by wlwp is the LWP ID of the calling LWP.

     [EINTR]	_lwp_wait() was interrupted by a caught signal, or the signal did not have the SA_RESTART flag set.

SEE ALSO

     _lwp_create(2), _lwp_exit(2)

HISTORY

     The _lwp_wait() system call first appeared in NetBSD 2.0.

BSD
								 January 13, 2003							       BSD

_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_sus-
       pend(), 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_con-
       tinue() 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.11							    13 Aug 2001 						   _lwp_suspend(2)