_lwp_suspend(2) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
_LWP_SUSPEND(2)           NetBSD System Calls Manual           _LWP_SUSPEND(2)


NAME

     _lwp_suspend, _lwp_continue -- suspend or continue a light-weight process


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <lwp.h>

     int
     _lwp_suspend(lwpid_t lwp);

     int
     _lwp_continue(lwpid_t lwp);


DESCRIPTION

     _lwp_suspend() suspends execution of the LWP specified by lwp.  Once an
     LWP is suspended, subsequent calls to _lwp_suspend() have no effect.  The
     only way to resume execution of a suspended LWP is via _lwp_continue().

     _lwp_continue() resumes execution of the LWP specified by lwp.  Once an
     LWP is resumed, subsequent calls to _lwp_continue() have no effect.


RETURN VALUES

     The _lwp_continue() and _lwp_suspend() functions return the value 0 if
     successful; otherwise the value -1 is returned and the global variable
     errno is set to indicate the error.


ERRORS

     _lwp_suspend() and _lwp_continue() will fail if:

     [ESRCH]            No LWP can be found in the current process correspond-
                        ing to that specified by lwp.

     _lwp_suspend() will fail if:

     [EDEADLK]          The LWP specified by lwp is the only LWP in the
                        process.


SEE ALSO

     _lwp_create(2)


HISTORY

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

NetBSD 10.1                    December 4, 2022                    NetBSD 10.1