--- a/Symbian3/PDK/Source/GUID-1CCFBCD1-543F-5C53-A1E7-594591BB5905.dita Fri Jul 02 12:51:36 2010 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,126 +0,0 @@
-<?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-1CCFBCD1-543F-5C53-A1E7-594591BB5905" xml:lang="en"><title>How
-to use CapImportCheck</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p><codeph>CapImportCheck</codeph> is a command line tool that allows you
-to compare the capabilities of a binary file with the capabilities of the
-binaries that may import that specific file. </p>
-<p>To use <codeph>CapImportCheck</codeph>, you need to define the name and
-location of the ROM log file, and the Symbian Capability List (<filepath><EPOCROOT>\epoc32\include\e32capability.h</filepath>). </p>
-<p>You also need to define the location of a file containing dependency data
-for ROM log binaries. This data is generated as a text file by a tool called <codeph>ImportsAnalyser</codeph>,
-provided with <codeph>CapImportCheck</codeph> (see below). This data is used
-by <codeph>CapImportCheck</codeph> to determine which binaries may import
-a given binary.</p>
-<p>The results are presented in HTML format, but may also be printed to the
-standard output.</p>
-<section><title>Running ImportsAnalyser</title> <p><codeph>ImportsAnalyser</codeph> is
-used to generate a mapping between a binary file and the binaries which import
-it. This information is used by <codeph>CapImportCheck</codeph> to determine
-dependency relationships between binaries in the ROM log.</p> <p><b>Command
-line syntax</b> </p> <p>The command line syntax to be used when running <codeph>CapImportsAnalyser</codeph> is
-shown below. </p> <p><codeph>>ImportsAnalyser.pl –r myRom.log [–p pluginTable.pld]
-[–D DependencyDataFile.txt] </codeph> </p> <p><b>Arguments</b> </p> <p>The
-following arguments are used.</p> <table id="GUID-FCFDB3E7-4BE3-59D5-B1B8-593CE485F770">
-<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>-p <plugin_table></codeph> </p> </entry>
-<entry><p>The name of the <filepath>.pld</filepath> file containing plug-in
-relationships. This may be found <filepath><EPOCROOT>\epoc32\tools\CapTools\data</filepath>.
-If no plug-in table is specified, no dynamic dependencies are generated.</p> </entry>
-</row>
-<row>
-<entry><p><codeph>-D <dependency_data_file></codeph> </p> </entry>
-<entry><p>Defines the location of the output file containing dependency data.</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>An example of how to use the <codeph>ImportsAnalyser</codeph> tool
-is shown below:</p> <codeblock id="GUID-67B4385F-6292-5833-BF01-D6D92DF1E2FD" xml:space="preserve">>ImportsAnalyser.pl -r .\input\rom.log -p plugintable.pld -D .input\depsData.txt</codeblock> </section>
-<section><title>Running CapImportCheck</title> <p>Once the dependency data
-has been generated, you can run <codeph>CapImportCheck</codeph>. Along with
-the dependency data file, you also need to specify the name and location of
-the ROM log file and the Symbian Capability list.</p> <p>You may also specify
-a capability override file, listing capabilities to be used instead of the
-capabilities of binaries found in the ROM log. </p> <p><b>Command line syntax</b> </p> <p>The
-command line syntax to be used when running <codeph>CapImportCheck</codeph> is
-shown below. </p> <p><codeph>>CapImportCheck.pl -r <rom_log_file> -s <Symbian_capability_list>
--D <dependency_data_file> [-o <override_file>] [-R <HTML_report>]</codeph> </p> <p>Mandatory
-arguments are <codeph>-r</codeph>, <codeph>-s</codeph> and <codeph>-D</codeph>.</p> <p><b>Arguments</b> </p> <p>The
-following arguments are used.</p> <table id="GUID-7A42DC75-B9B6-5FDC-BEF9-AB68B6C9CBB6">
-<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>-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. This is a header file
-named <filepath>e32capability.h</filepath>, located within <filepath><EPOCROOT>\epoc32\include</filepath>.
-This flag is mandatory.</p> </entry>
-</row>
-<row>
-<entry><p><codeph>-D <dependency_data_file></codeph> </p> </entry>
-<entry><p>Defines the location of the dependency data.</p> </entry>
-</row>
-<row>
-<entry><p><codeph>-O <override_file></codeph> </p> </entry>
-<entry><p>Defines a text file containing a list of binaries and capabilities,
-to be used instead of the ones found in the ROM log. This is optional. </p> <p>The
-file may contain a list of modifications to the set of capabilities granted
-to specified binaries. Capabilities can be added, removed or assigned, using
-the following format:</p> <codeblock id="GUID-2DAF3E35-2A1A-562E-B8F2-851AA5C9FA13" xml:space="preserve">
-agnmodel.dll +00000000 000000c0
-agnmodel.dll -00000000 00808000
-form.dll +00000000 0F80FFFF</codeblock> <p>where the first line specifies
-that <filepath>agnmodel.dll</filepath> should be granted <codeph>c0</codeph> capabilities
-in addition to any existing capabilities, and the second line specifies that
-it should have its <codeph>808000</codeph> capabilities revoked. The third
-line specifies that <filepath>form.dll</filepath> should have those exact
-capabilities regardless of its existing capabilities.</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>CapImportCheckReport.html</filepath>. </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>An example of how to use the <codeph>CapImportCheck</codeph> tool
-is shown below:</p> <codeblock id="GUID-4C707D85-3012-5097-8DB1-B521640CA3E0" xml:space="preserve">>CapImportCheck.pl -r .\input\rom.log -s e32capability.h -D .input\depsData.txt -R results.html</codeblock> </section>
-</conbody><related-links>
-<link href="GUID-7387B16E-1978-5997-ACCB-BEBFD2609C86.dita"><linktext>CapImportCheck
- report - file format</linktext></link>
-<link href="GUID-3C042957-E7C7-53EC-9397-E5650D2D61AA.dita"><linktext>CapSearch
-Guide</linktext></link>
-<link href="GUID-54E05FE1-1A71-5293-9FB5-E27D7DF2392B.dita"><linktext>CapCheck
-Guide</linktext></link>
-</related-links></concept>
\ No newline at end of file