The _lwp_kill() function sends a signal to the LWP specified by target_lwp. The signal that is to be sent is specified by sig and must be one from the list given in signal(3HEAD). If sig is 0 (the null signal), error checking is performed but no signal is actually sent. This can be used to check the validity of target_lwp.

The target_lwp must be an LWP within the same process as the calling LWP.

Upon successful completion, 0 is returned. A non-zero value indicates an error.

If any of the following conditions occur, _lwp_kill() fails and returns the corresponding value:

EINVAL

The sig argument is not a valid signal number.

ESRCH

The target_lwp argument cannot be found in the current process.

See attributes(5) for descriptions of the following attributes:

kill(2), sigaction(2), sigprocmask(2), signal(3HEAD), attributes(5)