unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.9)
Page:
Section:
Apropos / Subsearch:
optional field



System Calls                                         _lwp_kill(2)



NAME
     _lwp_kill - send a signal to a LWP

SYNOPSIS
     #include <sys/lwp.h>
     #include <signal.h>

     int _lwp_kill(lwpid_t target_lwp, int sig);

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

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

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

ATTRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO
     kill(2), sigaction(2), sigprocmask(2), signal(3HEAD), attri-
     butes(5)







SunOS 5.9            Last change: 8 Aug 2001                    1