|
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-6A8A4910-681B-5E5A-AEA9-FD8BDBD84EDD"><title>DumpInstallFileStatusTool </title><shortdesc> <codeph>DumpInstallFileStatusTool</codeph> checks the capabilities of executables within a SIS file against the capabilities supported by the signing certificates and displays the missing capabilities corresponding to each executable. </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody><refsyn><title>Syntax</title> <p><userinput>dumpinstallfilestatustool <parmname>[OPTIONS]</parmname> <cmdname> |
|
13 <ARGS></cmdname> </userinput> </p> <p>The following table lists all the options supported by <codeph>DumpInstallFileStatusTool</codeph>. </p> <table id="GUID-9F14F0F0-902F-52EB-AB88-3204C2FE0E9A"><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>dumpinstallfilestatustool [-v]</userinput> </p> </entry> </row> <row><entry><p> <varname>-h</varname> </p> </entry> <entry><p>Displays help message </p> </entry> <entry><p><userinput>dumpinstallfilestatustool [-h]</userinput> </p> </entry> </row> <row><entry><p> <varname>-i</varname> </p> </entry> <entry><p>Displays Open SSL licence. </p> </entry> <entry><p><userinput>dumpinstallfilestatustool [-i]</userinput> </p> </entry> </row> </tbody> </tgroup> </table> <p>The following table lists the arguments to be specified with <codeph>DumpInstallFileStatusTool</codeph>: </p> <table id="GUID-3E878113-8371-517D-8A0E-0CD925C44838"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><thead><row><entry> Arguments</entry> <entry> Description</entry> </row> </thead> <tbody><row><entry><p> <varname>SISFile</varname> </p> </entry> <entry><p>Specifies the name of the signed SIS file, whose capabilites are required to be validated against the signing certificates. </p> </entry> </row> <row><entry><p> <varname>DATFile</varname> </p> </entry> <entry><p>Specifies the location of the swicerstore.dat file on the ROM (For example, <filepath>Z:\resource\swicertstore.dat</filepath>). 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 writable <filepath>swicertstore.dat</filepath> file (For example, <filepath>c:\resource\swicertstore\dat\</filepath> ). Optional if <varname>DATFile</varname> is provided. </p> </entry> </row> <row><entry><p> <varname>Capabilities</varname> </p> </entry> <entry><p>Specifies a list of capabilities. </p> <p> <b>Note</b>: The tool lists all missing capabilities except the user-specified capabilities specified at the command prompt. </p> </entry> </row> </tbody> </tgroup> </table> <p> <b>Important</b>: You must specify the arguments in the same order as shown in the following command line: </p> <p><userinput>DumpInstallFileStatusTool SISFile DATFile Directory Capabilities</userinput> </p> </refsyn> <example id="GUID-CAAC7187-67A6-54FC-8B47-C049391597B5"><title>Examples</title> <p>The following examples illustrates the usage of <codeph>DumpInstallFileStatusTool</codeph>: </p> <ul><li id="GUID-897BE460-3DD0-5592-A22C-6D9830ED2753"><p>To extract and display the missing capabilities for all the executables of a SIS file. </p> <p><userinput>dumpinstallfilestatustool 102042AC.sis swicertstore.dat</userinput> </p> <p>This command lists all the executables and their capability status at the command prompt as shown in the following sample output: </p> <codeblock id="GUID-0E328884-E7C6-59B8-A6D1-8B3CDE049328" xml:space="preserve">Executable : |
|
14 |
|
15 c:\sys\bin\initLogger.exe |
|
16 |
|
17 FILE STATUS : Capabilities are not satisfied . |
|
18 |
|
19 Missing Capabilities List : |
|
20 |
|
21 CommDD |
|
22 PowerMgmt |
|
23 MultimediaDD |
|
24 ReadDeviceData |
|
25 WriteDeviceData |
|
26 DRM |
|
27 TrustedUI |
|
28 ProtServ |
|
29 DiskAdmin |
|
30 NetworkControl |
|
31 AllFiles |
|
32 SwEvent |
|
33 NetworkServices |
|
34 LocalServices |
|
35 ReadUserData |
|
36 WriteUserData |
|
37 Location |
|
38 SurroundingsDD |
|
39 UserEnvironment |
|
40 .... |
|
41 .... |
|
42 .... |
|
43 |
|
44 Executable : |
|
45 |
|
46 c:\sys\bin\closeLogger.exe |
|
47 |
|
48 FILE STATUS : Capabilities are not satisfied . |
|
49 |
|
50 Missing Capabilities List : |
|
51 |
|
52 CommDD |
|
53 PowerMgmt |
|
54 MultimediaDD |
|
55 ReadDeviceData |
|
56 WriteDeviceData |
|
57 DRM |
|
58 TrustedUI |
|
59 ProtServ |
|
60 DiskAdmin |
|
61 NetworkControl |
|
62 AllFiles |
|
63 SwEvent |
|
64 NetworkServices |
|
65 LocalServices |
|
66 ReadUserData |
|
67 WriteUserData |
|
68 Location |
|
69 SurroundingsDD |
|
70 UserEnvironment</codeblock> </li> <li id="GUID-73A67FBD-31D2-511B-81E9-A80FBE411639"><p>To specify the user-specified capabilities at the command prompt: </p> <p><userinput>dumpinstallfilestatustool 102042AC.sis swicertstore.dat ReadUserData WriteUserData</userinput> </p> <p>This command excludes the specified capabilities from the missing capability list as shown in the following sample output: </p> <codeblock id="GUID-DF87B623-4C28-55E6-BA91-A61DFA390CD2" xml:space="preserve">Executable : |
|
71 |
|
72 c:\sys\bin\initLogger.exe |
|
73 |
|
74 FILE STATUS : Capabilities are not satisfied . |
|
75 |
|
76 Missing Capabilities List : |
|
77 |
|
78 CommDD |
|
79 PowerMgmt |
|
80 MultimediaDD |
|
81 ReadDeviceData |
|
82 WriteDeviceData |
|
83 DRM |
|
84 TrustedUI |
|
85 ProtServ |
|
86 DiskAdmin |
|
87 NetworkControl |
|
88 AllFiles |
|
89 SwEvent |
|
90 NetworkServices |
|
91 LocalServices |
|
92 |
|
93 Location |
|
94 SurroundingsDD |
|
95 UserEnvironment |
|
96 .... |
|
97 .... |
|
98 .... |
|
99 |
|
100 Executable : |
|
101 |
|
102 c:\sys\bin\closeLogger.exe |
|
103 |
|
104 FILE STATUS : Capabilities are not satisfied . |
|
105 |
|
106 Missing Capabilities List : |
|
107 |
|
108 CommDD |
|
109 PowerMgmt |
|
110 MultimediaDD |
|
111 ReadDeviceData |
|
112 WriteDeviceData |
|
113 DRM |
|
114 TrustedUI |
|
115 ProtServ |
|
116 DiskAdmin |
|
117 NetworkControl |
|
118 AllFiles |
|
119 SwEvent |
|
120 NetworkServices |
|
121 LocalServices |
|
122 |
|
123 Location |
|
124 SurroundingsDD |
|
125 UserEnvironment</codeblock> <p>Note that the ReadUserData WriteUserData are not displayed in the list. </p> </li> </ul> </example> </refbody></reference> |