commands/heaptrace/heaptrace.cif
author Tom Sutcliffe <thomas.sutcliffe@accenture.com>
Wed, 15 Sep 2010 00:44:34 +0100
changeset 70 b06038904ef8
parent 0 7f656887cf89
permissions -rw-r--r--
Added ==smoke-test support and ciftest command. Commands can now define a "==smoke-test" section in their CIF files, which defines a snippet of fshell script that will be run as part of "fshell smoketest" or by invoking ciftest directly. See the ciftest documentation for more details. Added ==smoke-test sections to a few commands, the ones that were easy to test!

# heaptrace.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 heaptrace

==short-description

Enables tracing for the given thread's heap.

==long-description

This command does not modify any btrace settings, only the flags in the given thread's RAllocator. Therefore to actually get the logs you'll need to do enable btrace and the EHeap category, eg 'btrace -m 1 -f 14'. When FSHELL_ATRACE_USES_BTRACE is not defined, this command uses the autometric eikplugin to switch to a tracing allocator, therefore in this config it is only possible to enable tracing for UI applications. When FSHELL_ATRACE_USES_BTRACE is defined, you can enable tracing for any thread including kernel threads (which trace the kernel heap). To perform the allocator switching regardless of config, use 'amcommand --logging-allocator' instead.

==argument enum command

The command to execute.

==enum-value enable

==enum-value disable

==argument uint thread_id

The TThreadId of the thread whose allocator you want to change.


==copyright

Copyright (c) 2009-2010 Accenture. All rights reserved.