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 concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-5F46B075-B76D-40C4-A694-0B1786818699" xml:lang="en"><title>Configuring

    13 the LBS Root Repository Initialisation File (Optional)</title><shortdesc>This topic describes how to configure LBS so that the Privacy Controller

    14 is started when a privacy request is received and LBS is in the Standalone

    15 Privacy Mode configuration. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    16 <p>Implementing an observer class that derives from <xref href="GUID-BF88837F-1ADC-3DB2-98E5-CFBF75E2BE86.dita"><apiname>MLbsPrivacyObserver2</apiname></xref> causes

    17 the licensee Privacy Controller to receive notification of an LBS subsystem

    18 shutdown so that it may free resources and then shut itself down. However

    19 this does not cause the Privacy Controller to be automatically started when

    20 the LBS subsystem is started (for example when a privacy request is received

    21 and the LBS subsystem is configured in the Standalone Privacy Mode configuration).

    22     </p>

    23 <p><i>LBS Root</i> is the process with responsibility for starting and monitoring

    24 all the other processes that are part of the LBS subsystem. LBS Root uses

    25 the Symbian platform Central Repository to store the identities of the processes

    26 that it manages. In order to start the Privacy Controller when LBS starts,

    27 it is necessary to record the UID (secure ID) of the Privacy Controller process

    28 in the LBS Root Central Repository initialisation file.     </p>

    29 <p>The LBS Root repository initialisation source file is stored in the LBS

    30 source tree at <filepath>&lt;source_dir&gt;\LBS\lbsroot\group\10282266.txt</filepath> (the

    31 binary file <filepath>10282266.cre</filepath> is stored at the same location). </p>

    32 <note>The Privacy Controller UID must only be added to the LBSRoot repository

    33 initialisation file when the LBS subsystem is in the Standalone Privacy Mode

    34 configuration. For the <xref href="GUID-A898867E-0C50-583E-979F-132504C24C9A.dita">Full

    35 LBS configuration</xref> (in which the LBS subsystem is started on device

    36 startup in order to be able to handle emergency requests) a licensee should

    37 use a different method of starting their Privacy Controller, such as the Symbian

    38 OS System Starter component.   For the Full LBS configuration it is not the

    39 responsibility of LBS Root to ensure that the Privacy Controller remains available

    40 to handle privacy requests. </note>

    41 <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

    42 Guide</xref>. </p>

    43 </conbody></concept>