--- a/Symbian3/PDK/Source/GUID-AFE0238A-D6A4-5D07-BB99-85E8CF97BD26.dita Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-AFE0238A-D6A4-5D07-BB99-85E8CF97BD26.dita Tue Mar 30 11:56:28 2010 +0100
@@ -1,106 +1,106 @@
-<?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 concept
- PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
-<concept id="GUID-AFE0238A-D6A4-5D07-BB99-85E8CF97BD26" xml:lang="en"><title>Secure
-Software Install SIS Tools Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p>The <b>Secure Software Install SIS Tools</b> enable you to create, sign,
-decompile and preinstall SIS files. </p>
-<section id="GUID-7FDA2D06-5E36-4757-BC83-E78A206FF64B"><title>Description</title> <p>The Secure Software Install SIS Tools
-component comprises the following PC-side command-line tools: </p> <ul>
-<li id="GUID-08851BF3-9C9B-5B82-A231-6B18773E7411"><p>The <xref href="GUID-4BDC9F63-83A1-53A5-91A0-B092AA821755.dita">MakeSIS</xref> tool
-creates unsigned SIS files based on the information provided in an input package
-(PKG) file. </p> </li>
-<li id="GUID-9A4C3909-108E-50F0-A50B-23D95537F56A"><p>The <xref href="GUID-B20EE8A3-D7B2-5872-AF43-001A88C1A46E.dita">SignSIS</xref> tool
-signs SIS files using a certificate and private key. </p> </li>
-<li id="GUID-951A5574-4C25-5EC4-A024-76907FF2A4C6"><p>The <xref href="GUID-AA555CC1-5CFF-5609-9191-8970F32BA255.dita">CreateSIS</xref> tool
-is a wrapper around the MakeSIS, SignSIS, and MakeKeys tools, which automates
-the process of generating and signing SIS files. It supports creating new
-SIS files from package (PKG) files, signing existing package files and generating
-private-public key pair and certificate requests for signing. </p> </li>
-<li id="GUID-F1D3CFEF-7562-5E6C-B2CC-7801DF4D642C"><p>The <xref href="GUID-42CF6D55-CAD2-5049-A1B6-35479404C273.dita">DumpSIS</xref> tool
-decompiles input SIS file and extracts the corresponding PKG and source files. </p> </li>
-<li id="GUID-CEC7BC9C-9E67-58AA-AB48-FBEA773FEEA2"><p>The <xref href="GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita">InterpretSIS</xref> tool
-enables device creators to preinstall SIS files on a device system drive or
-memory card image. The InterpretSIS tool can be invoked either through the
-BUILDROM tool when creating a data drive image, or as a stand-alone tool. </p> </li>
-</ul> </section>
-<section id="GUID-5B284ADE-E9D1-437F-9610-78F20CDD2697"><title>Required background</title> <p>Before you start, you must
-be familiar with the following: </p> <ul>
-<li id="GUID-74F7883B-84E6-5CEF-8B17-90554A3F6048"><p><xref href="GUID-FB2CAA46-8EBB-5F76-847C-F3B953C9D31C.dita">Public
-Key Cryptography</xref> </p> </li>
-<li id="GUID-F3A86986-12F1-5E93-9DD8-DB21EFC84885"><p><xref href="GUID-911E9F7E-D0AD-55EC-A3F4-1D427F803780.dita">Digital
-Certificates</xref> </p> </li>
-</ul> </section>
-<section id="GUID-CF573733-60C3-4EBA-9A87-11A12E06EA4E"><title>Key concepts and terms</title> <dl>
-<dlentry>
-<dt>PKG File</dt>
-<dd><p>A package (PKG) file contains information required by the SIS file
-creation tools to create a SIS file. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>SIS File</dt>
-<dd><p>A Symbian Installation Source (SIS) file is a collection of executables
-and data files, packaged in a way that the software installer can install
-them onto a device. SIS files can be preinstalled on a device. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>Signing</dt>
-<dd><p>A SIS file must be signed with a digital signature, which is used in
-verifying the identity of the vendor of an installation file. This ensures
-that the file has not been tampered with since it was signed. For details
-see, <xref href="GUID-AFBD4ED6-9588-531C-8EDF-566DB1D03088.dita">Signing</xref>. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>Eclipsing</dt>
-<dd><p>Eclipsing is a mechanism to upgrade files existing on the ROM drive,
-by installing a new version of the same on the RAM drive. For details see, <xref href="GUID-F8A26275-883A-5299-9C37-9DDCC2F62108.dita">Eclipsing</xref>. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>System Upgrade Packages</dt>
-<dd><p>System upgrade packages allow device manufacturers to overcome the
-restriction of having a stub SIS file in the ROM drive for eclipsing. For
-details see, <xref href="GUID-CD5907AE-B439-5F76-AE19-9C9491832CB4.dita">System
-Upgrade Packages</xref>. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>Auto-propagation</dt>
-<dd><p>Auto-propagation is a process of automatically installating software
-packages from the media card when it is inserted into the Symbian device.
-For details, see <xref href="GUID-0250833D-7358-57AB-8CB8-956DF4310EFA.dita">Package
-Propagation</xref>. </p> </dd>
-</dlentry>
-</dl> </section>
-<section id="GUID-B5A78585-05EF-4763-8C70-33AE5882F1EA"><title>Typical Uses</title> <p>The SIS tools can be used to perform
-the following: </p> <ul>
-<li id="GUID-0E5E3BED-B678-54E1-98F0-09672A5BDA8C"><p> <b>Create and sign
-an installation file</b> </p> <p>Symbian application developers can create
-installation packages using <codeph>MakeSIS</codeph> and sign them using <codeph>SignSIS</codeph>.
-Alternatively, the <codeph>CreateSIS</codeph> tool, which is a wrapper around <codeph>MakeSIS</codeph> and <codeph>SignSIS</codeph>,
-can be used to create and sign an installation file. For details see <xref href="GUID-03BBEA31-3266-5B1C-9017-4EE7EA4AF1A8.dita">Creating and Signing an Installation
-File</xref> </p> </li>
-<li id="GUID-E5CAFFB6-7396-5220-942D-2406C39D8E01"><p> <b>Upgrade OS components</b> </p> <p>The
-software installer enables a device manufacturer to replace binaries and data
-files in ROM, for example, to fix a software issue, by means of eclipsing.
-For details, see <xref href="GUID-7F65B69A-6AC1-509C-91E8-9E49ED0BFEC0.dita">Upgrading
-an OS Component</xref>. </p> </li>
-<li id="GUID-F782386D-DB8D-5448-BBB3-31E7DA216ABB"><p> <b>Preinstall
-applications</b> </p> <p>Device creators can preinstall applications on device
-system drive or memory card image. For details, see <xref href="GUID-906165AD-D45D-54BB-8094-023F792F1632.dita">Preinstalling
-Applications</xref>. </p> </li>
-</ul> </section>
-</conbody><related-links>
-<link href="GUID-C55D1D74-B764-5DD1-8C43-5A5138578EAC.dita"><linktext>Secure Software
-Install SIS Tools Concepts</linktext></link>
-<link href="GUID-A4C26317-9F76-587E-A4B6-D94892ACF11B.dita"><linktext>Secure Software
-Install SIS Tools Tutorials</linktext></link>
-<link href="GUID-100F41B4-67BE-5978-99DA-C9B6DE8760F7.dita"><linktext>Secure Software
-Install SIS Tools Reference</linktext></link>
+<?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 concept
+ PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-AFE0238A-D6A4-5D07-BB99-85E8CF97BD26" xml:lang="en"><title>Secure
+Software Install SIS Tools Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The <b>Secure Software Install SIS Tools</b> enable you to create, sign,
+decompile and preinstall SIS files. </p>
+<section id="GUID-7FDA2D06-5E36-4757-BC83-E78A206FF64B"><title>Description</title> <p>The Secure Software Install SIS Tools
+component comprises the following PC-side command-line tools: </p> <ul>
+<li id="GUID-08851BF3-9C9B-5B82-A231-6B18773E7411"><p>The <xref href="GUID-4BDC9F63-83A1-53A5-91A0-B092AA821755.dita">MakeSIS</xref> tool
+creates unsigned SIS files based on the information provided in an input package
+(PKG) file. </p> </li>
+<li id="GUID-9A4C3909-108E-50F0-A50B-23D95537F56A"><p>The <xref href="GUID-B20EE8A3-D7B2-5872-AF43-001A88C1A46E.dita">SignSIS</xref> tool
+signs SIS files using a certificate and private key. </p> </li>
+<li id="GUID-951A5574-4C25-5EC4-A024-76907FF2A4C6"><p>The <xref href="GUID-AA555CC1-5CFF-5609-9191-8970F32BA255.dita">CreateSIS</xref> tool
+is a wrapper around the MakeSIS, SignSIS, and MakeKeys tools, which automates
+the process of generating and signing SIS files. It supports creating new
+SIS files from package (PKG) files, signing existing package files and generating
+private-public key pair and certificate requests for signing. </p> </li>
+<li id="GUID-F1D3CFEF-7562-5E6C-B2CC-7801DF4D642C"><p>The <xref href="GUID-42CF6D55-CAD2-5049-A1B6-35479404C273.dita">DumpSIS</xref> tool
+decompiles input SIS file and extracts the corresponding PKG and source files. </p> </li>
+<li id="GUID-CEC7BC9C-9E67-58AA-AB48-FBEA773FEEA2"><p>The <xref href="GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita">InterpretSIS</xref> tool
+enables device creators to preinstall SIS files on a device system drive or
+memory card image. The InterpretSIS tool can be invoked either through the
+BUILDROM tool when creating a data drive image, or as a stand-alone tool. </p> </li>
+</ul> </section>
+<section id="GUID-5B284ADE-E9D1-437F-9610-78F20CDD2697"><title>Required background</title> <p>Before you start, you must
+be familiar with the following: </p> <ul>
+<li id="GUID-74F7883B-84E6-5CEF-8B17-90554A3F6048"><p><xref href="GUID-FB2CAA46-8EBB-5F76-847C-F3B953C9D31C.dita">Public
+Key Cryptography</xref> </p> </li>
+<li id="GUID-F3A86986-12F1-5E93-9DD8-DB21EFC84885"><p><xref href="GUID-911E9F7E-D0AD-55EC-A3F4-1D427F803780.dita">Digital
+Certificates</xref> </p> </li>
+</ul> </section>
+<section id="GUID-CF573733-60C3-4EBA-9A87-11A12E06EA4E"><title>Key concepts and terms</title> <dl>
+<dlentry>
+<dt>PKG File</dt>
+<dd><p>A package (PKG) file contains information required by the SIS file
+creation tools to create a SIS file. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>SIS File</dt>
+<dd><p>A Symbian Installation Source (SIS) file is a collection of executables
+and data files, packaged in a way that the software installer can install
+them onto a device. SIS files can be preinstalled on a device. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>Signing</dt>
+<dd><p>A SIS file must be signed with a digital signature, which is used in
+verifying the identity of the vendor of an installation file. This ensures
+that the file has not been tampered with since it was signed. For details
+see, <xref href="GUID-AFBD4ED6-9588-531C-8EDF-566DB1D03088.dita">Signing</xref>. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>Eclipsing</dt>
+<dd><p>Eclipsing is a mechanism to upgrade files existing on the ROM drive,
+by installing a new version of the same on the RAM drive. For details see, <xref href="GUID-F8A26275-883A-5299-9C37-9DDCC2F62108.dita">Eclipsing</xref>. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>System Upgrade Packages</dt>
+<dd><p>System upgrade packages allow device manufacturers to overcome the
+restriction of having a stub SIS file in the ROM drive for eclipsing. For
+details see, <xref href="GUID-CD5907AE-B439-5F76-AE19-9C9491832CB4.dita">System
+Upgrade Packages</xref>. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>Auto-propagation</dt>
+<dd><p>Auto-propagation is a process of automatically installating software
+packages from the media card when it is inserted into the Symbian device.
+For details, see <xref href="GUID-0250833D-7358-57AB-8CB8-956DF4310EFA.dita">Package
+Propagation</xref>. </p> </dd>
+</dlentry>
+</dl> </section>
+<section id="GUID-B5A78585-05EF-4763-8C70-33AE5882F1EA"><title>Typical Uses</title> <p>The SIS tools can be used to perform
+the following: </p> <ul>
+<li id="GUID-0E5E3BED-B678-54E1-98F0-09672A5BDA8C"><p> <b>Create and sign
+an installation file</b> </p> <p>Symbian application developers can create
+installation packages using <codeph>MakeSIS</codeph> and sign them using <codeph>SignSIS</codeph>.
+Alternatively, the <codeph>CreateSIS</codeph> tool, which is a wrapper around <codeph>MakeSIS</codeph> and <codeph>SignSIS</codeph>,
+can be used to create and sign an installation file. For details see <xref href="GUID-03BBEA31-3266-5B1C-9017-4EE7EA4AF1A8.dita">Creating and Signing an Installation
+File</xref> </p> </li>
+<li id="GUID-E5CAFFB6-7396-5220-942D-2406C39D8E01"><p> <b>Upgrade OS components</b> </p> <p>The
+software installer enables a device manufacturer to replace binaries and data
+files in ROM, for example, to fix a software issue, by means of eclipsing.
+For details, see <xref href="GUID-7F65B69A-6AC1-509C-91E8-9E49ED0BFEC0.dita">Upgrading
+an OS Component</xref>. </p> </li>
+<li id="GUID-F782386D-DB8D-5448-BBB3-31E7DA216ABB"><p> <b>Preinstall
+applications</b> </p> <p>Device creators can preinstall applications on device
+system drive or memory card image. For details, see <xref href="GUID-906165AD-D45D-54BB-8094-023F792F1632.dita">Preinstalling
+Applications</xref>. </p> </li>
+</ul> </section>
+</conbody><related-links>
+<link href="GUID-C55D1D74-B764-5DD1-8C43-5A5138578EAC.dita"><linktext>Secure Software
+Install SIS Tools Concepts</linktext></link>
+<link href="GUID-A4C26317-9F76-587E-A4B6-D94892ACF11B.dita"><linktext>Secure Software
+Install SIS Tools Tutorials</linktext></link>
+<link href="GUID-100F41B4-67BE-5978-99DA-C9B6DE8760F7.dita"><linktext>Secure Software
+Install SIS Tools Reference</linktext></link>
</related-links></concept>
\ No newline at end of file