Symbian3/PDK/Source/GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita
changeset 9 59758314f811
parent 5 f345bda72bc4
child 12 80ef3a206772
equal deleted inserted replaced
8:ae94777fff8f 9:59758314f811
    15 be invoked either through BUILDROM while creating a data drive image or as
    15 be invoked either through BUILDROM while creating a data drive image or as
    16 a stand-alone tool. If invoking the tool through BUILDROM, the SIS files to
    16 a stand-alone tool. If invoking the tool through BUILDROM, the SIS files to
    17 be installed are listed in the OBEY file using the SISfile keyword. For an
    17 be installed are listed in the OBEY file using the SISfile keyword. For an
    18 example OBEY file, see <b> ROM Tools Guide &gt; ROM Tools Guide &gt; Using ROM Tools
    18 example OBEY file, see <b> ROM Tools Guide &gt; ROM Tools Guide &gt; Using ROM Tools
    19 &gt; Building a Data Drive Image</b>. </p> </abstract><prolog><metadata><keywords/></metadata></prolog><refbody>
    19 &gt; Building a Data Drive Image</b>. </p> </abstract><prolog><metadata><keywords/></metadata></prolog><refbody>
    20 <section><title>Syntax</title><p><userinput>interpretsis <parmname>[OPTIONS]</parmname> <cmdname>&lt;ARGS&gt;</cmdname> </userinput> </p> <p>The
    20 <section id="GUID-3003AA1E-5C97-4568-992D-55BD949DF733"><title>Syntax</title><p><userinput>interpretsis <parmname>[OPTIONS]</parmname> <cmdname>&lt;ARGS&gt;</cmdname> </userinput> </p> <p>The following table lists the options supported by
    21 following table lists the options supported by the <codeph>InterpretSIS</codeph> tool: </p> <table id="GUID-EB7B464E-6D7A-56EB-A4DD-94352C9250DB">
    21 the <codeph>InterpretSIS</codeph> tool: </p> <table id="GUID-EB7B464E-6D7A-56EB-A4DD-94352C9250DB">
       
    22 <title>Interpretsis tool options</title>
    22 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
    23 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
    23 <thead>
    24 <thead>
    24 <row>
    25 <row>
    25 <entry>Options</entry>
    26 <entry>Options</entry>
    26 <entry>Description</entry>
    27 <entry>Description</entry>
   111 arguments specified after the file overrides the file contents. </p> </entry>
   112 arguments specified after the file overrides the file contents. </p> </entry>
   112 <entry><p><userinput>interpretsis [-p param_file]</userinput> </p> </entry>
   113 <entry><p><userinput>interpretsis [-p param_file]</userinput> </p> </entry>
   113 </row>
   114 </row>
   114 <row>
   115 <row>
   115 <entry><p> <codeph>-s</codeph>  </p> </entry>
   116 <entry><p> <codeph>-s</codeph>  </p> </entry>
   116 <entry><p>Specifies the SIS files to install. This option must not be used
   117 <entry><p>Specifies the SIS files to install.</p> <p>This option can be used
   117 with <codeph>-x</codeph> option. </p> <p>This option can be used to override
   118 to override the drive specified in the PKG file. For example, see <xref href="GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE.dita#GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE/GUID-5ddda82b-39b2-4240-b89b-3f796f8f8e94">Overriding the installation drive specified in the PKG file</xref>. </p> <p>The <codeph>+sucert</codeph> option
   118 the drive specified in the PKG file. For example, see <xref href="GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE.dita#GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE/GUID-5ddda82b-39b2-4240-b89b-3f796f8f8e94">Overriding the installation drive specified in the PKG file</xref>. </p> <p>The <codeph>+sucert</codeph> option
       
   119 can be used with this option to indicate that the file is signed by a <codeph>SU</codeph> certificate.
   119 can be used with this option to indicate that the file is signed by a <codeph>SU</codeph> certificate.
   120 For example, see <xref href="GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE.dita#GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE/GUID-1df8c2ad-3bab-4b03-8245-b37826c2910d">Installing
   120 For example, see <xref href="GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE.dita#GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE/GUID-1df8c2ad-3bab-4b03-8245-b37826c2910d">Installing
   121 system upgrade packages</xref>. </p> </entry>
   121 system upgrade packages</xref>. </p><p>For more information about the options,
       
   122 see <xref href="GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita#GUID-8792CCC3-B70F-53FC-B394-B0069AF90349/GUID-37F7F864-6228-56DA-A62F-43A0E6CAEA96">additional
       
   123 options</xref>.</p></entry>
   122 <entry><p><userinput>interpretsis [-s [sisfile | dir] [+drive [+mcard | +mcardnr
   124 <entry><p><userinput>interpretsis [-s [sisfile | dir] [+drive [+mcard | +mcardnr
   123 | +mcardalone | + mcardalonenr] [+sucert]]] [-s ...]</userinput> </p> </entry>
   125 | +mcardalone | + mcardalonenr | +nonremovablepkg] [+sucert]]] [-s ...]</userinput> </p> </entry>
   124 </row>
   126 </row>
   125 <row>
   127 <row>
   126 <entry><p> <codeph>-w</codeph>  </p> </entry>
   128 <entry><p> <codeph>-w</codeph>  </p> </entry>
   127 <entry><p>The level of diagnostics to display –<codeph>WARN</codeph>, <codeph>ERROR</codeph>, <codeph>INFO</codeph>, <codeph>OFF</codeph> (<codeph>WARN</codeph> by default). </p> </entry>
   129 <entry><p>The level of diagnostics to display –<codeph>WARN</codeph>, <codeph>ERROR</codeph>, <codeph>INFO</codeph>, <codeph>OFF</codeph> (<codeph>WARN</codeph> by default). </p> </entry>
   128 <entry><p><userinput>interpretsis [-w [off | error | warn | info]]</userinput> </p> </entry>
   130 <entry><p><userinput>interpretsis [-w [off | error | warn | info]]</userinput> </p> </entry>
   129 </row>
   131 </row>
   130 <row>
   132 <row>
   131 <entry><p> <codeph>-x</codeph>  </p> </entry>
   133 <entry><p> <codeph>-x</codeph>  </p> </entry>
   132 <entry><p>Removes the files installed for a package. For example, see <xref href="GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE.dita#GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE/GUID-2e68d8df-461c-428e-9874-9b0df47072f0">Uninstalling
   134 <entry><p>Removes the files installed for a package. For example, see <xref href="GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE.dita#GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE/GUID-2e68d8df-461c-428e-9874-9b0df47072f0">Uninstalling
   133 preinstalled packages</xref>. </p> <p>This option must not be
   135 preinstalled packages</xref>. </p> <p>This option must not be used with <codeph>-s</codeph> option. </p> </entry>
   134 used with <codeph>-s</codeph> option. </p> </entry>
       
   135 <entry><p><userinput>interpretsis [-x pkgUID[,pkgUID2,...]]</userinput> </p> </entry>
   136 <entry><p><userinput>interpretsis [-x pkgUID[,pkgUID2,...]]</userinput> </p> </entry>
   136 </row>
   137 </row>
   137 </tbody>
   138 </tbody>
   138 </tgroup>
   139 </tgroup>
   139 </table> <p>The following table lists the additional options that can be used: </p> <table id="GUID-37F7F864-6228-56DA-A62F-43A0E6CAEA96">
   140 </table> <p>The following table lists the additional options that can be used: </p> <table id="GUID-37F7F864-6228-56DA-A62F-43A0E6CAEA96"><title>Additional options</title>
   140 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
   141 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
   141 <thead>
   142 <thead>
   142 <row>
   143 <row>
   143 <entry>Options</entry>
   144 <entry>Options</entry>
   144 <entry>Description</entry>
   145 <entry>Description</entry>
   164 <row>
   165 <row>
   165 <entry><p> <codeph>mcardalonenr</codeph>  </p> </entry>
   166 <entry><p> <codeph>mcardalonenr</codeph>  </p> </entry>
   166 <entry><p>Generates non-removable stub SIS file for the installation package
   167 <entry><p>Generates non-removable stub SIS file for the installation package
   167 and does not generating the SIS Registry entry in <filepath>$:\sys\install\sisregistry\&lt;package
   168 and does not generating the SIS Registry entry in <filepath>$:\sys\install\sisregistry\&lt;package
   168 UID&gt;\</filepath> directory. </p> </entry>
   169 UID&gt;\</filepath> directory. </p> </entry>
       
   170 </row>
       
   171 <row>
       
   172 <entry><p><codeph>nonremovablepkg</codeph></p></entry>
       
   173 <entry><p>Generates a non-removable installation package.</p><note> This option
       
   174 converts a removable SIS file to non-removable SIS file at install time. It
       
   175 reduces the effort of creating a new SIS file with the <codeph>NR</codeph> flag
       
   176 during device creation.</note></entry>
   169 </row>
   177 </row>
   170 <row>
   178 <row>
   171 <entry><p> <codeph>sucert</codeph>  </p> </entry>
   179 <entry><p> <codeph>sucert</codeph>  </p> </entry>
   172 <entry><p>Indicates that the SIS file is signed with a <codeph>SU</codeph> certificate. </p> </entry>
   180 <entry><p>Indicates that the SIS file is signed with a <codeph>SU</codeph> certificate. </p> </entry>
   173 </row>
   181 </row>