URL
https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk
Subversion Repositories openrisc_2011-10-31
[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [debugging-techniques.html] - Rev 509
Go to most recent revision | Compare with Previous | Blame | View Log
<!-- Copyright (C) 2003 Red Hat, Inc. --> <!-- This material may be distributed only subject to the terms --> <!-- and conditions set forth in the Open Publication License, v1.0 --> <!-- or later (the latest version is presently available at --> <!-- http://www.opencontent.org/openpub/). --> <!-- Distribution of the work or derivative of the work in any --> <!-- standard (paper) book form is prohibited unless prior --> <!-- permission is obtained from the copyright holder. --> <HTML ><HEAD ><TITLE >Debugging Techniques</TITLE ><meta name="MSSmartTagsPreventParsing" content="TRUE"> <META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ "><LINK REL="HOME" TITLE="eCos User Guide" HREF="ecos-user-guide.html"><LINK REL="UP" TITLE="eCos Programming Concepts and Techniques" HREF="ecos-programming-concepts-and-techniques.html"><LINK REL="PREVIOUS" TITLE="Compiling a C++ Application" HREF="compiling-cpp-app.html"><LINK REL="NEXT" TITLE="Kernel Instrumentation" HREF="kernel-instrumentation.html"></HEAD ><BODY CLASS="CHAPTER" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >eCos User Guide</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="compiling-cpp-app.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="kernel-instrumentation.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="CHAPTER" ><H1 ><A NAME="DEBUGGING-TECHNIQUES">Chapter 27. Debugging Techniques</H1 ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT ><A HREF="debugging-techniques.html#TRACING" >Tracing</A ></DT ><DT ><A HREF="kernel-instrumentation.html" >Kernel Instrumentation</A ></DT ></DL ></DIV ><P ><SPAN CLASS="PRODUCTNAME" >eCos</SPAN > applications and components can be debugged in traditional ways, with printing statements and debugger single-stepping, but there are situations in which these techniques cannot be used. One example of this is when a program is getting data at a high rate from a real-time source, and cannot be slowed down or interrupted.</P ><P ><SPAN CLASS="PRODUCTNAME" >eCos</SPAN >’s infrastructure module provides a <SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >tracing</I ></SPAN > formalism, allowing the kernel’s tracing macros to be configured in many useful ways. <SPAN CLASS="PRODUCTNAME" >eCos</SPAN >’s kernel provides <I CLASS="FIRSTTERM" >instrumentation buffers</I > which also collect specific (configurable) data about the system’s history and performance.</P ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="TRACING">Tracing</H1 ><P >To use <SPAN CLASS="PRODUCTNAME" >eCos</SPAN >’s tracing facilities you must first configure your system to use <I CLASS="FIRSTTERM" >tracing</I >. You should enable the Asserts and Tracing component (<TT CLASS="OPTION" >CYGPKG_INFRA_DEBUG</TT >) and the <TT CLASS="OPTION" >Use tracing</TT > component within it (<TT CLASS="OPTION" >CYGDBG_USE_TRACING</TT >). These options can be enabled with the <SPAN CLASS="APPLICATION" >Configuration Tool</SPAN > or by editing the file <TT CLASS="FILENAME" ><TT CLASS="REPLACEABLE" ><I >BUILD_DIR</I ></TT >/pkgconf/infra.h </TT > manually.</P ><P >You should then examine all the tracing-related options in the <I CLASS="CITETITLE" >Package: Infrastructure</I > chapter of the <I CLASS="CITETITLE" ><SPAN CLASS="PRODUCTNAME" >eCos</SPAN > Reference Manual</I >. One useful set of configuration options are: <TT CLASS="LITERAL" >CYGDBG_INFRA_DEBUG_FUNCTION_REPORTS</TT > and <TT CLASS="LITERAL" >CYGDBG_INFRA_DEBUG_TRACE_MESSAGE</TT >, which are both enabled by default when tracing is enabled.</P ><P >The following “Hello world with tracing” shows the output from running the hello world program (from <A HREF="building-and-running-sample-appliations.html#ECOS-HELLO-WORLD" >the Section called <I ><SPAN CLASS="PRODUCTNAME" >eCos</SPAN > Hello World</I > in Chapter 13</A >) that was built with tracing enabled: </P ><DIV CLASS="EXAMPLE" ><A NAME="AEN2289"><P ><B >Example 27-1. Hello world with tracing</B ></P ><TABLE BORDER="5" BGCOLOR="#E0E0F0" WIDTH="70%" ><TR ><TD ><PRE CLASS="SCREEN" >$ mips-tx39-elf-run --board=jmr3904 hello Hello, eCos world! ASSERT FAIL: <2>cyg_trac.h [ 623] Cyg_TraceFunction_Report_::set_exitvoid() exitvoid used in typed function TRACE: <1>mlqueue.cxx [ 395] Cyg_ThreadQueue_Implementation::enqueue() {{enter TRACE: <1>mlqueue.cxx [ 395] Cyg_ThreadQueue_Implementation::enqueue() }}RETURNING UNSET! TRACE: <1>mlqueue.cxx [ 126] Cyg_Scheduler_Implementation::add_thread() }}RETURNING UNSET! TRACE: <1>thread.cxx [ 654] Cyg_Thread::resume() }}return void TRACE: <1>cstartup.cxx [ 160] cyg_iso_c_start() }}return void TRACE: <1>startup.cxx [ 142] cyg_package_start() }}return void TRACE: <1>startup.cxx [ 150] cyg_user_start() {{enter TRACE: <1>startup.cxx [ 150] cyg_user_start() (((void))) TRACE: <1>startup.cxx [ 153] cyg_user_start() 'This is the system default cyg_user_start()' TRACE: <1>startup.cxx [ 157] cyg_user_start() }}return void TRACE: <1>sched.cxx [ 212] Cyg_Scheduler::start() {{enter TRACE: <1>mlqueue.cxx [ 102] Cyg_Scheduler_Implementation::schedule() {{enter TRACE: <1>mlqueue.cxx [ 437] Cyg_ThreadQueue_Implementation::highpri() {{enter TRACE: <1>mlqueue.cxx [ 437] Cyg_ThreadQueue_Implementation::highpri() }}RETURNING UNSET! TRACE: <1>mlqueue.cxx [ 102] Cyg_Scheduler_Implementation::schedule() }}RETURNING UNSET! TRACE: <2>intr.cxx [ 450] Cyg_Interrupt::enable_interrupts() {{enter TRACE: <2>intr.cxx [ 450] Cyg_Interrupt::enable_interrupts() }}RETURNING UNSET! TRACE: <2>thread.cxx [ 69] Cyg_HardwareThread::thread_entry() {{enter TRACE: <2>cstartup.cxx [ 127] invoke_main() {{enter TRACE: <2>cstartup.cxx [ 127] invoke_main() ((argument is ignored)) TRACE: <2>dummyxxmain.cxx [ 60] __main() {{enter TRACE: <2>dummyxxmain.cxx [ 60] __main() (((void))) TRACE: <2>dummyxxmain.cxx [ 63] __main() 'This is the system default __main()' TRACE: <2>dummyxxmain.cxx [ 67] __main() }}return void TRACE: <2>memcpy.c [ 112] _memcpy() {{enter TRACE: <2>memcpy.c [ 112] _memcpy() ((dst=80002804, src=BFC14E58, n=19)) TRACE: <2>memcpy.c [ 164] _memcpy() }}returning 80002804 TRACE: <2>cstartup.cxx [ 137] invoke_main() 'main() has returned with code 0. Calling exit()' TRACE: <2>exit.cxx [ 71] __libc_exit() {{enter TRACE: <2>exit.cxx [ 71] __libc_exit() ((status=0 )) TRACE: <2>atexit.cxx [ 84] cyg_libc_invoke_atexit_handlers() {{enter TRACE: <2>atexit.cxx [ 84] cyg_libc_invoke_atexit_handlers() (((void))) Scheduler: Lock: 0 Current Thread: <null> Threads: Idle Thread pri = 31 state = R id = 1 stack base = 800021F0 ptr = 80002510 size = 00000400 sleep reason NONE wake reason NONE queue = 80000C54 wait info = 00000000 <null> pri = 0 state = R id = 2 stack base = 80002A48 ptr = 8000A968 size = 00008000 sleep reason NONE wake reason NONE queue = 80000BD8 wait info = 00000000 </PRE ></TD ></TR ></TABLE ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="compiling-cpp-app.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ecos-user-guide.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="kernel-instrumentation.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Compiling a C++ Application</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ecos-programming-concepts-and-techniques.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Kernel Instrumentation</TD ></TR ></TABLE ></DIV ></BODY ></HTML >
Go to most recent revision | Compare with Previous | Blame | View Log