_lwp_kill(2) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
_LWP_KILL(2)              NetBSD 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 spe-
     cific 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 correspond-
                        ing 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