askillpid_server(3x)askillpid_server(3x)NAMEaskillpid_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);
DESCRIPTIONaskillpid_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
NOTESaskillpid_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 ALSOkill(2), aserrorcode(3X), askillash_server(3X), asopenserver(3X),
array_sessions(5).
Page 1
askillpid_server(3x)askillpid_server(3x)DIAGNOSTICS
Upon successful completion, a value of 0 is returned. Otherwise, a value
of -1 is returned and aserrorcode(3x) is set accordingly.
Page 2