_lwp_wait(2) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
_LWP_WAIT(2)              NetBSD 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

     The _lwp_wait() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.


ERRORS

     _lwp_wait() will fail if:

     [ESRCH]            No LWP can be found in the current process correspond-
                        ing 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.

     [EINVAL]           The LWP specified by wlwp is detached.

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

NetBSD 10.1                    December 4, 2022                    NetBSD 10.1