<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"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:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-AFB1F350-C5D3-5495-AE20-1AA6888B6FB1" xml:lang="en"><title>How

to Insert Trace Points in a Component </title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>Trace points can be added manually to trace specific-required events in

the source code or component at build time. </p>

<p>To instrument a component, the Instrumentor can use the methods given in

the <filepath>epoc32/include/e32utrace.h</filepath> file. The UTrace API provides

some basic information for each trace, but the Symbian developer has to define

the payload of the trace. It is recommended the Instrumentor is consistent

whilst adding traces in order to help the Trace Collector parse the trace

output once it is on the host. For example, being consistent while formatting

an Object ID or Object Name. </p>

</conbody><related-links>

<link href="GUID-D5984540-A411-52ED-B435-94C67F34ADD5.dita"><linktext>How to enable

tracing</linktext></link>

</related-links></concept>