Symbian3/PDK/Source/GUID-49D979C8-C9B5-55A4-A496-9B62FC569D05.dita
changeset 14 578be2adaf3e
parent 5 f345bda72bc4
--- a/Symbian3/PDK/Source/GUID-49D979C8-C9B5-55A4-A496-9B62FC569D05.dita	Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-49D979C8-C9B5-55A4-A496-9B62FC569D05.dita	Fri Aug 13 16:47:46 2010 +0100
@@ -1,96 +1,96 @@
-<?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
+<?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>
\ No newline at end of file