akill - terminate a process or array session


SYNOPSIS

       akill [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  sig­
       nal(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 spec­
       ified).   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:

       --aa arrayname or --aarrrraayy arrayname
            Specifies  the name of the array to which the command
            should be directed.  If not specified, the array ser­
            vices  daemon's  default  destination  will  be used.
            This option is ignored if the -pid option  is  speci­
            fied.

       --aasshh ASH or --hh ASH
            Specifies  the array session handle of the array ses­
            sion whose processes are to receive the signal.   The
            string  "-ash" itself is optional.  The -ash and -pid
            options are mutually exclusive.

       --DD or --ddiirreecctt
            When used with --ss, 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.  --DD is the default behav­
            ior under normal circumstances (but see the  descrip­
            tion of the AARRRRAAYYDD_FFOORRWWAARRDD variable, below).

            When  used with --ss, indicates that the request should
            be forwarded to the specified server  via  the  local
            array  services  daemon, rather than sent directly to
            it.  --FF will become the default behavior if the value
            of  the  AARRRRAAYYDD_FFOORRWWAARRDD  environment  variable begins
            with the letter "Y" (as in "yes"; it may be in either
            upper or lower case).

       --KKll key or --llooccaallkkeeyy key
            Use  key for the local authentication key when commu­
            nicating directly with a remote array  services  dae­
            mon.   key  is an unsigned 64-bit value.  The default
            local key is obtained from the  environment  variable
            AARRRRAAYYDD_LLOOCCAALLKKEEYY;  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.

       --KKrr key or --rreemmootteekkeeyy key
            Use key for the remote authentication key when commu­
            nicating  directly  with a remote array services dae­
            mon.  key is an unsigned 64-bit value.   The  default
            remote  key is obtained from the environment variable
            AARRRRAAYYDD_RREEMMOOTTEEKKEEYY; 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.

       --ll or --llooccaall
            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.

       --LL   Forces  the  command  to  be  processed  on the local
            machine only, even if normal array  services  conven­
            tions (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.

       --mm server or --mmaacchhiinnee server
            Equivalent to "-s server -l".  This is  a  convenient
            way  to  restrict  the operation of akill to a single
            machine.

            Specifies the port address of the array services dae­
            mon.   Defaults  to  the  value  of the "ARRAYD_PORT"
            environment variable if present, or the standard port
            number of the "sgi-arrayd" service otherwise.

       --ppiidd PID or --ii 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.

       --ss server or --sseerrvveerr server
            Specifies the hostname or IP  address  of  the  array
            services  daemon.   Defaults  to  the  value  of  the
            "ARRAYD" environment variable if present, or  "local­
            host" otherwise.

       --tt value or --ttiimmeeoouutt 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).

       NOTES  Unless -L is specified, the array  services  daemon
              (arrayd(1M))  must  be running on all machines that
              are to perform the signalling function.


SEE ALSO

       kill(1),     kill(2),     askillash_array(3X),      askil­
       lash_local(3X),                      askillash_server(3X),
       askillpid_server(3X), array_services(5).


Man(1) output converted with man2html