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  neces­
       sarily  have to reside on the same machine as the one exe­
       cuting 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 receiv­
       ing 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  spe­
       cific  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 pro­
          cess

        * 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).

       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.


Man(1) output converted with man2html