From 7b597b85405cb0740cbe57af7c1ad5f0cb665b18 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Wed, 10 Feb 1999 18:54:14 +0000 Subject: Now generates HTML, PostScript, and info correctly. --- doc/rtems_gdb/Makefile | 23 +++++++++++------------ doc/rtems_gdb/commands.t | 14 +++++++------- doc/rtems_gdb/example.t | 2 +- doc/rtems_gdb/intro.t | 4 ++++ doc/rtems_gdb/rtems_gdb.texi | 40 +++++++++++----------------------------- doc/rtems_gdb/started.t | 12 ++++-------- doc/rtems_gdb/trouble.t | 10 ++++------ 7 files changed, 42 insertions(+), 63 deletions(-) (limited to 'doc') diff --git a/doc/rtems_gdb/Makefile b/doc/rtems_gdb/Makefile index 42e5da6b4f..60d2863406 100644 --- a/doc/rtems_gdb/Makefile +++ b/doc/rtems_gdb/Makefile @@ -19,8 +19,7 @@ dirs: COMMON_FILES=../common/cpright.texi ../common/setup.texi GENERATED_FILES= \ - intro.t swarch.t started.t commands.t trouble.t example.t - + intro.texi swarch.texi started.texi commands.texi trouble.texi example.texi FILES=$(PROJECT).texi $(GENERATED_FILES) @@ -63,30 +62,30 @@ clean: intro.texi: intro.t Makefile $(BMENU) -p "Top" \ -u "Top" \ - -n "" ${*}.t + -n "Software Architecture" ${*}.t swarch.texi: swarch.t Makefile - $(BMENU) -p "Top" \ + $(BMENU) -p "Introduction" \ -u "Top" \ - -n "" ${*}.t + -n "Getting Started" ${*}.t started.texi: started.t Makefile - $(BMENU) -p "Top" \ + $(BMENU) -p "Software Architecture" \ -u "Top" \ - -n "" ${*}.t + -n "Commands" ${*}.t commands.texi: commands.t Makefile - $(BMENU) -p "Top" \ + $(BMENU) -p "Getting Started Attaching To The System" \ -u "Top" \ - -n "" ${*}.t + -n "Troubleshooting" ${*}.t trouble.texi: trouble.t Makefile - $(BMENU) -p "Top" \ + $(BMENU) -p "Commands Thread control" \ -u "Top" \ - -n "" ${*}.t + -n "Debug Session Example" ${*}.t example.texi: example.t Makefile - $(BMENU) -p "Top" \ + $(BMENU) -p "Troubleshooting Debug server not present" \ -u "Top" \ -n "" ${*}.t diff --git a/doc/rtems_gdb/commands.t b/doc/rtems_gdb/commands.t index fa2d27f8ff..ecbe1dc3cb 100644 --- a/doc/rtems_gdb/commands.t +++ b/doc/rtems_gdb/commands.t @@ -6,7 +6,7 @@ @c $Id$ @c -@section Commands +@chapter Commands The usual GDB commands are available to display or modify data structures and machine registers, disassemble code, display source listings, set and reset @@ -18,26 +18,26 @@ for multi-threaded debugging within a RTEMS host-target environment. These comma are described in this section. -@subsection Host-target connection control +@section Host-target connection control -@itemize +@itemize @bullet @item (gdb) setrpcmode sun : specifies the SUN RPC type. @item (gdb) setdaemontype rdbg : specifies the RDBG debug server type. @item (gdb) target rtems target-name : specifies the target type. @end itemize -@subsection System status information +@section System status information -@itemize +@itemize @bullet @item (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. @end itemize -@subsection Thread control +@section Thread control -@itemize +@itemize @bullet @item (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. @item (gdb) thread detach [id...] : all stops (breakpoints) of some specified diff --git a/doc/rtems_gdb/example.t b/doc/rtems_gdb/example.t index e1f0ea4cbd..97e44e2b2e 100644 --- a/doc/rtems_gdb/example.t +++ b/doc/rtems_gdb/example.t @@ -6,7 +6,7 @@ @c $Id$ @c -@section Debug Session Example +@chapter Debug Session Example @example GNU gdb 4.17 diff --git a/doc/rtems_gdb/intro.t b/doc/rtems_gdb/intro.t index f0c907ec76..23ebad9421 100644 --- a/doc/rtems_gdb/intro.t +++ b/doc/rtems_gdb/intro.t @@ -16,3 +16,7 @@ This paper documents @b{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. + diff --git a/doc/rtems_gdb/rtems_gdb.texi b/doc/rtems_gdb/rtems_gdb.texi index 80316eaa1c..bea340f462 100644 --- a/doc/rtems_gdb/rtems_gdb.texi +++ b/doc/rtems_gdb/rtems_gdb.texi @@ -64,43 +64,25 @@ END-INFO-DIR-ENTRY @c The alternative is to rework a sentence to avoid this problem. @include intro.texi -@include target.texi -@include makefiles.texi -@include linkcmds.texi -@include support.texi -@include init.texi -@include console.texi -@include clock.texi -@include timer.texi -@include rtc.texi -@include nvmem.texi -@include network.texi -@include shmsupp.texi -@include analog.texi -@include discrete.texi +@include swarch.texi +@include started.texi +@include commands.texi +@include trouble.texi +@include example.texi @ifinfo @node Top, Introduction, (dir), (dir) @top rtems_gdb -This is the online version of the Getting Started with RTEMS for C/C++ Users. +This is the online version of the RTEMS/GDB User's Guide. @menu * Introduction:: -* Target Dependent Files:: -* Makefiles:: -* Linker Script:: -* Miscellaneous Support Files:: -* Initialization Code:: -* Console Driver:: -* Clock Driver:: -* Timer Driver:: -* Real-Time Clock Driver:: -* Networking Driver:: -* Non-Volatile Memory Driver:: -* Shared Memory Support Driver:: -* Analog Driver:: -* Discrete Driver:: +* Software Architecture:: +* Getting Started:: +* Commands:: +* Troubleshooting:: +* Debug Session Example:: @end menu @c * Command and Variable Index:: diff --git a/doc/rtems_gdb/started.t b/doc/rtems_gdb/started.t index e2b80b6c36..c639001235 100644 --- a/doc/rtems_gdb/started.t +++ b/doc/rtems_gdb/started.t @@ -7,32 +7,28 @@ @c -@section Getting Started +@chapter Getting Started This section describes the steps which are necessary to set up a debugging session with RTEMS/GDB. -@subsection Compiling The System Components +@section 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 debug session. -@subsection Starting a debugging session +@section Starting a debugging session After having launched GDB, the user must connect to the RTEMS target with the following commands: @example - (gdb) setrpcmode sun - (gdb) setdaemontype rdbg - (gdb) target rtems target-name - @end example Then he can use the file GDB command to specify the binary to be debugged. @@ -42,7 +38,7 @@ file. Each time, the user will launch GDB, it will execute this initialization sequence. -@subsection Attaching To The System +@section 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: diff --git a/doc/rtems_gdb/trouble.t b/doc/rtems_gdb/trouble.t index 28999aac67..462bfda5c1 100644 --- a/doc/rtems_gdb/trouble.t +++ b/doc/rtems_gdb/trouble.t @@ -7,13 +7,13 @@ @c -@section Troubleshooting +@chapter Troubleshooting This section describes symptoms in some situations where the debugger does not work correctly, and it gives guidelines for resolving the problems encountered. -@subsection Target machine name unknown on the host +@section Target machine name unknown on the host RTEMS/GDB fails to connect to target machine named my_target: @@ -28,17 +28,15 @@ host address. Internet number of machine my_target in the file /etc/hosts on your host machine. } -@subsection{Debug server not present +@section Debug server not present The target rtems command fails: @example - -(gdb) target rtems my\_target +(gdb) target rtems my_target Attaching remote machine across net... RPC timed out. Couldn't connect to remote target - @end example -- cgit v1.2.3