OpenCores
URL https://opencores.org/ocsvn/or1k_old/or1k_old/trunk

Subversion Repositories or1k_old

[/] [or1k_old/] [trunk/] [rtems-20020807/] [doc/] [started_ada/] [gdb.t] - Blame information for rev 1782

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 1026 ivang
@c
2
@c  COPYRIGHT (c) 1988-2002.
3
@c  On-Line Applications Research Corporation (OAR).
4
@c  All rights reserved.
5
@c
6
@c  gdb.t,v 1.6 2002/01/17 21:47:46 joel Exp
7
@c
8
 
9
@chapter Building the GNU Debugger
10
 
11
GDB is not currently RTEMS aware. The following configurations have been
12
successfully 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
 
20
Other configurations of gdb have successfully been used by RTEMS users
21
but are not documented here.
22
 
23
@section Unarchive the gdb Distribution
24
 
25
Use the following commands to unarchive the gdb distribution:
26
 
27
@example
28
cd tools
29
tar xzf ../archive/@value{GDB-TAR}
30
@end example
31
 
32
The 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
41
No GNAT specific patches are required for @value{GDB-VERSION} to
42
support @value{RTEMS-VERSION} and @value{GNAT-VERSION}.
43
@end ifclear
44
 
45
@ifset GDB-GNATPATCH
46
 
47
Apply the patch using the following command sequence:
48
 
49
@example
50
cd tools/@value{GDB-UNTAR}
51
zcat archive/@value{GDB-GNATPATCH} | patch -p1
52
@end example
53
 
54
Check to see if any of these patches have been rejected using the following
55
sequence:
56
 
57
@example
58
cd tools/@value{GDB-UNTAR}
59
find . -name "*.rej" -print
60
@end example
61
 
62
If any files are found with the .rej extension, a patch has been rejected.
63
This should not happen with a good patch file.
64
 
65
To see the files that have been modified use the sequence:
66
 
67
@example
68
cd tools/@value{GDB-UNTAR}
69
find . -name "*.orig" -print
70
@end example
71
 
72
The 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
83
No RTEMS specific patches are required for @value{GDB-VERSION} to
84
support @value{RTEMS-VERSION}.
85
@end ifclear
86
 
87
@ifset GDB-RTEMSPATCH
88
 
89
Apply the patch using the following command sequence:
90
 
91
@example
92
cd tools/@value{GDB-UNTAR}
93
zcat archive/@value{GDB-RTEMSPATCH} | patch -p1
94
@end example
95
 
96
Check to see if any of these patches have been rejected using the following
97
sequence:
98
 
99
@example
100
cd tools/@value{GDB-UNTAR}
101
find . -name "*.rej" -print
102
@end example
103
 
104
If any files are found with the .rej extension, a patch has been rejected.
105
This should not happen with a good patch file.
106
 
107
To see the files that have been modified use the sequence:
108
 
109
@example
110
cd tools/@value{GDB-UNTAR}
111
find . -name "*.orig" -print
112
@end example
113
 
114
The 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
 
123
Create a build directory for the SIS Debugger
124
 
125
@example
126
cd tools
127
mkdir build-sis
128
@end example
129
 
130
@subheading Configure for the Build
131
 
132
Configure the GNU Debugger for the
133
Sparc Instruction Simulator (SIS):
134
 
135
@example
136
cd 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=
142
@end example
143
 
144
Where  is a unique location where the gdb
145
with SIS will be created.
146
 
147
@subheading Make the Debugger
148
 
149
From tools/build-sis execute the following command sequence:
150
 
151
@example
152
make all install
153
@end example
154
 
155
NOTE: 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
 
161
Create a build directory for the SIS Debugger
162
 
163
@example
164
cd tools
165
mkdir build-ppc
166
@end example
167
 
168
@subheading Configure for the Build
169
 
170
Configure the GNU Debugger for the PowerPC
171
Instruction Simulator (PSIM):
172
 
173
@example
174
cd 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=
184
@end example
185
 
186
Where  is a unique location where the gdb
187
with PSIM will be created.
188
 
189
 
190
@subheading Make the Debugger
191
 
192
From tools/build-ppc execute the following command sequence:
193
 
194
@example
195
make all install
196
@end example
197
 
198
NOTE: The @code{make} utility used should be GNU make.
199
 
200
@section GDB for DINK32
201
 
202
@subheading Make the Build Directory
203
 
204
Create a build directory for the DINK32 Debugger
205
 
206
@example
207
cd tools
208
mkdir build-dink32
209
@end example
210
 
211
@subheading Configure for the Build
212
 
213
Configure the GNU Debugger to communicate with
214
the DINK32 ROM monitor:
215
 
216
@example
217
cd tools/build-dink32
218
../@value{GDB-UNTAR}/configure --target-powerpc-elf \
219
    --program-prefix=powerpc-rtems- \
220
    --enable-targets=all \
221
    --prefix=
222
@end example
223
 
224
Where  is a unique location where the
225
gdb Dink32 will be created.
226
 
227
@subheading Make the Debugger
228
 
229
From tools/build-dink32 execute the following command sequence:
230
 
231
@example
232
make all install
233
@end example
234
 
235
NOTE: The @code{make} utility used should be GNU make.

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.