diff options
Diffstat (limited to 'doc/started/gdb.t')
-rw-r--r-- | doc/started/gdb.t | 38 |
1 files changed, 35 insertions, 3 deletions
diff --git a/doc/started/gdb.t b/doc/started/gdb.t index d54fca9d42..13716ca635 100644 --- a/doc/started/gdb.t +++ b/doc/started/gdb.t @@ -73,8 +73,40 @@ The files that are found, have been modified by the patch file. @end ifset +@section Using the bit_gdb script -@section GDB with Sparc Instruction Simulation (SIS) +The simplest way to build gdb for RTEMS is to use the @code{bit_gdb} script. +This script interprets the settings in the @code{user.cfg} file to +produce the gdb configuration most appropriate for the target CPU. + +This script is invoked as follows: + +@example +./bit_gdb CPU +@end example + +Where CPU is one of the RTEMS supported CPU families from the following +list: + +@itemize @bullet +@item hppa1.1 +@item i386 +@item i386-elf +@item i386-go32 +@item i960 +@item m68k +@item mips64orion +@item powerpc +@item sh +@item sparc +@end itemize + +If gdb supports a CPU instruction simulator for this configuration, then +it is included in the build. + +@section Using the gdb configure Script Directly + +@subsection GDB with Sparc Instruction Simulation (SIS) @subheading Make the Build Directory @@ -111,7 +143,7 @@ gmake all install @end example -@section GDB with PowerPC Instruction Simulator +@subsection GDB with PowerPC Instruction Simulator @subheading Make the Build Directory @@ -153,7 +185,7 @@ gmake all install @end example -@section GDB for DINK32 +@subsection GDB for DINK32 @subheading Make the Build Directory |