Symbian3/PDK/Source/GUID-5F46B075-B76D-40C4-A694-0B1786818699.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:56:28 +0100
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
permissions -rw-r--r--
Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"

<?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-5F46B075-B76D-40C4-A694-0B1786818699" xml:lang="en"><title>Configuring
the LBS Root Repository Initialisation File (Optional)</title><shortdesc>This topic describes how to configure LBS so that the Privacy Controller
is started when a privacy request is received and LBS is in the Standalone
Privacy Mode configuration. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Implementing an observer class that derives from <xref href="GUID-BF88837F-1ADC-3DB2-98E5-CFBF75E2BE86.dita"><apiname>MLbsPrivacyObserver2</apiname></xref> causes
the licensee Privacy Controller to receive notification of an LBS subsystem
shutdown so that it may free resources and then shut itself down. However
this does not cause the Privacy Controller to be automatically started when
the LBS subsystem is started (for example when a privacy request is received
and the LBS subsystem is configured in the Standalone Privacy Mode configuration).
    </p>
<p><i>LBS Root</i> is the process with responsibility for starting and monitoring
all the other processes that are part of the LBS subsystem. LBS Root uses
the Symbian platform Central Repository to store the identities of the processes
that it manages. In order to start the Privacy Controller when LBS starts,
it is necessary to record the UID (secure ID) of the Privacy Controller process
in the LBS Root Central Repository initialisation file.     </p>
<p>The LBS Root repository initialisation source file is stored in the LBS
source tree at <filepath>&lt;source_dir&gt;\LBS\lbsroot\group\10282266.txt</filepath> (the
binary file <filepath>10282266.cre</filepath> is stored at the same location). </p>
<note>The Privacy Controller UID must only be added to the LBSRoot repository
initialisation file when the LBS subsystem is in the Standalone Privacy Mode
configuration. For the <xref href="GUID-A898867E-0C50-583E-979F-132504C24C9A.dita">Full
LBS configuration</xref> (in which the LBS subsystem is started on device
startup in order to be able to handle emergency requests) a licensee should
use a different method of starting their Privacy Controller, such as the System
Starter component.   For the Full LBS configuration it is not the responsibility
of LBS Root to ensure that the Privacy Controller remains available to handle
privacy requests. </note>
<p>For details about how to configure the LBS Root repository file see the <xref href="GUID-D18B4715-3942-52EA-9D2F-E145037FA47A.dita">LBS Integration and Configuration
Guide</xref>. </p>
</conbody></concept>