1 # kill.cif

     2 # 

     3 # Copyright (c) 2010 Accenture. All rights reserved.

     4 # This component and the accompanying materials are made available

     5 # under the terms of the "Eclipse Public License v1.0"

     6 # which accompanies this distribution, and is available

     7 # at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 # 

     9 # Initial Contributors:

    10 # Accenture - Initial contribution

    11 #

    12 

    13 ==name kill

    14 

    15 ==short-description

    16 

    17 Kill, terminate or panic one or more processes or threads.

    18 

    19 ==argument uint id optional

    20 

    21 The identifier of the process or thread to be killed, as given by "ps" or similar.

    22 

    23 ==option int r reason

    24 

    25 The reason code to kill the process with (defaults to 0). If --panic is specified, this is used as the panic number (the "3" in "KERN-EXEC 3").

    26 

    27 ==option bool t terminate

    28 

    29 Terminate the process (or thread) rather than Kill.

    30 

    31 ==option string p panic

    32 

    33 Panic the process (or thread) with the specified category rather than Kill (use --reason to specify the panic number).

    34 

    35 ==option bool T thread

    36 

    37 Kill a single thread within a process rather than the whole process (may still kill the whole process if the thread is process permanent or process critical). If this option is specified, any supplied <id> argument is expected to be a thread ID rather than a process ID.

    38 

    39 ==option string m match

    40 

    41 A pattern used to match the process or thread name. Can be used instead of specifying the process or thread identifer value. If the --thread option is given, the match string is compared against the thread Full Name (ie includes the process name).

    42 

    43 ==option bool a all

    44 

    45 Only relevant when using the --match option. Kill (or terminate, etc) every process (or thread, as applicable) matching the given string. By default, if there is more than one match that is still running, an error will be printed and the command aborts.

    46 

    47 ==copyright

    48 

    49 Copyright (c) 2005-2010 Accenture. All rights reserved.

    50