akill(1)akill(1)NAMEakill - terminate a process or array session
SYNOPSISakill [options...] [-signal] [-ash] [ASH]
akill [options...] [-signal] -pid [PID]
DESCRIPTION
The akill command sends a signal to the processes in the array session
specified by the array session handle ASH, or to the single process
specified by process ID PID. The value of signal may be numeric or
symbolic (see signal(5)). The symbolic name is the name as is appears in
/usr/include/sys/signal.h, with the SIG prefix stripped off. Signal 15
(SIGTERM) is sent by default; this will normally kill processes that do
not catch or ignore the signal.
The processes that are to be signalled by akill do not necessarily have
to reside on the same system as the one from which the akill command is
issued. If array services is installed then a request to kill an array
session will be forwarded to all of the machines in the array specified
by the -a option (or the default array is -a was not specified).
Similarly, a signal can be sent to an individual process on another
machine that is running array services by using the -m and -pid options.
akill takes several options:
-a arrayname or -array arrayname
Specifies the name of the array to which the command should be
directed. If not specified, the array services daemon's default
destination will be used. This option is ignored if the -pid option
is specified.
-ash ASH or -h ASH
Specifies the array session handle of the array session whose
processes are to receive the signal. The string "-ash" itself is
optional. The -ash and -pid options are mutually exclusive.
-D or -direct
When used with -s, indicates that the request should be sent
directly to the specified server, rather than forwarded to that
server by the local array services daemon. This will fail on
systems that use array services authentication unless the -Kl and
-Kr options are also specified. -D is the default behavior under
normal circumstances (but see the description of the ARRAYD_FORWARD
variable, below).
-F or -forward
When used with -s, indicates that the request should be forwarded to
the specified server via the local array services daemon, rather
than sent directly to it. -F is the default unless the value of the
ARRAYD_FORWARD environment variable begins with the letter "N" (as
in "no"; it may be in either upper or lower case).
Page 1
akill(1)akill(1)-Kl key or -localkey key
Use key for the local authentication key when communicating directly
with a remote array services daemon. key is an unsigned 64-bit
value. The default local key is obtained from the environment
variable ARRAYD_LOCALKEY; if that does not exist, no key is used.
The actual role played by key depends on the authentication method
used by array services in a particular configuration. In general,
it is not used when communicating with an array services daemon on
the local machine.
-Kr key or -remotekey key
Use key for the remote authentication key when communicating
directly with a remote array services daemon. key is an unsigned
64-bit value. The default remote key is obtained from the
environment variable ARRAYD_REMOTEKEY; if that does not exist, no
key is used. The actual role played by key depends on the
authentication method used by array services in a particular
configuration. In general, it is not used when communicating with
an array services daemon on the local machine.
-l or -local
Local request: indicates that the request should not be propagated
to other machines (besides the machine running the array services
daemon, if that is not the local machine). This option is implied
if -pid is specified.
-L Forces the command to be processed on the local machine only, even
if normal array services conventions (such as the ARRAYD environment
variable) might otherwise have caused the command to be processed by
another machine. If -L is specified no attempt is made to contact
an array services daemon, so this can be useful if array services is
not currently active.
-m server or -machine server
Equivalent to "-s server -l". This is a convenient way to restrict
the operation of akill to a single machine.
-p port or -port port
Specifies the port address of the array services daemon. Defaults
to the value of the "ARRAYD_PORT" environment variable if present,
or the standard port number of the "sgi-arrayd" service otherwise.
-pid PID or -i PID
Specifies that the individual process PID, rather than all of the
processes in an array session, should be signalled. It is not
generally useful for this particular operation to be performed on
more than one machine, so the -l option is implied when -pid is
specified.
-s server or -server server
Specifies the hostname or IP address of the array services daemon.
Defaults to the value of the "ARRAYD" environment variable if
Page 2
akill(1)akill(1)
present, or "localhost" otherwise.
-t value or -timeout value
Specifies the timeout value (in seconds) used for waiting on a
single array services request. Most commands involve one array
services daemon requesting services from another array services
daemon, so it will typically take two times this many seconds before
the array command itself will timeout. The default is 15 seconds
(so most array commands will timeout if no response is received in
30 seconds).
Unless -L is specified, the array services daemon (arrayd(1M)) must be
running on all machines that are to perform the signalling function.
SEE ALSOkill(1), kill(2), askillash_array(3X), askillash_local(3X),
askillash_server(3X), askillpid_server(3X), array_services(5).
Page 3
