tkill - Terminate LAM on one node.


SYNTAX

       tkill [-dhvN] [-f <killfile>]


OPTIONS

       -d             Turn on debugging mode.  This implies -v.

       -h             Print the command help menu.

       -v             Be verbose.

       -N             Pretend; do not take action.

       -f <killfile>  Use  <killfile>  as  the  name  of the kill
                      file.


DESCRIPTION

       The tkill tool  terminates  the  LAM  session  started  by
       hboot(1)  on  the  local  node.  tkill makes use of a kill
       file created by the LAM kernel, which contains the process
       identifiers  of  every  LAM  process  in  ASCII format.  A
       SIGHUP (see signal(3)) signal is  sent  to  every  process
       listed  in  the  kill file.  tkill waits a short period of
       time for each process to die.  By adding the debug option,
       the  user  can  see the final disposition of each process.
       The mission is accomplished if all processes end up  dead.

       In  LAM, the first process to be killed is always the ker­
       nel.  When the kernel receives its termination signal,  it
       propagates the signal to all of its constituent processes.
       Therefore, tkill will ordinarily be racing the  kernel  to
       kill  all other processes.  This redundant aspect of tkill
       allows it to be used as a general purpose tool in associa­
       tion with hboot(1).


FILES

       /tmp/lam-$USER@<hostname>     the  kill  file,  created by
                                     the kernel, where  $USER  is
                                     the  userid,  and <hostname>
                                     is the  name  of  the  local
                                     machine


SEE ALSO

       hboot(1), lam-helpfile(5)


Man(1) output converted with man2html