DragonFly On-Line Manual Pages

LWP_KILL(2)              DragonFly System Calls Manual             LWP_KILL(2)

NAME
     lwp_kill -- send signal to a lwp

LIBRARY
     Standard C Library (libc, -lc)

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

     int
     lwp_kill(pid_t pid, lwpid_t tid, int sig);

DESCRIPTION
     The lwp_kill() function sends the signal sig to the lwp specified by pid
     and tid.  If pid is -1, the signal will be sent to the current process.
     Permission checking and signal behavior is exactly like in kill(2).

RETURN VALUES
     Upon successful completion, the value 0 is returned; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.

ERRORS
     Lwp_kill() will fail and no signal will be sent if:

     [EINVAL]           sig is not a valid signal number.

     [ESRCH]            no lwp corresponding to pid and tid can be found.

     [EPERM]            the sending process is not the super-user and its
                        effective user id does not match the effective user-id
                        of the receiving process.

SEE ALSO
     kill(2), lwp_create(2), raise(3)

HISTORY
     The lwp_kill() function first appeared in DragonFly 1.9.

DragonFly 4.7                   March 12, 2007                   DragonFly 4.7