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-B1015A9C-C0D5-509E-B7A9-D285BDAB14B5" xml:lang="en"><title>Run Mode

    13 Debugger Overview</title><shortdesc>Allows particular application threads to be paused for debugging.

    14 Provides a standard security-controlled user-side client-server interface

    15 that is suitable for debug tools vendors. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    16 <section id="GUID-3F47E5F0-194D-5A66-9E14-6007C26B363F"><title>Purpose</title> <p>The

    17 Debug Security server provides a client-server interface that can be used

    18 to perform debug operations on an executable running on a Symbian platform

    19 device. </p> </section>

    20 <section id="GUID-8197E066-D6BF-511A-AE50-D80C2DE040F4"><title>Description</title> <p>The

    21 Debug Agent is supplied by the tools vendors, and is responsible for making

    22 use of the debug interface provided by Debug Security Server (DSS) to perform

    23 any required debugging tasks. </p> <p>The tools vendor must provide the following: </p> <ul>

    24 <li id="GUID-54ADD20A-07D2-5140-AB03-09B0A4BF0870"><p>Debug Agent </p> </li>

    25 <li id="GUID-9FAC6BA0-DC7E-59DE-A452-AAEE10E855E5"><p>Host Debugger </p> </li>

    26 <li id="GUID-55E6A7F7-BFCA-5E68-88FC-93E5A1DE9185"><p>Kernel Comms Driver

    27 (optional) </p> </li>

    28 </ul> </section>

    29 <section id="GUID-66DDC7A1-5FE0-4DE5-98CC-0DE562D109BD"><title>Run Mode Debugger Summary</title> <p>Run Mode Debugger provides

    30 the following: </p> <ul>

    31 <li id="GUID-3C9557C6-03D0-5770-A7F2-C175100622D1"><p> <b>Debug Security Server</b>  </p> <p> <filepath>rm_debug_svr.exe</filepath>  </p> <p>Provides

    32 the debug service interface for third-party debug agents. </p> </li>

    33 <li id="GUID-E56FDC59-E338-540A-8FD7-D0CA4380AEA9"><p> <b>Debug Driver</b>  </p> <p> <filepath>rm_debug.ldd</filepath>  </p> <p>The

    34 logical device driver (LDD) used by application debuggers. </p> </li>

    35 </ul> </section>

    36 <section id="GUID-9BDDC462-D1D5-466E-BB73-CBC7CAF18B4F"><title>Using Run Mode Debugger</title> <p>The Run mode debugger is

    37 used to: </p> <ul>

    38 <li id="GUID-ABB19282-7411-51DE-B989-1E34E3AD69C0"><p>Write a debugger agent </p> </li>

    39 <li id="GUID-DAE9B19B-0A37-5B4E-951E-1BA0F7450F51"><p>Control DSS </p> </li>

    40 <li id="GUID-A987D210-62A3-5004-8CCF-BAF11C01FBD2"><p>Access DSS services </p> </li>

    41 </ul> </section>

    42 </conbody><related-links>

    43 <link href="GUID-C3CBD2D6-A010-5006-B352-BE3EC262268D.dita"><linktext>Tools Partner

    44 Guide</linktext></link>

    45 </related-links></concept>