Mercurial Mercurial > oss > FCL > sftools > depl > docscontent / diff
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Symbian3/PDK/Source/GUID-C86A7929-DC0F-50FA-93CB-662A22C4CD35.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-C86A7929-DC0F-50FA-93CB-662A22C4CD35.dita	Fri Jan 22 18:26:19 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 concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-C86A7929-DC0F-50FA-93CB-662A22C4CD35" xml:lang="en"><title>Device
+Variant Using Multiple Keyspace Files</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>This topic describes the use of multiple keyspace files on multiple ROFS
+layers to create a device variant. </p>
+<section><title>Introduction</title> <p>The central respository consists of
+keyspaces used to store application settings. The device variant creators
+need to modify these settings for every variant of the device. </p> <p>In
+the older method the variant engineer has to branch out the exisiting keyspace
+files , modify the settings and reflash the device with the new keyspace files.
+The disadvantage of the older method is that the variant engineer has to maintain
+multiple keyspace files. The modified keyspace must have the same files name
+as the existing one. </p> </section>
+<section><title>Multiple ROFS layers </title> <p>The central repository now
+supports keyspace that is composed of multiple files. A new keyspace file
+is created for a new ROFS layer. This enables the variant engineers to modify
+a specific setting in the keyspace in one layer and merge the repository with
+the new settings. The new feature to modify specific settings of a keyspace
+reduces the time to create different variants. </p> </section>
+<section><title>Merge the settings</title> <p>The figure below shows how a
+specific setting is modified in the new meachnism. In the example below the
+keyspace d is modified in the new ROFS layer to create a variant. The central
+repository reads the keyspace files and merges the modified settings of <codeph>keyspace
+d</codeph>. The settings in the higher ROFS layer get the priority of the
+settings. The higher ROFS layers cannot modify the global properties of the
+keyspaces like metadata, owner information and the access control information. </p> <fig id="GUID-BABA2027-0E54-575A-8A59-EB771CF46529">
+<title>              Central repository - Modify a setting            </title>
+<image href="GUID-D7179664-C442-5253-9925-994CA0C63B50_d0e569071_href.png" placement="inline"/>
+</fig> <p>The figure below shows how a new setting is added to the central
+repository keyspace. </p> <fig id="GUID-B1ED9F5D-4490-5F61-A084-44C8C6C0978C">
+<title>              Central repository - Add a new setting            </title>
+<image href="GUID-3A07445A-1CD4-5556-BE65-553A4A251789_d0e569082_href.png" placement="inline"/>
+</fig> </section>
+<section><title>Advantages</title> <p>The advantages of using
+multiple ROFS layer to create device variant are: </p> <ul>
+<li id="GUID-EED83088-C966-5206-94B3-4B9B693F6CF7"><p>variant engineers can
+modify selective settings in a keyspace </p> </li>
+<li id="GUID-5FCD32A3-8780-5B5C-BE29-0A6BAA068EF6"><p>no need to branch and
+maintain multiple keyspace files for each variant created </p> </li>
+<li id="GUID-89B96F5E-F33D-5512-889A-98D6A9A35033"><p>central repository can
+detect the multiple keyspace files at run time and merge the settings as one
+keyspace </p> </li>
+</ul> </section>
+<section><title>Guidelines</title> <p>The following are some guidelines to
+use the multiple ROFS layers to create device variant: </p> <ul>
+<li id="GUID-2D54FF98-37FE-554A-9C33-A9E60FFA6EF8"><p>Use the binary files
+(CRE) or text files to initialise the keyspaces </p> </li>
+<li id="GUID-97C5701A-58A5-57FD-A1F6-B36CB169D073"><p>Do not use the combination
+of text and binary files for a keyspace. Use one format of the initialisation
+files. </p> </li>
+<li id="GUID-1A5774F2-9CD9-509C-B17C-83990C51973F"><p>The keyspace files in
+higher ROFS layers must not modify the global properties such as metadata,
+owner information and access control information. </p> </li>
+</ul> </section>
+<section><title>Errors</title> <p>The following table shows the possible errors
+that may occur in use of multiple ROFS layers for device variant creation: </p> <table id="GUID-78196B5E-6474-5C23-9488-10290CA7D3D0">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry>Error</entry>
+<entry>Reason for the error</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <codeph>CENREPCLI: Panic 8</codeph>  </p> </entry>
+<entry><p>The binary files (CRE) must be converted with the new central repository
+conversion tool. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>CENREPCLI: Panic 9</codeph>  </p> </entry>
+<entry><p>The keyspace files in the higher layer is trying to modify a global
+property </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>CENREPCLI: Panic 10</codeph>  </p> </entry>
+<entry><p>Higher layer keyspace file is trying to modify a type of a setting
+in the lower layer </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>CENREPCLI: Panic 11</codeph>  </p> </entry>
+<entry><p>The default ROFS layer file is associated with <codeph>exattrib=u
+                  </codeph> attribute </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
+</conbody><related-links>
+<link href="GUID-E3BE62B2-9625-5F79-84A4-0248A3F36225.dita"><linktext> Central
+Repository Access Guide</linktext></link>
+<link href="GUID-1C683226-C142-5C7B-BD20-060058352B08.dita"><linktext>Central Repository
+Guide </linktext></link>
+<link href="GUID-3D152CC5-AF20-520A-AB67-457F956A5551.dita"><linktext>Device Variant
+With Multiple ROFS Layers                 Tutorial </linktext></link>
+</related-links></concept>
\ No newline at end of file
FCL/sftools/depl/docscontent