1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE reference

    11   PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

    12 <reference id="GUID-63293544-EACF-5F55-BBB5-7A471B4F9A69" xml:lang="en"><title>PKG

    13 File Format for Preinstallation</title><abstract><p>The SIS files that are installed using <codeph>InterpretSIS</codeph> can

    14 be configured to be non-removable. If an attempt is made to uninstall a non-removable

    15 package, an error (<codeph>KErrNotSupported</codeph>) is reported to the UI.

    16 In the package header for non-removable packages, an additional <xref href="GUID-D9D20EE0-AC86-512A-91C0-EA0ACF3912A7.dita#GUID-D9D20EE0-AC86-512A-91C0-EA0ACF3912A7/GUID-3C2E7248-23BD-5A9C-BC4F-2F86B1A94002">package-type</xref> of <codeph>NR</codeph> must be specified. For example: </p> <codeblock id="GUID-036D2CCE-53A0-55BC-AB45-6F9265B49CD4" xml:space="preserve">#{"PackageName"}, (0x80000001), 1, 2, 3, TYPE=SA, NR</codeblock> <p>InterpretSIS

    17 is the preferred mechanism to install non-removable base packages, as Software

    18 Installer only allows you to install a NR base package if it has been signed

    19 using the System Upgrade certificate. If an attempt is made to install a non-removable

    20 base package not signed with a SU cert using the software installer, an error

    21 (<codeph>KErrNotSupported</codeph>) is returned. </p><note>When replacing

    22 or upgrading a non-removable base package using the software installer, the

    23 upgrade package must also be non-removable. See <xref href="GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A.dita">Preinstalled

    24 Package Upgrades</xref> for more information. </note> <p>The following restrictions

    25 apply to the syntax of the PKG files used to create the SIS files for input

    26 to <codeph>InterpretSIS</codeph>: </p> <ul>

    27 <li id="GUID-9DFAD518-B3AF-5D78-92C2-6B0E2C12924C"><p><xref href="GUID-FF82B80D-18CA-5333-83EB-3AB94F696016.dita">Options-List</xref> is

    28 not supported – raises an error. </p> </li>

    29 <li id="GUID-4577E70F-45B1-55D4-AF53-A96127EE7E3D"><p>Embedded SIS Files –

    30 raises a warning. </p> </li>

    31 <li id="GUID-0C9F6AED-4F20-5914-854C-B2745D50126B"><p> <codeph>FILETEXT</codeph>, <codeph>FILERUN</codeph> and <codeph>FILEMIME</codeph> install

    32 options are not supported – raises a warning. </p> </li>

    33 <li id="GUID-7EE19A35-0E29-5C23-B929-74F425D4C673"><p>PP not supported. </p> </li>

    34 </ul> <p>The <codeph>-c</codeph> argument to <xref href="GUID-4BDC9F63-83A1-53A5-91A0-B092AA821755.dita">MakeSIS</xref> can

    35 be used to test whether the PKG file is syntactically valid for <codeph>InterpretSIS</codeph>.

    36 Breaching any of the preceding restrictions causes <codeph>InterpretSIS</codeph> to

    37 fail, reporting a negative error code. </p> <p> <b>Notes</b>: </p> <ul>

    38 <li id="GUID-3E6D1ADE-BB43-551E-96CB-7CA7BFF14FBF"><p>Device creators must

    39 extract the embedded SIS files using <xref href="GUID-42CF6D55-CAD2-5049-A1B6-35479404C273.dita">DumpSIS</xref> and

    40 install them in separate SIS files. Although the <codeph>InterpretSIS</codeph> can

    41 install SIS files that have embedded SIS files it displays a warning if the

    42 embedded SIS file is not already installed. </p> </li>

    43 <li id="GUID-CC06C2B8-456B-54D4-BE63-05D9DBD27E47"><p>SIS files can contain <xref href="GUID-DB220677-5998-529C-BE35-0D66F588E057.dita">dependencies</xref>, which

    44 must be satisfied. </p> </li>

    45 <li id="GUID-C3FDBD3A-48B0-5269-A126-328D31C48CD0"><p> <codeph>InterpretSIS</codeph> reports

    46 an error if any target file locations violate the rules imposed by <i>data

    47 caging</i>, summarised <xref href="GUID-54E62386-E4DB-55C3-BA9A-FFB7BFE6703E.dita#GUID-54E62386-E4DB-55C3-BA9A-FFB7BFE6703E/GUID-C8E8AB80-4EE5-5593-8981-4A91A0111419">here</xref>. </p> </li>

    48 <li id="GUID-B27F0573-5FBF-5645-AB4E-A6836101F843"><p>In any language-dependent

    49 statements, for example <xref href="GUID-9D5F3B5E-37FB-5156-808B-F92519412A7F.dita">Language-Dependent

    50 Files</xref> lists, InterpretSIS always selects English if the input language

    51 has not been provided by the command-line option or in the INI file. If the

    52 given input language is not in the list of supported languages of the SIS

    53 file, it selects the first language in the SIS file </p> </li>

    54 <li id="GUID-A4FA8C80-B7B5-5D93-A51B-08A4D64694C1"><p> <codeph>InterpretSIS</codeph> does

    55 not display the <xref href="GUID-F87A1381-3E71-5723-B8B6-3F4E0FF368CE.dita">Logo</xref> during

    56 installation. However, it installs them. </p> </li>

    57 <li id="GUID-CE3EA24D-2170-565C-8F3C-8AA0F1F7BDE2"><p> <codeph>InterpretSIS</codeph> does

    58 not perform signature verification or revocation checking when installing

    59 packages. Also, it does not perform policing of capabilities allocated to

    60 executables. </p> </li>

    61 <li id="GUID-2AAE33CC-00B1-5B45-84A3-D819B8B6BBCD"><p>Packages installed using <codeph>InterpretSIS</codeph> have

    62 their validation status set to <codeph>EValidatedToAnchor</codeph>. </p> </li>

    63 </ul> </abstract><prolog><metadata><keywords/></metadata></prolog></reference>