<?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>