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 reference

    11   PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

    12 <reference xml:lang="en" id="GUID-ABD45929-DEA1-5500-B64A-B32F623B6A06"><title>DumpSWIRegistryTool</title><shortdesc> <codeph>DumpSWIRegistryTool</codeph> interprets the software install registry entry (<filepath>.reg</filepath> file) and displays its content. </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody><refsyn><title>Syntax</title> <p><userinput>dumpswiregistrytool <parmname>[OPTIONS]</parmname> <cmdname>

    13           &lt;ARGS&gt;</cmdname> </userinput> </p> <p>The following table lists all the options supported by <codeph>DumpSWIRegistryTool</codeph>. </p> <table id="GUID-F66CFDF9-0C3F-5ED0-B271-C3EC7D7E41D9"><tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><thead><row><entry> Options</entry> <entry>Description</entry> <entry>Usage</entry> </row> </thead> <tbody><row><entry><p> <varname>-v</varname>  </p> </entry> <entry><p>Displays version of the tool. </p> </entry> <entry><p><userinput>dumpswiregistrytool -v</userinput> </p> </entry> </row> <row><entry><p> <varname>-h</varname>  </p> </entry> <entry><p>Displays help message </p> </entry> <entry><p><userinput>dumpswiregistrytool -h</userinput> </p> </entry> </row> <row><entry><p> <varname>-p</varname>  </p> </entry> <entry><p>Displays all the registry entries for a package file along with package information such as package name, package uid, vendor name and so on. </p> </entry> <entry><p><userinput>dumpswiregistrytool [RegistryPath] [-p PackageUid]</userinput> </p> </entry> </row> <row><entry><p> <varname>-r</varname>  </p> </entry> <entry><p>Displays controller information about a package for a specified registry entry. </p> <p>The registry entry is recognized based on package uid, package name and vendor name. </p> </entry> <entry><p><userinput>dumpswiregistrytool [RegistryPath] [-r PackageUid PackageName VendorName]</userinput> </p> </entry> </row> </tbody> </tgroup> </table> <p>The following table lists the arguments to be specified with <codeph>DumpSWIRegistryTool</codeph>. </p> <table id="GUID-D28532B7-5069-518E-B4F2-9F399806B3B6"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><thead><row><entry> Arguments</entry> <entry> Description</entry> </row> </thead> <tbody><row><entry><p> <varname>RegistryPath</varname>  </p> </entry> <entry><p>Specifies the software installation registry path. This overwrites the default PATH provided in environment variable. </p> <p> <b>Note:</b> The default path specified by <codeph>DUMPSWIREGISTRY</codeph> environment variable is <filepath>\epoc32\&lt;platform&gt;\c\sys\install\sisregistry\</filepath>. </p> </entry> </row> <row><entry><p> <varname>PackageUID</varname>  </p> </entry> <entry><p>Specifies the UID of the package. </p> </entry> </row> <row><entry><p> <varname>PackageName</varname>  </p> </entry> <entry><p>Specifies the name of the package. </p> <p>Can be obtained using the <varname>-p</varname> option. </p> </entry> </row> <row><entry><p> <varname>VendorName</varname>  </p> </entry> <entry><p>Specifies the name of the vendor. </p> <p>Can be obtained using the <varname>-p</varname> option. </p> </entry> </row> </tbody> </tgroup> </table> </refsyn> <example id="GUID-AE23E1B6-6816-5413-ACD1-0489E5030570"><title>Examples</title> <p>The following examples illustrates the usage of <codeph>DumpSWIRegistryTool</codeph>: </p> <ul><li id="GUID-E2F0001E-DDA5-51CD-B1DA-540D171DCA74"><p>To retrieve package level information </p> <p><userinput>dumpswiregistrytool -p 101f7989</userinput> </p> <p>This command displays information about all the registry entries of the specified package. In addition to this, it also displays package information such as packageuid, package name, vendor name, number of executables and so on, as shown in the following sample output: </p> <codeblock id="GUID-50992BB5-2979-5B7E-8D33-E0E27AC30F3B" xml:space="preserve">Package Information:

    14 

    15 Registry File :C:\sisregistry\101f7989\00000000.reg

    16 

    17 Package UID :0x101f7989

    18 Package Name :c32exe

    19 Vendor :symbianfoundation

    20 Package Index :0

    21 Drives :2000000

    22 No of executables :0

    23 Package Version :1.2.3

    24 Languages :English

    25 Selected Drive :No Drive Selected

    26 File Major Version :5

    27 File Minor Version :3

    28 Package Vendor Localized Name :symbianfoundation

    29 Package Install Type :Installation

    30 Is Package in ROM :Yes

    31 Package Preinstalled :No

    32 Is Package Signed :No

    33 Package Trust :SisPackageBuiltIntoRom

    34 </codeblock> </li> <li id="GUID-15734E5D-940D-5431-A798-4A04227B17D2"><p>To retrieve controller information for a package when a registry entry (<filepath>.reg</filepath> file) is specified. </p> <p><userinput>dumpswiregistrytool -r 101f7989 c32exe symbianfoundation</userinput> </p> <p>This command displays the controller information at the command prompt as shown in the following sample output: </p> <codeblock id="GUID-DD752B72-2CC2-5CB2-89D8-6C10407B7F9E" xml:space="preserve">Registry Controller Information:

    35 

    36 Registry Entry :\sisregistry\101f7989\00000000.reg

    37 

    38 Package UID :0x101f7989

    39 Package Name :c32exe

    40 Vendor :symbianfoundation

    41 Package Index :0

    42 

    43 Controller1 Version :1.2.3

    44 Controller1 Algorithm :SHA1

    45 

    46 Number of Dependencies : 0

    47 

    48 Number of Embedded Packages : 0

    49 

    50 SISProperty Count:0

    51 

    52 Number Of File Descriptions :1

    53 

    54 SIS File Description:

    55 

    56 Target1:z:\sys\bin\c32exe.exe

    57 File Operation Type :Install

    58 File Operation Options Type :VerifyOnRestore

    59 Algorithm :SHA1

    60 SID :0x0

    61 

    62 Validation Status : PackageInRom

    63 Revocation Status : OcspNotPerformed

    64 </codeblock> </li> </ul> </example> </refbody></reference>