Collapse all Symbian^3 Application Developer Library

DumpInstallFileStatusTool

DumpInstallFileStatusTool 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.

Syntax

dumpinstallfilestatustool [OPTIONS] <ARGS>

The following table lists all the options supported by DumpInstallFileStatusTool .

Options	Description	Usage
`-v`	Displays version of the tool.	`dumpinstallfilestatustool [-v]`
`-h`	Displays help message	`dumpinstallfilestatustool [-h]`
`-i`	Displays Open SSL licence.	`dumpinstallfilestatustool [-i]`

The following table lists the arguments to be specified with DumpInstallFileStatusTool :

Arguments	Description
`SISFile`	Specifies the name of the signed SIS file, whose capabilites are required to be validated against the signing certificates.
`DATFile`	Specifies the location of the swicerstore.dat file on the ROM (For example, Z:\resource\swicertstore.dat ). Optional if `Directory` is specified.
`Directory`	Specifies the location of the writable swicertstore.dat file (For example, c:\resource\swicertstore\dat\ ). Optional if `DATFile` is provided.
`Capabilities`	Specifies a list of capabilities. Note : The tool lists all missing capabilities except the user-specified capabilities specified at the command prompt.

Important : You must specify the arguments in the same order as shown in the following command line:

DumpInstallFileStatusTool SISFile DATFile Directory Capabilities

Examples

The following examples illustrates the usage of DumpInstallFileStatusTool :

To extract and display the missing capabilities for all the executables of a SIS file.

dumpinstallfilestatustool 102042AC.sis swicertstore.dat

This command lists all the executables and their capability status at the command prompt as shown in the following sample output:

         
          
         
         Executable :

c:\sys\bin\initLogger.exe

FILE STATUS : Capabilities are not satisfied .

Missing Capabilities List :

CommDD
PowerMgmt
MultimediaDD
ReadDeviceData
WriteDeviceData
DRM
TrustedUI
ProtServ
DiskAdmin
NetworkControl
AllFiles
SwEvent
NetworkServices
LocalServices
ReadUserData
WriteUserData
Location
SurroundingsDD
UserEnvironment
....
....
....

Executable :

c:\sys\bin\closeLogger.exe

FILE STATUS : Capabilities are not satisfied .

Missing Capabilities List :

CommDD
PowerMgmt
MultimediaDD
ReadDeviceData
WriteDeviceData
DRM
TrustedUI
ProtServ
DiskAdmin
NetworkControl
AllFiles
SwEvent
NetworkServices
LocalServices
ReadUserData
WriteUserData
Location
SurroundingsDD
UserEnvironment

To specify the user-specified capabilities at the command prompt:

dumpinstallfilestatustool 102042AC.sis swicertstore.dat ReadUserData WriteUserData

This command excludes the specified capabilities from the missing capability list as shown in the following sample output:

         
          
         
         Executable :

c:\sys\bin\initLogger.exe

FILE STATUS : Capabilities are not satisfied .

Missing Capabilities List :

CommDD
PowerMgmt
MultimediaDD
ReadDeviceData
WriteDeviceData
DRM
TrustedUI
ProtServ
DiskAdmin
NetworkControl
AllFiles
SwEvent
NetworkServices
LocalServices
                                                    
Location
SurroundingsDD
UserEnvironment
....
....
....

Executable :

c:\sys\bin\closeLogger.exe

FILE STATUS : Capabilities are not satisfied .

Missing Capabilities List :

CommDD
PowerMgmt
MultimediaDD
ReadDeviceData
WriteDeviceData
DRM
TrustedUI
ProtServ
DiskAdmin
NetworkControl
AllFiles
SwEvent
NetworkServices
LocalServices

Location
SurroundingsDD
UserEnvironment

Note that the ReadUserData WriteUserData are not displayed in the list.

Parent topic: SWI Analysis ToolKit Reference