diff -r 5072524fcc79 -r 80ef3a206772 Symbian3/PDK/Source/GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita --- a/Symbian3/PDK/Source/GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita Fri Jul 02 12:51:36 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita Fri Jul 16 17:23:46 2010 +0100 @@ -9,18 +9,20 @@ --> -InterpretSIS

The InterpretSIS tool is a PC-side command-line -tool. It can be used by device creators to install SIS files to a data drive -image that can be flashed to a device internal drive or removable media.

InterpretSIS can -be invoked either through BUILDROM while creating a data drive image or as -a stand-alone tool. If invoking the tool through BUILDROM, the SIS files to -be installed are listed in the OBEY file using the SISfile keyword. For an -example OBEY file, see ROM Tools Guide > ROM Tools Guide > Using ROM Tools -> Building a Data Drive Image.

-
Syntax

interpretsis [OPTIONS] <ARGS>

The following table lists the options supported by -the InterpretSIS tool:

-Interpretsis tool options - +InterpretSIS

The InterpretSIS tool is a PC-side +command-line tool. It can be used by device creators to install SIS +files to a data drive image that can be flashed to a device internal +drive or removable media.

InterpretSIS can +be invoked either through BUILDROM while creating a data drive image +or as a stand-alone tool. If invoking the tool through BUILDROM, the +SIS files to be installed are listed in the OBEY file using the SISfile +keyword. For an example OBEY file, see ROM Tools Guide > ROM Tools +Guide > Using ROM Tools > Building a Data Drive Image.

+
Syntax

interpretsis [OPTIONS] <ARGS>

The following table lists +the options supported by the InterpretSIS tool:

Interpretsis +tool options + + Options @@ -46,14 +48,14 @@

-z

-

The directory representing the Z drive on the -device.

+

The directory representing the Z drive +on the device.

interpretsis -[z dir]

-c

-

(Mandatory). The directory representing the system drive on the -device.

+

(Mandatory). The directory representing the system drive +on the device.

interpretsis [-c dir] [-d drive] [-t romstubdir]

@@ -63,10 +65,10 @@

-r

-

List of ROM or ROFS build log files. For example, see Configuring the content of ROM drive.

This option must not -be used with -z option or define the Z drive -in the configuration file.

-

interpretsis [-r rofsbuild_log_file1,rofsbuild_log _file2,...]

+

List of ROM or ROFS build log files. For example, see Configuring the content of ROM drive.

This option +must not be used with -z option or define the Z drive in the configuration file.

+

interpretsis [-r rofsbuild_log_file1,rofsbuild_log +_file2,...]

-t

@@ -75,29 +77,27 @@

-e

-

Disables eclipsing and SID checks using Z drive. -The -z or -r is not required when this option -is used.

+

Disables eclipsing and SID checks using Z drive. The -z or -r is not required +when this option is used.

interpretsis [-e]

-i

-

Configuration file with HAL attribute values for installation. For -example, see Supporting -device variant creation.

+

Configuration file with HAL attribute values for installation. +For example, see Supporting device variant creation.

interpretsis [-i config_file]

-k

Specifies the SISRegistry version to be generated. For example, -see Configuring -the registry version.

-

interpretsis [-k [4.0 | 5.0 | 5.1 | 5.2 | 5.3 | 5.4]]

+see Configuring the registry version.

+

interpretsis [-k [4.0 | 5.0 | 5.1 | 5.2 | 5.3 +| 5.4]]

-l

-

The log file in which the diagnostic information is stored. By default, -the information is stored in stderr.

+

The log file in which the diagnostic information is stored. +By default, the information is stored in stderr.

interpretsis [-l logfile]

@@ -108,21 +108,20 @@

-p

-

Specifies the file containing additional parameters. Command line -arguments specified after the file overrides the file contents.

+

Specifies the file containing additional parameters. Command +line arguments specified after the file overrides the file contents.

interpretsis [-p param_file]

-s

-

Specifies the SIS files to install.

This option can be used -to override the drive specified in the PKG file. For example, see Overriding the installation drive specified in the PKG file.

The +sucert option -can be used with this option to indicate that the file is signed by a SU certificate. -For example, see Installing -system upgrade packages.

For more information about the options, -see additional -options.

-

interpretsis [-s [sisfile | dir] [+drive [+mcard | +mcardnr -| +mcardalone | + mcardalonenr | +nonremovablepkg] [+sucert]]] [-s ...]

+

Specifies the SIS files to install.

This option can +be used to override the drive specified in the PKG file. For example, +see Overriding the installation drive specified in the PKG file.

The +sucert option can be used with this +option to indicate that the file is signed by a SU certificate. For example, see Installing system upgrade packages.

For more information +about the options, see additional options.

+

interpretsis [-s [sisfile | dir] [+drive [+mcard +| +mcardnr | +mcardalone | + mcardalonenr | +nonremovablepkg] [+sucert]]] +[-s ...]

-w

@@ -131,13 +130,21 @@

-x

-

Removes the files installed for a package. For example, see Uninstalling -preinstalled packages.

This option must not be used with -s option.

+

Removes the files installed for a package. For example, +see Uninstalling preinstalled packages.

This option must +not be used with -s option.

interpretsis [-x pkgUID[,pkgUID2,...]]

+ +

-a

+ + +
-

The following table lists the additional options that can be used:

Additional options +

The following table lists the additional options that +can be used:

+Additional options @@ -148,32 +155,31 @@

mcard

-

Generates stub SIS file for the installation package. This is required -for package propagation.

+

Generates stub SIS file for the installation package. This +is required for package propagation.

mcardnr

-

Generates non-removable stub SIS file for the installation package.

+

Generates non-removable stub SIS file for the installation +package.

mcardalone

-

Generates stub SIS file for the installation package and does not -generate the SIS Registry entry in the $:\sys\install\sisregistry\<package -UID>\ directory. It just creates a preinstalled package on the -media card.

+

Generates stub SIS file for the installation package and +does not generate the SIS Registry entry in the $:\sys\install\sisregistry\<package +UID>\ directory. It just creates a preinstalled package +on the media card.

mcardalonenr

-

Generates non-removable stub SIS file for the installation package -and does not generating the SIS Registry entry in $:\sys\install\sisregistry\<package -UID>\ directory.

+

Generates non-removable stub SIS file for the installation +package and does not generating the SIS Registry entry in $:\sys\install\sisregistry\<package UID>\ directory.

nonremovablepkg

-

Generates a non-removable installation package.

This option -converts a removable SIS file to non-removable SIS file at install time. It -reduces the effort of creating a new SIS file with the NR flag -during device creation.
+

Generates a non-removable installation package.

This option converts a removable SIS file to non-removable SIS file +at install time. It reduces the effort of creating a new SIS file +with the NR flag during device creation.

sucert

@@ -192,8 +198,8 @@

pkgUID

-

The installed package UID either in Hexadecimal or Decimal format -(for example, 0x12345678, 305419896).

+

The installed package UID either in Hexadecimal or Decimal +format (for example, 0x12345678, 305419896).

sisfile