secureswitools/swianalysistoolkit/source/chainvalidityandinstallfilestatustools/dumpinstallfilestatustool/readme.txt
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Thu, 17 Dec 2009 08:51:10 +0200
changeset 0 ba25891c3a9e
permissions -rw-r--r--
Revision: 200949 Kit: 200951

DUMPINSTALLFILESTATUSTOOL
=========================

DumpInstallFileStatusTool correlates (1) a unified list of capabilities of the form generated by DumpChainValidtyTool 
(2) user specified capabilities on command line (3) table of executables and capabilities in the form generated by DumpSIS.


USAGE
------

The command line syntax is:

dumpinstallfilestatustool  [-v] [-h]  SIS_Input DAT_Input Directory capabilities

where:

SIS_Input	Signed SIS File

DAT_Input	ROM Based SWICertstore.dat. Optional if Directory is specified 

Directory	Writable SWICertstore. Optional if swicertstore.dat is specified

capabilities - user specified capabilities(OPTIONAL).

-h | --help
Print this (help) message

-v | --version
version of DumpSWICertstore tool

NOTE:All inputs must be specified in the same order as mentioned above.



Example Usage:
--------------


1. Command Line Input :
   -------------------

dumpinstallfilestatustool simple.sis \epoc32\release\winscw\udeb\z\resouce\swicertstore.dat

    Output:
   --------

Executable1=!:\Documents\testarmv5\apparc.dll

FILE STATUS : Capabilities are not satisfied
Missing Capabilities :
CommDD
PowerMgmt
MultimediaDD
ReadDeviceData
WriteDeviceData
DRM
TrustedUI
ProtServ
DiskAdmin
NetworkControl
AllFiles
SwEvent
NetworkServices
LocalServices
ReadUserData
WriteUserData
Location
SurroundingsDD
UserEnvironment


Executable2=!:\sys\bin\tswiallcapabilities.exe

FILE STATUS : Capabilities are not satisfied
Missing Capabilities :
ReadDeviceData
WriteDeviceData
ReadUserData
WriteUserData


Press any key to continue

In the above example,user capabilities are not specified.


2.  Command Line Input :
    -------------------

dumpinstallfilestatustool simple.sis \epoc32\release\winscw\udeb\z\resouce\swicertstore.dat  ReadDeviceData ReadDeviceData 											WriteUserData WriteDeviceData

	Output:
	-------



Executable1=!:\Documents\testarmv5\apparc.dll

FILE STATUS : Capabilities are not satisfied
Missing Capabilities :
CommDD
PowerMgmt
MultimediaDD
DRM
TrustedUI
ProtServ
DiskAdmin
NetworkControl
AllFiles
SwEvent
NetworkServices
LocalServices
Location
SurroundingsDD
UserEnvironment


Executable2=!:\sys\bin\tswiallcapabilities.exe

FILE STATUS : Capabilities are satisfied by Signing Certificates
                 in conjunction with User Capabilities

Press any key to continue

In the above example with the addition of user specified capabilties , the second executable's capabilities are satisfied.