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