<?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-625A116D-185D-57A3-9FB7-B8257F4AB1B2" xml:lang="en"><title>Setting
Trace Filters Tutorial</title><shortdesc>Explains how to use the kernel trace tool API to filter trace data. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-09C81D5E-A9E0-46E1-8864-744B2B67925D"><title>Purpose</title> <p>Trace
data is written to kernel side chunks. The kernel trace tool API can specify
which trace data should be made available for further processing by setting
filters. </p> </section>
<section id="GUID-508D3D4E-955C-441A-A3BB-382EDD732410"><title>Intended audience</title> <p>This
document is intended for third party developers writing a trace tool using
the kernel trace tool component. </p></section>
<section id="GUID-06E2BA5C-ADA0-40B9-A6C4-C002FE2073BF"><title>Required background</title> <p>The
trace filters defined in <xref href="GUID-8919270A-B5CE-302D-B7CE-3A4680D5E8CF.dita"><apiname>EUser</apiname></xref>. The kernel trace tool component
in general. </p></section>
<section id="GUID-BC0711B7-3D4C-4342-B40A-E7EBCA1D6C83"><title>Introduction</title> <p>Setting
trace filters is a short task which is performed in combination with related
tasks as explained in <xref href="GUID-55C05441-33B5-5057-971D-4200345E941E.dita">Kernel
Trace Tool Tutorial</xref>. </p></section>
<section id="GUID-1585EA7A-1D16-4FA9-8FD3-994C7B6C972B"><title>Using Kernel
Trace tool to set trace filters</title><p>The following tasks will be covered
in this tutorial: </p> <ul>
<li id="GUID-433E2116-7AB1-5FEB-B149-C1841244F47C"><p>Setting trace filters. </p> </li>
</ul> </section>
<section id="GUID-C8B11555-AD81-40A4-AE03-0AA8EE1D49DA"><title>Basic procedure</title><p>The
high level steps to setting trace filters are shown here: </p> <ol id="GUID-47267A33-3AD7-549A-9824-9FD3CEDCE17E">
<li id="GUID-7BC999C6-CC55-5C7F-B77A-30867C8DCCF0"><p>Set a primary filter
specifying a category of data and whether it is to be output or not. </p> </li>
<li id="GUID-AC23ACAB-33A5-56E3-9A68-6EE9901F2C76"><p>Set a secondary filter
if necessary. </p> </li>
</ol> </section>
<section id="GUID-1958FEEB-116F-4E03-B50B-515D1A913D64"><title>Using the API</title> <p>These
are the function calls required to </p> <ol id="GUID-57ED60ED-1168-5AA5-8FB5-E26D3E56DC1A">
<li id="GUID-17C533B3-3B60-5E2B-A25E-F7FB1DB54823"><p>Call the <xref href="GUID-2A3BB97E-35F1-31A9-903F-3A3929524031.dita"><apiname>SetFilter()</apiname></xref> function
of the <xref href="GUID-9E859841-E8A3-37D5-9A19-BCAA3C700922.dita"><apiname>RBTrace</apiname></xref> object. This function takes two arguments: </p> <ul>
<li id="GUID-78E1D9B4-017C-561F-A60B-A7E114DDCECE"><p>An integer representing
the trace category taken from the enumeration <xref href="GUID-5BF17780-AD31-30CF-AFD9-915CBDA74441.dita#GUID-5BF17780-AD31-30CF-AFD9-915CBDA74441/GUID-BAB451BE-11CF-3406-A2C4-242520615248"><apiname>BTrace::TCategories</apiname></xref>,
and </p> </li>
<li id="GUID-A384C0A9-C230-59DA-8FC6-017B6FC5B041"><p>A boolean, True if the
trace category is to be output and False if it is not. </p> </li>
</ul> </li>
<li id="GUID-3211AD05-8222-5E3F-A4CB-55F474C1C4A6"><p>If you need a secondary
trace filter, call the <xref href="GUID-EA3459A9-2DDF-3C4C-AC96-3061A9327B01.dita"><apiname>SetFilter2()</apiname></xref> function of the <xref href="GUID-9E859841-E8A3-37D5-9A19-BCAA3C700922.dita"><apiname>RBTrace</apiname></xref> object. </p> </li>
</ol> </section>
</conbody><related-links>
<link href="GUID-7B477BA5-CC5B-56A2-82BC-E1BC0049FECB.dita"><linktext>Kernel Trace
Tool Overview</linktext></link>
<link href="GUID-55C05441-33B5-5057-971D-4200345E941E.dita"><linktext>Kernel Trace
Tool Tutorial</linktext></link>
</related-links></concept>