diff -r 4816d766a08a -r f345bda72bc4 Symbian3/PDK/Source/GUID-6A8A4910-681B-5E5A-AEA9-FD8BDBD84EDD.dita --- a/Symbian3/PDK/Source/GUID-6A8A4910-681B-5E5A-AEA9-FD8BDBD84EDD.dita Tue Mar 30 11:42:04 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-6A8A4910-681B-5E5A-AEA9-FD8BDBD84EDD.dita Tue Mar 30 11:56:28 2010 +0100 @@ -1,125 +1,125 @@ - - - - - -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 + + + + + +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.

    \ No newline at end of file