<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE reference
  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="GUID-42CF6D55-CAD2-5049-A1B6-35479404C273" xml:lang="en"><title>DumpSIS</title><abstract><p>The <codeph>DumpSIS</codeph> tool decompiles a SIS file and generates
corresponding PKG and source files. </p></abstract><prolog><metadata><keywords/></metadata></prolog><refbody>
<section><title>Syntax</title> <p><userinput>dumpsis <parmname>[OPTIONS]</parmname> <cmdname>&lt;ARGS&gt;</cmdname> </userinput> </p> <p>The
following table lists the options supported by the <codeph>DumpSIS</codeph> tool. </p> <table id="GUID-6E8DD71C-1B1D-5793-92FC-BEB1D7690AE9">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>Options</entry>
<entry>Description</entry>
<entry>Usage</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <varname>-i</varname>  </p> </entry>
<entry><p>Displays verbose output. </p> </entry>
<entry><p><userinput>dumpsis -i</userinput> </p> </entry>
</row>
<row>
<entry><p> <varname>-v</varname>  </p> </entry>
<entry><p>Displays version number of the tool. </p> </entry>
<entry><p><userinput>dumpsis -v</userinput> </p> </entry>
</row>
<row>
<entry><p> <varname>-h</varname>  </p> </entry>
<entry><p>Displays help message. </p> </entry>
<entry><p><userinput>dumpsis -h</userinput> </p> </entry>
</row>
<row>
<entry><p> <varname>-x</varname>  </p> </entry>
<entry><p>Extracts source files from the SIS file. </p> </entry>
<entry><p><userinput>dumpsis -x filename.sis</userinput> </p> </entry>
</row>
<row>
<entry><p> <varname>-p</varname>  </p> </entry>
<entry><p>Pauses before finishing. </p> </entry>
<entry><p><userinput>dumpsis -p filename.sis</userinput> </p> </entry>
</row>
<row>
<entry><p> <varname>-l</varname>  </p> </entry>
<entry><p>Extracts the executables and its corresponding capabilities from
the input SIS file. It also verifies that the capabilities listed in the SIS
file are the same as those in the executables. </p> </entry>
<entry><p><userinput>dumpsis [-l[-y]][-d directory] filename.sis</userinput> </p> </entry>
</row>
<row>
<entry><p> <varname>-y</varname>  </p> </entry>
<entry><p>Lists the executables and their capabilities. </p> <p>This option
must be specified with the <codeph>-l</codeph> option. </p> </entry>
<entry><p><userinput>dumpsis [-l[-y]][-d directory] filename.sis</userinput> </p> </entry>
</row>
</tbody>
</tgroup>
</table> <p>The following table lists the arguments to be specified with <codeph>DumpSISTool</codeph>. </p> <table id="GUID-62B6C47F-F9E3-5ACE-B83E-E4798A496E0A">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
<row>
<entry>Arguments</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <varname>-d directory</varname>  </p> </entry>
<entry><p>Specifies the directory to which the files are extracted. The directory
is created if it does not exist. </p> <p>By default, files are extracted to
a directory with the same name as the SIS file. </p> </entry>
</row>
<row>
<entry><p> <varname>filename.sis</varname>  </p> </entry>
<entry><p>Specifies the name of the SIS file. </p> </entry>
</row>
</tbody>
</tgroup>
</table> <p><b>Notes</b>:</p><ul>
<li id="GUID-857964D8-29B4-5BE8-8448-F6BF1C7C7D1A"><p>The source-filenames
specified in the original package file are not stored in the SIS file, therefore
DumpSIS creates new filenames for the extracted files. </p> </li>
<li id="GUID-846D5C89-2353-5F41-B11A-DB62E584B23C"><p>DumpSIS does not reinstate
timestamps. </p> </li>
<li id="GUID-659AF74A-65BF-587C-9D47-DC3732A75A85"><p>If the SIS file is signed,
you can display and strip the signatures with <xref href="GUID-B20EE8A3-D7B2-5872-AF43-001A88C1A46E.dita">SignSIS</xref>.
DumpSIS does not preserve or display any signing information. </p> </li>
<li id="GUID-51A7C492-292A-5D0B-8023-A863AFF93506"><p><xref href="GUID-AA555CC1-5CFF-5609-9191-8970F32BA255.dita">CreateSIS</xref> can
be run on the resultant files to recreate the SIS file. </p> </li>
</ul></section>
</refbody><related-links>
<link href="GUID-43B4B4E7-413E-5D18-811C-4B9E38CDEB69.dita"><linktext>PKG Format</linktext>
</link>
<link href="GUID-4BDC9F63-83A1-53A5-91A0-B092AA821755.dita"><linktext>MakeSIS</linktext>
</link>
<link href="GUID-03BBEA31-3266-5B1C-9017-4EE7EA4AF1A8.dita"><linktext>Creating
and Signing an Installation File</linktext></link>
</related-links></reference>