source: rtems/doc/started_ada/gdb.t @ 6449498

4.104.114.84.9
Last change on this file since 6449498 was 6449498, checked in by Joel Sherrill <joel.sherrill@…>, on Jan 17, 2002 at 9:47:47 PM

2001-01-17 Joel Sherrill <joel@…>

  • SUPPORT, LICENSE: New files.
  • Numerous files touched as part of merging the 4.5 branch onto the mainline development trunk and ensuring that the script that cuts snapshots and releases works on the documentation.
  • Property mode set to 100644
File size: 4.9 KB
Line 
1@c
2@c  COPYRIGHT (c) 1988-2002.
3@c  On-Line Applications Research Corporation (OAR).
4@c  All rights reserved.
5@c
6@c  $Id$
7@c
8
9@chapter Building the GNU Debugger
10
11GDB is not currently RTEMS aware. The following configurations have been
12successfully used with RTEMS applications:
13
14@itemize @bullet
15@item Sparc Instruction Simulator (SIS)
16@item PowerPC Instruction Simulator (PSIM)
17@item DINK32
18@end itemize
19
20Other configurations of gdb have successfully been used by RTEMS users
21but are not documented here.
22
23@section Unarchive the gdb Distribution
24
25Use the following commands to unarchive the gdb distribution:
26
27@example
28cd tools
29tar xzf ../archive/@value{GDB-TAR}
30@end example
31
32The directory @value{GDB-UNTAR} is created under the tools directory.
33
34@c
35@c  GDB GNAT Patch
36@c
37
38@section Apply GNAT Patch to GDB
39
40@ifclear GDB-GNATPATCH
41No GNAT specific patches are required for @value{GDB-VERSION} to
42support @value{RTEMS-VERSION} and @value{GNAT-VERSION}.
43@end ifclear
44
45@ifset GDB-GNATPATCH
46
47Apply the patch using the following command sequence:
48
49@example
50cd tools/@value{GDB-UNTAR}
51zcat archive/@value{GDB-GNATPATCH} | patch -p1
52@end example
53
54Check to see if any of these patches have been rejected using the following
55sequence:
56
57@example
58cd tools/@value{GDB-UNTAR}
59find . -name "*.rej" -print
60@end example
61
62If any files are found with the .rej extension, a patch has been rejected.
63This should not happen with a good patch file.
64
65To see the files that have been modified use the sequence:
66
67@example
68cd tools/@value{GDB-UNTAR}
69find . -name "*.orig" -print
70@end example
71
72The files that are found, have been modified by the patch file.
73
74@end ifset
75
76@c
77@c  GDB RTEMS Patch
78@c
79
80@section Apply RTEMS Patch to GDB
81
82@ifclear GDB-RTEMSPATCH
83No RTEMS specific patches are required for @value{GDB-VERSION} to
84support @value{RTEMS-VERSION}.
85@end ifclear
86
87@ifset GDB-RTEMSPATCH
88
89Apply the patch using the following command sequence:
90
91@example
92cd tools/@value{GDB-UNTAR}
93zcat archive/@value{GDB-RTEMSPATCH} | patch -p1
94@end example
95
96Check to see if any of these patches have been rejected using the following
97sequence:
98
99@example
100cd tools/@value{GDB-UNTAR}
101find . -name "*.rej" -print
102@end example
103
104If any files are found with the .rej extension, a patch has been rejected.
105This should not happen with a good patch file.
106
107To see the files that have been modified use the sequence:
108
109@example
110cd tools/@value{GDB-UNTAR}
111find . -name "*.orig" -print
112@end example
113
114The files that are found, have been modified by the patch file.
115
116@end ifset
117
118
119@section GDB with Sparc Instruction Simulation (SIS)
120
121@subheading Make the Build Directory
122
123Create a build directory for the SIS Debugger
124
125@example
126cd tools
127mkdir build-sis
128@end example
129
130@subheading Configure for the Build
131
132Configure the GNU Debugger for the
133Sparc Instruction Simulator (SIS):
134
135@example
136cd tools/build-sis
137../@value{GDB-UNTAR}/configure --target-sparc-erc32-aout \
138    --program-prefix=sparc-rtems- \
139    --disable-gdbtk \
140    --enable-targets=all \
141    --prefix=<INSTALL_POINT_FOR_SIS>
142@end example
143
144Where <INSTALL_POINT_FOR_SIS> is a unique location where the gdb
145with SIS will be created. 
146
147@subheading Make the Debugger
148
149From tools/build-sis execute the following command sequence:
150
151@example
152make all install
153@end example
154
155NOTE: The @code{make} utility used should be GNU make.
156
157@section GDB with PowerPC Instruction Simulator
158
159@subheading Make the Build Directory
160
161Create a build directory for the SIS Debugger
162
163@example
164cd tools
165mkdir build-ppc
166@end example
167
168@subheading Configure for the Build
169
170Configure the GNU Debugger for the PowerPC
171Instruction Simulator (PSIM):
172
173@example
174cd tools/build-ppc
175../@value{GDB-UNTAR}/configure \
176      --target=powerpc-unknown-eabi \
177      --program-prefix=powerpc-rtems- \
178      --enable-sim-powerpc \
179      --enable-sim-timebase \
180      --enable-sim-inline \
181      --enable-sim-hardware \
182      --enable-targets=all \
183      --prefix=<INSTALL_POINT_FOR_PPC>
184@end example
185
186Where <INSTALL_POINT_FOR_PPC> is a unique location where the gdb
187with PSIM will be created. 
188
189
190@subheading Make the Debugger
191
192From tools/build-ppc execute the following command sequence:
193
194@example
195make all install
196@end example
197
198NOTE: The @code{make} utility used should be GNU make.
199
200@section GDB for DINK32
201
202@subheading Make the Build Directory
203
204Create a build directory for the DINK32 Debugger
205
206@example
207cd tools
208mkdir build-dink32
209@end example
210
211@subheading Configure for the Build
212
213Configure the GNU Debugger to communicate with
214the DINK32 ROM monitor:
215
216@example
217cd tools/build-dink32
218../@value{GDB-UNTAR}/configure --target-powerpc-elf \
219    --program-prefix=powerpc-rtems- \
220    --enable-targets=all \
221    --prefix=<INSTALL_POINT_FOR_DINK32>
222@end example
223
224Where <INSTALL_POINT_FOR_DINK32> is a unique location where the
225gdb Dink32 will be created.
226
227@subheading Make the Debugger
228
229From tools/build-dink32 execute the following command sequence:
230
231@example
232make all install
233@end example
234
235NOTE: The @code{make} utility used should be GNU make.
Note: See TracBrowser for help on using the repository browser.