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.