xenial (1) tkill.1.gz

NAME

       tkill - Terminate LAM on one node.

SYNOPSIS

       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 kernel.  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 association 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)