--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-50CA6507-18AF-58D7-8494-2FECF8FDBDF3.dita Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,74 @@
+<?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-50CA6507-18AF-58D7-8494-2FECF8FDBDF3" xml:lang="en"><title>How
+to use CapCheck</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p> <codeph>CapCheck</codeph> is a tool that allows you to compare the capabilities
+of binaries within your ROM log with a list of expected capabilities, called
+an Expected Capability List. This is to make sure that the applications within
+your ROM image have the correct access rights. </p>
+<p>The Expected Capability list is a text file listing the capabilities you
+expect to find in your ROM log file. This can be created manually or, as a
+starting point, by using the standard output from <codeph>CapSearch</codeph> without
+specifying any capabilities. To be useful, this seeded list must then be modified
+appropriately to include expected capabilities only. All the capabilities
+are listed in hexadecimal format. </p>
+<p>All the permissible capabilities are defined in a Symbian Capability List,
+which is a file called <filepath>e32capability.h</filepath>, located in <filepath><EPOCROOT>\epoc32\include</filepath>. </p>
+<p>To use the <codeph>CapCheck</codeph> tool, you need to define the name
+and location of the ROM log file, the file listing the expected capabilities,
+and the name and location of the Symbian Capability list. </p>
+<p>The results are displayed in a report, in HTML format. </p>
+<section><title>Command line syntax</title> <p>The command line syntax to
+be used for <codeph>CapCheck</codeph> is shown below. </p> <p> <codeph>>CapCheck.pl
+-r <rom_log_file> -e <expected_capability_list> -s <Symbian_capability_list>
+[-R <HTML_report>]</codeph> </p> <p>Mandatory arguments are <codeph>-r</codeph>, <codeph>-e</codeph> and <codeph>-s</codeph>. </p> <p><b>Arguments</b> </p> <p>The following arguments are used. </p> <table id="GUID-C88DC3A2-B2DD-57C8-8F39-01B8FE2CEF34">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<tbody>
+<row>
+<entry><p> <codeph>-r <rom_log_file></codeph> </p> </entry>
+<entry><p>The name and location of the ROM log file to be checked, in relation
+to the directory where the tool is run from, for example <filepath>.\input\rom.log</filepath>.
+This is mandatory. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-e <expected_capability_list></codeph> </p> </entry>
+<entry><p>The name of the file listing the capabilities you expect to find
+in the ROM. This file is a text file created by you, either manually, or by
+using <codeph>CapSearch</codeph>. This flag is mandatory. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-s <Symbian_capability_list></codeph> </p> </entry>
+<entry><p>The name of the Symbian Capability List, listing all the capabilities
+available to search, and their corresponding values (<filepath><EPOCROOT>\epoc32\include\e32capability.h</filepath>. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-R <HTML_report></codeph> </p> </entry>
+<entry><p>Defines the name of the HTML report to be generated in the working
+directory. If not specified, the default name is <filepath>CapCheckReport.html</filepath>.
+This is optional. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-h</codeph> </p> </entry>
+<entry><p>Displays help information (optional). </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> <p><b>Example</b> </p> <p>A full example of how to use the <codeph>CapSearch</codeph> tool
+is shown below: </p> <codeblock id="GUID-5AFC93AE-DCE6-5981-984F-73968E9962E4" xml:space="preserve">>CapCheck.pl -r .\input\rom.log -e MyExpectedCapabilityList.txt -s e32capability.h -R results.html</codeblock> </section>
+</conbody><related-links>
+<link href="GUID-48326B53-0814-57B9-A744-78AA219D3480.dita"><linktext>CapCheck
+report - file format</linktext></link>
+<link href="GUID-3C042957-E7C7-53EC-9397-E5650D2D61AA.dita"><linktext>CapSearch
+Guide</linktext></link>
+<link href="GUID-C244E0D1-DF89-5C86-9C4C-419900BE0DDA.dita"><linktext>CapImportCheck
+Guide</linktext></link>
+</related-links></concept>
\ No newline at end of file