Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

_LWP_KILL(2)                  System Calls Manual                 _LWP_KILL(2)

NAME
     _lwp_kill - send a signal to a light-weight process

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <lwp.h>

     int
     _lwp_kill(lwpid_t lwp, int sig);

DESCRIPTION
     _lwp_kill() sends the signal specified by sig to the light-weight process
     specified by lwp.  If the sig argument is given as 0 (zero), _lwp_kill
     will test for the existence of the target LWP, but will take no further
     action.

     Job control signals and uncatchable signals can not be directed to a
     specific LWP: if posted with _lwp_kill, they will affect all LWPs in the
     process.

     Signals will be posted successfully to suspended LWPs, but will not be
     handled further until the LWP has been continued.

RETURN VALUES
     The _lwp_kill() 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
     [EINVAL]           sig is not a valid signal number.

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

SEE ALSO
     _lwp_continue(2), _lwp_suspend(2), kill(2), sigaction(2), signal(7)

HISTORY
     The _lwp_kill() system call first appeared in NetBSD 5.0.

NetBSD 10.99                   January 20, 2007                   NetBSD 10.99