diff -r 000000000000 -r 7f656887cf89 core/builtins/ps.cif --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/builtins/ps.cif Wed Jun 23 15:52:26 2010 +0100 @@ -0,0 +1,102 @@ +# ps.cif +# +# Copyright (c) 2010 Accenture. All rights reserved. +# This component and the accompanying materials are made available +# under the terms of the "Eclipse Public License v1.0" +# which accompanies this distribution, and is available +# at the URL "http://www.eclipse.org/legal/epl-v10.html". +# +# Initial Contributors: +# Accenture - Initial contribution +# + +==name ps + +==short-description + +List information relating to the currently running processes and threads. + +==see-also + +L, L, L, L + +==argument uint process_id optional + +The identifier of the process to examine. If not specified, displays information on all processes. + +==option bool v verbose + +Verbose output. Prints warnings if threads couldn't be opened, and displays full thread names instead of short ones. + +==option string m match + +A pattern used to match processes by name (defaults to C<*>). + +==option string M matchify + +Like C<--match> but without the need for leading/trailing asterisks (see C). + +==option bool H human + +Print human readable sizes. + +==option bool p priority + +Print process and thread priority information. + +==option bool x exclude-dead + +Does not list threads/processes that have exited or died (by default they will appear if anything still has a handle open to them). + +==option bool o only-dead + +Only list threads/processes that have exited or died. + +==option bool n handle-count + +Print the number of handles held by a given thread or process. + +==option bool A addresses + +Print kernel object addresses. + +==option bool t threads + +Print thread information. + +==option bool s stacks + +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. + +==option bool a heaps + +Print thread heap usage (only valid with the C<--thread> option). + +==option bool c cpu-time + +Print thread CPU time (only valid with the C<--thread> option). + +==option bool k chunks + +Print details about the chunks belonging to each process. + +==option bool f filename + +Print the executable's file name. + +==option bool r memory + +Print memory usage information. + +==option bool d command_line + +Print the command line arguments. Only available on non-emulated builds of EKA1. + +==option bool l flags + +Print C, C and C flag values. Only available on EKA1. + +==copyright + +Copyright (c) 2005-2010 Accenture. All rights reserved. +