1 |
24 |
jeremybenn |
This is gdb.info, produced by makeinfo version 4.8 from
|
2 |
|
|
../.././gdb/doc/gdb.texinfo.
|
3 |
|
|
|
4 |
|
|
INFO-DIR-SECTION Software development
|
5 |
|
|
START-INFO-DIR-ENTRY
|
6 |
|
|
* Gdb: (gdb). The GNU debugger.
|
7 |
|
|
END-INFO-DIR-ENTRY
|
8 |
|
|
|
9 |
|
|
This file documents the GNU debugger GDB.
|
10 |
|
|
|
11 |
|
|
This is the Ninth Edition, of `Debugging with GDB: the GNU
|
12 |
|
|
Source-Level Debugger' for GDB Version 6.8.
|
13 |
|
|
|
14 |
|
|
Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
|
15 |
|
|
1998,
|
16 |
|
|
1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
|
17 |
|
|
Free Software Foundation, Inc.
|
18 |
|
|
|
19 |
|
|
Permission is granted to copy, distribute and/or modify this document
|
20 |
|
|
under the terms of the GNU Free Documentation License, Version 1.1 or
|
21 |
|
|
any later version published by the Free Software Foundation; with the
|
22 |
|
|
Invariant Sections being "Free Software" and "Free Software Needs Free
|
23 |
|
|
Documentation", with the Front-Cover Texts being "A GNU Manual," and
|
24 |
|
|
with the Back-Cover Texts as in (a) below.
|
25 |
|
|
|
26 |
|
|
(a) The FSF's Back-Cover Text is: "You are free to copy and modify
|
27 |
|
|
this GNU Manual. Buying copies from GNU Press supports the FSF in
|
28 |
|
|
developing GNU and promoting software freedom."
|
29 |
|
|
|
30 |
|
|
|
31 |
|
|
Indirect:
|
32 |
|
|
gdb.info-1: 1109
|
33 |
|
|
gdb.info-2: 299141
|
34 |
|
|
gdb.info-3: 599007
|
35 |
|
|
gdb.info-4: 891206
|
36 |
|
|
|
37 |
|
|
Tag Table:
|
38 |
|
|
(Indirect)
|
39 |
|
|
Node: Top1109
|
40 |
|
|
Node: Summary3815
|
41 |
|
|
Node: Free Software5451
|
42 |
|
|
Node: Contributors11019
|
43 |
|
|
Node: Sample Session19003
|
44 |
|
|
Node: Invocation25839
|
45 |
|
|
Node: Invoking GDB26383
|
46 |
|
|
Node: File Options28696
|
47 |
|
|
Node: Mode Options31353
|
48 |
|
|
Node: Startup37765
|
49 |
|
|
Ref: Startup-Footnote-139670
|
50 |
|
|
Node: Quitting GDB39779
|
51 |
|
|
Node: Shell Commands40676
|
52 |
|
|
Node: Logging Output41518
|
53 |
|
|
Node: Commands42364
|
54 |
|
|
Node: Command Syntax43002
|
55 |
|
|
Node: Completion45168
|
56 |
|
|
Node: Help49503
|
57 |
|
|
Node: Running54742
|
58 |
|
|
Node: Compilation55924
|
59 |
|
|
Node: Starting58563
|
60 |
|
|
Node: Arguments63452
|
61 |
|
|
Node: Environment64722
|
62 |
|
|
Node: Working Directory67990
|
63 |
|
|
Node: Input/Output69098
|
64 |
|
|
Node: Attach71069
|
65 |
|
|
Node: Kill Process73536
|
66 |
|
|
Node: Threads74502
|
67 |
|
|
Node: Processes81338
|
68 |
|
|
Node: Checkpoint/Restart86557
|
69 |
|
|
Ref: Checkpoint/Restart-Footnote-191090
|
70 |
|
|
Node: Stopping91125
|
71 |
|
|
Node: Breakpoints92272
|
72 |
|
|
Node: Set Breaks95691
|
73 |
|
|
Node: Set Watchpoints109829
|
74 |
|
|
Node: Set Catchpoints117636
|
75 |
|
|
Node: Delete Breaks121675
|
76 |
|
|
Node: Disabling123611
|
77 |
|
|
Node: Conditions126476
|
78 |
|
|
Node: Break Commands131424
|
79 |
|
|
Node: Breakpoint Menus134309
|
80 |
|
|
Node: Error in Breakpoints136035
|
81 |
|
|
Node: Breakpoint-related Warnings137613
|
82 |
|
|
Node: Continuing and Stepping139940
|
83 |
|
|
Node: Signals149252
|
84 |
|
|
Node: Thread Stops153524
|
85 |
|
|
Node: Stack158161
|
86 |
|
|
Node: Frames159637
|
87 |
|
|
Node: Backtrace162389
|
88 |
|
|
Ref: Backtrace-Footnote-1167280
|
89 |
|
|
Node: Selection167468
|
90 |
|
|
Node: Frame Info170332
|
91 |
|
|
Node: Source172663
|
92 |
|
|
Node: List173729
|
93 |
|
|
Node: Specify Location176342
|
94 |
|
|
Node: Edit179592
|
95 |
|
|
Ref: Edit-Footnote-1181067
|
96 |
|
|
Node: Search181302
|
97 |
|
|
Node: Source Path182110
|
98 |
|
|
Ref: set substitute-path187865
|
99 |
|
|
Node: Machine Code190086
|
100 |
|
|
Node: Data193460
|
101 |
|
|
Node: Expressions195841
|
102 |
|
|
Node: Variables197809
|
103 |
|
|
Node: Arrays202300
|
104 |
|
|
Node: Output Formats204829
|
105 |
|
|
Ref: Output Formats-Footnote-1207702
|
106 |
|
|
Node: Memory207859
|
107 |
|
|
Node: Auto Display213106
|
108 |
|
|
Node: Print Settings216819
|
109 |
|
|
Node: Value History230290
|
110 |
|
|
Node: Convenience Vars232706
|
111 |
|
|
Node: Registers236230
|
112 |
|
|
Ref: Registers-Footnote-1240905
|
113 |
|
|
Node: Floating Point Hardware241300
|
114 |
|
|
Node: Vector Unit241830
|
115 |
|
|
Node: OS Information242215
|
116 |
|
|
Node: Memory Region Attributes244213
|
117 |
|
|
Node: Dump/Restore Files248871
|
118 |
|
|
Node: Core File Generation251174
|
119 |
|
|
Node: Character Sets252406
|
120 |
|
|
Node: Caching Remote Data259231
|
121 |
|
|
Node: Macros260379
|
122 |
|
|
Node: Tracepoints267330
|
123 |
|
|
Node: Set Tracepoints269172
|
124 |
|
|
Node: Create and Delete Tracepoints270372
|
125 |
|
|
Node: Enable and Disable Tracepoints272016
|
126 |
|
|
Node: Tracepoint Passcounts272715
|
127 |
|
|
Node: Tracepoint Actions274139
|
128 |
|
|
Node: Listing Tracepoints277139
|
129 |
|
|
Node: Starting and Stopping Trace Experiments278261
|
130 |
|
|
Node: Analyze Collected Data279442
|
131 |
|
|
Node: tfind280747
|
132 |
|
|
Node: tdump285140
|
133 |
|
|
Node: save-tracepoints286799
|
134 |
|
|
Node: Tracepoint Variables287218
|
135 |
|
|
Node: Overlays288233
|
136 |
|
|
Node: How Overlays Work288953
|
137 |
|
|
Ref: A code overlay291513
|
138 |
|
|
Node: Overlay Commands294951
|
139 |
|
|
Node: Automatic Overlay Debugging299141
|
140 |
|
|
Node: Overlay Sample Program301282
|
141 |
|
|
Node: Languages303042
|
142 |
|
|
Node: Setting304205
|
143 |
|
|
Node: Filenames305907
|
144 |
|
|
Node: Manually306693
|
145 |
|
|
Node: Automatically307902
|
146 |
|
|
Node: Show308963
|
147 |
|
|
Node: Checks310285
|
148 |
|
|
Node: Type Checking311675
|
149 |
|
|
Node: Range Checking314408
|
150 |
|
|
Node: Supported Languages316809
|
151 |
|
|
Node: C317982
|
152 |
|
|
Node: C Operators319283
|
153 |
|
|
Node: C Constants323602
|
154 |
|
|
Node: C Plus Plus Expressions326006
|
155 |
|
|
Node: C Defaults329549
|
156 |
|
|
Node: C Checks330232
|
157 |
|
|
Node: Debugging C330955
|
158 |
|
|
Node: Debugging C Plus Plus331439
|
159 |
|
|
Node: Decimal Floating Point334556
|
160 |
|
|
Node: Objective-C335814
|
161 |
|
|
Node: Method Names in Commands336275
|
162 |
|
|
Node: The Print Command with Objective-C337970
|
163 |
|
|
Node: Fortran338621
|
164 |
|
|
Node: Fortran Operators339346
|
165 |
|
|
Node: Fortran Defaults339936
|
166 |
|
|
Node: Special Fortran Commands340321
|
167 |
|
|
Node: Pascal340827
|
168 |
|
|
Node: Modula-2341342
|
169 |
|
|
Node: M2 Operators342317
|
170 |
|
|
Node: Built-In Func/Proc345315
|
171 |
|
|
Node: M2 Constants348176
|
172 |
|
|
Node: M2 Types349777
|
173 |
|
|
Node: M2 Defaults352996
|
174 |
|
|
Node: Deviations353596
|
175 |
|
|
Node: M2 Checks354697
|
176 |
|
|
Node: M2 Scope355515
|
177 |
|
|
Node: GDB/M2356539
|
178 |
|
|
Node: Ada357451
|
179 |
|
|
Node: Ada Mode Intro358250
|
180 |
|
|
Node: Omissions from Ada360122
|
181 |
|
|
Node: Additions to Ada364083
|
182 |
|
|
Node: Stopping Before Main Program367981
|
183 |
|
|
Node: Ada Glitches368513
|
184 |
|
|
Node: Unsupported Languages370491
|
185 |
|
|
Node: Symbols371181
|
186 |
|
|
Node: Altering384680
|
187 |
|
|
Node: Assignment385649
|
188 |
|
|
Node: Jumping388754
|
189 |
|
|
Node: Signaling390889
|
190 |
|
|
Node: Returning392020
|
191 |
|
|
Node: Calling393222
|
192 |
|
|
Node: Patching395115
|
193 |
|
|
Node: GDB Files396192
|
194 |
|
|
Node: Files396733
|
195 |
|
|
Ref: Shared Libraries409568
|
196 |
|
|
Node: Separate Debug Files414964
|
197 |
|
|
Node: Symbol Errors425587
|
198 |
|
|
Node: Targets429190
|
199 |
|
|
Node: Active Targets430670
|
200 |
|
|
Node: Target Commands432249
|
201 |
|
|
Node: Byte Order437489
|
202 |
|
|
Node: Remote Debugging438466
|
203 |
|
|
Node: Connecting439728
|
204 |
|
|
Node: File Transfer444603
|
205 |
|
|
Node: Server445543
|
206 |
|
|
Ref: Monitor Commands for gdbserver452174
|
207 |
|
|
Ref: Server-Footnote-1453033
|
208 |
|
|
Node: Remote Configuration453153
|
209 |
|
|
Ref: set remotebreak454177
|
210 |
|
|
Ref: set remote hardware-watchpoint-limit455641
|
211 |
|
|
Ref: set remote hardware-breakpoint-limit455641
|
212 |
|
|
Ref: set remote exec-file455923
|
213 |
|
|
Node: Remote Stub459201
|
214 |
|
|
Node: Stub Contents462098
|
215 |
|
|
Node: Bootstrapping464209
|
216 |
|
|
Node: Debug Session468018
|
217 |
|
|
Node: Configurations469578
|
218 |
|
|
Node: Native470347
|
219 |
|
|
Node: HP-UX470941
|
220 |
|
|
Node: BSD libkvm Interface471230
|
221 |
|
|
Node: SVR4 Process Information472301
|
222 |
|
|
Node: DJGPP Native475731
|
223 |
|
|
Node: Cygwin Native482311
|
224 |
|
|
Node: Non-debug DLL Symbols485692
|
225 |
|
|
Node: Hurd Native490238
|
226 |
|
|
Node: Neutrino495501
|
227 |
|
|
Node: Embedded OS495876
|
228 |
|
|
Node: VxWorks496352
|
229 |
|
|
Node: VxWorks Connection498569
|
230 |
|
|
Node: VxWorks Download499503
|
231 |
|
|
Node: VxWorks Attach501238
|
232 |
|
|
Node: Embedded Processors501636
|
233 |
|
|
Node: ARM502780
|
234 |
|
|
Node: M32R/D505734
|
235 |
|
|
Node: M68K507436
|
236 |
|
|
Node: MIPS Embedded507732
|
237 |
|
|
Node: OpenRISC 1000512677
|
238 |
|
|
Node: PowerPC Embedded515532
|
239 |
|
|
Node: PA516998
|
240 |
|
|
Node: Sparclet517287
|
241 |
|
|
Node: Sparclet File518771
|
242 |
|
|
Node: Sparclet Connection519651
|
243 |
|
|
Node: Sparclet Download520129
|
244 |
|
|
Node: Sparclet Execution521178
|
245 |
|
|
Node: Sparclite521769
|
246 |
|
|
Node: Z8000522142
|
247 |
|
|
Node: AVR523526
|
248 |
|
|
Node: CRIS523889
|
249 |
|
|
Node: Super-H524867
|
250 |
|
|
Node: Architectures525109
|
251 |
|
|
Node: i386525531
|
252 |
|
|
Node: A29K526213
|
253 |
|
|
Node: Alpha527052
|
254 |
|
|
Node: MIPS527185
|
255 |
|
|
Node: HPPA529809
|
256 |
|
|
Node: SPU530328
|
257 |
|
|
Node: PowerPC531572
|
258 |
|
|
Node: Controlling GDB532150
|
259 |
|
|
Node: Prompt532911
|
260 |
|
|
Node: Editing533690
|
261 |
|
|
Node: Command History534633
|
262 |
|
|
Node: Screen Size538037
|
263 |
|
|
Node: Numbers539742
|
264 |
|
|
Node: ABI541719
|
265 |
|
|
Node: Messages/Warnings544648
|
266 |
|
|
Node: Debugging Output547141
|
267 |
|
|
Node: Sequences551508
|
268 |
|
|
Node: Define552119
|
269 |
|
|
Node: Hooks555470
|
270 |
|
|
Node: Command Files557661
|
271 |
|
|
Node: Output561514
|
272 |
|
|
Node: Interpreters566281
|
273 |
|
|
Node: TUI568376
|
274 |
|
|
Node: TUI Overview569343
|
275 |
|
|
Node: TUI Keys571776
|
276 |
|
|
Node: TUI Single Key Mode574080
|
277 |
|
|
Node: TUI Commands574955
|
278 |
|
|
Node: TUI Configuration577043
|
279 |
|
|
Node: Emacs578339
|
280 |
|
|
Node: GDB/MI583816
|
281 |
|
|
Node: GDB/MI Command Syntax585638
|
282 |
|
|
Node: GDB/MI Input Syntax585851
|
283 |
|
|
Node: GDB/MI Output Syntax587405
|
284 |
|
|
Node: GDB/MI Compatibility with CLI590823
|
285 |
|
|
Node: GDB/MI Development and Front Ends591560
|
286 |
|
|
Node: GDB/MI Output Records593481
|
287 |
|
|
Node: GDB/MI Result Records593763
|
288 |
|
|
Node: GDB/MI Stream Records594490
|
289 |
|
|
Node: GDB/MI Out-of-band Records595761
|
290 |
|
|
Node: GDB/MI Simple Examples597198
|
291 |
|
|
Node: GDB/MI Command Description Format599007
|
292 |
|
|
Node: GDB/MI Breakpoint Commands599887
|
293 |
|
|
Node: GDB/MI Program Context616392
|
294 |
|
|
Node: GDB/MI Thread Commands620874
|
295 |
|
|
Node: GDB/MI Program Execution622950
|
296 |
|
|
Node: GDB/MI Stack Manipulation631559
|
297 |
|
|
Node: GDB/MI Variable Objects641190
|
298 |
|
|
Ref: -var-list-children648202
|
299 |
|
|
Ref: -var-update653161
|
300 |
|
|
Ref: -var-set-frozen653975
|
301 |
|
|
Node: GDB/MI Data Manipulation654698
|
302 |
|
|
Node: GDB/MI Tracepoint Commands669060
|
303 |
|
|
Node: GDB/MI Symbol Query669304
|
304 |
|
|
Node: GDB/MI File Commands672592
|
305 |
|
|
Node: GDB/MI Target Manipulation676845
|
306 |
|
|
Node: GDB/MI File Transfer Commands684024
|
307 |
|
|
Node: GDB/MI Miscellaneous Commands685346
|
308 |
|
|
Ref: -interpreter-exec688490
|
309 |
|
|
Node: Annotations690791
|
310 |
|
|
Node: Annotations Overview691705
|
311 |
|
|
Node: Server Prefix694168
|
312 |
|
|
Node: Prompting694808
|
313 |
|
|
Node: Errors696325
|
314 |
|
|
Node: Invalidation697221
|
315 |
|
|
Node: Annotations for Running697698
|
316 |
|
|
Node: Source Annotations699218
|
317 |
|
|
Node: GDB Bugs700143
|
318 |
|
|
Node: Bug Criteria700870
|
319 |
|
|
Node: Bug Reporting701747
|
320 |
|
|
Node: Command Line Editing709370
|
321 |
|
|
Node: Introduction and Notation710022
|
322 |
|
|
Node: Readline Interaction711642
|
323 |
|
|
Node: Readline Bare Essentials712831
|
324 |
|
|
Node: Readline Movement Commands714618
|
325 |
|
|
Node: Readline Killing Commands715581
|
326 |
|
|
Node: Readline Arguments717499
|
327 |
|
|
Node: Searching718541
|
328 |
|
|
Node: Readline Init File720690
|
329 |
|
|
Node: Readline Init File Syntax721753
|
330 |
|
|
Node: Conditional Init Constructs733685
|
331 |
|
|
Node: Sample Init File736216
|
332 |
|
|
Node: Bindable Readline Commands739331
|
333 |
|
|
Node: Commands For Moving740386
|
334 |
|
|
Node: Commands For History741245
|
335 |
|
|
Node: Commands For Text744367
|
336 |
|
|
Node: Commands For Killing747091
|
337 |
|
|
Node: Numeric Arguments749231
|
338 |
|
|
Node: Commands For Completion750368
|
339 |
|
|
Node: Keyboard Macros751910
|
340 |
|
|
Node: Miscellaneous Commands752479
|
341 |
|
|
Node: Readline vi Mode755838
|
342 |
|
|
Node: Using History Interactively756755
|
343 |
|
|
Node: History Interaction757270
|
344 |
|
|
Node: Event Designators758692
|
345 |
|
|
Node: Word Designators759625
|
346 |
|
|
Node: Modifiers761262
|
347 |
|
|
Node: Formatting Documentation762487
|
348 |
|
|
Ref: Formatting Documentation-Footnote-1765816
|
349 |
|
|
Node: Installing GDB765880
|
350 |
|
|
Node: Requirements766389
|
351 |
|
|
Ref: Expat766958
|
352 |
|
|
Node: Running Configure767669
|
353 |
|
|
Node: Separate Objdir771208
|
354 |
|
|
Node: Config Names774092
|
355 |
|
|
Node: Configure Options775537
|
356 |
|
|
Node: Maintenance Commands777873
|
357 |
|
|
Ref: maint info breakpoints778532
|
358 |
|
|
Node: Remote Protocol788832
|
359 |
|
|
Node: Overview789284
|
360 |
|
|
Ref: Binary Data791471
|
361 |
|
|
Node: Packets793730
|
362 |
|
|
Ref: extended mode794812
|
363 |
|
|
Ref: read registers packet797336
|
364 |
|
|
Ref: cycle step packet798502
|
365 |
|
|
Ref: write register packet800378
|
366 |
|
|
Ref: step with signal packet801285
|
367 |
|
|
Ref: X packet805991
|
368 |
|
|
Ref: insert breakpoint or watchpoint packet806281
|
369 |
|
|
Node: Stop Reply Packets808727
|
370 |
|
|
Node: General Query Packets812286
|
371 |
|
|
Ref: QPassSignals819329
|
372 |
|
|
Ref: qSupported821404
|
373 |
|
|
Ref: qXfer read829996
|
374 |
|
|
Ref: qXfer auxiliary vector read830490
|
375 |
|
|
Ref: qXfer target description read830839
|
376 |
|
|
Ref: qXfer library list read831283
|
377 |
|
|
Ref: qXfer memory map read831929
|
378 |
|
|
Ref: qXfer spu read832318
|
379 |
|
|
Ref: qXfer spu write834448
|
380 |
|
|
Ref: General Query Packets-Footnote-1835738
|
381 |
|
|
Node: Register Packet Format836065
|
382 |
|
|
Node: Tracepoint Packets836983
|
383 |
|
|
Node: Host I/O Packets843078
|
384 |
|
|
Node: Interrupts847220
|
385 |
|
|
Node: Examples848681
|
386 |
|
|
Node: File-I/O Remote Protocol Extension849294
|
387 |
|
|
Node: File-I/O Overview849756
|
388 |
|
|
Node: Protocol Basics851905
|
389 |
|
|
Node: The F Request Packet854137
|
390 |
|
|
Node: The F Reply Packet855038
|
391 |
|
|
Node: The Ctrl-C Message855956
|
392 |
|
|
Node: Console I/O857585
|
393 |
|
|
Node: List of Supported Calls858802
|
394 |
|
|
Node: open859164
|
395 |
|
|
Node: close861658
|
396 |
|
|
Node: read862040
|
397 |
|
|
Node: write862647
|
398 |
|
|
Node: lseek863414
|
399 |
|
|
Node: rename864292
|
400 |
|
|
Node: unlink865688
|
401 |
|
|
Node: stat/fstat866627
|
402 |
|
|
Node: gettimeofday867514
|
403 |
|
|
Node: isatty867949
|
404 |
|
|
Node: system868545
|
405 |
|
|
Node: Protocol-specific Representation of Datatypes870087
|
406 |
|
|
Node: Integral Datatypes870464
|
407 |
|
|
Node: Pointer Values871271
|
408 |
|
|
Node: Memory Transfer871979
|
409 |
|
|
Node: struct stat872599
|
410 |
|
|
Node: struct timeval874801
|
411 |
|
|
Node: Constants875318
|
412 |
|
|
Node: Open Flags875767
|
413 |
|
|
Node: mode_t Values876108
|
414 |
|
|
Node: Errno Values876600
|
415 |
|
|
Node: Lseek Flags877411
|
416 |
|
|
Node: Limits877596
|
417 |
|
|
Node: File-I/O Examples877956
|
418 |
|
|
Node: Library List Format879072
|
419 |
|
|
Node: Memory Map Format880940
|
420 |
|
|
Node: Agent Expressions883473
|
421 |
|
|
Node: General Bytecode Design886406
|
422 |
|
|
Node: Bytecode Descriptions891206
|
423 |
|
|
Node: Using Agent Expressions901892
|
424 |
|
|
Node: Varying Target Capabilities903425
|
425 |
|
|
Node: Tracing on Symmetrix904598
|
426 |
|
|
Node: Rationale910420
|
427 |
|
|
Node: Target Descriptions917799
|
428 |
|
|
Node: Retrieving Descriptions919838
|
429 |
|
|
Node: Target Description Format920923
|
430 |
|
|
Node: Predefined Target Types927470
|
431 |
|
|
Node: Standard Target Features928669
|
432 |
|
|
Node: ARM Features930422
|
433 |
|
|
Node: MIPS Features931041
|
434 |
|
|
Node: M68K Features931985
|
435 |
|
|
Node: PowerPC Features932648
|
436 |
|
|
Node: Copying933588
|
437 |
|
|
Node: GNU Free Documentation License952806
|
438 |
|
|
Node: Index975241
|
439 |
|
|
|
440 |
|
|
End Tag Table
|