askillpid_server(3x)

NAME
     askillpid_server - send a signal to a remote process

SYNOPSIS
     #include <sys/types.h>
     #include <arraysvcs.h>

     int askillpid_server(asserver_t Server, pid_t PID, int Sig);

DESCRIPTION
     askillpid_server sends a signal to the process PID.  Depending on the
     server token Server, PID does not necessarily have to reside on the same
     machine as the one executing askillpid_server.  The signal that is to be
     sent is specified by Sig and is either one from the list given in
     signal(2), or 0.  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 PID.

     The real or effective user ID of the sending process must match the real,
     saved, or effective user ID of the receiving process, unless the
     effective user ID of the sending process is superuser.

     The Server argument specifies an optional array server token, which can
     be used to direct the request to a specific machine.  If NULL is
     specified instead, the request will be processed by the default array
     services daemon (see array(1) for more information on how the default
     array services daemon is selected).  For more details on creating an
     array server token, see asopenserver(3X).

     askillpid_server will fail if one or more of the following are true:

     * Sig is not a valid signal number

     * Sig is SIGKILL and PID is process 1.

     * The user ID of the sending process is not superuser, and its real or
       effective user ID does not match the real, saved, or effective user ID
       of the receiving process

     * The array services daemon (arrayd) is not currently active on the
       machine specified by Server

NOTES
     askillpid_server is found in the library "libarray.so", and will be
     loaded if the option "-larray" is used with cc(1) or ld(1).

SEE ALSO
     kill(2), aserrorcode(3X), askillash_server(3X), asopenserver(3X),
     array_sessions(5).
DIAGNOSTICS
     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of -1 is returned and aserrorcode(3x) is set accordingly.