--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-BD9F3912-9C8B-5962-BEC7-D5F961335B49.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,67 @@
+<?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-BD9F3912-9C8B-5962-BEC7-D5F961335B49" xml:lang="en"><title>Kernel
+Trace Tool Overview</title><shortdesc>Describes the Kernel Trace tool to obtain trace information. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-6DC0934A-BE24-4E13-8603-011BBBBFA8DE"><title>Purpose</title> <p>The
+trace tool provides a means of extracting trace data from a memory buffer. </p> </section>
+<section id="GUID-5933F3F4-AE73-4E6D-9E4D-0D5A854F39C3"><title>Required background</title> <p>The
+kernel trace tool LDD is only a part of the actual kernel trace tool. </p> <p>The
+actual kernel trace tool consists of the following: </p> <ul>
+<li id="GUID-1D5857F0-418E-5ECE-BC9F-BF97DF06DAC3"><p><filepath>btracex.ldd</filepath> </p> <p>Used
+to obtain kernel activity and place it in a buffer that can be seen by user-side
+applications. </p> </li>
+<li id="GUID-8C2EA2EA-2A04-51E3-98F3-CBDE01F62CE9"><p>trace filters defined
+in EUser </p> <p>Used to filter out the trace information that is not required. </p> </li>
+<li id="GUID-B370EE1C-8CB3-5A9A-AD70-DB591D77BDFC"><p><filepath>btracec.dll</filepath> and <filepath>btracec.lib</filepath> </p> <p>Used
+to provide an interface for extracting trace data from a memory buffer. </p> </li>
+</ul> </section>
+<section id="GUID-A6FB8DB6-5623-401B-8112-1FD0789B1785"><title>Key concepts
+and terms</title> <dl>
+<dlentry>
+<dt>user-side and kernel-side</dt>
+<dd><p>When an application asks for service from an operating system it is
+actually making a request for the operating system to carry this out (a state
+of affairs known as user-side). The request can only be carried out by the
+operating system (a state of affairs known as kernel-side). </p> <p>This method
+is used to prevent one process (or thread) from interfering with the internal
+operation of another. </p> </dd>
+</dlentry>
+</dl> </section>
+<section id="GUID-86FFD675-07A0-4502-9BDE-58A8FCDB5A7F"><title>Architecture</title> <p>The
+trace tool consists of two parts, a driver on the user-side that captures
+the required kernel events and writes them to a buffer that be accessed by
+user-side applications. Then a trace filter, <filepath>btracec.dll</filepath> and <filepath>btrace.lib</filepath> are
+used as an interface to the trace buffer. </p> </section>
+<section id="GUID-0932C259-5F05-4F95-B16C-C08D345EE3C2"><title>APIs</title> <table id="GUID-AE6F13C1-B835-5A4E-B834-9515146CAA3C">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry>API</entry>
+<entry>Description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <xref href="GUID-9E859841-E8A3-37D5-9A19-BCAA3C700922.dita"><apiname>RBTrace</apiname></xref>  </p> </entry>
+<entry><p>Interface to the fast-trace memory buffer. </p> <p> <note> Use btracec.dll
+and btracec.lib to access this buffer.</note> </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
+<section id="GUID-E461A3A5-99E9-49AC-ADF4-ADEEFE524A47"><title>Typical uses</title> <p>The
+kernel trace tool is intended to be used by developers for obtaining trace
+information. </p> </section>
+</conbody><related-links>
+<link href="GUID-BD9F3912-9C8B-5962-BEC7-D5F961335B49.dita"><linktext>Kernel Trace
+Tool                 Overview</linktext></link>
+</related-links></concept>
\ No newline at end of file