1 # ps.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 ps

    14 

    15 ==short-description

    16 

    17 List information relating to the currently running processes and threads.

    18 

    19 ==see-also

    20 

    21 L<kerninfo|kerninfo>, L<objinfo|objinfo>, L<chunkinfo|chunkinfo>, L<top|top>

    22 

    23 ==argument uint process_id optional

    24 

    25 The identifier of the process to examine. If not specified, displays information on all processes.

    26 

    27 ==option bool v verbose

    28 

    29 Verbose output. Prints warnings if threads couldn't be opened, and displays full thread names instead of short ones.

    30 

    31 ==option string m match

    32 

    33 A pattern used to match processes by name (defaults to C<*>).

    34 

    35 ==option string M matchify

    36 

    37 Like C<--match> but without the need for leading/trailing asterisks (see C<LtkUtils::Matchify>).

    38 

    39 ==option bool H human

    40 

    41 Print human readable sizes.

    42 

    43 ==option bool p priority

    44 

    45 Print process and thread priority information.

    46 

    47 ==option bool x exclude-dead

    48 

    49 Does not list threads/processes that have exited or died (by default they will appear if anything still has a handle open to them).

    50 

    51 ==option bool o only-dead

    52 

    53 Only list threads/processes that have exited or died.

    54 

    55 ==option bool n handle-count

    56 

    57 Print the number of handles held by a given thread or process.

    58 

    59 ==option bool A addresses

    60 

    61 Print kernel object addresses.

    62 

    63 ==option bool t threads

    64 

    65 Print thread information.

    66 

    67 ==option bool s stacks

    68 

    69 Print thread stack information (only valid with the C<--thread> option). Note, the term 'High water mark' is used to indicate the largest amount of stack a given thread has used in its lifetime.

    70 

    71 ==option bool a heaps

    72 

    73 Print thread heap usage (only valid with the C<--thread> option).

    74 

    75 ==option bool c cpu-time

    76 

    77 Print thread CPU time (only valid with the C<--thread> option).

    78 

    79 ==option bool k chunks

    80 

    81 Print details about the chunks belonging to each process.

    82 

    83 ==option bool f filename

    84 

    85 Print the executable's file name.

    86 

    87 ==option bool r memory

    88 

    89 Print memory usage information.

    90 

    91 ==option bool d command_line

    92 

    93 Print the command line arguments. Only available on non-emulated builds of EKA1.

    94 

    95 ==option bool l flags

    96 

    97 Print C<System>, C<Protected> and C<LoadedFromRam> flag values. Only available on EKA1.

    98 

    99 ==copyright

   100 

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

   102