RTEMS/GDB User's Guide
Contents
1. _Thread_Dispatch at rtems4 c src exec score src thread c 315 134283270 SPE1 No No _Thread_Handler at rtems4 c src exec score src thread c 1107 134283269 RDBG No No 0x22fe65 in enterRdbg 134283268 SCrx No No _Thread_Dispatch at rtems4 c src exec score src thread c 315 134283267 SCtx No No _Thread_Dispatch at rtems4 c src exec score src thread c 315 134283266 ntwk No No _Thread_Dispatch at rtems4 c src exec score src thread c 315 gdb b init c 92 Breakpoint 1 at 0x200180 file rtems4 c src tests samples debug init c line 92 gdb c Continuing Thread 134283273 Rini has been deleted 12 RTEMS GDB User s Guide Switching to Rtems thread 134283271 Not suspended lt current target thread Breakpoint 1 example2 argument 4 at rtems4 c src tests samples debug init c 92 92 tuto tuti gdb b init c 66 Breakpoint 2 at 0x200128 file rtems4 c src tests samples debug init c line 66 gdb c Continuing Switching to Rtems thread 134283270 Not suspended lt current target thread Breakpoint 2 examplel argument 4 at rtems4 c src tests samples debug init c 66 66 toto titi gdb c Continuing Switching to Rtems thread 134283271 Not suspended lt current target thread Breakpoint 1 example2 argument 4 at rtems4 c src tests samples debug init c 92 92 tuto tuti gdb s 93 if print_enable2 gdb detach Detaching pro2. PC timed out Couldn t connect to remote target gt Verify that the target system is properly configured and is running the debugging daemon and communication stack 10 RTEMS GDB User s Guide Chapter 6 Debug Session Example 11 6 Debug Session Example The following is a debug session Note that some lines have been broken to aviod formatting problems in the printed document GNU gdb 4 17 Copyright 1998 Free Software Foundation Inc GDB is free software covered by the GNU General Public License and you are welcome to change it and or distribute copies of it under certain conditions Type show copying to see the conditions There is absolutely no warranty for GDB Type show warranty for details This GDB was configured as host i686 pc linux gnu target i386 rtens gdb setrpcmode sun gdb setdaemontype rdbg gdb target rtems usnet test Attaching remote machine across net Connected to usnet test Now the run command will start a remote process gdb file buildr4 pc386 tests debug exe Reading symbols from buildr4 pc386 tests debug exe done gdb attach 1 Attaching program buildr4 pc386 tests debug exe pid 1 0x22fe65 in enterRdbg gdb info threads There are 8 threads Id Name Detached Suspended 134283273 Rini No No lt current target thread 0x22fe65 in enterRdbg 134283272 Evnt No No _Thread_Dispatch at rtems4 c src exec score src thread c 315 134283271 SPE2 No No
3. RTEMS GDB User s Guide Edition 1 for 4 5 0 beta3 May 2000 Emmanuel Raguet and Eric Valette Canon Research Centre On Line Applications Research Corporation On Line Applications Research Corporation TEXinfo 1999 09 25 10 COPYRIGHT 1988 2000 On Line Applications Research Corporation OAR The authors have used their best efforts in preparing this material These efforts include the development research and testing of the theories and programs to determine their effectiveness No warranty of any kind expressed or implied with regard to the software or the material contained in this document is provided No liability arising out of the application or use of any product described in this document is assumed The authors reserve the right to revise this material and to make changes from time to time in the content hereof without obligation to notify anyone of such revision or changes Any inquiries concerning RTEMS its related support components or its documentation should be directed to either On Line Applications Research Corporation 4910 L Corporate Drive Huntsville AL 35805 VOICE 256 722 9985 FAX 256 722 0985 EMAIL rtemsCDARcorp com Chapter 1 Introduction 1 1 Introduction GDB 4 17 is a source level symbolic debugger for RTEMS environment This version is an extension of GNU GDB version 4 17 adapted for the debugging of RTEMS applications in a heterogeneous host target environment This paper
4. documents only the RTEMS GDB extensions to GNU GDB 4 17 as well as its use in the RTEMS environment The reader is assumed to be familiar with GNU GDB The RTEMS project would like to thank Emmanuel Raguet raguet crf canon fr and Eric Valette valette crf canon fr of the Canon Research Centre France S A for developing and documenting RTEMS GDB and submitting it RTEMS GDB User s Guide Chapter 2 Software Architecture 3 2 Software Architecture RTEMS GDB host target debugger is architectured around e One debugger running on the host e One debug server running on the target The host debugger communicates with the debug server using Sun RPC over UDP IP Ethernet When opening a debugging session the user takes the control over the entire target system The target system is viewed as a single multi threaded process The debugger can observe the state of the system objects without stopping the entire system However breakpoints and stepping affect stop the entire system For a given target only one single system debugging session is possible at a time RTEMS GDB User s Guide Chapter 3 Getting Started 5 3 Getting Started This section describes the steps which are necessary to set up a debugging session with RTEMS GDB 3 1 Compiling The System Components The components that need to be debugged have to be compiled with the g option in order the generated file to contain the required information for the deb
5. e target type 4 2 System status information e gdb info threads gives a list of all threads in the debuggee their names identifiers and states It also indicates which thread is the target thread 4 3 Thread control e gdb thread target id allows the user to get set the target thread The argument id is either the thread s symbolic name or its local identifier e gdb thread detach id all stops breakpoints of some specified thread s can be ignored using the thread detach command Each time a detached thread hits a breakpoint RTEMS GDB will automatically restart the debuggee without passing control to the user e gdb thread attach id re attach specified thread s RTEMS GDB User s Guide Chapter 5 Troubleshooting 9 5 Troubleshooting This section describes symptoms in some situations where the debugger does not work correctly and it gives guidelines for resolving the problems encountered 5 1 Target machine name unknown on the host RTEMS GDB fails to connect to target machine named my _target gdb target rtems my_target Attaching remote machine across net Invalid hostname Couldn t find remote host address gt Ask your system administrator to add an entry with the Internet number of machine my target in the file etc hosts on your host machine 5 2 Debug server not present The target rtems command fails gdb target rtems my_target Attaching remote machine across net R
6. gram buildr4 pc386 tests debug exe pid 1 Warning the next command will be done localy If you want to restart another remote program reuse the target command gdb quit Table of Contents 1 ANGPOGUCtiON 6 4 4 462095404 64o a a 1 2 Software Architecture oo o o oo oooooo 3 3 Getting Started rat 5 3 1 Compiling The System Components 222220 5 3 2 Starting a debugging session 00 0 e eee ee eee 5 3 3 Attaching To The System 0 00 siad eee eee 5 4 Commander teen T 4 1 Host target connection control 00 ce ee ee eee ri 4 2 System status information 0 000 eee eee eee 7 4 3 Thread Control uud T 5 Troubleshooting ooo o o 9 5 1 Target machine name unknown on the host 9 5 2 Debug server not present 00 eee essen nen 9 6 Debug Session Example 11 RTEMS GDB User s Guide
7. ug session 3 2 Starting a debugging session After having launched GDB the user must connect to the RTEMS target with the following commands gdb setrpcmode sun gdb setdaemontype rdbg gdb target rtems target name Then he can use the file GDB command to specify the binary to be debugged This initialization phase can be written in a gdbinit file Each time the user will launch GDB it will execute this initialization sequence 3 3 Attaching To The System The entire target system is viewed as a single multi threaded process the identifier of which is 1 To attach use gdb attach 1 When successfully attached the user can control the execution of the target system from the debugger RTEMS GDB User s Guide Chapter 4 Commands T 4 Commands The usual GDB commands are available to display or modify data structures and machine registers disassemble code display source listings set and reset breakpoints control the debuggee execution etc Refer to Debugging with GDB for a complete documentation of the standard GDB commands GDB 4 17 has been extended with a number of commands specifically for multi threaded debugging within a RTEMS host target environment These commands are described in this section 4 1 Host target connection control e gdb setrpcmode sun specifies the SUN RPC type e gdb setdaemontype rdbg specifies the RDBG debug server type e gdb target rtems target name specifies th
Download Pdf Manuals
Related Search