<?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 reference

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

<reference xml:lang="en" id="GUID-49D979C8-C9B5-55A4-A496-9B62FC569D05"><title>DumpSWICertstoreTool </title><shortdesc> <codeph>DumpSWICertstoreTool</codeph> extracts certificate related information such as capabilities and mandatory status from one or more SWI certificate stores. </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody><refsyn><title>Syntax</title> <p><userinput>dumpswicertstoretool <parmname>[OPTIONS]</parmname> <cmdname>

          &lt;ARGS&gt;</cmdname> </userinput> </p> <p>The following table lists all the options supported by <codeph>DumpSWICertstoreTool</codeph>. </p> <table id="GUID-0A7E4045-3A93-5ED9-BF57-317F6EE725EE"><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>dumpswicertstoretool [-v]</userinput> </p> </entry> </row> <row><entry><p> <varname>-h</varname>  </p> </entry> <entry><p>Displays help message. </p> </entry> <entry><p><userinput>dumpswicertstoretool [-h]</userinput> </p> </entry> </row> <row><entry><p> <varname>-i</varname>  </p> </entry> <entry><p>Displays Open SSL licence. </p> </entry> <entry><p><userinput>dumpswicertstoretool [-i]</userinput> </p> </entry> </row> <row><entry><p> <varname>-c</varname>  </p> </entry> <entry><p>Extracts certificates from the <filepath>swicertstore.dat</filepath> file to the current location. </p> </entry> <entry><p><userinput>dumpswicertstoretool [-c] datfile directory</userinput> </p> </entry> </row> <row><entry><p> <varname>-d</varname>  </p> </entry> <entry><p>Displays certificates in PEM format along with details of capabilities and mandatory status. </p> </entry> <entry><p><userinput>dumpswicertstoretool [-d] datfile directory</userinput> </p> </entry> </row> </tbody> </tgroup> </table> <p>The following table lists the arguments to be specified with <codeph>DumpSWICertstoreTool</codeph>. </p> <table id="GUID-94E10ED3-EF1F-54D8-9BE9-2DE30DC5B617"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><thead><row><entry> Arguments</entry> <entry> Description</entry> </row> </thead> <tbody><row><entry><p> <varname>datfile</varname>  </p> </entry> <entry><p>Specifies the location of the <filepath>swicerstore.dat </filepath> file on the ROM ( For example, Z:\resource\swicertstore.dat). Optional, if <varname>directory</varname> is specified. </p> </entry> </row> <row><entry><p> <varname>directory</varname>  </p> </entry> <entry><p>Specifies the location of the <filepath>C:\</filepath> based writable <filepath>swicertstore.dat</filepath> file (For example, c:\resource\swicertstore\dat\ ). Optional, if <varname>datfile</varname> is provided. </p> </entry> </row> </tbody> </tgroup> </table> </refsyn> <example id="GUID-8FA5FE3D-2167-59C3-83C8-DEC6E174A4D4"><title>Examples</title> <p>The following examples illustrates the usage of <codeph>DumpSWICertstoreTool</codeph>: </p> <ul><li id="GUID-8D91867F-4CB3-5F85-9FC7-4FFD29A89398"><p>To display certificate information for all the certificates available in ROM based SWI certificate store. </p> <p><userinput>dumswicertstoretool Z:\resource\swicertstore.dat</userinput> </p> <p>This command displays a list of all the certificates from the ROM based <filepath>swicertstore.dat</filepath> file along with their capability information and mandatory status, at the command-prompt as shown in the following sample output: </p> <codeblock id="GUID-21185073-B3D6-5F08-8568-0B1965D006DC" xml:space="preserve">Z:\resource\swicertstore.dat: ROM Based SwiCertStore:

[Root5CA]

file=Root5CA.der

capability= ReadDeviceData

capability= WriteDeviceData

capability= DRM

capability= AllFiles

application=SWInstall

Mandatory=1

[Sample1RSACA]

file=SymbianTestRSACA.der

capability= TCB

capability= CommDD

application=SWInstall

Mandatory=0

</codeblock> </li> <li id="GUID-71202599-520D-5EB5-9EF6-9732E7BE1B6E"><p>To display certificate information for all the certificates available in the ROM based and <filepath>C:\</filepath> based <filepath>swicertstore.dat</filepath> files. </p> <p><userinput>dumswicertstoretool Z:\resource\swicertstore.dat C:\resource\swicertstore\dat\swicertstore.dat</userinput> </p> <p>This command displays the certificate information as shown in the following sample output: </p> <codeblock id="GUID-03CF2D34-EC61-57F4-B66B-A46C2601E01C" xml:space="preserve">Z:\resource\swicertstore.dat: ROM Based SwiCertStore:

[Root5CA]

file=Root5CA.der

capability= ReadDeviceData

capability= WriteDeviceData

capability= DRM

capability= AllFiles

application=SWInstall

Mandatory=1

[Sample1RSACA]

file=SymbianTestRSACA.der

capability= TCB

capability= CommDD

application=SWInstall

Mandatory=0

C:\resource\swicertstore\dat\swicertstore.dat:

[StatCA]

file=StatCA.der

capability= TCB

capability= CommDD

capability= PowerMgmt

capability= MultimediaDD

capability= ReadDeviceData

capability= WriteDeviceData

capability= DRM

capability= TrustedUI

capability= ProtServ

capability= DiskAdmin

capability= NetworkControl

capability= AllFiles

capability= SwEvent

capability= NetworkServices

capability= LocalServices

capability= ReadUserData

capability= WriteUserData

capability= Location

capability= SurroundingsDD

capability= UserEnvironment

application=SWInstall

application=SWInstallOCSP

Mandatory=0

....

....

[Sample1DSACA]

file = SampleDSACA.der

capability = MultimediaDD

capability = NetworkServices

capability = LocalServices

capability = Location

application = SWInstall

application = SWInstallOCSP

Mandatory = 0

SystemUpgrade = 0

</codeblock> </li> <li id="GUID-A7402E4B-7CD1-5019-BFB5-19C2E018F7F4"><p>To extract all the certificates from the ROM based and writeable <filepath>swicertstore.dat</filepath> files. </p> <p><userinput>dumpswicertstoretool -c Z:\resource\swicertstore.dat C:\resource\swicertstore\dat\swicertstore.dat</userinput> </p> <p>This command extracts all the certificates to the current working directory and displays capability information at the command-prompt. </p> </li> </ul> </example> </refbody></reference>