Symbian3/SDK/Source/GUID-935DF48C-F014-5E2A-8BE6-29B00C4FD31D.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-935DF48C-F014-5E2A-8BE6-29B00C4FD31D.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,60 @@
+<?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-935DF48C-F014-5E2A-8BE6-29B00C4FD31D" xml:lang="en"><title>Component
+Specific Debugging Help</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-320B950A-06A8-54A2-89F4-87FE3D7384E1"><title>Node Framework</title> <p>To
+debug any Node in the Comms Three Plane Architecture, use: </p> <ul>
+<li id="GUID-C43A1617-B957-5C76-B8CA-BDBEF4EB2CE6"><p>SVG diagrams to see
+the message traffic. See <xref href="GUID-ABE77283-EED8-5A33-B574-3B771EF11086.dita">How
+to Use ULogger with Comms</xref>  </p> </li>
+<li id="GUID-8ED2D6CD-D55C-5698-A49A-E8478C9FCD03"><p>Conditional breakpoints
+in the <codeph>ReceivedL</codeph> function of the Node. </p> <p>The extensive
+re-use of code for states and transitions causes breakpoints in the code for
+states and transitions to be called many times. These breakpoints may not
+be effective. Set conditional breakpoints in the ReceiveL functon of Nodes
+to track the processing of messages within a Node. </p> </li>
+</ul> </section>
+<section id="GUID-820398A9-17FD-5A87-8C45-64BDD99C312D"><title>IP Networking</title> <p> <b>General
+networking</b> - For debugging network problems, a version of ping and IPConfig
+are provided with the source code for Symbian platform and built into test
+builds. To build manually, the code is located in <codeph>\networking\inetutil\</codeph>. </p> <p> <b>IPSec,
+IPSec6, IPSecPol</b> - These components use Flogger. For more information
+see <xref href="GUID-0EF25CCA-1E6B-5B62-8E77-9A670986C5EF.dita">Textual Logging</xref>. </p> <p> <b>PPP,
+RAW IP and other NIF 's</b> - Full packet logging of each PPP frame is available
+from the PPP component. Enable the CDU tags and extract the binary output
+from the log file using the <codeph>splitlog.bat</codeph> program. For more
+information see <xref href="GUID-0EF25CCA-1E6B-5B62-8E77-9A670986C5EF.dita">Textual
+Logging</xref>. This binary output can then be loaded into a packet viewer
+program such as the freeware Wireshark (formerly Ethereal). For more information
+see <xref href="GUID-61B3E668-07ED-58BD-9D11-04BC293A5187.dita#GUID-61B3E668-07ED-58BD-9D11-04BC293A5187/GUID-D98CA3A0-5B40-5CF2-8DD7-552A6E12B34A">PPP
+Ini File: [log]</xref>. The RAW IP NIF will similarly log, using the CDU tag
+"<codeph>LOG RawIP *</codeph> ", in the Wireshark-compatible <i>pcap</i> format.
+The Ethernet NIF uses the "<codeph>LOG TCPDump           *</codeph> " tags. </p> <p>The
+TCPdumping example code hooks into the TCP/IP stack and dumps the TCP traffic
+in pcap format, which is suitable for loading into Wireshark. This is useful
+when using a NIF which does not provide its own logging. The TCPdumping executable
+is only built in test builds, so to build it manually refer to the source
+code located at <filepath>networking\examplecode\tcpdumping</filepath>. </p> <p> <b>Tcpip6</b> -
+The logs from this component are some of the most useful when debugging. Note
+that some versions of this component use Flogger, while others use CDU with
+the tags "<codeph>LOG inet6 *</codeph> ". </p> </section>
+<section id="GUID-867983C3-9C7F-5C28-AE1B-5DE0451C8AD4"><title>Bluetooth</title> <p> <b>Bluetooth</b> -
+The Bluetooth host controller allows vendor-specific debugging events to be
+reported back using a secure channel. For more information see <xref href="GUID-5C63EF5C-826D-5838-BB7E-12FF4EA1DFCE.dita">Debugging
+the Host Controller</xref>. </p> </section>
+<section id="GUID-0FF90100-006F-55BE-8E5C-41BAE8D5C92E"><title>Telephony</title> <p> <b>Etel</b> -
+The <xref href="GUID-D49696D1-4B84-56B5-909D-A15F599F4B6D.dita">Telephony Server</xref> can
+record and play back the IPC messages passing through the server. It can be
+installed on the device to record the messages, and then the recording can
+be processing in a debugging environment without the need for the specific
+device or network environment. This is very useful for reproducing defects. </p> </section>
+</conbody></concept>
\ No newline at end of file