DP_KILL(2-N)               SYSTEM CALLS              DP_KILL(2-N)


NAME
     dp_kill -- send a signal to a process in the same MPPG


SYNOPSIS
     #include <sys/mppg.h>

     int dp_kill(int lnid, pid_t pid, int signo);


DESCRIPTION
     dp_kill sends a signal to a process in the MPPG to which the
     calling process belongs.

     lnid specifies the logical node number to which  the  target
     process belongs.

     pid specifies the process ID of the target process.

     signo  is  the  signal  number to be sent.  When signo is 0,
     error checking is performed but no signal is actually  sent.

     dp_kill fails if one or more of the following are true:

     [EINVAL]   The calling process does not belong to an MPPG.

     [EINVAL]   The  calling  process  has not changed the signal
                mode by dp_cntl(2).

     [EINVAL]   signo is not a valid signal number.

     [ESRCH]    No logical node can  be  found  corresponding  to
                that specified by lnid.

     [ESRCH]    No  process  can  be  found corresponding to that
                specified by pid.

     [EIO]      There is no response from the node in  which  the
                specified process exists.

SEE ALSO
     dp_create(2),    dp_join(2),    dp_exit(2),   dp_xmalloc(2),
     dp_xmfree(2), dp_xmshare(2), dp_xmatt(2),
     dp_cntl(2), dp_resume(2), kill(2), signal(2)
     Global Memory in the SUPER-UX Programmer's Guide

DIAGNOSTICS
     Upon  successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and errno is set to  indi-
     cate the error.







SUPER-UX            Last change: Oct 13, 1999                   1