Symbian3/SDK/Source/GUID-42CF6D55-CAD2-5049-A1B6-35479404C273.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-42CF6D55-CAD2-5049-A1B6-35479404C273.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,105 @@
+<?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>
\ No newline at end of file