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

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

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

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

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

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

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

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

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

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

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

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

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

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

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

    22 an Object ID or Object Name. </p>

    23 </conbody><related-links>

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

    25 tracing</linktext></link>

    26 </related-links></concept>