gdb: Improve cache matching criteria for the bfd cache.
[deliverable/binutils-gdb.git] / gdb / NEWS
CommitLineData
c906108c
SS
1 What has changed in GDB?
2 (Organized release by release)
3
7c79d316
JB
4*** Changes since GDB 7.10
5
58d2eda5
PL
6* Support for tracepoints on aarch64-linux was added in GDBserver.
7
da8c46d2
MM
8* The 'record instruction-history' command now indicates speculative execution
9 when using the Intel(R) Processor Trace recording format.
10
629500fa
KS
11* GDB now allows users to specify explicit locations, bypassing
12 the linespec parser. This feature is also available to GDB/MI
13 clients.
14
fbea99ea
PA
15* New commands
16
17maint set target-non-stop (on|off|auto)
18maint show target-non-stop
19 Control whether GDB targets always operate in non-stop mode even if
20 "set non-stop" is "off". The default is "auto", meaning non-stop
21 mode is enabled if supported by the target.
22
6ff0ba5f
DE
23* The "disassemble" command accepts a new modifier: /s.
24 It prints mixed source+disassembly like /m with two differences:
25 - disassembled instructions are now printed in program order, and
26 - and source for all relevant files is now printed.
27 The "/m" option is now considered deprecated: its "source-centric"
28 output hasn't proved useful in practice.
29
7c79d316 30*** Changes in GDB 7.10
df8411da 31
c16a3f52
OJ
32* Support for process record-replay and reverse debugging on aarch64*-linux*
33 targets has been added. GDB now supports recording of A64 instruction set
34 including advance SIMD instructions.
35
18a94d75
DE
36* Support for Sun's version of the "stabs" debug file format has been removed.
37
df8411da
SDJ
38* GDB now honors the content of the file /proc/PID/coredump_filter
39 (PID is the process ID) on GNU/Linux systems. This file can be used
40 to specify the types of memory mappings that will be included in a
41 corefile. For more information, please refer to the manual page of
42 "core(5)". GDB also has a new command: "set use-coredump-filter
43 on|off". It allows to set whether GDB will read the content of the
44 /proc/PID/coredump_filter file when generating a corefile.
3b2f13ff 45
d33279b3
AT
46* The "info os" command on GNU/Linux can now display information on
47 cpu information :
48 "info os cpus" Listing of all cpus/cores on the system
49
236af5e3
YG
50* GDB has two new commands: "set serial parity odd|even|none" and
51 "show serial parity". These allows to set or show parity for the
52 remote serial I/O.
53
b6577aab
DE
54* The "info source" command now displays the producer string if it was
55 present in the debug info. This typically includes the compiler version
56 and may include things like its command line arguments.
57
b30a0bc3
JB
58* The "info dll", an alias of the "info sharedlibrary" command,
59 is now available on all platforms.
60
599bd15c
GB
61* Directory names supplied to the "set sysroot" commands may be
62 prefixed with "target:" to tell GDB to access shared libraries from
63 the target system, be it local or remote. This replaces the prefix
64 "remote:". The default sysroot has been changed from "" to
65 "target:". "remote:" is automatically converted to "target:" for
66 backward compatibility.
67
a9a5a3d1
GB
68* The system root specified by "set sysroot" will be prepended to the
69 filename of the main executable (if reported to GDB as absolute by
70 the operating system) when starting processes remotely, and when
71 attaching to already-running local or remote processes.
72
1b6e6f5c
GB
73* GDB now supports automatic location and retrieval of executable
74 files from remote targets. Remote debugging can now be initiated
75 using only a "target remote" or "target extended-remote" command
76 (no "set sysroot" or "file" commands are required). See "New remote
77 packets" below.
78
cf75d6c3
AB
79* The "dump" command now supports verilog hex format.
80
417c80f9
AA
81* GDB now supports the vector ABI on S/390 GNU/Linux targets.
82
51aad7cc
GB
83* On GNU/Linux, GDB and gdbserver are now able to access executable
84 and shared library files without a "set sysroot" command when
85 attaching to processes running in different mount namespaces from
86 the debugger. This makes it possible to attach to processes in
87 containers as simply as "gdb -p PID" or "gdbserver --attach PID".
88 See "New remote packets" below.
89
51f0e40d
AB
90* The "tui reg" command now provides completion for all of the
91 available register groups, including target specific groups.
92
b58c513b
PP
93* The HISTSIZE environment variable is no longer read when determining
94 the size of GDB's command history. GDB now instead reads the dedicated
bc460514
PP
95 GDBHISTSIZE environment variable. Setting GDBHISTSIZE to "-1" or to "" now
96 disables truncation of command history. Non-numeric values of GDBHISTSIZE
97 are ignored.
b58c513b 98
37442ce1
DE
99* Guile Scripting
100
101 ** Memory ports can now be unbuffered.
102
3a8b707a
DE
103* Python Scripting
104
105 ** gdb.Objfile objects have a new attribute "username",
106 which is the name of the objfile as specified by the user,
107 without, for example, resolving symlinks.
d11916aa 108 ** You can now write frame unwinders in Python.
59fb7612
SS
109 ** gdb.Type objects have a new method "optimized_out",
110 returning optimized out gdb.Value instance of this type.
4c082a81
SC
111 ** gdb.Value objects have new methods "reference_value" and
112 "const_value" which return a reference to the value and a
113 "const" version of the value respectively.
3a8b707a 114
f57d2163
DE
115* New commands
116
117maint print symbol-cache
118 Print the contents of the symbol cache.
119
120maint print symbol-cache-statistics
121 Print statistics of symbol cache usage.
122
123maint flush-symbol-cache
124 Flush the contents of the symbol cache.
125
fbea99ea
PA
126maint set target-non-stop (on|off|auto)
127maint show target-non-stop
128 Control whether GDB targets always operate in non-stop mode even if
129 "set non-stop" is "off". The default is "auto", meaning non-stop
130 mode is enabled if supported by the target.
131
f4abbc16
MM
132record btrace bts
133record bts
134 Start branch trace recording using Branch Trace Store (BTS) format.
135
36de76f9
JK
136compile print
137 Evaluate expression by using the compiler and print result.
138
a4ea0946
AB
139tui enable
140tui disable
141 Explicit commands for enabling and disabling tui mode.
142
29c1c244
WT
143show mpx bound
144set mpx bound on i386 and amd64
145 Support for bound table investigation on Intel(R) MPX enabled applications.
146
b20a6524
MM
147record btrace pt
148record pt
149 Start branch trace recording using Intel(R) Processor Trace format.
150
b0627500
MM
151maint info btrace
152 Print information about branch tracing internals.
153
154maint btrace packet-history
155 Print the raw branch tracing data.
156
157maint btrace clear-packet-history
158 Discard the stored raw branch tracing data.
159
160maint btrace clear
161 Discard all branch tracing data. It will be fetched and processed
162 anew by the next "record" command.
163
253828f1
JK
164* New options
165
b4f54984
DE
166set debug dwarf-die
167 Renamed from "set debug dwarf2-die".
168show debug dwarf-die
169 Renamed from "show debug dwarf2-die".
170
171set debug dwarf-read
172 Renamed from "set debug dwarf2-read".
173show debug dwarf-read
174 Renamed from "show debug dwarf2-read".
175
176maint set dwarf always-disassemble
177 Renamed from "maint set dwarf2 always-disassemble".
178maint show dwarf always-disassemble
179 Renamed from "maint show dwarf2 always-disassemble".
180
181maint set dwarf max-cache-age
182 Renamed from "maint set dwarf2 max-cache-age".
183maint show dwarf max-cache-age
184 Renamed from "maint show dwarf2 max-cache-age".
185
27e0867f
DE
186set debug dwarf-line
187show debug dwarf-line
188 Control display of debugging info regarding DWARF line processing.
189
ef0b411a
GB
190set max-completions
191show max-completions
192 Set the maximum number of candidates to be considered during
193 completion. The default value is 200. This limit allows GDB
194 to avoid generating large completion lists, the computation of
195 which can cause the debugger to become temporarily unresponsive.
196
fc637f04
PP
197set history remove-duplicates
198show history remove-duplicates
199 Control the removal of duplicate history entries.
200
f57d2163
DE
201maint set symbol-cache-size
202maint show symbol-cache-size
203 Control the size of the symbol cache.
204
d33501a5
MM
205set|show record btrace bts buffer-size
206 Set and show the size of the ring buffer used for branch tracing in
207 BTS format.
208 The obtained size may differ from the requested size. Use "info
209 record" to see the obtained buffer size.
210
7a6a1731
GB
211set debug linux-namespaces
212show debug linux-namespaces
213 Control display of debugging info regarding Linux namespaces.
214
b20a6524
MM
215set|show record btrace pt buffer-size
216 Set and show the size of the ring buffer used for branch tracing in
217 Intel(R) Processor Trace format.
218 The obtained size may differ from the requested size. Use "info
219 record" to see the obtained buffer size.
220
b0627500
MM
221maint set|show btrace pt skip-pad
222 Set and show whether PAD packets are skipped when computing the
223 packet history.
224
253828f1
JK
225* The command 'thread apply all' can now support new option '-ascending'
226 to call its specified command for all threads in ascending order.
227
9f050062
DE
228* Python/Guile scripting
229
230 ** GDB now supports auto-loading of Python/Guile scripts contained in the
231 special section named `.debug_gdb_scripts'.
232
f4abbc16
MM
233* New remote packets
234
235qXfer:btrace-conf:read
236 Return the branch trace configuration for the current thread.
237
d33501a5
MM
238Qbtrace-conf:bts:size
239 Set the requested ring buffer size for branch tracing in BTS format.
240
b20a6524
MM
241Qbtrace:pt
242 Enable Intel(R) Procesor Trace-based branch tracing for the current
243 process. The remote stub reports support for this packet to GDB's
244 qSupported query.
245
246Qbtrace-conf:pt:size
247 Set the requested ring buffer size for branch tracing in Intel(R) Processor
248 Trace format.
249
f7e6eed5
PA
250swbreak stop reason
251 Indicates a memory breakpoint instruction was executed, irrespective
252 of whether it was GDB that planted the breakpoint or the breakpoint
253 is hardcoded in the program. This is required for correct non-stop
254 mode operation.
255
256hwbreak stop reason
257 Indicates the target stopped for a hardware breakpoint. This is
258 required for correct non-stop mode operation.
259
0a93529c
GB
260vFile:fstat:
261 Return information about files on the remote system.
262
c78fa86a
GB
263qXfer:exec-file:read
264 Return the full absolute name of the file that was executed to
265 create a process running on the remote system.
266
15a201c8
GB
267vFile:setfs:
268 Select the filesystem on which vFile: operations with filename
269 arguments will operate. This is required for GDB to be able to
270 access files on remote targets where the remote stub does not
271 share a common filesystem with the inferior(s).
272
0d71eef5
DB
273fork stop reason
274 Indicates that a fork system call was executed.
275
276vfork stop reason
277 Indicates that a vfork system call was executed.
278
279vforkdone stop reason
280 Indicates that a vfork child of the specified process has executed
281 an exec or exit, allowing the vfork parent to resume execution.
282
283fork-events and vfork-events features in qSupported
284 The qSupported packet allows GDB to request support for fork and
285 vfork events using new 'gdbfeatures' fork-events and vfork-events,
286 and the qSupported response can contain the corresponding
287 'stubfeatures'. Set and show commands can be used to display
288 whether these features are enabled.
289
290* Extended-remote fork events
291
292 ** GDB now has support for fork events on extended-remote Linux
293 targets. For targets with Linux kernels 2.5.60 and later, this
294 enables follow-fork-mode and detach-on-fork for both fork and
295 vfork, as well as fork and vfork catchpoints.
296
d33501a5
MM
297* The info record command now shows the recording format and the
298 branch tracing configuration for the current thread when using
299 the btrace record target.
300 For the BTS format, it shows the ring buffer size.
301
b05e3b0d
JM
302* GDB now has support for DTrace USDT (Userland Static Defined
303 Tracing) probes. The supported targets are x86_64-*-linux-gnu.
304
550bdf96
AA
305* GDB now supports access to vector registers on S/390 GNU/Linux
306 targets.
307
4f45d445
JK
308* Removed command line options
309
310-xdb HP-UX XDB compatibility mode.
311
0800b440
JK
312* Removed targets and native configurations
313
314HP/PA running HP-UX hppa*-*-hpux*
315Itanium running HP-UX ia64-*-hpux*
316
58bfce93
MM
317* New configure options
318
319--with-intel-pt
320 This configure option allows the user to build GDB with support for
321 Intel(R) Processor Trace (default: auto). This requires libipt.
322
323--with-libipt-prefix=PATH
324 Specify the path to the version of libipt that GDB should use.
325 $PATH/include should contain the intel-pt.h header and
326 $PATH/lib should contain the libipt.so library.
327
f5f85ab9
JB
328*** Changes in GDB 7.9.1
329
330* Python Scripting
331
332 ** Xmethods can now specify a result type.
333
3b2f13ff 334*** Changes in GDB 7.9
919b9a93 335
05db5edd
ST
336* GDB now supports hardware watchpoints on x86 GNU Hurd.
337
5f3b99cf 338* Python Scripting
2b4fd423
DE
339
340 ** You can now access frame registers from Python scripts.
341 ** New attribute 'producer' for gdb.Symtab objects.
d096d8c1
DE
342 ** gdb.Objfile objects have a new attribute "progspace",
343 which is the gdb.Progspace object of the containing program space.
a0be3e44 344 ** gdb.Objfile objects have a new attribute "owner".
7c50a931
DE
345 ** gdb.Objfile objects have a new attribute "build_id",
346 which is the build ID generated when the file was built.
86e4ed39 347 ** gdb.Objfile objects have a new method "add_separate_debug_file".
4ffbba72
DE
348 ** A new event "gdb.clear_objfiles" has been added, triggered when
349 selecting a new file to debug.
02be9a71 350 ** You can now add attributes to gdb.Objfile and gdb.Progspace objects.
6dddd6a5 351 ** New function gdb.lookup_objfile.
5f3b99cf 352
8fda9068
YQ
353 New events which are triggered when GDB modifies the state of the
354 inferior.
355
356 ** gdb.events.inferior_call_pre: Function call is about to be made.
357 ** gdb.events.inferior_call_post: Function call has just been made.
358 ** gdb.events.memory_changed: A memory location has been altered.
359 ** gdb.events.register_changed: A register has been altered.
360
faa42425
DE
361* New Python-based convenience functions:
362
363 ** $_caller_is(name [, number_of_frames])
364 ** $_caller_matches(regexp [, number_of_frames])
365 ** $_any_caller_is(name [, number_of_frames])
366 ** $_any_caller_matches(regexp [, number_of_frames])
367
bb2ec1b3
TT
368* GDB now supports the compilation and injection of source code into
369 the inferior. GDB will use GCC 5.0 or higher built with libcc1.so
370 to compile the source code to object code, and if successful, inject
371 and execute that code within the current context of the inferior.
372 Currently the C language is supported. The commands used to
373 interface with this new feature are:
374
375 compile code [-raw|-r] [--] [source code]
376 compile file [-raw|-r] filename
377
81219e53
DE
378* New commands
379
439250fb
DE
380demangle [-l language] [--] name
381 Demangle "name" in the specified language, or the current language
382 if elided. This command is renamed from the "maint demangle" command.
383 The latter is kept as a no-op to avoid "maint demangle" being interpreted
384 as "maint demangler-warning".
385
81219e53
DE
386queue-signal signal-name-or-number
387 Queue a signal to be delivered to the thread when it is resumed.
388
f10c5b19
JK
389add-auto-load-scripts-directory directory
390 Add entries to the list of directories from which to load auto-loaded
391 scripts.
392
f5b95c01
AA
393maint print user-registers
394 List all currently available "user" registers.
395
bb2ec1b3
TT
396compile code [-r|-raw] [--] [source code]
397 Compile, inject, and execute in the inferior the executable object
398 code produced by compiling the provided source code.
399
400compile file [-r|-raw] filename
401 Compile and inject into the inferior the executable object code
402 produced by compiling the source code stored in the filename
403 provided.
404
70509625
PA
405* On resume, GDB now always passes the signal the program had stopped
406 for to the thread the signal was sent to, even if the user changed
407 threads before resuming. Previously GDB would often (but not
408 always) deliver the signal to the thread that happens to be current
409 at resume time.
410
411* Conversely, the "signal" command now consistently delivers the
412 requested signal to the current thread. GDB now asks for
413 confirmation if the program had stopped for a signal and the user
414 switched threads meanwhile.
415
a25a5a45
PA
416* "breakpoint always-inserted" modes "off" and "auto" merged.
417
418 Now, when 'breakpoint always-inserted mode' is set to "off", GDB
419 won't remove breakpoints from the target until all threads stop,
420 even in non-stop mode. The "auto" mode has been removed, and "off"
421 is now the default mode.
422
cc485e62
DE
423* New options
424
425set debug symbol-lookup
426show debug symbol-lookup
427 Control display of debugging info regarding symbol lookup.
428
2ddf4301
SM
429* MI changes
430
431 ** The -list-thread-groups command outputs an exit-code field for
432 inferiors that have exited.
433
bb7e3f4d
YQ
434* New targets
435
436MIPS SDE mips*-sde*-elf*
437
3831839c
PA
438* Removed targets
439
440Support for these obsolete configurations has been removed.
441
5ab806de
PA
442Alpha running OSF/1 (or Tru64) alpha*-*-osf*
443SGI Irix-5.x mips-*-irix5*
444SGI Irix-6.x mips-*-irix6*
09dd9a69
PA
445VAX running (4.2 - 4.3 Reno) BSD vax-*-bsd*
446VAX running Ultrix vax-*-ultrix*
3831839c 447
6bf6fd09
JB
448* The "dll-symbols" command, and its two aliases ("add-shared-symbol-files"
449 and "assf"), have been removed. Use the "sharedlibrary" command, or
450 its alias "share", instead.
451
919b9a93 452*** Changes in GDB 7.8
e9475ead 453
8d551b02
DE
454* New command line options
455
456-D data-directory
457 This is an alias for the --data-directory option.
458
e9475ead
SA
459* GDB supports printing and modifying of variable length automatic arrays
460 as specified in ISO C99.
461
a75fef0e
NC
462* The ARM simulator now supports instruction level tracing
463 with or without disassembly.
b7bba001 464
ed3ef339
DE
465* Guile scripting
466
467 GDB now has support for scripting using Guile. Whether this is
468 available is determined at configure time.
469 Guile version 2.0 or greater is required.
470 Guile version 2.0.9 is well tested, earlier 2.0 versions are not.
471
472* New commands (for set/show, see "New options" below)
473
474guile [code]
475gu [code]
476 Invoke CODE by passing it to the Guile interpreter.
477
478guile-repl
479gr
480 Start a Guile interactive prompt (or "repl" for "read-eval-print loop").
481
482info auto-load guile-scripts [regexp]
483 Print the list of automatically loaded Guile scripts.
484
485* The source command is now capable of sourcing Guile scripts.
486 This feature is dependent on the debugger being built with Guile support.
487
c6044dd1
JB
488* New options
489
770e7fc7
DE
490set print symbol-loading (off|brief|full)
491show print symbol-loading
492 Control whether to print informational messages when loading symbol
493 information for a file. The default is "full", but when debugging
494 programs with large numbers of shared libraries the amount of output
495 becomes less useful.
496
ed3ef339
DE
497set guile print-stack (none|message|full)
498show guile print-stack
499 Show a stack trace when an error is encountered in a Guile script.
500
501set auto-load guile-scripts (on|off)
502show auto-load guile-scripts
503 Control auto-loading of Guile script files.
504
c6044dd1
JB
505maint ada set ignore-descriptive-types (on|off)
506maint ada show ignore-descriptive-types
507 Control whether the debugger should ignore descriptive types in Ada
508 programs. The default is not to ignore the descriptive types. See
509 the user manual for more details on descriptive types and the intended
510 usage of this option.
511
6a3cb8e8
PA
512set auto-connect-native-target
513
514 Control whether GDB is allowed to automatically connect to the
515 native target for the run, attach, etc. commands when not connected
516 to any target yet. See also "target native" below.
517
67b5c0c1
MM
518set record btrace replay-memory-access (read-only|read-write)
519show record btrace replay-memory-access
520 Control what memory accesses are allowed during replay.
521
329ea579
PA
522maint set target-async (on|off)
523maint show target-async
5784b3ca
JK
524 This controls whether GDB targets operate in synchronous or
525 asynchronous mode. Normally the default is asynchronous, if it is
329ea579 526 available; but this can be changed to more easily debug problems
5784b3ca 527 occurring only in synchronous mode.
329ea579
PA
528
529set mi-async (on|off)
530show mi-async
531 Control whether MI asynchronous mode is preferred. This supersedes
532 "set target-async" of previous GDB versions.
533
534* "set target-async" is deprecated as a CLI option and is now an alias
535 for "set mi-async" (only puts MI into async mode).
536
537* Background execution commands (e.g., "c&", "s&", etc.) are now
538 possible ``out of the box'' if the target supports them. Previously
539 the user would need to explicitly enable the possibility with the
540 "set target-async on" command.
541
87ce2a04
DE
542* New features in the GDB remote stub, GDBserver
543
544 ** New option --debug-format=option1[,option2,...] allows one to add
545 additional text to each output. At present only timestamps
546 are supported: --debug-format=timestamps.
547 Timestamps can also be turned on with the
548 "monitor set debug-format timestamps" command from GDB.
549
5de9129b
MM
550* The 'record instruction-history' command now starts counting instructions
551 at one. This also affects the instruction ranges reported by the
552 'record function-call-history' command when given the /i modifier.
553
8710b709
MM
554* The command 'record function-call-history' supports a new modifier '/c' to
555 indent the function names based on their call stack depth.
556 The fields for the '/i' and '/l' modifier have been reordered.
557 The source line range is now prefixed with 'at'.
558 The instruction range is now prefixed with 'inst'.
559 Both ranges are now printed as '<from>, <to>' to allow copy&paste to the
560 "record instruction-history" and "list" commands.
561
0688d04e
MM
562* The ranges given as arguments to the 'record function-call-history' and
563 'record instruction-history' commands are now inclusive.
564
066ce621 565* The btrace record target now supports the 'record goto' command.
0b722aec
MM
566 For locations inside the execution trace, the back trace is computed
567 based on the information stored in the execution trace.
066ce621 568
52834460
MM
569* The btrace record target supports limited reverse execution and replay.
570 The target does not record data and therefore does not allow reading
571 memory or registers.
572
237b092b
AA
573* The "catch syscall" command now works on s390*-linux* targets.
574
936d2992
PA
575* The "compare-sections" command is no longer specific to target
576 remote. It now works with all targets.
577
930ee1b1
PA
578* All native targets are now consistently called "native".
579 Consequently, the "target child", "target GNU", "target djgpp",
580 "target procfs" (Solaris/Irix/OSF/AIX) and "target darwin-child"
581 commands have been replaced with "target native". The QNX/NTO port
582 leaves the "procfs" target in place and adds a "native" target for
583 consistency with other ports. The impact on users should be minimal
584 as these commands previously either throwed an error, or were
585 no-ops. The target's name is visible in the output of the following
586 commands: "help target", "info target", "info files", "maint print
587 target-stack".
588
6a3cb8e8
PA
589* The "target native" command now connects to the native target. This
590 can be used to launch native programs even when "set
591 auto-connect-native-target" is set to off.
592
dc304a94
JK
593* GDB now supports access to Intel(R) MPX registers on GNU/Linux.
594
595* Support for Intel(R) AVX-512 registers on GNU/Linux.
596 Support displaying and modifying Intel(R) AVX-512 registers
597 $zmm0 - $zmm31 and $k0 - $k7 on GNU/Linux.
598
969c39fb
MM
599* New remote packets
600
601qXfer:btrace:read's annex
602 The qXfer:btrace:read packet supports a new annex 'delta' to read
603 branch trace incrementally.
604
f7bd0f78
SC
605* Python Scripting
606
607 ** Valid Python operations on gdb.Value objects representing
608 structs/classes invoke the corresponding overloaded operators if
609 available.
0c6e92a5
SC
610 ** New `Xmethods' feature in the Python API. Xmethods are
611 additional methods or replacements for existing methods of a C++
612 class. This feature is useful for those cases where a method
613 defined in C++ source code could be inlined or optimized out by
614 the compiler, making it unavailable to GDB.
f7bd0f78 615
36c24d95
UW
616* New targets
617PowerPC64 GNU/Linux little-endian powerpc64le-*-linux*
618
95060284
JB
619* The "dll-symbols" command, and its two aliases ("add-shared-symbol-files"
620 and "assf"), have been deprecated. Use the "sharedlibrary" command, or
621 its alias "share", instead.
622
7f3c0343
JB
623* The commands "set remotebaud" and "show remotebaud" are no longer
624 supported. Use "set serial baud" and "show serial baud" (respectively)
625 instead.
626
329ea579
PA
627* MI changes
628
629 ** A new option "-gdb-set mi-async" replaces "-gdb-set
630 target-async". The latter is left as a deprecated alias of the
631 former for backward compatibility. If the target supports it,
632 CLI background execution commands are now always possible by
633 default, independently of whether the frontend stated a
634 preference for asynchronous execution with "-gdb-set mi-async".
635 Previously "-gdb-set target-async off" affected both MI execution
636 commands and CLI execution commands.
637
b7bba001 638*** Changes in GDB 7.7
2d450646 639
33a97bbe
OJ
640* Improved support for process record-replay and reverse debugging on
641 arm*-linux* targets. Support for thumb32 and syscall instruction
642 recording has been added.
643
08248ca9
SDJ
644* GDB now supports SystemTap SDT probes on AArch64 GNU/Linux.
645
73869dc2
DE
646* GDB now supports Fission DWP file format version 2.
647 http://gcc.gnu.org/wiki/DebugFission
648
a280dbd1
SDJ
649* New convenience function "$_isvoid", to check whether an expression
650 is void. A void expression is an expression where the type of the
651 result is "void". For example, some convenience variables may be
652 "void" when evaluated (e.g., "$_exitcode" before the execution of
653 the program being debugged; or an undefined convenience variable).
654 Another example, when calling a function whose return type is
655 "void".
656
52e260a3
DE
657* The "maintenance print objfiles" command now takes an optional regexp.
658
9f948660
SDJ
659* The "catch syscall" command now works on arm*-linux* targets.
660
901461f8
PA
661* GDB now consistently shows "<not saved>" when printing values of
662 registers the debug info indicates have not been saved in the frame
663 and there's nowhere to retrieve them from
664 (callee-saved/call-clobbered registers):
665
666 (gdb) p $rax
667 $1 = <not saved>
668
669 (gdb) info registers rax
670 rax <not saved>
671
672 Before, the former would print "<optimized out>", and the latter
673 "*value not available*".
674
caf26be9
SB
675* New script contrib/gdb-add-index.sh for adding .gdb_index sections
676 to binaries.
677
1e611234
PM
678* Python scripting
679
680 ** Frame filters and frame decorators have been added.
f76c27b5 681 ** Temporary breakpoints are now supported.
bc79de95 682 ** Line tables representation has been added.
a16b0e22
SC
683 ** New attribute 'parent_type' for gdb.Field objects.
684 ** gdb.Field objects can be used as subscripts on gdb.Value objects.
c0d48811 685 ** New attribute 'name' for gdb.Type objects.
1e611234 686
a1217d97
SL
687* New targets
688
689Nios II ELF nios2*-*-elf
690Nios II GNU/Linux nios2*-*-linux
42059f0e 691Texas Instruments MSP430 msp430*-*-elf
a1217d97 692
2659903b
JK
693* Removed native configurations
694
695Support for these a.out NetBSD and OpenBSD obsolete configurations has
696been removed. ELF variants of these configurations are kept supported.
697
698arm*-*-netbsd* but arm*-*-netbsdelf* is kept supported.
699i[34567]86-*-netbsd* but i[34567]86-*-netbsdelf* is kept supported.
700i[34567]86-*-openbsd[0-2].* but i[34567]86-*-openbsd* is kept supported.
701i[34567]86-*-openbsd3.[0-3]
702m68*-*-netbsd* but m68*-*-netbsdelf* is kept supported.
703sparc-*-netbsd* but sparc-*-netbsdelf* is kept supported.
704vax-*-netbsd* but vax-*-netbsdelf* is kept supported.
705
bd712aed 706* New commands:
b340913d
TT
707catch rethrow
708 Like "catch throw", but catches a re-thrown exception.
7d0c9981
DE
709maint check-psymtabs
710 Renamed from old "maint check-symtabs".
711maint check-symtabs
712 Perform consistency checks on symtabs.
713maint expand-symtabs
714 Expand symtabs matching an optional regexp.
b340913d 715
dccca75d
EZ
716show configuration
717 Display the details of GDB configure-time options.
718
bd712aed
DE
719maint set|show per-command
720maint set|show per-command space
721maint set|show per-command time
722maint set|show per-command symtab
723 Enable display of per-command gdb resource usage.
724
98297bf6
NB
725remove-symbol-file FILENAME
726remove-symbol-file -a ADDRESS
727 Remove a symbol file added via add-symbol-file. The file to remove
728 can be identified by its filename or by an address that lies within
729 the boundaries of this symbol file in memory.
730
58d06528
JB
731info exceptions
732info exceptions REGEXP
733 Display the list of Ada exceptions defined in the program being
734 debugged. If provided, only the exceptions whose names match REGEXP
735 are listed.
736
bd3eecc3
PA
737* New options
738
8fb8eb5c
DE
739set debug symfile off|on
740show debug symfile
741 Control display of debugging info regarding reading symbol files and
742 symbol tables within those files
743
e7045703
DE
744set print raw frame-arguments
745show print raw frame-arguments
746 Set/show whether to print frame arguments in raw mode,
747 disregarding any defined pretty-printers.
748
bd3eecc3
PA
749set remote trace-status-packet
750show remote trace-status-packet
751 Set/show the use of remote protocol qTStatus packet.
752
a1217d97
SL
753set debug nios2
754show debug nios2
755 Control display of debugging messages related to Nios II targets.
756
c1e36e3e
PA
757set range-stepping
758show range-stepping
759 Control whether target-assisted range stepping is enabled.
760
98882a26
PA
761set startup-with-shell
762show startup-with-shell
763 Specifies whether Unix child processes are started via a shell or
764 directly.
765
29453a14
YQ
766set code-cache
767show code-cache
768 Use the target memory cache for accesses to the code segment. This
769 improves performance of remote debugging (particularly disassembly).
770
1c2e4450
PA
771* You can now use a literal value 'unlimited' for options that
772 interpret 0 or -1 as meaning "unlimited". E.g., "set
773 trace-buffer-size unlimited" is now an alias for "set
774 trace-buffer-size -1" and "set height unlimited" is now an alias for
775 "set height 0".
776
db0fec5c
DE
777* The "set debug symtab-create" debugging option of GDB has been changed to
778 accept a verbosity level. 0 means "off", 1 provides basic debugging
779 output, and values of 2 or greater provides more verbose output.
780
dccca75d
EZ
781* New command-line options
782--configuration
783 Display the details of GDB configure-time options.
784
d0353e76
YQ
785* The command 'tsave' can now support new option '-ctf' to save trace
786 buffer in Common Trace Format.
787
b292c783
JK
788* Newly installed $prefix/bin/gcore acts as a shell interface for the
789 GDB command gcore.
790
6e72ca20
TT
791* GDB now implements the the C++ 'typeid' operator.
792
b340913d
TT
793* The new convenience variable $_exception holds the exception being
794 thrown or caught at an exception-related catchpoint.
795
796* The exception-related catchpoints, like "catch throw", now accept a
797 regular expression which can be used to filter exceptions by type.
798
0c557179
SDJ
799* The new convenience variable $_exitsignal is automatically set to
800 the terminating signal number when the program being debugged dies
801 due to an uncaught signal.
802
d0353e76
YQ
803* MI changes
804
403cb6b1 805 ** All MI commands now accept an optional "--language" option.
4e35e808
JB
806 Support for this feature can be verified by using the "-list-features"
807 command, which should contain "language-option".
403cb6b1 808
6b7cbff1
JB
809 ** The new command -info-gdb-mi-command allows the user to determine
810 whether a GDB/MI command is supported or not.
811
2ea126fa
JB
812 ** The "^error" result record returned when trying to execute an undefined
813 GDB/MI command now provides a variable named "code" whose content is the
814 "undefined-command" error code. Support for this feature can be verified
815 by using the "-list-features" command, which should contain
816 "undefined-command-error-code".
817
d0353e76
YQ
818 ** The -trace-save MI command can optionally save trace buffer in Common
819 Trace Format now.
820
c5867ab6
HZ
821 ** The new command -dprintf-insert sets a dynamic printf breakpoint.
822
c898adb7
YQ
823 ** The command -data-list-register-values now accepts an optional
824 "--skip-unavailable" option. When used, only the available registers
825 are displayed.
826
dc673c81
YQ
827 ** The new command -trace-frame-collected dumps collected variables,
828 computed expressions, tvars, memory and registers in a traceframe.
829
6211c335
YQ
830 ** The commands -stack-list-locals, -stack-list-arguments and
831 -stack-list-variables now accept an option "--skip-unavailable".
832 When used, only the available locals or arguments are displayed.
833
5713b9b5
JB
834 ** The -exec-run command now accepts an optional "--start" option.
835 When used, the command follows the same semantics as the "start"
836 command, stopping the program's execution at the start of its
72bfa06c
JB
837 main subprogram. Support for this feature can be verified using
838 the "-list-features" command, which should contain
839 "exec-run-start-option".
5713b9b5 840
40555925
JB
841 ** The new commands -catch-assert and -catch-exceptions insert
842 catchpoints stopping the program when Ada exceptions are raised.
843
58d06528
JB
844 ** The new command -info-ada-exceptions provides the equivalent of
845 the new "info exceptions" command.
846
0201faac
JB
847* New system-wide configuration scripts
848 A GDB installation now provides scripts suitable for use as system-wide
849 configuration scripts for the following systems:
850 ** ElinOS
851 ** Wind River Linux
852
c1e36e3e
PA
853* GDB now supports target-assigned range stepping with remote targets.
854 This improves the performance of stepping source lines by reducing
855 the number of control packets from/to GDB. See "New remote packets"
856 below.
857
28a93511
YQ
858* GDB now understands the element 'tvar' in the XML traceframe info.
859 It has the id of the collected trace state variables.
860
4ac33720
UW
861* On S/390 targets that provide the transactional-execution feature,
862 the program interruption transaction diagnostic block (TDB) is now
863 represented as a number of additional "registers" in GDB.
864
c1e36e3e
PA
865* New remote packets
866
867vCont;r
868
869 The vCont packet supports a new 'r' action, that tells the remote
870 stub to step through an address range itself, without GDB
871 involvemement at each single-step.
872
7f91dbec
GB
873qXfer:libraries-svr4:read's annex
874 The previously unused annex of the qXfer:libraries-svr4:read packet
875 is now used to support passing an argument list. The remote stub
876 reports support for this argument list to GDB's qSupported query.
877 The defined arguments are "start" and "prev", used to reduce work
878 necessary for library list updating, resulting in significant
879 speedup.
880
c2d6af84
PA
881* New features in the GDB remote stub, GDBserver
882
883 ** GDBserver now supports target-assisted range stepping. Currently
884 enabled on x86/x86_64 GNU/Linux targets.
885
28a93511
YQ
886 ** GDBserver now adds element 'tvar' in the XML in the reply to
887 'qXfer:traceframe-info:read'. It has the id of the collected
888 trace state variables.
889
7a60ad40
YQ
890 ** GDBserver now supports hardware watchpoints on the MIPS GNU/Linux
891 target.
892
6fbe845e
AB
893* New 'z' formatter for printing and examining memory, this displays the
894 value as hexadecimal zero padded on the left to the size of the type.
895
9058cc3a
TG
896* GDB can now use Windows x64 unwinding data.
897
0d12017b
JB
898* The "set remotebaud" command has been replaced by "set serial baud".
899 Similarly, "show remotebaud" has been replaced by "show serial baud".
900 The "set remotebaud" and "show remotebaud" commands are still available
901 to provide backward compatibility with older versions of GDB.
902
2d450646 903*** Changes in GDB 7.6
80c8d323 904
59ea5688
MM
905* Target record has been renamed to record-full.
906 Record/replay is now enabled with the "record full" command.
907 This also affects settings that are associated with full record/replay
908 that have been moved from "set/show record" to "set/show record full":
909
910set|show record full insn-number-max
911set|show record full stop-at-limit
912set|show record full memory-query
913
914* A new record target "record-btrace" has been added. The new target
915 uses hardware support to record the control-flow of a process. It
916 does not support replaying the execution, but it implements the
917 below new commands for investigating the recorded execution log.
918 This new recording method can be enabled using:
919
920record btrace
921
922 The "record-btrace" target is only available on Intel Atom processors
923 and requires a Linux kernel 2.6.32 or later.
924
925* Two new commands have been added for record/replay to give information
926 about the recorded execution without having to replay the execution.
927 The commands are only supported by "record btrace".
928
929record instruction-history prints the execution history at
930 instruction granularity
931
932record function-call-history prints the execution history at
933 function granularity
934
543bf33d
AT
935* New native configurations
936
51d66578 937ARM AArch64 GNU/Linux aarch64*-*-linux-gnu
543bf33d 938FreeBSD/powerpc powerpc*-*-freebsd
4f4352f7 939x86_64/Cygwin x86_64-*-cygwin*
ea5f3910 940Tilera TILE-Gx GNU/Linux tilegx*-*-linux-gnu
543bf33d 941
249729c4
JB
942* New targets
943
51d66578
MS
944ARM AArch64 aarch64*-*-elf
945ARM AArch64 GNU/Linux aarch64*-*-linux
249729c4 946Lynx 178 PowerPC powerpc-*-lynx*178
3c095f49 947x86_64/Cygwin x86_64-*-cygwin*
ea5f3910 948Tilera TILE-Gx GNU/Linux tilegx*-*-linux
249729c4 949
e64e0392
DE
950* If the configured location of system.gdbinit file (as given by the
951 --with-system-gdbinit option at configure time) is in the
952 data-directory (as specified by --with-gdb-datadir at configure
953 time) or in one of its subdirectories, then GDB will look for the
954 system-wide init file in the directory specified by the
955 --data-directory command-line option.
956
07540c15
DE
957* New command line options:
958
959-nh Disables auto-loading of ~/.gdbinit, but still executes all the
960 other initialization files, unlike -nx which disables all of them.
961
e93a8774
TT
962* Removed command line options
963
964-epoch This was used by the gdb mode in Epoch, an ancient fork of
965 Emacs.
966
53342f27
TT
967* The 'ptype' and 'whatis' commands now accept an argument to control
968 type formatting.
969
451b7c33
TT
970* 'info proc' now works on some core files.
971
a72c3253
DE
972* Python scripting
973
974 ** Vectors can be created with gdb.Type.vector.
975
d7de8e3c
TT
976 ** Python's atexit.register now works in GDB.
977
18a9fc12
TT
978 ** Types can be pretty-printed via a Python API.
979
9a27f2c6
PK
980 ** Python 3 is now supported (in addition to Python 2.4 or later)
981
bea883fd
SCR
982 ** New class gdb.Architecture exposes GDB's internal representation
983 of architecture in the Python API.
984
985 ** New method Frame.architecture returns the gdb.Architecture object
986 corresponding to the frame's architecture.
987
a72c3253
DE
988* New Python-based convenience functions:
989
990 ** $_memeq(buf1, buf2, length)
991 ** $_streq(str1, str2)
992 ** $_strlen(str)
993 ** $_regex(str, regex)
994
f3c8a52a
JK
995* The 'cd' command now defaults to using '~' (the home directory) if not
996 given an argument.
997
1605ef26
TT
998* The C++ ABI now defaults to the GNU v3 ABI. This has been the
999 default for GCC since November 2000.
1000
504b36fd
YQ
1001* The command 'forward-search' can now be abbreviated as 'fo'.
1002
f2a8bc8a
YQ
1003* The command 'info tracepoints' can now display 'installed on target'
1004 or 'not installed on target' for each non-pending location of tracepoint.
1005
23a80689
JB
1006* New configure options
1007
1008--enable-libmcheck/--disable-libmcheck
1009 By default, development versions are built with -lmcheck on hosts
1010 that support it, in order to help track memory corruption issues.
1011 Release versions, on the other hand, are built without -lmcheck
1012 by default. The --enable-libmcheck/--disable-libmcheck configure
1013 options allow the user to override that default.
393fd4c3
YQ
1014--with-babeltrace/--with-babeltrace-include/--with-babeltrace-lib
1015 This configure option allows the user to build GDB with
1016 libbabeltrace using which GDB can read Common Trace Format data.
23a80689 1017
d6b28940
TT
1018* New commands (for set/show, see "New options" below)
1019
ab04a2af
TT
1020catch signal
1021 Catch signals. This is similar to "handle", but allows commands and
1022 conditions to be attached.
1023
d6b28940
TT
1024maint info bfds
1025 List the BFDs known to GDB.
1026
8315665e
YPK
1027python-interactive [command]
1028pi [command]
1029 Start a Python interactive prompt, or evaluate the optional command
1030 and print the result of expressions.
1031
1032py [command]
1033 "py" is a new alias for "python".
1034
18a9fc12
TT
1035enable type-printer [name]...
1036disable type-printer [name]...
1037 Enable or disable type printers.
1038
aa9259cc
TS
1039* Removed commands
1040
1041 ** For the Renesas Super-H architecture, the "regs" command has been removed
1042 (has been deprecated in GDB 7.5), and "info all-registers" should be used
1043 instead.
1044
53342f27
TT
1045* New options
1046
1047set print type methods (on|off)
1048show print type methods
1049 Control whether method declarations are displayed by "ptype".
1050 The default is to show them.
1051
1052set print type typedefs (on|off)
1053show print type typedefs
1054 Control whether typedef definitions are displayed by "ptype".
1055 The default is to show them.
1056
1b56eb55
JK
1057set filename-display basename|relative|absolute
1058show filename-display
1059 Control the way in which filenames is displayed.
1060 The default is "relative", which preserves previous behavior.
1061
e9f1758d
PA
1062set trace-buffer-size
1063show trace-buffer-size
1064 Request target to change the size of trace buffer.
1065
a46c1e42
PA
1066set remote trace-buffer-size-packet auto|on|off
1067show remote trace-buffer-size-packet
1068 Control the use of the remote protocol `QTBuffer:size' packet.
1069
be9a8770
PA
1070set debug aarch64
1071show debug aarch64
1072 Control display of debugging messages related to ARM AArch64.
1073 The default is off.
1074
1075set debug coff-pe-read
1076show debug coff-pe-read
1077 Control display of debugging messages related to reading of COFF/PE
1078 exported symbols.
1079
1080set debug mach-o
1081show debug mach-o
1082 Control display of debugging messages related to Mach-O symbols
1083 processing.
1084
1085set debug notification
1086show debug notification
1087 Control display of debugging info for async remote notification.
1088
5b9afe8a
YQ
1089* MI changes
1090
1091 ** Command parameter changes are now notified using new async record
1092 "=cmd-param-changed".
201b4506
YQ
1093 ** Trace frame changes caused by command "tfind" are now notified using
1094 new async record "=traceframe-changed".
134a2066
YQ
1095 ** The creation, deletion and modification of trace state variables
1096 are now notified using new async records "=tsv-created",
1097 "=tsv-deleted" and "=tsv-modified".
82a90ccf
YQ
1098 ** The start and stop of process record are now notified using new
1099 async record "=record-started" and "=record-stopped".
8de0566d
YQ
1100 ** Memory changes are now notified using new async record
1101 "=memory-changed".
ed8a1c2d 1102 ** The data-disassemble command response will include a "fullname" field
ec83d211 1103 containing the absolute file name when source has been requested.
62747a60
TT
1104 ** New optional parameter COUNT added to the "-data-write-memory-bytes"
1105 command, to allow pattern filling of memory areas.
3fa7bf06
MG
1106 ** New commands "-catch-load"/"-catch-unload" added for intercepting
1107 library load/unload events.
f2a8bc8a
YQ
1108 ** The response to breakpoint commands and breakpoint async records
1109 includes an "installed" field containing a boolean state about each
1110 non-pending tracepoint location is whether installed on target or not.
f5911ea1
HAQ
1111 ** Output of the "-trace-status" command includes a "trace-file" field
1112 containing the name of the trace file being examined. This field is
1113 optional, and only present when examining a trace file.
ec83d211
JK
1114 ** The "fullname" field is now always present along with the "file" field,
1115 even if the file cannot be found by GDB.
5b9afe8a 1116
608e2dbb
TT
1117* GDB now supports the "mini debuginfo" section, .gnu_debugdata.
1118 You must have the LZMA library available when configuring GDB for this
1119 feature to be enabled. For more information, see:
1120 http://fedoraproject.org/wiki/Features/MiniDebugInfo
1121
f6f899bf
HAQ
1122* New remote packets
1123
1124QTBuffer:size
1125 Set the size of trace buffer. The remote stub reports support for this
1126 packet to gdb's qSupported query.
1127
10782d74
MM
1128Qbtrace:bts
1129 Enable Branch Trace Store (BTS)-based branch tracing for the current
1130 thread. The remote stub reports support for this packet to gdb's
1131 qSupported query.
1132
1133Qbtrace:off
1134 Disable branch tracing for the current thread. The remote stub reports
1135 support for this packet to gdb's qSupported query.
1136
1137qXfer:btrace:read
1138 Read the traced branches for the current thread. The remote stub
1139 reports support for this packet to gdb's qSupported query.
1140
80c8d323 1141*** Changes in GDB 7.5
d6e00af6 1142
1b3371b1
L
1143* GDB now supports x32 ABI. Visit <http://sites.google.com/site/x32abi/>
1144 for more x32 ABI info.
1145
d0e64392
MR
1146* GDB now supports access to MIPS DSP registers on Linux targets.
1147
4cc0665f
MR
1148* GDB now supports debugging microMIPS binaries.
1149
85d4a676
SS
1150* The "info os" command on GNU/Linux can now display information on
1151 several new classes of objects managed by the operating system:
1152 "info os procgroups" lists process groups
1153 "info os files" lists file descriptors
1154 "info os sockets" lists internet-domain sockets
1155 "info os shm" lists shared-memory regions
1156 "info os semaphores" lists semaphores
1157 "info os msg" lists message queues
1158 "info os modules" lists loaded kernel modules
1159
55aa24fb
SDJ
1160* GDB now has support for SDT (Static Defined Tracing) probes. Currently,
1161 the only implemented backend is for SystemTap probes (<sys/sdt.h>). You
1162 can set a breakpoint using the new "-probe, "-pstap" or "-probe-stap"
1163 options and inspect the probe arguments using the new $_probe_arg family
1164 of convenience variables. You can obtain more information about SystemTap
1165 in <http://sourceware.org/systemtap/>.
1166
72508ac0
PO
1167* GDB now supports reversible debugging on ARM, it allows you to
1168 debug basic ARM and THUMB instructions, and provides
1169 record/replay support.
1170
16899756
DE
1171* The option "symbol-reloading" has been deleted as it is no longer used.
1172
4795f398
DE
1173* Python scripting
1174
7d74f244
DE
1175 ** GDB commands implemented in Python can now be put in command class
1176 "gdb.COMMAND_USER".
1177
4795f398
DE
1178 ** The "maint set python print-stack on|off" is now deleted.
1179
50897289
TT
1180 ** A new class, gdb.printing.FlagEnumerationPrinter, can be used to
1181 apply "flag enum"-style pretty-printing to any enum.
1182
64e7d9dd
TT
1183 ** gdb.lookup_symbol can now work when there is no current frame.
1184
1185 ** gdb.Symbol now has a 'line' attribute, holding the line number in
1186 the source at which the symbol was defined.
1187
f0823d2c
TT
1188 ** gdb.Symbol now has the new attribute 'needs_frame' and the new
1189 method 'value'. The former indicates whether the symbol needs a
1190 frame in order to compute its value, and the latter computes the
1191 symbol's value.
1192
7b282c5a
SCR
1193 ** A new method 'referenced_value' on gdb.Value objects which can
1194 dereference pointer as well as C++ reference values.
1195
a20ee7a4
SCR
1196 ** New methods 'global_block' and 'static_block' on gdb.Symtab objects
1197 which return the global and static blocks (as gdb.Block objects),
1198 of the underlying symbol table, respectively.
1199
7efc75aa
SCR
1200 ** New function gdb.find_pc_line which returns the gdb.Symtab_and_line
1201 object associated with a PC value.
1202
ee0bf529
SCR
1203 ** gdb.Symtab_and_line has new attribute 'last' which holds the end
1204 of the address range occupied by code for the current source line.
1205
a766d390
DE
1206* Go language support.
1207 GDB now supports debugging programs written in the Go programming
1208 language.
1209
e0f9f062
DE
1210* GDBserver now supports stdio connections.
1211 E.g. (gdb) target remote | ssh myhost gdbserver - hello
1212
217bff3e
JK
1213* The binary "gdbtui" can no longer be built or installed.
1214 Use "gdb -tui" instead.
1215
cafec441
TT
1216* GDB will now print "flag" enums specially. A flag enum is one where
1217 all the enumerator values have no bits in common when pairwise
1218 "and"ed. When printing a value whose type is a flag enum, GDB will
1219 show all the constants, e.g., for enum E { ONE = 1, TWO = 2}:
1220 (gdb) print (enum E) 3
1221 $1 = (ONE | TWO)
1222
4aac40c8
TT
1223* The filename part of a linespec will now match trailing components
1224 of a source file name. For example, "break gcc/expr.c:1000" will
1225 now set a breakpoint in build/gcc/expr.c, but not
1226 build/libcpp/expr.c.
1227
d99bd577
UW
1228* The "info proc" and "generate-core-file" commands will now also
1229 work on remote targets connected to GDBserver on Linux.
1230
53fe1783
GB
1231* The command "info catch" has been removed. It has been disabled
1232 since December 2007.
1233
e41eec66
JB
1234* The "catch exception" and "catch assert" commands now accept
1235 a condition at the end of the command, much like the "break"
1236 command does. For instance:
1237
1238 (gdb) catch exception Constraint_Error if Barrier = True
1239
1240 Previously, it was possible to add a condition to such catchpoints,
1241 but it had to be done as a second step, after the catchpoint had been
1242 created, using the "condition" command.
1243
5808517f
YQ
1244* The "info static-tracepoint-marker" command will now also work on
1245 native Linux targets with in-process agent.
1246
481860b3
GB
1247* GDB can now set breakpoints on inlined functions.
1248
1249* The .gdb_index section has been updated to include symbols for
1250 inlined functions. GDB will ignore older .gdb_index sections by
1251 default, which could cause symbol files to be loaded more slowly
e615022a
DE
1252 until their .gdb_index sections can be recreated. The new command
1253 "set use-deprecated-index-sections on" will cause GDB to use any older
1254 .gdb_index sections it finds. This will restore performance, but the
1255 ability to set breakpoints on inlined functions will be lost in symbol
1256 files with older .gdb_index sections.
481860b3 1257
156942c7
DE
1258 The .gdb_index section has also been updated to record more information
1259 about each symbol. This speeds up the "info variables", "info functions"
1260 and "info types" commands when used with programs having the .gdb_index
1261 section, as well as speeding up debugging with shared libraries using
1262 the .gdb_index section.
1263
927fbba6
JB
1264* Ada support for GDB/MI Variable Objects has been added.
1265
20388dd6
YQ
1266* GDB can now support 'breakpoint always-inserted mode' in 'record'
1267 target.
1268
f3e0e960
SS
1269* MI changes
1270
1271 ** New command -info-os is the MI equivalent of "info os".
1272
37ce89eb
SS
1273 ** Output logs ("set logging" and related) now include MI output.
1274
edcc5120
TT
1275* New commands
1276
e615022a
DE
1277 ** "set use-deprecated-index-sections on|off"
1278 "show use-deprecated-index-sections on|off"
1279 Controls the use of deprecated .gdb_index sections.
1280
edcc5120
TT
1281 ** "catch load" and "catch unload" can be used to stop when a shared
1282 library is loaded or unloaded, respectively.
1283
816338b5
SS
1284 ** "enable count" can be used to auto-disable a breakpoint after
1285 several hits.
1286
57651221 1287 ** "info vtbl" can be used to show the virtual method tables for
c4aeac85
TT
1288 C++ and Java objects.
1289
06fc020f 1290 ** "explore" and its sub commands "explore value" and "explore type"
6ea71545 1291 can be used to recursively explore values and types of
06fc020f
SCR
1292 expressions. These commands are available only if GDB is
1293 configured with '--with-python'.
1294
bf88dd68
JK
1295 ** "info auto-load" shows status of all kinds of auto-loaded files,
1296 "info auto-load gdb-scripts" shows status of auto-loading GDB canned
1297 sequences of commands files, "info auto-load python-scripts"
1298 shows status of auto-loading Python script files,
1299 "info auto-load local-gdbinit" shows status of loading init file
1300 (.gdbinit) from current directory and "info auto-load libthread-db" shows
1301 status of inferior specific thread debugging shared library loading.
1302
1303 ** "info auto-load-scripts", "set auto-load-scripts on|off"
1304 and "show auto-load-scripts" commands have been deprecated, use their
1305 "info auto-load python-scripts", "set auto-load python-scripts on|off"
1306 and "show auto-load python-scripts" counterparts instead.
1307
e7e0cddf
SS
1308 ** "dprintf location,format,args..." creates a dynamic printf, which
1309 is basically a breakpoint that does a printf and immediately
1310 resumes your program's execution, so it is like a printf that you
1311 can insert dynamically at runtime instead of at compiletime.
1312
9cb709b6
TT
1313 ** "set print symbol"
1314 "show print symbol"
1315 Controls whether GDB attempts to display the symbol, if any,
1316 corresponding to addresses it prints. This defaults to "on", but
1317 you can set it to "off" to restore GDB's previous behavior.
1318
2d4c29c5
TS
1319* Deprecated commands
1320
1321 ** For the Renesas Super-H architecture, the "regs" command has been
1322 deprecated, and "info all-registers" should be used instead.
1323
a58b110a
KB
1324* New targets
1325
1326Renesas RL78 rl78-*-elf
60c9a3c0 1327HP OpenVMS ia64 ia64-hp-openvms*
a58b110a 1328
72895ff6
LM
1329* GDBserver supports evaluation of breakpoint conditions. When
1330 support is advertised by GDBserver, GDB may be told to send the
1331 breakpoint conditions in bytecode form to GDBserver. GDBserver
1332 will only report the breakpoint trigger to GDB when its condition
1333 evaluates to true.
1334
1335* New options
1336
4cc0665f
MR
1337set mips compression
1338show mips compression
1339 Select the compressed ISA encoding used in functions that have no symbol
1340 information available. The encoding can be set to either of:
1341 mips16
1342 micromips
1343 and is updated automatically from ELF file flags if available.
1344
72895ff6
LM
1345set breakpoint condition-evaluation
1346show breakpoint condition-evaluation
cf65ecd3 1347 Control whether breakpoint conditions are evaluated by GDB ("host") or by
5b43fab2
JK
1348 GDBserver ("target"). Default option "auto" chooses the most efficient
1349 available mode.
72895ff6
LM
1350 This option can improve debugger efficiency depending on the speed of the
1351 target.
1352
bf88dd68
JK
1353set auto-load off
1354 Disable auto-loading globally.
1355
1356show auto-load
1357 Show auto-loading setting of all kinds of auto-loaded files.
1358
1359set auto-load gdb-scripts on|off
1360show auto-load gdb-scripts
1361 Control auto-loading of GDB canned sequences of commands files.
1362
1363set auto-load python-scripts on|off
1364show auto-load python-scripts
1365 Control auto-loading of Python script files.
1366
1367set auto-load local-gdbinit on|off
1368show auto-load local-gdbinit
1369 Control loading of init file (.gdbinit) from current directory.
1370
1371set auto-load libthread-db on|off
1372show auto-load libthread-db
1373 Control auto-loading of inferior specific thread debugging shared library.
1374
7349ff92 1375set auto-load scripts-directory <dir1>[:<dir2>...]
9cc815f5 1376show auto-load scripts-directory
7349ff92
JK
1377 Set a list of directories from which to load auto-loaded scripts.
1378 Automatically loaded Python scripts and GDB scripts are located in one
1379 of the directories listed by this option.
1380 The delimiter (':' above) may differ according to the host platform.
1381
bccbefd2
JK
1382set auto-load safe-path <dir1>[:<dir2>...]
1383show auto-load safe-path
1384 Set a list of directories from which it is safe to auto-load files.
1385 The delimiter (':' above) may differ according to the host platform.
1386
4dc84fd1
JK
1387set debug auto-load on|off
1388show debug auto-load
1389 Control display of debugging info for auto-loading the files above.
1390
d3ce09f5 1391set dprintf-style gdb|call|agent
e7e0cddf 1392show dprintf-style
d3ce09f5
SS
1393 Control the way in which a dynamic printf is performed; "gdb"
1394 requests a GDB printf command, while "call" causes dprintf to call a
1395 function in the inferior. "agent" requests that the target agent
1396 (such as GDBserver) do the printing.
e7e0cddf
SS
1397
1398set dprintf-function <expr>
1399show dprintf-function
1400set dprintf-channel <expr>
1401show dprintf-channel
1402 Set the function and optional first argument to the call when using
1403 the "call" style of dynamic printf.
1404
d3ce09f5
SS
1405set disconnected-dprintf on|off
1406show disconnected-dprintf
1407 Control whether agent-style dynamic printfs continue to be in effect
1408 after GDB disconnects.
1409
6dea1fbd
JK
1410* New configure options
1411
7349ff92
JK
1412--with-auto-load-dir
1413 Configure default value for the 'set auto-load scripts-directory'
1564a261
JK
1414 setting above. It defaults to '$debugdir:$datadir/auto-load',
1415 $debugdir representing global debugging info directories (available
1416 via 'show debug-file-directory') and $datadir representing GDB's data
1417 directory (available via 'show data-directory').
7349ff92 1418
6dea1fbd
JK
1419--with-auto-load-safe-path
1420 Configure default value for the 'set auto-load safe-path' setting
7349ff92 1421 above. It defaults to the --with-auto-load-dir setting.
6dea1fbd
JK
1422
1423--without-auto-load-safe-path
1424 Set 'set auto-load safe-path' to '/', effectively disabling this
1425 security feature.
1426
72895ff6
LM
1427* New remote packets
1428
74c48cbb
PA
1429z0/z1 conditional breakpoints extension
1430
72895ff6
LM
1431 The z0/z1 breakpoint insertion packets have been extended to carry
1432 a list of conditional expressions over to the remote stub depending on the
1433 condition evaluation mode. The use of this extension can be controlled
1434 via the "set remote conditional-breakpoints-packet" command.
1435
9b224c5e
PA
1436QProgramSignals:
1437
1438 Specify the signals which the remote stub may pass to the debugged
1439 program without GDB involvement.
1440
8320cc4f
JK
1441* New command line options
1442
1443--init-command=FILE, -ix Like --command, -x but execute it
1444 before loading inferior.
1445--init-eval-command=COMMAND, -iex Like --eval-command=COMMAND, -ex but
1446 execute it before loading inferior.
1447
8837a20f
JB
1448*** Changes in GDB 7.4
1449
f8eba3c6
TT
1450* GDB now handles ambiguous linespecs more consistently; the existing
1451 FILE:LINE support has been expanded to other types of linespecs. A
1452 breakpoint will now be set on all matching locations in all
1453 inferiors, and locations will be added or removed according to
1454 inferior changes.
1455
1bfeeb0f
JL
1456* GDB now allows you to skip uninteresting functions and files when
1457 stepping with the "skip function" and "skip file" commands.
1458
480a3f21
PW
1459* GDB has two new commands: "set remote hardware-watchpoint-length-limit"
1460 and "show remote hardware-watchpoint-length-limit". These allows to
1461 set or show the maximum length limit (in bytes) of a remote
1462 target hardware watchpoint.
1463
1464 This allows e.g. to use "unlimited" hardware watchpoints with the
1465 gdbserver integrated in Valgrind version >= 3.7.0. Such Valgrind
1466 watchpoints are slower than real hardware watchpoints but are
1467 significantly faster than gdb software watchpoints.
1468
3a7bf607
PM
1469* Python scripting
1470
32d1c362 1471 ** The register_pretty_printer function in module gdb.printing now takes
7d0aff21 1472 an optional `replace' argument. If True, the new printer replaces any
32d1c362
DE
1473 existing one.
1474
3a7bf607 1475 ** The "maint set python print-stack on|off" command has been
4795f398
DE
1476 deprecated and will be deleted in GDB 7.5.
1477 A new command: "set python print-stack none|full|message" has
1478 replaced it. Additionally, the default for "print-stack" is
1479 now "message", which just prints the error message without
1480 the stack trace.
3a7bf607 1481
baacfb07 1482 ** A prompt substitution hook (prompt_hook) is now available to the
3a7bf607 1483 Python API.
713389e0 1484
fa3a4f15
PM
1485 ** A new Python module, gdb.prompt has been added to the GDB Python
1486 modules library. This module provides functionality for
baacfb07 1487 escape sequences in prompts (used by set/show
fa3a4f15
PM
1488 extended-prompt). These escape sequences are replaced by their
1489 corresponding value.
1490
5e239b84
PM
1491 ** Python commands and convenience-functions located in
1492 'data-directory'/python/gdb/command and
1493 'data-directory'/python/gdb/function are now automatically loaded
1494 on GDB start-up.
1495
9df2fbc4
PM
1496 ** Blocks now provide four new attributes. global_block and
1497 static_block will return the global and static blocks
1498 respectively. is_static and is_global are boolean attributes
1499 that indicate if the block is one of those two types.
1500
457e09f0
DE
1501 ** Symbols now provide the "type" attribute, the type of the symbol.
1502
6839b47f
KP
1503 ** The "gdb.breakpoint" function has been deprecated in favor of
1504 "gdb.breakpoints".
1505
cc72b2a2
KP
1506 ** A new class "gdb.FinishBreakpoint" is provided to catch the return
1507 of a function. This class is based on the "finish" command
1508 available in the CLI.
1509
84ad80e6
PK
1510 ** Type objects for struct and union types now allow access to
1511 the fields using standard Python dictionary (mapping) methods.
1512 For example, "some_type['myfield']" now works, as does
1513 "some_type.items()".
1514
20c168b5
KP
1515 ** A new event "gdb.new_objfile" has been added, triggered by loading a
1516 new object file.
1517
03c3051a
PK
1518 ** A new function, "deep_items" has been added to the gdb.types
1519 module in the GDB Python modules library. This function returns
1520 an iterator over the fields of a struct or union type. Unlike
1521 the standard Python "iteritems" method, it will recursively traverse
1522 any anonymous fields.
1523
7376e450
TT
1524* MI changes
1525
1526 ** "*stopped" events can report several new "reason"s, such as
1527 "solib-event".
1528
1529 ** Breakpoint changes are now notified using new async records, like
1530 "=breakpoint-modified".
1531
1532 ** New command -ada-task-info.
1533
98a5dd13
DE
1534* libthread-db-search-path now supports two special values: $sdir and $pdir.
1535 $sdir specifies the default system locations of shared libraries.
1536 $pdir specifies the directory where the libpthread used by the application
1537 lives.
1538
1539 GDB no longer looks in $sdir and $pdir after it has searched the directories
1540 mentioned in libthread-db-search-path. If you want to search those
1541 directories, they must be specified in libthread-db-search-path.
1542 The default value of libthread-db-search-path on GNU/Linux and Solaris
1543 systems is now "$sdir:$pdir".
1544
1545 $pdir is not supported by gdbserver, it is currently ignored.
1546 $sdir is supported by gdbserver.
1547
478aac75
DE
1548* New configure option --with-iconv-bin.
1549 When using the internationalization support like the one in the GNU C
1550 library, GDB will invoke the "iconv" program to get a list of supported
1551 character sets. If this program lives in a non-standard location, one can
1552 use this option to specify where to find it.
1553
9c06b0b4
TJB
1554* When natively debugging programs on PowerPC BookE processors running
1555 a Linux kernel version 2.6.34 or later, GDB supports masked hardware
1556 watchpoints, which specify a mask in addition to an address to watch.
1557 The mask specifies that some bits of an address (the bits which are
1558 reset in the mask) should be ignored when matching the address accessed
1559 by the inferior against the watchpoint address. See the "PowerPC Embedded"
1560 section in the user manual for more details.
1561
03f2bd59
JK
1562* The new option --once causes GDBserver to stop listening for connections once
1563 the first connection is made. The listening port used by GDBserver will
1564 become available after that.
1565
71eba9c2 1566* New commands "info macros" and "alias" have been added.
edc84990 1567
2bda9cc5
JK
1568* New function parameters suffix @entry specifies value of function parameter
1569 at the time the function got called. Entry values are available only since
1570 gcc version 4.7.
1571
ed59ded5
DE
1572* New commands
1573
1574!SHELL COMMAND
1575 "!" is now an alias of the "shell" command.
1576 Note that no space is needed between "!" and SHELL COMMAND.
1577
9c06b0b4
TJB
1578* Changed commands
1579
1580watch EXPRESSION mask MASK_VALUE
1581 The watch command now supports the mask argument which allows creation
1582 of masked watchpoints, if the current architecture supports this feature.
1583
dbaefcf7
DE
1584info auto-load-scripts [REGEXP]
1585 This command was formerly named "maintenance print section-scripts".
1586 It is now generally useful and is no longer a maintenance-only command.
1587
71eba9c2 1588info macro [-all] [--] MACRO
1589 The info macro command has new options `-all' and `--'. The first for
1590 printing all definitions of a macro. The second for explicitly specifying
1591 the end of arguments and the beginning of the macro name in case the macro
1592 name starts with a hyphen.
1593
3065dfb6
SS
1594collect[/s] EXPRESSIONS
1595 The tracepoint collect command now takes an optional modifier "/s"
1596 that directs it to dereference pointer-to-character types and
1597 collect the bytes of memory up to a zero byte. The behavior is
1598 similar to what you see when you use the regular print command on a
1599 string. An optional integer following the "/s" sets a bound on the
1600 number of bytes that will be collected.
1601
f196051f
SS
1602tstart [NOTES]
1603 The trace start command now interprets any supplied arguments as a
1604 note to be recorded with the trace run, with an effect similar to
1605 setting the variable trace-notes.
1606
1607tstop [NOTES]
1608 The trace stop command now interprets any arguments as a note to be
1609 mentioned along with the tstatus report that the trace was stopped
1610 with a command. The effect is similar to setting the variable
1611 trace-stop-notes.
1612
d248b706
KY
1613* Tracepoints can now be enabled and disabled at any time after a trace
1614 experiment has been started using the standard "enable" and "disable"
1615 commands. It is now possible to start a trace experiment with no enabled
1616 tracepoints; GDB will display a warning, but will allow the experiment to
1617 begin, assuming that tracepoints will be enabled as needed while the trace
1618 is running.
1619
405f8e94
SS
1620* Fast tracepoints on 32-bit x86-architectures can now be placed at
1621 locations with 4-byte instructions, when they were previously
1622 limited to locations with instructions of 5 bytes or longer.
1623
2bda9cc5
JK
1624* New options
1625
45cfd468
DE
1626set debug dwarf2-read
1627show debug dwarf2-read
1628 Turns on or off display of debugging messages related to reading
1629 DWARF debug info. The default is off.
1630
1631set debug symtab-create
1632show debug symtab-create
1633 Turns on or off display of debugging messages related to symbol table
1634 creation. The default is off.
1635
baacfb07
PM
1636set extended-prompt
1637show extended-prompt
1638 Set the GDB prompt, and allow escape sequences to be inserted to
1639 display miscellaneous information (see 'help set extended-prompt'
1640 for the list of sequences). This prompt (and any information
1641 accessed through the escape sequences) is updated every time the
1642 prompt is displayed.
1643
2bda9cc5
JK
1644set print entry-values (both|compact|default|if-needed|no|only|preferred)
1645show print entry-values
1646 Set printing of frame argument values at function entry. In some cases
1647 GDB can determine the value of function argument which was passed by the
1648 function caller, even if the value was modified inside the called function.
1649
1650set debug entry-values
1651show debug entry-values
1652 Control display of debugging info for determining frame argument values at
1653 function entry and virtual tail call frames.
1654
c011a4f4
DE
1655set basenames-may-differ
1656show basenames-may-differ
1657 Set whether a source file may have multiple base names.
1658 (A "base name" is the name of a file with the directory part removed.
1659 Example: The base name of "/home/user/hello.c" is "hello.c".)
1660 If set, GDB will canonicalize file names (e.g., expand symlinks)
1661 before comparing them. Canonicalization is an expensive operation,
1662 but it allows the same file be known by more than one base name.
1663 If not set (the default), all source files are assumed to have just
1664 one base name, and gdb will do file name comparisons more efficiently.
1665
f196051f
SS
1666set trace-user
1667show trace-user
1668set trace-notes
1669show trace-notes
1670 Set a user name and notes for the current and any future trace runs.
1671 This is useful for long-running and/or disconnected traces, to
1672 inform others (or yourself) as to who is running the trace, supply
1673 contact information, or otherwise explain what is going on.
1674
1675set trace-stop-notes
1676show trace-stop-notes
1677 Set a note attached to the trace run, that is displayed when the
1678 trace has been stopped by a tstop command. This is useful for
1679 instance as an explanation, if you are stopping a trace run that was
1680 started by someone else.
1681
d248b706
KY
1682* New remote packets
1683
1684QTEnable
1685
1686 Dynamically enable a tracepoint in a started trace experiment.
1687
1688QTDisable
1689
1690 Dynamically disable a tracepoint in a started trace experiment.
1691
f196051f
SS
1692QTNotes
1693
1694 Set the user and notes of the trace run.
1695
1696qTP
1697
1698 Query the current status of a tracepoint.
1699
405f8e94
SS
1700qTMinFTPILen
1701
1702 Query the minimum length of instruction at which a fast tracepoint may
1703 be placed.
1704
1a532630
PP
1705* Dcache size (number of lines) and line-size are now runtime-configurable
1706 via "set dcache line" and "set dcache line-size" commands.
1707
11315641
YQ
1708* New targets
1709
1710Texas Instruments TMS320C6x tic6x-*-*
1711
87326c78
DD
1712* New Simulators
1713
1714Renesas RL78 rl78-*-elf
1715
e8d56f18
JB
1716*** Changes in GDB 7.3.1
1717
1718* The build failure for NetBSD and OpenBSD targets have now been fixed.
1719
d6e00af6 1720*** Changes in GDB 7.3
797054e6 1721
60f98dde
MS
1722* GDB has a new command: "thread find [REGEXP]".
1723 It finds the thread id whose name, target id, or thread extra info
1724 matches the given regular expression.
1725
eee5b35e
DD
1726* The "catch syscall" command now works on mips*-linux* targets.
1727
b716877b
AB
1728* The -data-disassemble MI command now supports modes 2 and 3 for
1729 dumping the instruction opcodes.
1730
aae1c79a
DE
1731* New command line options
1732
1733-data-directory DIR Specify DIR as the "data-directory".
1734 This is mostly for testing purposes.
1735
a86caf66
DE
1736* The "maint set python auto-load on|off" command has been renamed to
1737 "set auto-load-scripts on|off".
1738
99e7ae30
DE
1739* GDB has a new command: "set directories".
1740 It is like the "dir" command except that it replaces the
1741 source path list instead of augmenting it.
1742
4694da01
TT
1743* GDB now understands thread names.
1744
1745 On GNU/Linux, "info threads" will display the thread name as set by
1746 prctl or pthread_setname_np.
1747
1748 There is also a new command, "thread name", which can be used to
1749 assign a name internally for GDB to display.
1750
f4b8a18d
KW
1751* OpenCL C
1752 Initial support for the OpenCL C language (http://www.khronos.org/opencl)
1753 has been integrated into GDB.
1754
585d1eb8
PM
1755* Python scripting
1756
da5d4055
PM
1757 ** The function gdb.Write now accepts an optional keyword 'stream'.
1758 This keyword, when provided, will direct the output to either
1759 stdout, stderr, or GDB's logging output.
1760
9a6f1302
PM
1761 ** Parameters can now be be sub-classed in Python, and in particular
1762 you may implement the get_set_doc and get_show_doc functions.
1763 This improves how Parameter set/show documentation is processed
1764 and allows for more dynamic content.
1765
29703da4
PM
1766 ** Symbols, Symbol Table, Symbol Table and Line, Object Files,
1767 Inferior, Inferior Thread, Blocks, and Block Iterator APIs now
1768 have an is_valid method.
1769
350c6c65
PM
1770 ** Breakpoints can now be sub-classed in Python, and in particular
1771 you may implement a 'stop' function that is executed each time
1772 the inferior reaches that breakpoint.
1773
6e6fbe60
DE
1774 ** New function gdb.lookup_global_symbol looks up a global symbol.
1775
585d1eb8
PM
1776 ** GDB values in Python are now callable if the value represents a
1777 function. For example, if 'some_value' represents a function that
1778 takes two integer parameters and returns a value, you can call
1779 that function like so:
1780
1781 result = some_value (10,20)
1782
0e3509db
DE
1783 ** Module gdb.types has been added.
1784 It contains a collection of utilities for working with gdb.Types objects:
1785 get_basic_type, has_field, make_enum_dict.
1786
7b51bc51
DE
1787 ** Module gdb.printing has been added.
1788 It contains utilities for writing and registering pretty-printers.
1789 New classes: PrettyPrinter, SubPrettyPrinter,
1790 RegexpCollectionPrettyPrinter.
1791 New function: register_pretty_printer.
1792
1793 ** New commands "info pretty-printers", "enable pretty-printer" and
1794 "disable pretty-printer" have been added.
1795
99e7ae30
DE
1796 ** gdb.parameter("directories") is now available.
1797
d8e22779
TT
1798 ** New function gdb.newest_frame returns the newest frame in the
1799 selected thread.
1800
4694da01
TT
1801 ** The gdb.InferiorThread class has a new "name" attribute. This
1802 holds the thread's name.
1803
505500db
SW
1804 ** Python Support for Inferior events.
1805 Python scripts can add observers to be notified of events
824446ad 1806 occurring in the process being debugged.
c17a9e46
HZ
1807 The following events are currently supported:
1808 - gdb.events.cont Continue event.
1809 - gdb.events.exited Inferior exited event.
1810 - gdb.events.stop Signal received, and Breakpoint hit events.
1811
def98928
TT
1812* C++ Improvements:
1813
1814 ** GDB now puts template parameters in scope when debugging in an
1815 instantiation. For example, if you have:
1816
1817 template<int X> int func (void) { return X; }
1818
1819 then if you step into func<5>, "print X" will show "5". This
1820 feature requires proper debuginfo support from the compiler; it
1821 was added to GCC 4.5.
1822
66cb8159
TT
1823 ** The motion commands "next", "finish", "until", and "advance" now
1824 work better when exceptions are thrown. In particular, GDB will
1825 no longer lose control of the inferior; instead, the GDB will
1826 stop the inferior at the point at which the exception is caught.
1827 This functionality requires a change in the exception handling
1828 code that was introduced in GCC 4.5.
1829
4aac0db7
UW
1830* GDB now follows GCC's rules on accessing volatile objects when
1831 reading or writing target state during expression evaluation.
1832 One notable difference to prior behavior is that "print x = 0"
1833 no longer generates a read of x; the value of the assignment is
1834 now always taken directly from the value being assigned.
1835
283e6a52
TT
1836* GDB now has some support for using labels in the program's source in
1837 linespecs. For instance, you can use "advance label" to continue
1838 execution to a label.
1839
1840* GDB now has support for reading and writing a new .gdb_index
1841 section. This section holds a fast index of DWARF debugging
1842 information and can be used to greatly speed up GDB startup and
1843 operation. See the documentation for `save gdb-index' for details.
1844
b56df873 1845* The "watch" command now accepts an optional "-location" argument.
14c0d4e1 1846 When used, this causes GDB to watch the memory referred to by the
b56df873
TT
1847 expression. Such a watchpoint is never deleted due to it going out
1848 of scope.
1849
ae53ffa4
PA
1850* GDB now supports thread debugging of core dumps on GNU/Linux.
1851
1852 GDB now activates thread debugging using the libthread_db library
1853 when debugging GNU/Linux core dumps, similarly to when debugging
1854 live processes. As a result, when debugging a core dump file, GDB
1855 is now able to display pthread_t ids of threads. For example, "info
1856 threads" shows the same output as when debugging the process when it
1857 was live. In earlier releases, you'd see something like this:
1858
1859 (gdb) info threads
1860 * 1 LWP 6780 main () at main.c:10
1861
1862 While now you see this:
1863
1864 (gdb) info threads
1865 * 1 Thread 0x7f0f5712a700 (LWP 6780) main () at main.c:10
1866
1867 It is also now possible to inspect TLS variables when debugging core
1868 dumps.
1869
1870 When debugging a core dump generated on a machine other than the one
1871 used to run GDB, you may need to point GDB at the correct
1872 libthread_db library with the "set libthread-db-search-path"
1873 command. See the user manual for more details on this command.
1874
f1310107
TJB
1875* When natively debugging programs on PowerPC BookE processors running
1876 a Linux kernel version 2.6.34 or later, GDB supports ranged breakpoints,
1877 which stop execution of the inferior whenever it executes an instruction
1878 at any address within the specified range. See the "PowerPC Embedded"
1879 section in the user manual for more details.
1880
248c9dbc
JB
1881* New features in the GDB remote stub, GDBserver
1882
1aee7009
JB
1883 ** GDBserver is now supported on PowerPC LynxOS (versions 4.x and 5.x),
1884 and i686 LynxOS (version 5.x).
248c9dbc 1885
eb826dc6
MF
1886 ** GDBserver is now supported on Blackfin Linux.
1887
44603653
JB
1888* New native configurations
1889
1890ia64 HP-UX ia64-*-hpux*
1891
91021223
MF
1892* New targets:
1893
1894Analog Devices, Inc. Blackfin Processor bfin-*
1895
6e1bb179
JB
1896* Ada task switching is now supported on sparc-elf targets when
1897 debugging a program using the Ravenscar Profile. For more information,
1898 see the "Tasking Support when using the Ravenscar Profile" section
1899 in the GDB user manual.
1900
50c97f38
TT
1901* Guile support was removed.
1902
448a92bf
MF
1903* New features in the GNU simulator
1904
1905 ** The --map-info flag lists all known core mappings.
1906
66ee2731
MF
1907 ** CFI flashes may be simulated via the "cfi" device.
1908
76b8507d 1909*** Changes in GDB 7.2
bfbf3774 1910
ba25b921
PA
1911* Shared library support for remote targets by default
1912
1913 When GDB is configured for a generic, non-OS specific target, like
1914 for example, --target=arm-eabi or one of the many *-*-elf targets,
1915 GDB now queries remote stubs for loaded shared libraries using the
1916 `qXfer:libraries:read' packet. Previously, shared library support
1917 was always disabled for such configurations.
1918
4656f5c6
SW
1919* C++ Improvements:
1920
1921 ** Argument Dependent Lookup (ADL)
1922
1923 In C++ ADL lookup directs function search to the namespaces of its
1924 arguments even if the namespace has not been imported.
1925 For example:
1926 namespace A
1927 {
1928 class B { };
1929 void foo (B) { }
1930 }
1931 ...
1932 A::B b
1933 foo(b)
1934 Here the compiler will search for `foo' in the namespace of 'b'
1935 and find A::foo. GDB now supports this. This construct is commonly
1936 used in the Standard Template Library for operators.
1937
1938 ** Improved User Defined Operator Support
1939
1940 In addition to member operators, GDB now supports lookup of operators
1941 defined in a namespace and imported with a `using' directive, operators
1942 defined in the global scope, operators imported implicitly from an
1943 anonymous namespace, and the ADL operators mentioned in the previous
1944 entry.
1945 GDB now also supports proper overload resolution for all the previously
1946 mentioned flavors of operators.
1947
254e6b9e
DE
1948 ** static const class members
1949
1950 Printing of static const class members that are initialized in the
1951 class definition has been fixed.
1952
711e434b
PM
1953* Windows Thread Information Block access.
1954
1955 On Windows targets, GDB now supports displaying the Windows Thread
1956 Information Block (TIB) structure. This structure is visible either
1957 by using the new command `info w32 thread-information-block' or, by
1958 dereferencing the new convenience variable named `$_tlb', a
1959 thread-specific pointer to the TIB. This feature is also supported
1960 when remote debugging using GDBserver.
1961
0fb4aa4b
PA
1962* Static tracepoints
1963
1964 Static tracepoints are calls in the user program into a tracing
1965 library. One such library is a port of the LTTng kernel tracer to
1966 userspace --- UST (LTTng Userspace Tracer, http://lttng.org/ust).
1967 When debugging with GDBserver, GDB now supports combining the GDB
1968 tracepoint machinery with such libraries. For example: the user can
1969 use GDB to probe a static tracepoint marker (a call from the user
1970 program into the tracing library) with the new "strace" command (see
1971 "New commands" below). This creates a "static tracepoint" in the
1972 breakpoint list, that can be manipulated with the same feature set
1973 as fast and regular tracepoints. E.g., collect registers, local and
1974 global variables, collect trace state variables, and define
1975 tracepoint conditions. In addition, the user can collect extra
1976 static tracepoint marker specific data, by collecting the new
1977 $_sdata internal variable. When analyzing the trace buffer, you can
1978 inspect $_sdata like any other variable available to GDB. For more
1979 information, see the "Tracepoints" chapter in GDB user manual. New
1980 remote packets have been defined to support static tracepoints, see
1981 the "New remote packets" section below.
1982
ca11e899
SS
1983* Better reconstruction of tracepoints after disconnected tracing
1984
1985 GDB will attempt to download the original source form of tracepoint
1986 definitions when starting a trace run, and then will upload these
1987 upon reconnection to the target, resulting in a more accurate
1988 reconstruction of the tracepoints that are in use on the target.
1989
1990* Observer mode
1991
1992 You can now exercise direct control over the ways that GDB can
1993 affect your program. For instance, you can disallow the setting of
1994 breakpoints, so that the program can run continuously (assuming
1995 non-stop mode). In addition, the "observer" variable is available
1996 to switch all of the different controls; in observer mode, GDB
1997 cannot affect the target's behavior at all, which is useful for
1998 tasks like diagnosing live systems in the field.
1999
2000* The new convenience variable $_thread holds the number of the
2001 current thread.
2002
711e434b
PM
2003* New remote packets
2004
2005qGetTIBAddr
2006
2007 Return the address of the Windows Thread Information Block of a given thread.
2008
dde08ee1
PA
2009qRelocInsn
2010
2011 In response to several of the tracepoint packets, the target may now
2012 also respond with a number of intermediate `qRelocInsn' request
2013 packets before the final result packet, to have GDB handle
2014 relocating an instruction to execute at a different address. This
2015 is particularly useful for stubs that support fast tracepoints. GDB
2016 reports support for this feature in the qSupported packet.
2017
0fb4aa4b
PA
2018qTfSTM, qTsSTM
2019
2020 List static tracepoint markers in the target program.
2021
2022qTSTMat
2023
2024 List static tracepoint markers at a given address in the target
2025 program.
2026
2027qXfer:statictrace:read
2028
2029 Read the static trace data collected (by a `collect $_sdata'
2030 tracepoint action). The remote stub reports support for this packet
2031 to gdb's qSupported query.
2032
ca11e899
SS
2033QAllow
2034
2035 Send the current settings of GDB's permission flags.
2036
2037QTDPsrc
2038
2039 Send part of the source (textual) form of a tracepoint definition,
2040 which includes location, conditional, and action list.
2041
3f7b2faa
DE
2042* The source command now accepts a -s option to force searching for the
2043 script in the source search path even if the script name specifies
2044 a directory.
2045
d337e9f0
PA
2046* New features in the GDB remote stub, GDBserver
2047
0fb4aa4b
PA
2048 - GDBserver now support tracepoints (including fast tracepoints, and
2049 static tracepoints). The feature is currently supported by the
2050 i386-linux and amd64-linux builds. See the "Tracepoints support
2051 in gdbserver" section in the manual for more information.
2052
2053 GDBserver JIT compiles the tracepoint's conditional agent
2054 expression bytecode into native code whenever possible for low
2055 overhead dynamic tracepoints conditionals. For such tracepoints,
2056 an expression that examines program state is evaluated when the
2057 tracepoint is reached, in order to determine whether to capture
2058 trace data. If the condition is simple and false, processing the
2059 tracepoint finishes very quickly and no data is gathered.
2060
2061 GDBserver interfaces with the UST (LTTng Userspace Tracer) library
2062 for static tracepoints support.
d337e9f0 2063
c24d0242
PM
2064 - GDBserver now supports x86_64 Windows 64-bit debugging.
2065
c8d5aac9
L
2066* GDB now sends xmlRegisters= in qSupported packet to indicate that
2067 it understands register description.
2068
7c953934
TT
2069* The --batch flag now disables pagination and queries.
2070
8685c86f
L
2071* X86 general purpose registers
2072
2073 GDB now supports reading/writing byte, word and double-word x86
2074 general purpose registers directly. This means you can use, say,
2075 $ah or $ax to refer, respectively, to the byte register AH and
2076 16-bit word register AX that are actually portions of the 32-bit
2077 register EAX or 64-bit register RAX.
2078
95a42b64 2079* The `commands' command now accepts a range of breakpoints to modify.
86b17b60
PA
2080 A plain `commands' following a command that creates multiple
2081 breakpoints affects all the breakpoints set by that command. This
2082 applies to breakpoints set by `rbreak', and also applies when a
2083 single `break' command creates multiple breakpoints (e.g.,
2084 breakpoints on overloaded c++ functions).
95a42b64 2085
8bd10a10
CM
2086* The `rbreak' command now accepts a filename specification as part of
2087 its argument, limiting the functions selected by the regex to those
2088 in the specified file.
2089
ab38a727
PA
2090* Support for remote debugging Windows and SymbianOS shared libraries
2091 from Unix hosts has been improved. Non Windows GDB builds now can
2092 understand target reported file names that follow MS-DOS based file
2093 system semantics, such as file names that include drive letters and
2094 use the backslash character as directory separator. This makes it
2095 possible to transparently use the "set sysroot" and "set
2096 solib-search-path" on Unix hosts to point as host copies of the
2097 target's shared libraries. See the new command "set
2098 target-file-system-kind" described below, and the "Commands to
2099 specify files" section in the user manual for more information.
2100
6149aea9
PA
2101* New commands
2102
f1421989
HZ
2103eval template, expressions...
2104 Convert the values of one or more expressions under the control
2105 of the string template to a command line, and call it.
2106
ab38a727
PA
2107set target-file-system-kind unix|dos-based|auto
2108show target-file-system-kind
2109 Set or show the assumed file system kind for target reported file
2110 names.
2111
6149aea9
PA
2112save breakpoints <filename>
2113 Save all current breakpoint definitions to a file suitable for use
2114 in a later debugging session. To read the saved breakpoint
2115 definitions, use the `source' command.
2116
2117`save tracepoints' is a new alias for `save-tracepoints'. The latter
2118is now deprecated.
2119
0fb4aa4b
PA
2120info static-tracepoint-markers
2121 Display information about static tracepoint markers in the target.
2122
2123strace FN | FILE:LINE | *ADDR | -m MARKER_ID
2124 Define a static tracepoint by probing a marker at the given
2125 function, line, address, or marker ID.
2126
ca11e899
SS
2127set observer on|off
2128show observer
2129 Enable and disable observer mode.
2130
2131set may-write-registers on|off
2132set may-write-memory on|off
2133set may-insert-breakpoints on|off
2134set may-insert-tracepoints on|off
2135set may-insert-fast-tracepoints on|off
2136set may-interrupt on|off
2137 Set individual permissions for GDB effects on the target. Note that
2138 some of these settings can have undesirable or surprising
2139 consequences, particularly when changed in the middle of a session.
2140 For instance, disabling the writing of memory can prevent
2141 breakpoints from being inserted, cause single-stepping to fail, or
2142 even crash your program, if you disable after breakpoints have been
2143 inserted. However, GDB should not crash.
2144
2145set record memory-query on|off
2146show record memory-query
2147 Control whether to stop the inferior if memory changes caused
2148 by an instruction cannot be recorded.
2149
53a71c06
CR
2150* Changed commands
2151
2152disassemble
2153 The disassemble command now supports "start,+length" form of two arguments.
2154
f3e9a817
PM
2155* Python scripting
2156
9279c692
JB
2157** GDB now provides a new directory location, called the python directory,
2158 where Python scripts written for GDB can be installed. The location
2159 of that directory is <data-directory>/python, where <data-directory>
2160 is the GDB data directory. For more details, see section `Scripting
2161 GDB using Python' in the manual.
2162
adc36818 2163** The GDB Python API now has access to breakpoints, symbols, symbol
595939de
PM
2164 tables, program spaces, inferiors, threads and frame's code blocks.
2165 Additionally, GDB Parameters can now be created from the API, and
2166 manipulated via set/show in the CLI.
f870a310 2167
fa33c3cd 2168** New functions gdb.target_charset, gdb.target_wide_charset,
07ca107c
DE
2169 gdb.progspaces, gdb.current_progspace, and gdb.string_to_argv.
2170
2171** New exception gdb.GdbError.
fa33c3cd
DE
2172
2173** Pretty-printers are now also looked up in the current program space.
f3e9a817 2174
967cf477
DE
2175** Pretty-printers can now be individually enabled and disabled.
2176
8a1ea21f
DE
2177** GDB now looks for names of Python scripts to auto-load in a
2178 special section named `.debug_gdb_scripts', in addition to looking
2179 for a OBJFILE-gdb.py script when OBJFILE is read by the debugger.
2180
a7bdde9e
VP
2181* Tracepoint actions were unified with breakpoint commands. In particular,
2182there are no longer differences in "info break" output for breakpoints and
2183tracepoints and the "commands" command can be used for both tracepoints and
2184regular breakpoints.
2185
05071a4d
PA
2186* New targets
2187
2188ARM Symbian arm*-*-symbianelf*
2189
6aecb9c2
JB
2190* D language support.
2191 GDB now supports debugging programs written in the D programming
2192 language.
2193
431e49aa
TJB
2194* GDB now supports the extended ptrace interface for PowerPC which is
2195 available since Linux kernel version 2.6.34. This automatically enables
2196 any hardware breakpoints and additional hardware watchpoints available in
2197 the processor. The old ptrace interface exposes just one hardware
2198 watchpoint and no hardware breakpoints.
2199
2200* GDB is now able to use the Data Value Compare (DVC) register available on
2201 embedded PowerPC processors to implement in hardware simple watchpoint
2202 conditions of the form:
2203
2204 watch ADDRESS|VARIABLE if ADDRESS|VARIABLE == CONSTANT EXPRESSION
2205
2206 This works in native GDB running on Linux kernels with the extended ptrace
2207 interface mentioned above.
2208
bfbf3774 2209*** Changes in GDB 7.1
abc7453d 2210
4eef138c
TT
2211* C++ Improvements
2212
2213 ** Namespace Support
71dee663
SW
2214
2215 GDB now supports importing of namespaces in C++. This enables the
2216 user to inspect variables from imported namespaces. Support for
2217 namepace aliasing has also been added. So, if a namespace is
2218 aliased in the current scope (e.g. namepace C=A; ) the user can
2219 print variables using the alias (e.g. (gdb) print C::x).
2220
4eef138c
TT
2221 ** Bug Fixes
2222
2223 All known bugs relating to the printing of virtual base class were
2224 fixed. It is now possible to call overloaded static methods using a
2225 qualified name.
2226
2227 ** Cast Operators
2228
2229 The C++ cast operators static_cast<>, dynamic_cast<>, const_cast<>,
2230 and reinterpret_cast<> are now handled by the C++ expression parser.
2231
2d1c1221
ME
2232* New targets
2233
2234Xilinx MicroBlaze microblaze-*-*
34207b9e 2235Renesas RX rx-*-elf
2d1c1221
ME
2236
2237* New Simulators
2238
2239Xilinx MicroBlaze microblaze
34207b9e 2240Renesas RX rx
2d1c1221 2241
6c95b8df
PA
2242* Multi-program debugging.
2243
2244 GDB now has support for multi-program (a.k.a. multi-executable or
2245 multi-exec) debugging. This allows for debugging multiple inferiors
2246 simultaneously each running a different program under the same GDB
2247 session. See "Debugging Multiple Inferiors and Programs" in the
2248 manual for more information. This implied some user visible changes
2249 in the multi-inferior support. For example, "info inferiors" now
2250 lists inferiors that are not running yet or that have exited
2251 already. See also "New commands" and "New options" below.
2252
d5551862
SS
2253* New tracing features
2254
2255 GDB's tracepoint facility now includes several new features:
2256
2257 ** Trace state variables
f61e138d
SS
2258
2259 GDB tracepoints now include support for trace state variables, which
2260 are variables managed by the target agent during a tracing
2261 experiment. They are useful for tracepoints that trigger each
2262 other, so for instance one tracepoint can count hits in a variable,
2263 and then a second tracepoint has a condition that is true when the
2264 count reaches a particular value. Trace state variables share the
2265 $-syntax of GDB convenience variables, and can appear in both
2266 tracepoint actions and condition expressions. Use the "tvariable"
2267 command to create, and "info tvariables" to view; see "Trace State
2268 Variables" in the manual for more detail.
7a697b8d 2269
d5551862 2270 ** Fast tracepoints
7a697b8d
SS
2271
2272 GDB now includes an option for defining fast tracepoints, which
2273 targets may implement more efficiently, such as by installing a jump
2274 into the target agent rather than a trap instruction. The resulting
2275 speedup can be by two orders of magnitude or more, although the
2276 tradeoff is that some program locations on some target architectures
2277 might not allow fast tracepoint installation, for instance if the
2278 instruction to be replaced is shorter than the jump. To request a
2279 fast tracepoint, use the "ftrace" command, with syntax identical to
2280 the regular trace command.
2281
d5551862
SS
2282 ** Disconnected tracing
2283
2284 It is now possible to detach GDB from the target while it is running
2285 a trace experiment, then reconnect later to see how the experiment
2286 is going. In addition, a new variable disconnected-tracing lets you
2287 tell the target agent whether to continue running a trace if the
2288 connection is lost unexpectedly.
2289
00bf0b85
SS
2290 ** Trace files
2291
2292 GDB now has the ability to save the trace buffer into a file, and
2293 then use that file as a target, similarly to you can do with
2294 corefiles. You can select trace frames, print data that was
2295 collected in them, and use tstatus to display the state of the
2296 tracing run at the moment that it was saved. To create a trace
2297 file, use "tsave <filename>", and to use it, do "target tfile
2298 <name>".
4daf5ac0
SS
2299
2300 ** Circular trace buffer
2301
2302 You can ask the target agent to handle the trace buffer as a
2303 circular buffer, discarding the oldest trace frames to make room for
2304 newer ones, by setting circular-trace-buffer to on. This feature may
2305 not be available for all target agents.
2306
21a0512e
PP
2307* Changed commands
2308
2309disassemble
2310 The disassemble command, when invoked with two arguments, now requires
2311 the arguments to be comma-separated.
2312
0fe7935b
DJ
2313info variables
2314 The info variables command now displays variable definitions. Files
2315 which only declare a variable are not shown.
2316
fb2e7cb4
JB
2317source
2318 The source command is now capable of sourcing Python scripts.
2319 This feature is dependent on the debugger being build with Python
2320 support.
2321
2322 Related to this enhancement is also the introduction of a new command
2323 "set script-extension" (see below).
2324
6c95b8df
PA
2325* New commands (for set/show, see "New options" below)
2326
399cd161
MS
2327record save [<FILENAME>]
2328 Save a file (in core file format) containing the process record
2329 execution log for replay debugging at a later time.
2330
2331record restore <FILENAME>
2332 Restore the process record execution log that was saved at an
2333 earlier time, for replay debugging.
2334
6c95b8df
PA
2335add-inferior [-copies <N>] [-exec <FILENAME>]
2336 Add a new inferior.
2337
2338clone-inferior [-copies <N>] [ID]
2339 Make a new inferior ready to execute the same program another
2340 inferior has loaded.
2341
2342remove-inferior ID
2343 Remove an inferior.
2344
2345maint info program-spaces
2346 List the program spaces loaded into GDB.
2347
9a7071a8
JB
2348set remote interrupt-sequence [Ctrl-C | BREAK | BREAK-g]
2349show remote interrupt-sequence
2350 Allow the user to select one of ^C, a BREAK signal or BREAK-g
2351 as the sequence to the remote target in order to interrupt the execution.
2352 Ctrl-C is a default. Some system prefers BREAK which is high level of
2353 serial line for some certain time. Linux kernel prefers BREAK-g, a.k.a
2354 Magic SysRq g. It is BREAK signal and character 'g'.
2355
2356set remote interrupt-on-connect [on | off]
2357show remote interrupt-on-connect
2358 When interrupt-on-connect is ON, gdb sends interrupt-sequence to
2359 remote target when gdb connects to it. This is needed when you debug
2360 Linux kernel.
2361
2362set remotebreak [on | off]
2363show remotebreak
2364Deprecated. Use "set/show remote interrupt-sequence" instead.
2365
f61e138d
SS
2366tvariable $NAME [ = EXP ]
2367 Create or modify a trace state variable.
2368
2369info tvariables
2370 List trace state variables and their values.
2371
2372delete tvariable $NAME ...
2373 Delete one or more trace state variables.
2374
6da95a67
SS
2375teval EXPR, ...
2376 Evaluate the given expressions without collecting anything into the
2377 trace buffer. (Valid in tracepoint actions only.)
2378
7a697b8d
SS
2379ftrace FN / FILE:LINE / *ADDR
2380 Define a fast tracepoint at the given function, line, or address.
2381
b0f02ee9
JK
2382* New expression syntax
2383
2384 GDB now parses the 0b prefix of binary numbers the same way as GCC does.
2385 GDB now parses 0b101010 identically with 42.
2386
6c95b8df
PA
2387* New options
2388
2389set follow-exec-mode new|same
2390show follow-exec-mode
2391 Control whether GDB reuses the same inferior across an exec call or
2392 creates a new one. This is useful to be able to restart the old
2393 executable after the inferior having done an exec call.
2394
236f1d4d
SS
2395set default-collect EXPR, ...
2396show default-collect
2397 Define a list of expressions to be collected at each tracepoint.
2398 This is a useful way to ensure essential items are not overlooked,
2399 such as registers or a critical global variable.
2400
d5551862
SS
2401set disconnected-tracing
2402show disconnected-tracing
2403 If set to 1, the target is instructed to continue tracing if it
2404 loses its connection to GDB. If 0, the target is to stop tracing
2405 upon disconnection.
2406
4daf5ac0
SS
2407set circular-trace-buffer
2408show circular-trace-buffer
2409 If set to on, the target is instructed to use a circular trace buffer
2410 and discard the oldest trace frames instead of stopping the trace due
2411 to a full trace buffer. If set to off, the trace stops when the buffer
2412 fills up. Some targets may not support this.
2413
fb2e7cb4
JB
2414set script-extension off|soft|strict
2415show script-extension
2416 If set to "off", the debugger does not perform any script language
2417 recognition, and all sourced files are assumed to be GDB scripts.
2418 If set to "soft" (the default), files are sourced according to
2419 filename extension, falling back to GDB scripts if the first
2420 evaluation failed.
2421 If set to "strict", files are sourced according to filename extension.
2422
2b71fc8e
JB
2423set ada trust-PAD-over-XVS on|off
2424show ada trust-PAD-over-XVS
2425 If off, activate a workaround against a bug in the debugging information
2426 generated by the compiler for PAD types (see gcc/exp_dbug.ads in
2427 the GCC sources for more information about the GNAT encoding and
2428 PAD types in particular). It is always safe to set this option to
2429 off, but this introduces a slight performance penalty. The default
2430 is on.
2431
de2e5182
TT
2432* Python API Improvements
2433
2434 ** GDB provides the new class gdb.LazyString. This is useful in
2435 some pretty-printing cases. The new method gdb.Value.lazy_string
2436 provides a simple way to create objects of this type.
2437
2438 ** The fields returned by gdb.Type.fields now have an
2439 `is_base_class' attribute.
2440
2441 ** The new method gdb.Type.range returns the range of an array type.
2442
2443 ** The new method gdb.parse_and_eval can be used to parse and
2444 evaluate an expression.
2445
f61e138d
SS
2446* New remote packets
2447
2448QTDV
2449 Define a trace state variable.
2450
2451qTV
2452 Get the current value of a trace state variable.
2453
d5551862
SS
2454QTDisconnected
2455 Set desired tracing behavior upon disconnection.
2456
4daf5ac0
SS
2457QTBuffer:circular
2458 Set the trace buffer to be linear or circular.
2459
d5551862
SS
2460qTfP, qTsP
2461 Get data about the tracepoints currently in use.
2462
2d483d34
MS
2463* Bug fixes
2464
2465Process record now works correctly with hardware watchpoints.
2466
6e0e5977
JB
2467Multiple bug fixes have been made to the mips-irix port, making it
2468much more reliable. In particular:
2469 - Debugging threaded applications is now possible again. Previously,
2470 GDB would hang while starting the program, or while waiting for
2471 the program to stop at a breakpoint.
2472 - Attaching to a running process no longer hangs.
2473 - An error occurring while loading a core file has been fixed.
2474 - Changing the value of the PC register now works again. This fixes
2475 problems observed when using the "jump" command, or when calling
2476 a function from GDB, or even when assigning a new value to $pc.
2477 - With the "finish" and "return" commands, the return value for functions
2478 returning a small array is now correctly printed.
2479 - It is now possible to break on shared library code which gets executed
2480 during a shared library init phase (code executed while executing
2481 their .init section). Previously, the breakpoint would have no effect.
2482 - GDB is now able to backtrace through the signal handler for
2483 non-threaded programs.
2484
93c26624
JK
2485PIE (Position Independent Executable) programs debugging is now supported.
2486This includes debugging execution of PIC (Position Independent Code) shared
2487libraries although for that, it should be possible to run such libraries as an
2488executable program.
2489
abc7453d 2490*** Changes in GDB 7.0
75feb17d 2491
4efc6507
DE
2492* GDB now has an interface for JIT compilation. Applications that
2493dynamically generate code can create symbol files in memory and register
2494them with GDB. For users, the feature should work transparently, and
2495for JIT developers, the interface is documented in the GDB manual in the
2496"JIT Compilation Interface" chapter.
2497
782b2b07
SS
2498* Tracepoints may now be conditional. The syntax is as for
2499breakpoints; either an "if" clause appended to the "trace" command,
2500or the "condition" command is available. GDB sends the condition to
2501the target for evaluation using the same bytecode format as is used
2502for tracepoint actions.
2503
53a71c06
CR
2504* The disassemble command now supports: an optional /r modifier, print the
2505raw instructions in hex as well as in symbolic form, and an optional /m
2506modifier to print mixed source+assembly.
e6158f16 2507
e7a8dbfb
HZ
2508* Process record and replay
2509
2510 In a architecture environment that supports ``process record and
2511 replay'', ``process record and replay'' target can record a log of
2512 the process execution, and replay it with both forward and reverse
2513 execute commands.
2514
64644d9b
MS
2515* Reverse debugging: GDB now has new commands reverse-continue, reverse-
2516step, reverse-next, reverse-finish, reverse-stepi, reverse-nexti, and
2517set execution-direction {forward|reverse}, for targets that support
2518reverse execution.
2519
b9412953
DD
2520* GDB now supports hardware watchpoints on MIPS/Linux systems. This
2521feature is available with a native GDB running on kernel version
25222.6.28 or later.
2523
6c7a06a3
TT
2524* GDB now has support for multi-byte and wide character sets on the
2525target. Strings whose character type is wchar_t, char16_t, or
2526char32_t are now correctly printed. GDB supports wide- and unicode-
2527literals in C, that is, L'x', L"string", u'x', u"string", U'x', and
2528U"string" syntax. And, GDB allows the "%ls" and "%lc" formats in
2529`printf'. This feature requires iconv to work properly; if your
2530system does not have a working iconv, GDB can use GNU libiconv. See
2531the installation instructions for more information.
2532
f1838a98
UW
2533* GDB now supports automatic retrieval of shared library files from
2534remote targets. To use this feature, specify a system root that begins
2535with the `remote:' prefix, either via the `set sysroot' command or via
2536the `--with-sysroot' configure-time option.
2537
55333a84
DE
2538* "info sharedlibrary" now takes an optional regex of libraries to show,
2539and it now reports if a shared library has no debugging information.
2540
7f6a6314
PM
2541* Commands `set debug-file-directory', `set solib-search-path' and `set args'
2542now complete on file names.
2543
65d12d83
TT
2544* When completing in expressions, gdb will attempt to limit
2545completions to allowable structure or union fields, where appropriate.
2546For instance, consider:
2547
2548 # struct example { int f1; double f2; };
2549 # struct example variable;
2550 (gdb) p variable.
2551
2552If the user types TAB at the end of this command line, the available
2553completions will be "f1" and "f2".
2554
edb3359d
DJ
2555* Inlined functions are now supported. They show up in backtraces, and
2556the "step", "next", and "finish" commands handle them automatically.
2557
2fae03e8
TT
2558* GDB now supports the token-splicing (##) and stringification (#)
2559operators when expanding macros. It also supports variable-arity
2560macros.
2561
47a3467a 2562* GDB now supports inspecting extra signal information, exported by
58d6951d
DJ
2563the new $_siginfo convenience variable. The feature is currently
2564implemented on linux ARM, i386 and amd64.
2565
2566* GDB can now display the VFP floating point registers and NEON vector
2567registers on ARM targets. Both ARM GNU/Linux native GDB and gdbserver
2568can provide these registers (requires Linux 2.6.30 or later). Remote
2569and simulator targets may also provide them.
47a3467a 2570
08388c79
DE
2571* New remote packets
2572
2573qSearch:memory:
2574 Search memory for a sequence of bytes.
2575
a6f3e723
SL
2576QStartNoAckMode
2577 Turn off `+'/`-' protocol acknowledgments to permit more efficient
2578 operation over reliable transport links. Use of this packet is
2579 controlled by the `set remote noack-packet' command.
2580
d7713ae0
EZ
2581vKill
2582 Kill the process with the specified process ID. Use this in preference
2583 to `k' when multiprocess protocol extensions are supported.
2584
07e059b5
VP
2585qXfer:osdata:read
2586 Obtains additional operating system information
2587
47a3467a
PA
2588qXfer:siginfo:read
2589qXfer:siginfo:write
2590 Read or write additional signal information.
2591
060871df
PA
2592* Removed remote protocol undocumented extension
2593
2594 An undocumented extension to the remote protocol's `S' stop reply
2595 packet that permited the stub to pass a process id was removed.
2596 Remote servers should use the `T' stop reply packet instead.
2597
c055b101 2598* GDB now supports multiple function calling conventions according to the
a0ef4274 2599DWARF-2 DW_AT_calling_convention function attribute.
c055b101
CV
2600
2601* The SH target utilizes the aforementioned change to distinguish between gcc
a0ef4274
DJ
2602and Renesas calling convention. It also adds the new CLI commands
2603`set/show sh calling-convention'.
c055b101 2604
31fffb02
CS
2605* GDB can now read compressed debug sections, as produced by GNU gold
2606with the --compress-debug-sections=zlib flag.
2607
88d8a8e0
JB
2608* 64-bit core files are now supported on AIX.
2609
7f99b190
JB
2610* Thread switching is now supported on Tru64.
2611
ccd213ac
DJ
2612* Watchpoints can now be set on unreadable memory locations, e.g. addresses
2613which will be allocated using malloc later in program execution.
2614
1fddbabb 2615* The qXfer:libraries:read remote procotol packet now allows passing a
31fffb02 2616list of section offsets.
1fddbabb 2617
a0ef4274
DJ
2618* On GNU/Linux, GDB can now attach to stopped processes. Several race
2619conditions handling signals delivered during attach or thread creation
2620have also been fixed.
2621
bfb8797a 2622* GDB now supports the use of DWARF boolean types for Ada's type Boolean.
158c7665
PH
2623From the user's standpoint, all unqualified instances of True and False
2624are treated as the standard definitions, regardless of context.
bfb8797a 2625
71c25dea
TT
2626* GDB now parses C++ symbol and type names more flexibly. For
2627example, given:
2628
2629 template<typename T> class C { };
2630 C<char const *> c;
2631
2632GDB will now correctly handle all of:
2633
2634 ptype C<char const *>
2635 ptype C<char const*>
2636 ptype C<const char *>
2637 ptype C<const char*>
2638
ccd213ac
DJ
2639* New features in the GDB remote stub, gdbserver
2640
2641 - The "--wrapper" command-line argument tells gdbserver to use a
2642 wrapper program to launch programs for debugging.
2643
7ae0e2a2
UW
2644 - On PowerPC and S/390 targets, it is now possible to use a single
2645 gdbserver executable to debug both 32-bit and 64-bit programs.
2646 (This requires gdbserver itself to be built as a 64-bit executable.)
2647
a6f3e723
SL
2648 - gdbserver uses the new noack protocol mode for TCP connections to
2649 reduce communications latency, if also supported and enabled in GDB.
2650
da8bd9a3
DJ
2651 - Support for the sparc64-linux-gnu target is now included in
2652 gdbserver.
2653
d70e31dd
DE
2654 - The amd64-linux build of gdbserver now supports debugging both
2655 32-bit and 64-bit programs.
2656
2657 - The i386-linux, amd64-linux, and i386-win32 builds of gdbserver
2658 now support hardware watchpoints, and will use them automatically
2659 as appropriate.
2660
d57a3c85
TJB
2661* Python scripting
2662
2663 GDB now has support for scripting using Python. Whether this is
2664 available is determined at configure time.
2665
d8906c6f
TJB
2666 New GDB commands can now be written in Python.
2667
aadc346a
JB
2668* Ada tasking support
2669
2670 Ada tasks can now be inspected in GDB. The following commands have
2671 been introduced:
2672
2673 info tasks
2674 Print the list of Ada tasks.
2675 info task N
2676 Print detailed information about task number N.
2677 task
2678 Print the task number of the current task.
2679 task N
2680 Switch the context of debugging to task number N.
2681
adb483fe
DJ
2682* Support for user-defined prefixed commands. The "define" command can
2683add new commands to existing prefixes, e.g. "target".
2684
2277426b
PA
2685* Multi-inferior, multi-process debugging.
2686
2687 GDB now has generalized support for multi-inferior debugging. See
2688 "Debugging Multiple Inferiors" in the manual for more information.
2689 Although availability still depends on target support, the command
2690 set is more uniform now. The GNU/Linux specific multi-forks support
2691 has been migrated to this new framework. This implied some user
2692 visible changes; see "New commands" and also "Removed commands"
2693 below.
2694
08d16641
PA
2695* Target descriptions can now describe the target OS ABI. See the
2696"Target Description Format" section in the user manual for more
2697information.
2698
e35359c5
UW
2699* Target descriptions can now describe "compatible" architectures
2700to indicate that the target can execute applications for a different
2701architecture in addition to those for the main target architecture.
2702See the "Target Description Format" section in the user manual for
2703more information.
2704
85e747d2
UW
2705* Multi-architecture debugging.
2706
2707 GDB now includes general supports for debugging applications on
2708 hybrid systems that use more than one single processor architecture
2709 at the same time. Each such hybrid architecture still requires
2710 specific support to be added. The only hybrid architecture supported
2711 in this version of GDB is the Cell Broadband Engine.
2712
2713* GDB now supports integrated debugging of Cell/B.E. applications that
2714use both the PPU and SPU architectures. To enable support for hybrid
2715Cell/B.E. debugging, you need to configure GDB to support both the
2716powerpc-linux or powerpc64-linux and the spu-elf targets, using the
2717--enable-targets configure option.
2718
11ade57a
PA
2719* Non-stop mode debugging.
2720
2721 For some targets, GDB now supports an optional mode of operation in
2722 which you can examine stopped threads while other threads continue
2723 to execute freely. This is referred to as non-stop mode, with the
2724 old mode referred to as all-stop mode. See the "Non-Stop Mode"
2725 section in the user manual for more information.
2726
2727 To be able to support remote non-stop debugging, a remote stub needs
2728 to implement the non-stop mode remote protocol extensions, as
2729 described in the "Remote Non-Stop" section of the user manual. The
2730 GDB remote stub, gdbserver, has been adjusted to support these
2731 extensions on linux targets.
2732
d7713ae0 2733* New commands (for set/show, see "New options" below)
75feb17d 2734
a96d9b2e
SDJ
2735catch syscall [NAME(S) | NUMBER(S)]
2736 Catch system calls. Arguments, which should be names of system
2737 calls or their numbers, mean catch only those syscalls. Without
2738 arguments, every syscall will be caught. When the inferior issues
2739 any of the specified syscalls, GDB will stop and announce the system
2740 call, both when it is called and when its call returns. This
2741 feature is currently available with a native GDB running on the
2742 Linux Kernel, under the following architectures: x86, x86_64,
2743 PowerPC and PowerPC64.
2744
08388c79
DE
2745find [/size-char] [/max-count] start-address, end-address|+search-space-size,
2746 val1 [, val2, ...]
2747 Search memory for a sequence of bytes.
2748
d57a3c85
TJB
2749maint set python print-stack
2750maint show python print-stack
2751 Show a stack trace when an error is encountered in a Python script.
2752
2753python [CODE]
2754 Invoke CODE by passing it to the Python interpreter.
2755
d7713ae0
EZ
2756macro define
2757macro list
2758macro undef
2759 These allow macros to be defined, undefined, and listed
2760 interactively.
2761
2762info os processes
2763 Show operating system information about processes.
2764
2277426b
PA
2765info inferiors
2766 List the inferiors currently under GDB's control.
2767
2768inferior NUM
2769 Switch focus to inferior number NUM.
2770
2771detach inferior NUM
2772 Detach from inferior number NUM.
2773
2774kill inferior NUM
2775 Kill inferior number NUM.
2776
d7713ae0
EZ
2777* New options
2778
3285f3fe
UW
2779set spu stop-on-load
2780show spu stop-on-load
2781 Control whether to stop for new SPE threads during Cell/B.E. debugging.
2782
ff1a52c6
UW
2783set spu auto-flush-cache
2784show spu auto-flush-cache
2785 Control whether to automatically flush the software-managed cache
2786 during Cell/B.E. debugging.
2787
d7713ae0
EZ
2788set sh calling-convention
2789show sh calling-convention
2790 Control the calling convention used when calling SH target functions.
2791
e0a3ce09 2792set debug timestamp
75feb17d 2793show debug timestamp
d7713ae0
EZ
2794 Control display of timestamps with GDB debugging output.
2795
2796set disassemble-next-line
2797show disassemble-next-line
2798 Control display of disassembled source lines or instructions when
2799 the debuggee stops.
2800
2801set remote noack-packet
2802show remote noack-packet
2803 Set/show the use of remote protocol QStartNoAckMode packet. See above
2804 under "New remote packets."
2805
2806set remote query-attached-packet
2807show remote query-attached-packet
2808 Control use of remote protocol `qAttached' (query-attached) packet.
2809
2810set remote read-siginfo-object
2811show remote read-siginfo-object
2812 Control use of remote protocol `qXfer:siginfo:read' (read-siginfo-object)
2813 packet.
2814
2815set remote write-siginfo-object
2816show remote write-siginfo-object
2817 Control use of remote protocol `qXfer:siginfo:write' (write-siginfo-object)
2818 packet.
2819
40ab02ce
MS
2820set remote reverse-continue
2821show remote reverse-continue
2822 Control use of remote protocol 'bc' (reverse-continue) packet.
2823
2824set remote reverse-step
2825show remote reverse-step
2826 Control use of remote protocol 'bs' (reverse-step) packet.
2827
d7713ae0
EZ
2828set displaced-stepping
2829show displaced-stepping
2830 Control displaced stepping mode. Displaced stepping is a way to
2831 single-step over breakpoints without removing them from the debuggee.
2832 Also known as "out-of-line single-stepping".
2833
2834set debug displaced
2835show debug displaced
2836 Control display of debugging info for displaced stepping.
2837
2838maint set internal-error
2839maint show internal-error
2840 Control what GDB does when an internal error is detected.
2841
2842maint set internal-warning
2843maint show internal-warning
2844 Control what GDB does when an internal warning is detected.
75feb17d 2845
ccd213ac
DJ
2846set exec-wrapper
2847show exec-wrapper
2848unset exec-wrapper
2849 Use a wrapper program to launch programs for debugging.
fa4727a6 2850
aad4b048
JB
2851set multiple-symbols (all|ask|cancel)
2852show multiple-symbols
2853 The value of this variable can be changed to adjust the debugger behavior
2854 when an expression or a breakpoint location contains an ambiguous symbol
2855 name (an overloaded function name, for instance).
2856
74960c60
VP
2857set breakpoint always-inserted
2858show breakpoint always-inserted
2859 Keep breakpoints always inserted in the target, as opposed to inserting
2860 them when resuming the target, and removing them when the target stops.
2861 This option can improve debugger performance on slow remote targets.
2862
0428b8f5
DJ
2863set arm fallback-mode (arm|thumb|auto)
2864show arm fallback-mode
2865set arm force-mode (arm|thumb|auto)
2866show arm force-mode
2867 These commands control how ARM GDB determines whether instructions
2868 are ARM or Thumb. The default for both settings is auto, which uses
2869 the current CPSR value for instructions without symbols; previous
2870 versions of GDB behaved as if "set arm fallback-mode arm".
2871
10568435
JK
2872set disable-randomization
2873show disable-randomization
2874 Standalone programs run with the virtual address space randomization enabled
2875 by default on some platforms. This option keeps the addresses stable across
2876 multiple debugging sessions.
2877
d7713ae0
EZ
2878set non-stop
2879show non-stop
2880 Control whether other threads are stopped or not when some thread hits
2881 a breakpoint.
2882
b3eb342c 2883set target-async
d7713ae0 2884show target-async
b3eb342c
VP
2885 Requests that asynchronous execution is enabled in the target, if available.
2886 In this case, it's possible to resume target in the background, and interact
2887 with GDB while the target is running. "show target-async" displays the
2888 current state of asynchronous execution of the target.
2889
6c7a06a3
TT
2890set target-wide-charset
2891show target-wide-charset
2892 The target-wide-charset is the name of the character set that GDB
2893 uses when printing characters whose type is wchar_t.
2894
84603566
SL
2895set tcp auto-retry (on|off)
2896show tcp auto-retry
2897set tcp connect-timeout
2898show tcp connect-timeout
2899 These commands allow GDB to retry failed TCP connections to a remote stub
2900 with a specified timeout period; this is useful if the stub is launched
2901 in parallel with GDB but may not be ready to accept connections immediately.
2902
17a37d48
PP
2903set libthread-db-search-path
2904show libthread-db-search-path
2905 Control list of directories which GDB will search for appropriate
2906 libthread_db.
2907
d4db2f36
PA
2908set schedule-multiple (on|off)
2909show schedule-multiple
2910 Allow GDB to resume all threads of all processes or only threads of
2911 the current process.
2912
4e5d721f
DE
2913set stack-cache
2914show stack-cache
2915 Use more aggressive caching for accesses to the stack. This improves
2916 performance of remote debugging (particularly backtraces) without
2917 affecting correctness.
2918
910c5da8
JB
2919set interactive-mode (on|off|auto)
2920show interactive-mode
2921 Control whether GDB runs in interactive mode (on) or not (off).
2922 When in interactive mode, GDB waits for the user to answer all
2923 queries. Otherwise, GDB does not wait and assumes the default
2924 answer. When set to auto (the default), GDB determines which
2925 mode to use based on the stdin settings.
2926
2277426b
PA
2927* Removed commands
2928
2929info forks
2930 For program forks, this is replaced by the new more generic `info
2931 inferiors' command. To list checkpoints, you can still use the
2932 `info checkpoints' command, which was an alias for the `info forks'
2933 command.
2934
2935fork NUM
2936 Replaced by the new `inferior' command. To switch between
2937 checkpoints, you can still use the `restart' command, which was an
2938 alias for the `fork' command.
2939
2940process PID
2941 This is removed, since some targets don't have a notion of
2942 processes. To switch between processes, you can still use the
2943 `inferior' command using GDB's own inferior number.
2944
2945delete fork NUM
2946 For program forks, this is replaced by the new more generic `kill
2947 inferior' command. To delete a checkpoint, you can still use the
2948 `delete checkpoint' command, which was an alias for the `delete
2949 fork' command.
2950
2951detach fork NUM
2952 For program forks, this is replaced by the new more generic `detach
2953 inferior' command. To detach a checkpoint, you can still use the
2954 `detach checkpoint' command, which was an alias for the `detach
2955 fork' command.
2956
a80b95ba
TG
2957* New native configurations
2958
2959x86/x86_64 Darwin i[34567]86-*-darwin*
2960
b8bfd3ed
JB
2961x86_64 MinGW x86_64-*-mingw*
2962
75a2d5e7
TT
2963* New targets
2964
c28c63d8 2965Lattice Mico32 lm32-*
75a2d5e7 2966x86 DICOS i[34567]86-*-dicos*
4c1d2973 2967x86_64 DICOS x86_64-*-dicos*
5f814c3b 2968S+core 3 score-*-*
75a2d5e7 2969
6de3146c
PA
2970* The GDB remote stub, gdbserver, now supports x86 Windows CE
2971 (mingw32ce) debugging.
2972
d5cbbe6e
JB
2973* Removed commands
2974
2975catch load
2976catch unload
2977 These commands were actually not implemented on any target.
2978
75feb17d 2979*** Changes in GDB 6.8
f9ed52be 2980
af5ca30d
NH
2981* New native configurations
2982
2983NetBSD/hppa hppa*-*netbsd*
94a0e877 2984Xtensa GNU/Linux xtensa*-*-linux*
af5ca30d
NH
2985
2986* New targets
2987
2988NetBSD/hppa hppa*-*-netbsd*
94a0e877 2989Xtensa GNU/Lunux xtensa*-*-linux*
af5ca30d 2990
7a404eba
PA
2991* Change in command line behavior -- corefiles vs. process ids.
2992
2993 When the '-p NUMBER' or '--pid NUMBER' options are used, and
2994 attaching to process NUMBER fails, GDB no longer attempts to open a
2995 core file named NUMBER. Attaching to a program using the -c option
2996 is no longer supported. Instead, use the '-p' or '--pid' options.
2997
430ebac9
PA
2998* GDB can now be built as a native debugger for debugging Windows x86
2999(mingw32) Portable Executable (PE) programs.
3000
fe6fbf8b 3001* Pending breakpoints no longer change their number when their address
8d5f9c6f 3002is resolved.
fe6fbf8b
VP
3003
3004* GDB now supports breakpoints with multiple locations,
8d5f9c6f
DJ
3005including breakpoints on C++ constructors, inside C++ templates,
3006and in inlined functions.
fe6fbf8b 3007
10665d76
JB
3008* GDB's ability to debug optimized code has been improved. GDB more
3009accurately identifies function bodies and lexical blocks that occupy
3010more than one contiguous range of addresses.
3011
7cc46491
DJ
3012* Target descriptions can now describe registers for PowerPC.
3013
d71340b8
DJ
3014* The GDB remote stub, gdbserver, now supports the AltiVec and SPE
3015registers on PowerPC targets.
3016
523c4513
DJ
3017* The GDB remote stub, gdbserver, now supports thread debugging on GNU/Linux
3018targets even when the libthread_db library is not available.
3019
a6b151f1
DJ
3020* The GDB remote stub, gdbserver, now supports the new file transfer
3021commands (remote put, remote get, and remote delete).
3022
2d717e4f
DJ
3023* The GDB remote stub, gdbserver, now supports run and attach in
3024extended-remote mode.
3025
24a836bd 3026* hppa*64*-*-hpux11* target broken
d001be7a
DJ
3027The debugger is unable to start a program and fails with the following
3028error: "Error trying to get information about dynamic linker".
3029The gdb-6.7 release is also affected.
24a836bd 3030
d0c678e6
UW
3031* GDB now supports the --enable-targets= configure option to allow
3032building a single GDB executable that supports multiple remote
3033target architectures.
3034
d64a946d
TJB
3035* GDB now supports debugging C and C++ programs which use the
3036Decimal Floating Point extension. In addition, the PowerPC target
3037now has a set of pseudo-registers to inspect decimal float values
3038stored in two consecutive float registers.
3039
ee163bf5
VP
3040* The -break-insert MI command can optionally create pending
3041breakpoints now.
3042
b93b6ca7 3043* Improved support for debugging Ada
d001be7a
DJ
3044Many improvements to the Ada language support have been made. These
3045include:
b93b6ca7
JB
3046 - Better support for Ada2005 interface types
3047 - Improved handling of arrays and slices in general
3048 - Better support for Taft-amendment types
3049 - The '{type} ADDRESS' expression is now allowed on the left hand-side
3050 of an assignment
3051 - Improved command completion in Ada
3052 - Several bug fixes
3053
d001be7a
DJ
3054* GDB on GNU/Linux and HP/UX can now debug through "exec" of a new
3055process.
3056
a6b151f1
DJ
3057* New commands
3058
6d53d0af
JB
3059set print frame-arguments (all|scalars|none)
3060show print frame-arguments
3061 The value of this variable can be changed to control which argument
3062 values should be printed by the debugger when displaying a frame.
3063
a6b151f1
DJ
3064remote put
3065remote get
3066remote delete
3067 Transfer files to and from a remote target, and delete remote files.
3068
3069* New MI commands
3070
3071-target-file-put
3072-target-file-get
3073-target-file-delete
3074 Transfer files to and from a remote target, and delete remote files.
3075
3076* New remote packets
3077
3078vFile:open:
3079vFile:close:
3080vFile:pread:
3081vFile:pwrite:
3082vFile:unlink:
3083 Open, close, read, write, and delete files on the remote system.
d0c678e6 3084
2d717e4f
DJ
3085vAttach
3086 Attach to an existing process on the remote system, in extended-remote
3087 mode.
3088
3089vRun
3090 Run a new process on the remote system, in extended-remote mode.
3091
8d5f9c6f 3092*** Changes in GDB 6.7
6dd09645 3093
19d378fc
MS
3094* Resolved 101 resource leaks, null pointer dereferences, etc. in gdb,
3095bfd, libiberty and opcodes, as revealed by static analysis donated by
3096Coverity, Inc. (http://scan.coverity.com).
3097
3a40aaa0
UW
3098* When looking up multiply-defined global symbols, GDB will now prefer the
3099symbol definition in the current shared library if it was built using the
3100-Bsymbolic linker option.
3101
a6ec25f2
BW
3102* When the Text User Interface (TUI) is not configured, GDB will now
3103recognize the -tui command-line option and print a message that the TUI
3104is not supported.
3105
6dd09645
JB
3106* The GDB remote stub, gdbserver, now has lower overhead for high
3107frequency signals (e.g. SIGALRM) via the QPassSignals packet.
3108
c9bb8148
DJ
3109* GDB for MIPS targets now autodetects whether a remote target provides
311032-bit or 64-bit register values.
3111
0d5de010
DJ
3112* Support for C++ member pointers has been improved.
3113
23181151
DJ
3114* GDB now understands XML target descriptions, which specify the
3115target's overall architecture. GDB can read a description from
3116a local file or over the remote serial protocol.
3117
ea37ba09
DJ
3118* Vectors of single-byte data use a new integer type which is not
3119automatically displayed as character or string data.
3120
3121* The /s format now works with the print command. It displays
3122arrays of single-byte integers and pointers to single-byte integers
3123as strings.
e1f48ead 3124
123dc839
DJ
3125* Target descriptions can now describe target-specific registers,
3126for architectures which have implemented the support (currently
8d5f9c6f 3127only ARM, M68K, and MIPS).
123dc839 3128
05a4558a
DJ
3129* GDB and the GDB remote stub, gdbserver, now support the XScale
3130iWMMXt coprocessor.
fb1e4ffc 3131
7c963485
PA
3132* The GDB remote stub, gdbserver, has been updated to support
3133ARM Windows CE (mingw32ce) debugging, and GDB Windows CE support
3134has been rewritten to use the standard GDB remote protocol.
3135
b18be20d
DJ
3136* GDB can now step into C++ functions which are called through thunks.
3137
0ca420ce
UW
3138* GDB for the Cell/B.E. SPU now supports overlay debugging.
3139
31d99776
DJ
3140* The GDB remote protocol "qOffsets" packet can now honor ELF segment
3141layout. It also supports a TextSeg= and DataSeg= response when only
3142segment base addresses (rather than offsets) are available.
3143
a4642986
MR
3144* The /i format now outputs any trailing branch delay slot instructions
3145immediately following the last instruction within the count specified.
3146
cfa9d6d9
DJ
3147* The GDB remote protocol "T" stop reply packet now supports a
3148"library" response. Combined with the new "qXfer:libraries:read"
3149packet, this response allows GDB to debug shared libraries on targets
3150where the operating system manages the list of loaded libraries (e.g.
3151Windows and SymbianOS).
255e7678
DJ
3152
3153* The GDB remote stub, gdbserver, now supports dynamic link libraries
3154(DLLs) on Windows and Windows CE targets.
f5db8714
JK
3155
3156* GDB now supports a faster verification that a .debug file matches its binary
3157according to its build-id signature, if the signature is present.
cfa9d6d9 3158
c9bb8148
DJ
3159* New commands
3160
23776285
MR
3161set remoteflow
3162show remoteflow
3163 Enable or disable hardware flow control (RTS/CTS) on the serial port
3164 when debugging using remote targets.
3165
c9bb8148
DJ
3166set mem inaccessible-by-default
3167show mem inaccessible-by-default
3168 If the target supplies a memory map, for instance via the remote
3169 protocol's "qXfer:memory-map:read" packet, setting this variable
3170 prevents GDB from accessing memory outside the memory map. This
3171 is useful for targets with memory mapped registers or which react
3172 badly to accesses of unmapped address space.
3173
3174set breakpoint auto-hw
3175show breakpoint auto-hw
3176 If the target supplies a memory map, for instance via the remote
3177 protocol's "qXfer:memory-map:read" packet, setting this variable
3178 lets GDB use hardware breakpoints automatically for memory regions
3179 where it can not use software breakpoints. This covers both the
3180 "break" command and internal breakpoints used for other commands
3181 including "next" and "finish".
3182
0e420bd8
JB
3183catch exception
3184catch exception unhandled
3185 Stop the program execution when Ada exceptions are raised.
3186
3187catch assert
3188 Stop the program execution when an Ada assertion failed.
3189
f822c95b
DJ
3190set sysroot
3191show sysroot
3192 Set an alternate system root for target files. This is a more
3193 general version of "set solib-absolute-prefix", which is now
3194 an alias to "set sysroot".
3195
83cc5c53
UW
3196info spu
3197 Provide extended SPU facility status information. This set of
3198 commands is available only when debugging the Cell/B.E. SPU
3199 architecture.
3200
bd372731
MK
3201* New native configurations
3202
3203OpenBSD/sh sh*-*openbsd*
3204
23181151
DJ
3205set tdesc filename
3206unset tdesc filename
3207show tdesc filename
3208 Use the specified local file as an XML target description, and do
3209 not query the target for its built-in description.
3210
c9bb8148
DJ
3211* New targets
3212
54fe9172 3213OpenBSD/sh sh*-*-openbsd*
c9bb8148 3214MIPS64 GNU/Linux (gdbserver) mips64-linux-gnu
c077150c 3215Toshiba Media Processor mep-elf
c9bb8148 3216
6dd09645
JB
3217* New remote packets
3218
3219QPassSignals:
3220 Ignore the specified signals; pass them directly to the debugged program
3221 without stopping other threads or reporting them to GDB.
3222
23181151
DJ
3223qXfer:features:read:
3224 Read an XML target description from the target, which describes its
3225 features.
6dd09645 3226
83cc5c53
UW
3227qXfer:spu:read:
3228qXfer:spu:write:
3229 Read or write contents of an spufs file on the target system. These
3230 packets are available only on the Cell/B.E. SPU architecture.
3231
cfa9d6d9
DJ
3232qXfer:libraries:read:
3233 Report the loaded shared libraries. Combined with new "T" packet
3234 response, this packet allows GDB to debug shared libraries on
3235 targets where the operating system manages the list of loaded
3236 libraries (e.g. Windows and SymbianOS).
3237
483367ee
DJ
3238* Removed targets
3239
3240Support for these obsolete configurations has been removed.
3241
d08950c4
UW
3242alpha*-*-osf1*
3243alpha*-*-osf2*
7ce59000 3244d10v-*-*
483367ee
DJ
3245hppa*-*-hiux*
3246i[34567]86-ncr-*
3247i[34567]86-*-dgux*
3248i[34567]86-*-lynxos*
3249i[34567]86-*-netware*
3250i[34567]86-*-sco3.2v5*
3251i[34567]86-*-sco3.2v4*
3252i[34567]86-*-sco*
3253i[34567]86-*-sysv4.2*
3254i[34567]86-*-sysv4*
3255i[34567]86-*-sysv5*
3256i[34567]86-*-unixware2*
3257i[34567]86-*-unixware*
3258i[34567]86-*-sysv*
3259i[34567]86-*-isc*
3260m68*-cisco*-*
3261m68*-tandem-*
ad527d2e 3262mips*-*-pe
483367ee 3263rs6000-*-lynxos*
ad527d2e 3264sh*-*-pe
483367ee 3265
7ce59000
DJ
3266* Other removed features
3267
3268target abug
3269target cpu32bug
3270target est
3271target rom68k
3272
3273 Various m68k-only ROM monitors.
3274
ea35711c
DJ
3275target hms
3276target e7000
3277target sh3
3278target sh3e
3279
3280 Various Renesas ROM monitors and debugging interfaces for SH and
3281 H8/300.
3282
3283target ocd
3284
3285 Support for a Macraigor serial interface to on-chip debugging.
3286 GDB does not directly support the newer parallel or USB
3287 interfaces.
3288
7ce59000
DJ
3289DWARF 1 support
3290
3291 A debug information format. The predecessor to DWARF 2 and
3292 DWARF 3, which are still supported.
3293
54d61198
DJ
3294Support for the HP aCC compiler on HP-UX/PA-RISC
3295
3296 SOM-encapsulated symbolic debugging information, automatic
3297 invocation of pxdb, and the aCC custom C++ ABI. This does not
3298 affect HP-UX for Itanium or GCC for HP-UX/PA-RISC. Code compiled
3299 with aCC can still be debugged on an assembly level.
3300
ea35711c
DJ
3301MIPS ".pdr" sections
3302
3303 A MIPS-specific format used to describe stack frame layout
3304 in debugging information.
3305
3306Scheme support
3307
3308 GDB could work with an older version of Guile to debug
3309 the interpreter and Scheme programs running in it.
3310
1a69e1e4
DJ
3311set mips stack-arg-size
3312set mips saved-gpreg-size
3313
3314 Use "set mips abi" to control parameter passing for MIPS.
3315
6dd09645 3316*** Changes in GDB 6.6
e374b601 3317
ca3bf3bd
DJ
3318* New targets
3319
3320Xtensa xtensa-elf
9c309e77 3321Cell Broadband Engine SPU spu-elf
ca3bf3bd 3322
6aec2e11
DJ
3323* GDB can now be configured as a cross-debugger targeting native Windows
3324(mingw32) or Cygwin. It can communicate with a remote debugging stub
3325running on a Windows system over TCP/IP to debug Windows programs.
3326
3327* The GDB remote stub, gdbserver, has been updated to support Windows and
3328Cygwin debugging. Both single-threaded and multi-threaded programs are
3329supported.
3330
17218d91
DJ
3331* The "set trust-readonly-sections" command works again. This command was
3332broken in GDB 6.3, 6.4, and 6.5.
3333
9ebce043
DJ
3334* The "load" command now supports writing to flash memory, if the remote
3335stub provides the required support.
3336
7d3d3ece
DJ
3337* Support for GNU/Linux Thread Local Storage (TLS, per-thread variables) no
3338longer requires symbolic debug information (e.g. DWARF-2).
3339
4f8253f3
JB
3340* New commands
3341
3342set substitute-path
3343unset substitute-path
3344show substitute-path
3345 Manage a list of substitution rules that GDB uses to rewrite the name
3346 of the directories where the sources are located. This can be useful
3347 for instance when the sources were moved to a different location
3348 between compilation and debugging.
3349
9fa66fd7
AS
3350set trace-commands
3351show trace-commands
3352 Print each CLI command as it is executed. Each command is prefixed with
3353 a number of `+' symbols representing the nesting depth.
3354 The source command now has a `-v' option to enable the same feature.
3355
1f5befc1
DJ
3356* REMOVED features
3357
3358The ARM Demon monitor support (RDP protocol, "target rdp").
3359
2ec3381a
DJ
3360Kernel Object Display, an embedded debugging feature which only worked with
3361an obsolete version of Cisco IOS.
3362
3d00d119
DJ
3363The 'set download-write-size' and 'show download-write-size' commands.
3364
be2a5f71
DJ
3365* New remote packets
3366
3367qSupported:
3368 Tell a stub about GDB client features, and request remote target features.
3369 The first feature implemented is PacketSize, which allows the target to
3370 specify the size of packets it can handle - to minimize the number of
3371 packets required and improve performance when connected to a remote
3372 target.
3373
0876f84a
DJ
3374qXfer:auxv:read:
3375 Fetch an OS auxilliary vector from the remote stub. This packet is a
3376 more efficient replacement for qPart:auxv:read.
3377
9ebce043
DJ
3378qXfer:memory-map:read:
3379 Fetch a memory map from the remote stub, including information about
3380 RAM, ROM, and flash memory devices.
3381
3382vFlashErase:
3383vFlashWrite:
3384vFlashDone:
3385 Erase and program a flash memory device.
3386
0876f84a
DJ
3387* Removed remote packets
3388
3389qPart:auxv:read:
3390 This packet has been replaced by qXfer:auxv:read. Only GDB 6.4 and 6.5
3391 used it, and only gdbserver implemented it.
3392
e374b601 3393*** Changes in GDB 6.5
53e5f3cf 3394
96309189
MS
3395* New targets
3396
3397Renesas M32C/M16C m32c-elf
3398
3399Morpho Technologies ms1 ms1-elf
3400
53e5f3cf
AS
3401* New commands
3402
3403init-if-undefined Initialize a convenience variable, but
3404 only if it doesn't already have a value.
3405
ac264b3b
MS
3406The following commands are presently only implemented for native GNU/Linux:
3407
3408checkpoint Save a snapshot of the program state.
3409
3410restart <n> Return the program state to a
3411 previously saved state.
3412
3413info checkpoints List currently saved checkpoints.
3414
3415delete-checkpoint <n> Delete a previously saved checkpoint.
3416
3417set|show detach-on-fork Tell gdb whether to detach from a newly
3418 forked process, or to keep debugging it.
3419
3420info forks List forks of the user program that
3421 are available to be debugged.
3422
3423fork <n> Switch to debugging one of several
3424 forks of the user program that are
3425 available to be debugged.
3426
3427delete-fork <n> Delete a fork from the list of forks
3428 that are available to be debugged (and
3429 kill the forked process).
3430
3431detach-fork <n> Delete a fork from the list of forks
3432 that are available to be debugged (and
3433 allow the process to continue).
3434
3950dc3f
NS
3435* New architecture
3436
3437Morpho Technologies ms2 ms1-elf
3438
0ea3f30e
DJ
3439* Improved Windows host support
3440
3441GDB now builds as a cross debugger hosted on i686-mingw32, including
3442native console support, and remote communications using either
3443network sockets or serial ports.
3444
f79daebb
GM
3445* Improved Modula-2 language support
3446
3447GDB can now print most types in the Modula-2 syntax. This includes:
3448basic types, set types, record types, enumerated types, range types,
3449pointer types and ARRAY types. Procedure var parameters are correctly
3450printed and hexadecimal addresses and character constants are also
3451written in the Modula-2 syntax. Best results can be obtained by using
3452GNU Modula-2 together with the -gdwarf-2 command line option.
3453
acab6ab2
MM
3454* REMOVED features
3455
3456The ARM rdi-share module.
3457
f4267320
DJ
3458The Netware NLM debug server.
3459
53e5f3cf 3460*** Changes in GDB 6.4
156a53ca 3461
e0ecbda1
MK
3462* New native configurations
3463
02a677ac 3464OpenBSD/arm arm*-*-openbsd*
e0ecbda1
MK
3465OpenBSD/mips64 mips64-*-openbsd*
3466
d64a6579
KB
3467* New targets
3468
3469Morpho Technologies ms1 ms1-elf
3470
b33a6190
AS
3471* New command line options
3472
3473--batch-silent As for --batch, but totally silent.
3474--return-child-result The debugger will exist with the same value
3475 the child (debugged) program exited with.
3476--eval-command COMMAND, -ex COMMAND
3477 Execute a single GDB CLI command. This may be
3478 specified multiple times and in conjunction
3479 with the --command (-x) option.
3480
11dced61
AC
3481* Deprecated commands removed
3482
3483The following commands, that were deprecated in 2000, have been
3484removed:
3485
3486 Command Replacement
3487 set|show arm disassembly-flavor set|show arm disassembler
3488 othernames set arm disassembler
3489 set|show remotedebug set|show debug remote
3490 set|show archdebug set|show debug arch
3491 set|show eventdebug set|show debug event
3492 regs info registers
3493
6fe85783
MK
3494* New BSD user-level threads support
3495
3496It is now possible to debug programs using the user-level threads
3497library on OpenBSD and FreeBSD. Currently supported (target)
3498configurations are:
3499
3500FreeBSD/amd64 x86_64-*-freebsd*
3501FreeBSD/i386 i386-*-freebsd*
3502OpenBSD/i386 i386-*-openbsd*
3503
3504Note that the new kernel threads libraries introduced in FreeBSD 5.x
3505are not yet supported.
3506
5260ca71
MS
3507* New support for Matsushita MN10300 w/sim added
3508(Work in progress). mn10300-elf.
3509
e84ecc99
AC
3510* REMOVED configurations and files
3511
3512VxWorks and the XDR protocol *-*-vxworks
9445aa30 3513Motorola MCORE mcore-*-*
9445aa30 3514National Semiconductor NS32000 ns32k-*-*
156a53ca 3515
31e35378
JB
3516* New "set print array-indexes" command
3517
3518After turning this setting "on", GDB prints the index of each element
3519when displaying arrays. The default is "off" to preserve the previous
3520behavior.
3521
e85e5c83
MK
3522* VAX floating point support
3523
3524GDB now supports the not-quite-ieee VAX F and D floating point formats.
3525
d91e9901
AS
3526* User-defined command support
3527
3528In addition to using $arg0..$arg9 for argument passing, it is now possible
3529to use $argc to determine now many arguments have been passed. See the
3530section on user-defined commands in the user manual for more information.
3531
f2cb65ca
MC
3532*** Changes in GDB 6.3:
3533
f47b1503
AS
3534* New command line option
3535
3536GDB now accepts -l followed by a number to set the timeout for remote
3537debugging.
3538
f2cb65ca
MC
3539* GDB works with GCC -feliminate-dwarf2-dups
3540
3541GDB now supports a more compact representation of DWARF-2 debug
3542information using DW_FORM_ref_addr references. These are produced
3543by GCC with the option -feliminate-dwarf2-dups and also by some
3544proprietary compilers. With GCC, you must use GCC 3.3.4 or later
3545to use -feliminate-dwarf2-dups.
860660cb 3546
d08c0230
AC
3547* Internationalization
3548
3549When supported by the host system, GDB will be built with
3550internationalization (libintl). The task of marking up the sources is
3551continued, we're looking forward to our first translation.
3552
117ea3cf
PH
3553* Ada
3554
3555Initial support for debugging programs compiled with the GNAT
3556implementation of the Ada programming language has been integrated
3557into GDB. In this release, support is limited to expression evaluation.
3558
d08c0230
AC
3559* New native configurations
3560
3561GNU/Linux/m32r m32r-*-linux-gnu
3562
3563* Remote 'p' packet
3564
3565GDB's remote protocol now includes support for the 'p' packet. This
3566packet is used to fetch individual registers from a remote inferior.
3567
3568* END-OF-LIFE registers[] compatibility module
3569
3570GDB's internal register infrastructure has been completely rewritten.
3571The new infrastructure making possible the implementation of key new
3572features including 32x64 (e.g., 64-bit amd64 GDB debugging a 32-bit
3573i386 application).
3574
3575GDB 6.3 will be the last release to include the the registers[]
3576compatibility module that allowed out-of-date configurations to
3577continue to work. This change directly impacts the following
3578configurations:
3579
3580hppa-*-hpux
3581ia64-*-aix
3582mips-*-irix*
3583*-*-lynx
3584mips-*-linux-gnu
3585sds protocol
3586xdr protocol
3587powerpc bdm protocol
3588
3589Unless there is activity to revive these configurations, they will be
3590made OBSOLETE in GDB 6.4, and REMOVED from GDB 6.5.
3591
3592* OBSOLETE configurations and files
3593
3594Configurations that have been declared obsolete in this release have
3595been commented out. Unless there is activity to revive these
3596configurations, the next release of GDB will have their sources
3597permanently REMOVED.
3598
3599h8300-*-*
3600mcore-*-*
3601mn10300-*-*
3602ns32k-*-*
3603sh64-*-*
3604v850-*-*
3605
ebb7c577
AC
3606*** Changes in GDB 6.2.1:
3607
3608* MIPS `break main; run' gave an heuristic-fence-post warning
3609
3610When attempting to run even a simple program, a warning about
3611heuristic-fence-post being hit would be reported. This problem has
3612been fixed.
3613
3614* MIPS IRIX 'long double' crashed GDB
3615
3616When examining a long double variable, GDB would get a segmentation
3617fault. The crash has been fixed (but GDB 6.2 cannot correctly examine
3618IRIX long double values).
3619
3620* VAX and "next"
3621
3622A bug in the VAX stack code was causing problems with the "next"
3623command. This problem has been fixed.
3624
860660cb 3625*** Changes in GDB 6.2:
faae5abe 3626
0dea2468
AC
3627* Fix for ``many threads''
3628
3629On GNU/Linux systems that use the NPTL threads library, a program
3630rapidly creating and deleting threads would confuse GDB leading to the
3631error message:
3632
3633 ptrace: No such process.
3634 thread_db_get_info: cannot get thread info: generic error
3635
3636This problem has been fixed.
3637
2c07db7a
AC
3638* "-async" and "-noasync" options removed.
3639
3640Support for the broken "-noasync" option has been removed (it caused
3641GDB to dump core).
3642
c23968a2
JB
3643* New ``start'' command.
3644
3645This command runs the program until the begining of the main procedure.
3646
71009278
MK
3647* New BSD Kernel Data Access Library (libkvm) interface
3648
3649Using ``target kvm'' it is now possible to debug kernel core dumps and
3650live kernel memory images on various FreeBSD, NetBSD and OpenBSD
3651platforms. Currently supported (native-only) configurations are:
3652
3653FreeBSD/amd64 x86_64-*-freebsd*
3654FreeBSD/i386 i?86-*-freebsd*
3655NetBSD/i386 i?86-*-netbsd*
3656NetBSD/m68k m68*-*-netbsd*
3657NetBSD/sparc sparc-*-netbsd*
3658OpenBSD/amd64 x86_64-*-openbsd*
3659OpenBSD/i386 i?86-*-openbsd*
3660OpenBSD/m68k m68*-openbsd*
3661OpenBSD/sparc sparc-*-openbsd*
3662
3c0b7db2
AC
3663* Signal trampoline code overhauled
3664
3665Many generic problems with GDB's signal handling code have been fixed.
3666These include: backtraces through non-contiguous stacks; recognition
3667of sa_sigaction signal trampolines; backtrace from a NULL pointer
3668call; backtrace through a signal trampoline; step into and out of
3669signal handlers; and single-stepping in the signal trampoline.
3670
73cc75f3
AC
3671Please note that kernel bugs are a limiting factor here. These
3672features have been shown to work on an s390 GNU/Linux system that
3673include a 2.6.8-rc1 kernel. Ref PR breakpoints/1702.
3c0b7db2 3674
7243600a
BF
3675* Cygwin support for DWARF 2 added.
3676
6f606e1c
MK
3677* New native configurations
3678
97dc871c 3679GNU/Linux/hppa hppa*-*-linux*
0e56aeaf 3680OpenBSD/hppa hppa*-*-openbsd*
bf2ca189
MK
3681OpenBSD/m68k m68*-*-openbsd*
3682OpenBSD/m88k m88*-*-openbsd*
d195bc9f 3683OpenBSD/powerpc powerpc-*-openbsd*
6f606e1c 3684NetBSD/vax vax-*-netbsd*
9f076e7a 3685OpenBSD/vax vax-*-openbsd*
6f606e1c 3686
a1b461bf
AC
3687* END-OF-LIFE frame compatibility module
3688
3689GDB's internal frame infrastructure has been completely rewritten.
3690The new infrastructure making it possible to support key new features
3691including DWARF 2 Call Frame Information. To aid in the task of
3692migrating old configurations to this new infrastructure, a
3693compatibility module, that allowed old configurations to continue to
3694work, was also included.
3695
3696GDB 6.2 will be the last release to include this frame compatibility
3697module. This change directly impacts the following configurations:
3698
3699h8300-*-*
3700mcore-*-*
3701mn10300-*-*
3702ns32k-*-*
3703sh64-*-*
3704v850-*-*
3705xstormy16-*-*
3706
3707Unless there is activity to revive these configurations, they will be
3708made OBSOLETE in GDB 6.3, and REMOVED from GDB 6.4.
3709
3c7012f5
AC
3710* REMOVED configurations and files
3711
3712Sun 3, running SunOS 3 m68*-*-sunos3*
3713Sun 3, running SunOS 4 m68*-*-sunos4*
3714Sun 2, running SunOS 3 m68000-*-sunos3*
3715Sun 2, running SunOS 4 m68000-*-sunos4*
3716Motorola 680x0 running LynxOS m68*-*-lynxos*
3717AT&T 3b1/Unix pc m68*-att-*
3718Bull DPX2 (68k, System V release 3) m68*-bull-sysv*
3719decstation mips-dec-* mips-little-*
3720riscos mips-*-riscos* mips-*-sysv*
3721sonymips mips-sony-*
3722sysv mips*-*-sysv4* (IRIX 5/6 not included)
3723
e5fe55f7
AC
3724*** Changes in GDB 6.1.1:
3725
3726* TUI (Text-mode User Interface) built-in (also included in GDB 6.1)
3727
3728The TUI (Text-mode User Interface) is now built as part of a default
3729GDB configuration. It is enabled by either selecting the TUI with the
3730command line option "-i=tui" or by running the separate "gdbtui"
3731program. For more information on the TUI, see the manual "Debugging
3732with GDB".
3733
3734* Pending breakpoint support (also included in GDB 6.1)
3735
3736Support has been added to allow you to specify breakpoints in shared
3737libraries that have not yet been loaded. If a breakpoint location
3738cannot be found, and the "breakpoint pending" option is set to auto,
3739GDB queries you if you wish to make the breakpoint pending on a future
3740shared-library load. If and when GDB resolves the breakpoint symbol,
3741the pending breakpoint is removed as one or more regular breakpoints
3742are created.
3743
3744Pending breakpoints are very useful for GCJ Java debugging.
3745
3746* Fixed ISO-C build problems
3747
3748The files bfd/elf-bfd.h, gdb/dictionary.c and gdb/types.c contained
3749non ISO-C code that stopped them being built using a more strict ISO-C
3750compiler (e.g., IBM's C compiler).
3751
3752* Fixed build problem on IRIX 5
3753
3754Due to header problems with <sys/proc.h>, the file gdb/proc-api.c
3755wasn't able to compile compile on an IRIX 5 system.
3756
3757* Added execute permission to gdb/gdbserver/configure
3758
3759The shell script gdb/testsuite/gdb.stabs/configure lacked execute
3760permission. This bug would cause configure to fail on a number of
3761systems (Solaris, IRIX). Ref: server/519.
3762
3763* Fixed build problem on hpux2.0w-hp-hpux11.00 using the HP ANSI C compiler
3764
3765Older HPUX ANSI C compilers did not accept variable array sizes. somsolib.c
3766has been updated to use constant array sizes.
3767
3768* Fixed a panic in the DWARF Call Frame Info code on Solaris 2.7
3769
3770GCC 3.3.2, on Solaris 2.7, includes the DW_EH_PE_funcrel encoding in
3771its generated DWARF Call Frame Info. This encoding was causing GDB to
3772panic, that panic has been fixed. Ref: gdb/1628.
3773
3774* Fixed a problem when examining parameters in shared library code.
3775
3776When examining parameters in optimized shared library code generated
3777by a mainline GCC, GDB would incorrectly report ``Variable "..." is
3778not available''. GDB now correctly displays the variable's value.
3779
faae5abe 3780*** Changes in GDB 6.1:
f2c06f52 3781
9175c9a3
MC
3782* Removed --with-mmalloc
3783
3784Support for the mmalloc memory manager has been removed, as it
3785conflicted with the internal gdb byte cache.
3786
3cc87ec0
MK
3787* Changes in AMD64 configurations
3788
3789The AMD64 target now includes the %cs and %ss registers. As a result
3790the AMD64 remote protocol has changed; this affects the floating-point
3791and SSE registers. If you rely on those registers for your debugging,
3792you should upgrade gdbserver on the remote side.
3793
f0424ef6
MK
3794* Revised SPARC target
3795
3796The SPARC target has been completely revised, incorporating the
3797FreeBSD/sparc64 support that was added for GDB 6.0. As a result
03cebad2
MK
3798support for LynxOS and SunOS 4 has been dropped. Calling functions
3799from within GDB on operating systems with a non-executable stack
3800(Solaris, OpenBSD) now works.
f0424ef6 3801
59659be2
ILT
3802* New C++ demangler
3803
3804GDB has a new C++ demangler which does a better job on the mangled
3805names generated by current versions of g++. It also runs faster, so
3806with this and other changes gdb should now start faster on large C++
3807programs.
3808
9e08b29b
DJ
3809* DWARF 2 Location Expressions
3810
3811GDB support for location expressions has been extended to support function
3812arguments and frame bases. Older versions of GDB could crash when they
3813encountered these.
3814
8dfe8985
DC
3815* C++ nested types and namespaces
3816
3817GDB's support for nested types and namespaces in C++ has been
3818improved, especially if you use the DWARF 2 debugging format. (This
3819is the default for recent versions of GCC on most platforms.)
3820Specifically, if you have a class "Inner" defined within a class or
3821namespace "Outer", then GDB realizes that the class's name is
3822"Outer::Inner", not simply "Inner". This should greatly reduce the
3823frequency of complaints about not finding RTTI symbols. In addition,
3824if you are stopped at inside of a function defined within a namespace,
3825GDB modifies its name lookup accordingly.
3826
cced5e27
MK
3827* New native configurations
3828
3829NetBSD/amd64 x86_64-*-netbsd*
27d1e716 3830OpenBSD/amd64 x86_64-*-openbsd*
2031c21a 3831OpenBSD/alpha alpha*-*-openbsd*
f2cab569
MK
3832OpenBSD/sparc sparc-*-openbsd*
3833OpenBSD/sparc64 sparc64-*-openbsd*
cced5e27 3834
b4b4b794
KI
3835* New debugging protocols
3836
3837M32R with SDI protocol m32r-*-elf*
3838
7989c619
AC
3839* "set prompt-escape-char" command deleted.
3840
3841The command "set prompt-escape-char" has been deleted. This command,
3842and its very obscure effet on GDB's prompt, was never documented,
3843tested, nor mentioned in the NEWS file.
3844
5994185b
AC
3845* OBSOLETE configurations and files
3846
3847Configurations that have been declared obsolete in this release have
3848been commented out. Unless there is activity to revive these
3849configurations, the next release of GDB will have their sources
3850permanently REMOVED.
3851
3852Sun 3, running SunOS 3 m68*-*-sunos3*
3853Sun 3, running SunOS 4 m68*-*-sunos4*
3854Sun 2, running SunOS 3 m68000-*-sunos3*
3855Sun 2, running SunOS 4 m68000-*-sunos4*
3856Motorola 680x0 running LynxOS m68*-*-lynxos*
3857AT&T 3b1/Unix pc m68*-att-*
3858Bull DPX2 (68k, System V release 3) m68*-bull-sysv*
0748d941
AC
3859decstation mips-dec-* mips-little-*
3860riscos mips-*-riscos* mips-*-sysv*
3861sonymips mips-sony-*
3862sysv mips*-*-sysv4* (IRIX 5/6 not included)
5994185b 3863
0ddabb4c
AC
3864* REMOVED configurations and files
3865
3866SGI Irix-4.x mips-sgi-irix4 or iris4
3867SGI Iris (MIPS) running Irix V3: mips-sgi-irix or iris
4a8269c0
AC
3868Z8000 simulator z8k-zilog-none or z8ksim
3869Matsushita MN10200 w/simulator mn10200-*-*
3870H8/500 simulator h8500-hitachi-hms or h8500hms
3871HP/PA running BSD hppa*-*-bsd*
3872HP/PA running OSF/1 hppa*-*-osf*
3873HP/PA Pro target hppa*-*-pro*
3874PMAX (MIPS) running Mach 3.0 mips*-*-mach3*
cf7c5c23 3875386BSD i[3456]86-*-bsd*
4a8269c0
AC
3876Sequent family i[3456]86-sequent-sysv4*
3877 i[3456]86-sequent-sysv*
3878 i[3456]86-sequent-bsd*
f0424ef6
MK
3879SPARC running LynxOS sparc-*-lynxos*
3880SPARC running SunOS 4 sparc-*-sunos4*
4a8269c0
AC
3881Tsqware Sparclet sparclet-*-*
3882Fujitsu SPARClite sparclite-fujitsu-none or sparclite
0ddabb4c 3883
c7f1390e
DJ
3884*** Changes in GDB 6.0:
3885
1fe43d45
AC
3886* Objective-C
3887
3888Support for debugging the Objective-C programming language has been
3889integrated into GDB.
3890
e6beb428
AC
3891* New backtrace mechanism (includes DWARF 2 Call Frame Information).
3892
3893DWARF 2's Call Frame Information makes available compiler generated
3894information that more exactly describes the program's run-time stack.
3895By using this information, GDB is able to provide more robust stack
3896backtraces.
3897
3898The i386, amd64 (nee, x86-64), Alpha, m68hc11, ia64, and m32r targets
3899have been updated to use a new backtrace mechanism which includes
3900DWARF 2 CFI support.
3901
3902* Hosted file I/O.
3903
3904GDB's remote protocol has been extended to include support for hosted
3905file I/O (where the remote target uses GDB's file system). See GDB's
3906remote protocol documentation for details.
3907
3908* All targets using the new architecture framework.
3909
3910All of GDB's targets have been updated to use the new internal
3911architecture framework. The way is now open for future GDB releases
3912to include cross-architecture native debugging support (i386 on amd64,
3913ppc32 on ppc64).
3914
3915* GNU/Linux's Thread Local Storage (TLS)
3916
3917GDB now includes support for for the GNU/Linux implementation of
3918per-thread variables.
3919
3920* GNU/Linux's Native POSIX Thread Library (NPTL)
3921
3922GDB's thread code has been updated to work with either the new
3923GNU/Linux NPTL thread library or the older "LinuxThreads" library.
3924
3925* Separate debug info.
3926
3927GDB, in conjunction with BINUTILS, now supports a mechanism for
3928automatically loading debug information from a separate file. Instead
3929of shipping full debug and non-debug versions of system libraries,
3930system integrators can now instead ship just the stripped libraries
3931and optional debug files.
3932
3933* DWARF 2 Location Expressions
3934
3935DWARF 2 Location Expressions allow the compiler to more completely
3936describe the location of variables (even in optimized code) to the
3937debugger.
3938
3939GDB now includes preliminary support for location expressions (support
3940for DW_OP_piece is still missing).
3941
3942* Java
3943
3944A number of long standing bugs that caused GDB to die while starting a
3945Java application have been fixed. GDB's Java support is now
3946considered "useable".
3947
85f8f974
DJ
3948* GNU/Linux support for fork, vfork, and exec.
3949
3950The "catch fork", "catch exec", "catch vfork", and "set follow-fork-mode"
3951commands are now implemented for GNU/Linux. They require a 2.5.x or later
3952kernel.
3953
0fac0b41
DJ
3954* GDB supports logging output to a file
3955
3956There are two new commands, "set logging" and "show logging", which can be
3957used to capture GDB's output to a file.
f2c06f52 3958
6ad8ae5c
DJ
3959* The meaning of "detach" has changed for gdbserver
3960
3961The "detach" command will now resume the application, as documented. To
3962disconnect from gdbserver and leave it stopped, use the new "disconnect"
3963command.
3964
e286caf2 3965* d10v, m68hc11 `regs' command deprecated
5f601589
AC
3966
3967The `info registers' command has been updated so that it displays the
3968registers using a format identical to the old `regs' command.
3969
d28f9cdf
DJ
3970* Profiling support
3971
3972A new command, "maint set profile on/off", has been added. This command can
3973be used to enable or disable profiling while running GDB, to profile a
3974session or a set of commands. In addition there is a new configure switch,
3975"--enable-profiling", which will cause GDB to be compiled with profiling
3976data, for more informative profiling results.
3977
da0f9dcd
AC
3978* Default MI syntax changed to "mi2".
3979
3980The default MI (machine interface) syntax, enabled by the command line
3981option "-i=mi", has been changed to "mi2". The previous MI syntax,
b68767c1 3982"mi1", can be enabled by specifying the option "-i=mi1".
da0f9dcd
AC
3983
3984Support for the original "mi0" syntax (included in GDB 5.0) has been
3985removed.
3986
fb9b6b35
JJ
3987Fix for gdb/192: removed extraneous space when displaying frame level.
3988Fix for gdb/672: update changelist is now output in mi list format.
3989Fix for gdb/702: a -var-assign that updates the value now shows up
3990 in a subsequent -var-update.
3991
954a4db8
MK
3992* New native configurations.
3993
3994FreeBSD/amd64 x86_64-*-freebsd*
3995
6760f9e6
JB
3996* Multi-arched targets.
3997
b4263afa 3998HP/PA HPUX11 hppa*-*-hpux*
85a453d5 3999Renesas M32R/D w/simulator m32r-*-elf*
6760f9e6 4000
1b831c93
AC
4001* OBSOLETE configurations and files
4002
4003Configurations that have been declared obsolete in this release have
4004been commented out. Unless there is activity to revive these
4005configurations, the next release of GDB will have their sources
4006permanently REMOVED.
4007
8b0e5691 4008Z8000 simulator z8k-zilog-none or z8ksim
67f16606 4009Matsushita MN10200 w/simulator mn10200-*-*
fd2299bd 4010H8/500 simulator h8500-hitachi-hms or h8500hms
56056df7
AC
4011HP/PA running BSD hppa*-*-bsd*
4012HP/PA running OSF/1 hppa*-*-osf*
4013HP/PA Pro target hppa*-*-pro*
78c43945 4014PMAX (MIPS) running Mach 3.0 mips*-*-mach3*
2fbce691
AC
4015Sequent family i[3456]86-sequent-sysv4*
4016 i[3456]86-sequent-sysv*
4017 i[3456]86-sequent-bsd*
f81824a9
AC
4018Tsqware Sparclet sparclet-*-*
4019Fujitsu SPARClite sparclite-fujitsu-none or sparclite
fd2299bd 4020
5835abe7
NC
4021* REMOVED configurations and files
4022
4023V850EA ISA
1b831c93
AC
4024Motorola Delta 88000 running Sys V m88k-motorola-sysv or delta88
4025IBM AIX PS/2 i[3456]86-*-aix
4026i386 running Mach 3.0 i[3456]86-*-mach3*
4027i386 running Mach i[3456]86-*-mach*
4028i386 running OSF/1 i[3456]86-*osf1mk*
4029HP/Apollo 68k Family m68*-apollo*-sysv*,
4030 m68*-apollo*-bsd*,
4031 m68*-hp-bsd*, m68*-hp-hpux*
4032Argonaut Risc Chip (ARC) arc-*-*
4033Mitsubishi D30V d30v-*-*
4034Fujitsu FR30 fr30-*-elf*
4035OS/9000 i[34]86-*-os9k
4036I960 with MON960 i960-*-coff
5835abe7 4037
a094c6fb
AC
4038* MIPS $fp behavior changed
4039
4040The convenience variable $fp, for the MIPS, now consistently returns
4041the address of the current frame's base. Previously, depending on the
4042context, $fp could refer to either $sp or the current frame's base
4043address. See ``8.10 Registers'' in the manual ``Debugging with GDB:
4044The GNU Source-Level Debugger''.
4045
299ffc64 4046*** Changes in GDB 5.3:
37057839 4047
46248966
AC
4048* GNU/Linux shared library multi-threaded performance improved.
4049
4050When debugging a multi-threaded application on GNU/Linux, GDB now uses
4051`/proc', in preference to `ptrace' for memory reads. This may result
4052in an improvement in the start-up time of multi-threaded, shared
4053library applications when run under GDB. One GDB user writes: ``loads
4054shared libs like mad''.
4055
b9d14705 4056* ``gdbserver'' now supports multi-threaded applications on some targets
6da02953 4057
b9d14705
DJ
4058Support for debugging multi-threaded applications which use
4059the GNU/Linux LinuxThreads package has been added for
4060arm*-*-linux*-gnu*, i[3456]86-*-linux*-gnu*, mips*-*-linux*-gnu*,
4061powerpc*-*-linux*-gnu*, and sh*-*-linux*-gnu*.
6da02953 4062
e0e9281e
JB
4063* GDB now supports C/C++ preprocessor macros.
4064
4065GDB now expands preprocessor macro invocations in C/C++ expressions,
4066and provides various commands for showing macro definitions and how
4067they expand.
4068
dd73b9bb
AC
4069The new command `macro expand EXPRESSION' expands any macro
4070invocations in expression, and shows the result.
4071
4072The new command `show macro MACRO-NAME' shows the definition of the
4073macro named MACRO-NAME, and where it was defined.
4074
e0e9281e
JB
4075Most compilers don't include information about macros in the debugging
4076information by default. In GCC 3.1, for example, you need to compile
4077your program with the options `-gdwarf-2 -g3'. If the macro
4078information is present in the executable, GDB will read it.
4079
2250ee0c
CV
4080* Multi-arched targets.
4081
6e3ba3b8
JT
4082DEC Alpha (partial) alpha*-*-*
4083DEC VAX (partial) vax-*-*
2250ee0c 4084NEC V850 v850-*-*
6e3ba3b8 4085National Semiconductor NS32000 (partial) ns32k-*-*
a1789893
GS
4086Motorola 68000 (partial) m68k-*-*
4087Motorola MCORE mcore-*-*
2250ee0c 4088
cd9bfe15 4089* New targets.
e33ce519 4090
456f8b9d
DB
4091Fujitsu FRV architecture added by Red Hat frv*-*-*
4092
e33ce519 4093
da8ca43d
JT
4094* New native configurations
4095
4096Alpha NetBSD alpha*-*-netbsd*
029923d4 4097SH NetBSD sh*-*-netbsdelf*
45888261 4098MIPS NetBSD mips*-*-netbsd*
9ce5c36a 4099UltraSPARC NetBSD sparc64-*-netbsd*
da8ca43d 4100
cd9bfe15
AC
4101* OBSOLETE configurations and files
4102
4103Configurations that have been declared obsolete in this release have
4104been commented out. Unless there is activity to revive these
4105configurations, the next release of GDB will have their sources
4106permanently REMOVED.
4107
92eb23c5 4108Mitsubishi D30V d30v-*-*
a99a9e1b 4109OS/9000 i[34]86-*-os9k
1c7cc583 4110IBM AIX PS/2 i[3456]86-*-aix
7a3085c1 4111Fujitsu FR30 fr30-*-elf*
7fb623f7 4112Motorola Delta 88000 running Sys V m88k-motorola-sysv or delta88
eb4c54a2 4113Argonaut Risc Chip (ARC) arc-*-*
d8ee244c
MK
4114i386 running Mach 3.0 i[3456]86-*-mach3*
4115i386 running Mach i[3456]86-*-mach*
4116i386 running OSF/1 i[3456]86-*osf1mk*
822e978b
AC
4117HP/Apollo 68k Family m68*-apollo*-sysv*,
4118 m68*-apollo*-bsd*,
4119 m68*-hp-bsd*, m68*-hp-hpux*
4d210288 4120I960 with MON960 i960-*-coff
92eb23c5 4121
db034ac5
AC
4122* OBSOLETE languages
4123
4124CHILL, a Pascal like language used by telecommunications companies.
4125
cd9bfe15
AC
4126* REMOVED configurations and files
4127
4128AMD 29k family via UDI a29k-amd-udi, udi29k
4129A29K VxWorks a29k-*-vxworks
4130AMD 29000 embedded, using EBMON a29k-none-none
4131AMD 29000 embedded with COFF a29k-none-coff
4132AMD 29000 embedded with a.out a29k-none-aout
4133
4134testsuite/gdb.hp/gdb.threads-hp/ directory
4135
20f01a46
DH
4136* New command "set max-user-call-depth <nnn>"
4137
4138This command allows the user to limit the call depth of user-defined
4139commands. The default is 1024.
4140
a5941fbf
MK
4141* Changes in FreeBSD/i386 native debugging.
4142
4143Support for the "generate-core-file" has been added.
4144
89743e04
MS
4145* New commands "dump", "append", and "restore".
4146
4147These commands allow data to be copied from target memory
4148to a bfd-format or binary file (dump and append), and back
4149from a file into memory (restore).
37057839 4150
9fb14e79
JB
4151* Improved "next/step" support on multi-processor Alpha Tru64.
4152
4153The previous single-step mechanism could cause unpredictable problems,
4154including the random appearance of SIGSEGV or SIGTRAP signals. The use
4155of a software single-step mechanism prevents this.
4156
2037aebb
AC
4157*** Changes in GDB 5.2.1:
4158
4159* New targets.
4160
4161Atmel AVR avr*-*-*
4162
4163* Bug fixes
4164
4165gdb/182: gdb/323: gdb/237: On alpha, gdb was reporting:
4166mdebugread.c:2443: gdb-internal-error: sect_index_data not initialized
4167Fix, by Joel Brobecker imported from mainline.
4168
4169gdb/439: gdb/291: On some ELF object files, gdb was reporting:
4170dwarf2read.c:1072: gdb-internal-error: sect_index_text not initialize
4171Fix, by Fred Fish, imported from mainline.
4172
4173Dwarf2 .debug_frame & .eh_frame handler improved in many ways.
4174Surprisingly enough, it works now.
4175By Michal Ludvig, imported from mainline.
4176
4177i386 hardware watchpoint support:
4178avoid misses on second run for some targets.
4179By Pierre Muller, imported from mainline.
4180
37057839 4181*** Changes in GDB 5.2:
eb7cedd9 4182
1a703748
MS
4183* New command "set trust-readonly-sections on[off]".
4184
4185This command is a hint that tells gdb that read-only sections
4186really are read-only (ie. that their contents will not change).
4187In this mode, gdb will go to the object file rather than the
4188target to read memory from read-only sections (such as ".text").
4189This can be a significant performance improvement on some
4190(notably embedded) targets.
4191
cefd4ef5
MS
4192* New command "generate-core-file" (or "gcore").
4193
55241689
AC
4194This new gdb command allows the user to drop a core file of the child
4195process state at any time. So far it's been implemented only for
4196GNU/Linux and Solaris, but should be relatively easily ported to other
4197hosts. Argument is core file name (defaults to core.<pid>).
cefd4ef5 4198
352ed7b4
MS
4199* New command line option
4200
4201GDB now accepts --pid or -p followed by a process id.
4202
4203* Change in command line behavior -- corefiles vs. process ids.
4204
4205There is a subtle behavior in the way in which GDB handles
4206command line arguments. The first non-flag argument is always
4207a program to debug, but the second non-flag argument may either
4208be a corefile or a process id. Previously, GDB would attempt to
4209open the second argument as a corefile, and if that failed, would
4210issue a superfluous error message and then attempt to attach it as
4211a process. Now, if the second argument begins with a non-digit,
4212it will be treated as a corefile. If it begins with a digit,
4213GDB will attempt to attach it as a process, and if no such process
4214is found, will then attempt to open it as a corefile.
4215
fe419ffc
RE
4216* Changes in ARM configurations.
4217
4218Multi-arch support is enabled for all ARM configurations. The ARM/NetBSD
4219configuration is fully multi-arch.
4220
eb7cedd9
MK
4221* New native configurations
4222
fe419ffc 4223ARM NetBSD arm*-*-netbsd*
eb7cedd9 4224x86 OpenBSD i[3456]86-*-openbsd*
55241689 4225AMD x86-64 running GNU/Linux x86_64-*-linux-*
768f0842 4226Sparc64 running FreeBSD sparc64-*-freebsd*
eb7cedd9 4227
c9f63e6b
CV
4228* New targets
4229
4230Sanyo XStormy16 xstormy16-elf
4231
9b4ff276
AC
4232* OBSOLETE configurations and files
4233
4234Configurations that have been declared obsolete in this release have
4235been commented out. Unless there is activity to revive these
4236configurations, the next release of GDB will have their sources
4237permanently REMOVED.
4238
4239AMD 29k family via UDI a29k-amd-udi, udi29k
4240A29K VxWorks a29k-*-vxworks
4241AMD 29000 embedded, using EBMON a29k-none-none
4242AMD 29000 embedded with COFF a29k-none-coff
4243AMD 29000 embedded with a.out a29k-none-aout
4244
b4ceaee6 4245testsuite/gdb.hp/gdb.threads-hp/ directory
9b4ff276 4246
e2caac18
AC
4247* REMOVED configurations and files
4248
4249TI TMS320C80 tic80-*-*
7bc65f05 4250WDC 65816 w65-*-*
7768dd6c
AC
4251PowerPC Solaris powerpcle-*-solaris*
4252PowerPC Windows NT powerpcle-*-cygwin32
4253PowerPC Netware powerpc-*-netware*
5e734e1f 4254Harris/CXUX m88k m88*-harris-cxux*
1406caf7
AC
4255Most ns32k hosts and targets ns32k-*-mach3* ns32k-umax-*
4256 ns32k-utek-sysv* ns32k-utek-*
7e24f0b1 4257SunOS 4.0.Xi on i386 i[3456]86-*-sunos*
9b567150 4258Ultracomputer (29K) running Sym1 a29k-nyu-sym1 a29k-*-kern*
3680c638
AC
4259Sony NEWS (68K) running NEWSOS 3.x m68*-sony-sysv news
4260ISI Optimum V (3.05) under 4.3bsd. m68*-isi-*
a752853e 4261Apple Macintosh (MPW) host and target N/A host, powerpc-*-macos*
e2caac18 4262
c2a727fa
TT
4263* Changes to command line processing
4264
4265The new `--args' feature can be used to specify command-line arguments
4266for the inferior from gdb's command line.
4267
467d8519
TT
4268* Changes to key bindings
4269
4270There is a new `operate-and-get-next' function bound to `C-o'.
4271
7072a954
AC
4272*** Changes in GDB 5.1.1
4273
4274Fix compile problem on DJGPP.
4275
4276Fix a problem with floating-point registers on the i386 being
4277corrupted.
4278
4279Fix to stop GDB crashing on .debug_str debug info.
4280
4281Numerous documentation fixes.
4282
4283Numerous testsuite fixes.
4284
34f47bc4 4285*** Changes in GDB 5.1:
139760b7
MK
4286
4287* New native configurations
4288
4289Alpha FreeBSD alpha*-*-freebsd*
4290x86 FreeBSD 3.x and 4.x i[3456]86*-freebsd[34]*
55241689 4291MIPS GNU/Linux mips*-*-linux*
e23194cb
EZ
4292MIPS SGI Irix 6.x mips*-sgi-irix6*
4293ia64 AIX ia64-*-aix*
55241689 4294s390 and s390x GNU/Linux {s390,s390x}-*-linux*
139760b7 4295
bf64bfd6
AC
4296* New targets
4297
def90278 4298Motorola 68HC11 and 68HC12 m68hc11-elf
24be5c34 4299CRIS cris-axis
55241689 4300UltraSparc running GNU/Linux sparc64-*-linux*
def90278 4301
17e78a56 4302* OBSOLETE configurations and files
bf64bfd6
AC
4303
4304x86 FreeBSD before 2.2 i[3456]86*-freebsd{1,2.[01]}*,
9b9c068d 4305Harris/CXUX m88k m88*-harris-cxux*
bb19ff3b
AC
4306Most ns32k hosts and targets ns32k-*-mach3* ns32k-umax-*
4307 ns32k-utek-sysv* ns32k-utek-*
76f4ea53
AC
4308TI TMS320C80 tic80-*-*
4309WDC 65816 w65-*-*
4a1968f4 4310Ultracomputer (29K) running Sym1 a29k-nyu-sym1 a29k-*-kern*
1b2b2c16
AC
4311PowerPC Solaris powerpcle-*-solaris*
4312PowerPC Windows NT powerpcle-*-cygwin32
4313PowerPC Netware powerpc-*-netware*
24f89b68 4314SunOS 4.0.Xi on i386 i[3456]86-*-sunos*
514e603d
AC
4315Sony NEWS (68K) running NEWSOS 3.x m68*-sony-sysv news
4316ISI Optimum V (3.05) under 4.3bsd. m68*-isi-*
d036b4d9 4317Apple Macintosh (MPW) host N/A
bf64bfd6 4318
17e78a56
AC
4319stuff.c (Program to stuff files into a specially prepared space in kdb)
4320kdb-start.c (Main loop for the standalone kernel debugger)
4321
7fcca85b
AC
4322Configurations that have been declared obsolete in this release have
4323been commented out. Unless there is activity to revive these
4324configurations, the next release of GDB will have their sources
4325permanently REMOVED.
4326
a196c81c 4327* REMOVED configurations and files
7fcca85b
AC
4328
4329Altos 3068 m68*-altos-*
4330Convex c1-*-*, c2-*-*
4331Pyramid pyramid-*-*
4332ARM RISCix arm-*-* (as host)
4333Tahoe tahoe-*-*
a196c81c 4334ser-ocd.c *-*-*
bf64bfd6 4335
6d6b80e5 4336* GDB has been converted to ISO C.
e23194cb 4337
6d6b80e5 4338GDB's source code has been converted to ISO C. In particular, the
e23194cb
EZ
4339sources are fully protoized, and rely on standard headers being
4340present.
4341
bf64bfd6
AC
4342* Other news:
4343
e23194cb
EZ
4344* "info symbol" works on platforms which use COFF, ECOFF, XCOFF, and NLM.
4345
4346* The MI enabled by default.
4347
4348The new machine oriented interface (MI) introduced in GDB 5.0 has been
4349revised and enabled by default. Packages which use GDB as a debugging
4350engine behind a UI or another front end are encouraged to switch to
4351using the GDB/MI interface, instead of the old annotations interface
4352which is now deprecated.
4353
4354* Support for debugging Pascal programs.
4355
4356GDB now includes support for debugging Pascal programs. The following
4357main features are supported:
4358
4359 - Pascal-specific data types such as sets;
4360
4361 - automatic recognition of Pascal sources based on file-name
4362 extension;
4363
4364 - Pascal-style display of data types, variables, and functions;
4365
4366 - a Pascal expression parser.
4367
4368However, some important features are not yet supported.
4369
4370 - Pascal string operations are not supported at all;
4371
4372 - there are some problems with boolean types;
4373
4374 - Pascal type hexadecimal constants are not supported
4375 because they conflict with the internal variables format;
4376
4377 - support for Pascal objects and classes is not full yet;
4378
4379 - unlike Pascal, GDB is case-sensitive for symbol names.
4380
4381* Changes in completion.
4382
4383Commands such as `shell', `run' and `set args', which pass arguments
4384to inferior programs, now complete on file names, similar to what
4385users expect at the shell prompt.
4386
4387Commands which accept locations, such as `disassemble', `print',
4388`breakpoint', `until', etc. now complete on filenames as well as
4389program symbols. Thus, if you type "break foob TAB", and the source
4390files linked into the programs include `foobar.c', that file name will
4391be one of the candidates for completion. However, file names are not
4392considered for completion after you typed a colon that delimits a file
4393name from a name of a function in that file, as in "break foo.c:bar".
4394
4395`set demangle-style' completes on available demangling styles.
4396
4397* New platform-independent commands:
4398
4399It is now possible to define a post-hook for a command as well as a
4400hook that runs before the command. For more details, see the
4401documentation of `hookpost' in the GDB manual.
4402
4403* Changes in GNU/Linux native debugging.
4404
d7275149
MK
4405Support for debugging multi-threaded programs has been completely
4406revised for all platforms except m68k and sparc. You can now debug as
4407many threads as your system allows you to have.
4408
e23194cb
EZ
4409Attach/detach is supported for multi-threaded programs.
4410
d7275149
MK
4411Support for SSE registers was added for x86. This doesn't work for
4412multi-threaded programs though.
e23194cb
EZ
4413
4414* Changes in MIPS configurations.
bf64bfd6
AC
4415
4416Multi-arch support is enabled for all MIPS configurations.
4417
e23194cb
EZ
4418GDB can now be built as native debugger on SGI Irix 6.x systems for
4419debugging n32 executables. (Debugging 64-bit executables is not yet
4420supported.)
4421
4422* Unified support for hardware watchpoints in all x86 configurations.
4423
4424Most (if not all) native x86 configurations support hardware-assisted
4425breakpoints and watchpoints in a unified manner. This support
4426implements debug register sharing between watchpoints, which allows to
4427put a virtually infinite number of watchpoints on the same address,
4428and also supports watching regions up to 16 bytes with several debug
4429registers.
4430
4431The new maintenance command `maintenance show-debug-regs' toggles
4432debugging print-outs in functions that insert, remove, and test
4433watchpoints and hardware breakpoints.
4434
4435* Changes in the DJGPP native configuration.
4436
4437New command ``info dos sysinfo'' displays assorted information about
4438the CPU, OS, memory, and DPMI server.
4439
4440New commands ``info dos gdt'', ``info dos ldt'', and ``info dos idt''
4441display information about segment descriptors stored in GDT, LDT, and
4442IDT.
4443
4444New commands ``info dos pde'' and ``info dos pte'' display entries
4445from Page Directory and Page Tables (for now works with CWSDPMI only).
4446New command ``info dos address-pte'' displays the Page Table entry for
4447a given linear address.
4448
4449GDB can now pass command lines longer than 126 characters to the
4450program being debugged (requires an update to the libdbg.a library
4451which is part of the DJGPP development kit).
4452
4453DWARF2 debug info is now supported.
4454
6c56c069
EZ
4455It is now possible to `step' and `next' through calls to `longjmp'.
4456
e23194cb
EZ
4457* Changes in documentation.
4458
4459All GDB documentation was converted to GFDL, the GNU Free
4460Documentation License.
4461
4462Tracepoints-related commands are now fully documented in the GDB
4463manual.
4464
4465TUI, the Text-mode User Interface, is now documented in the manual.
4466
4467Tracepoints-related commands are now fully documented in the GDB
4468manual.
4469
4470The "GDB Internals" manual now has an index. It also includes
4471documentation of `ui_out' functions, GDB coding standards, x86
4472hardware watchpoints, and memory region attributes.
4473
5d6640b1
AC
4474* GDB's version number moved to ``version.in''
4475
4476The Makefile variable VERSION has been replaced by the file
4477``version.in''. People creating GDB distributions should update the
4478contents of this file.
4479
1a1d8446
AC
4480* gdba.el deleted
4481
4482GUD support is now a standard part of the EMACS distribution.
139760b7 4483
9debab2f 4484*** Changes in GDB 5.0:
7a292a7a 4485
c63ce875
EZ
4486* Improved support for debugging FP programs on x86 targets
4487
4488Unified and much-improved support for debugging floating-point
4489programs on all x86 targets. In particular, ``info float'' now
4490displays the FP registers in the same format on all x86 targets, with
4491greater level of detail.
4492
4493* Improvements and bugfixes in hardware-assisted watchpoints
4494
4495It is now possible to watch array elements, struct members, and
4496bitfields with hardware-assisted watchpoints. Data-read watchpoints
4497on x86 targets no longer erroneously trigger when the address is
4498written.
4499
4500* Improvements in the native DJGPP version of GDB
4501
4502The distribution now includes all the scripts and auxiliary files
4503necessary to build the native DJGPP version on MS-DOS/MS-Windows
4504machines ``out of the box''.
4505
4506The DJGPP version can now debug programs that use signals. It is
4507possible to catch signals that happened in the debuggee, deliver
4508signals to it, interrupt it with Ctrl-C, etc. (Previously, a signal
4509would kill the program being debugged.) Programs that hook hardware
4510interrupts (keyboard, timer, etc.) can also be debugged.
4511
4512It is now possible to debug DJGPP programs that redirect their
4513standard handles or switch them to raw (as opposed to cooked) mode, or
4514even close them. The command ``run < foo > bar'' works as expected,
4515and ``info terminal'' reports useful information about the debuggee's
4516terminal, including raw/cooked mode, redirection, etc.
4517
4518The DJGPP version now uses termios functions for console I/O, which
4519enables debugging graphics programs. Interrupting GDB with Ctrl-C
4520also works.
4521
4522DOS-style file names with drive letters are now fully supported by
4523GDB.
4524
4525It is now possible to debug DJGPP programs that switch their working
4526directory. It is also possible to rerun the debuggee any number of
4527times without restarting GDB; thus, you can use the same setup,
4528breakpoints, etc. for many debugging sessions.
4529
ed9a39eb
JM
4530* New native configurations
4531
4532ARM GNU/Linux arm*-*-linux*
afc05dd4 4533PowerPC GNU/Linux powerpc-*-linux*
ed9a39eb 4534
7a292a7a
SS
4535* New targets
4536
96baa820 4537Motorola MCore mcore-*-*
adf40b2e
JM
4538x86 VxWorks i[3456]86-*-vxworks*
4539PowerPC VxWorks powerpc-*-vxworks*
7a292a7a
SS
4540TI TMS320C80 tic80-*-*
4541
085dd6e6
JM
4542* OBSOLETE configurations
4543
4544Altos 3068 m68*-altos-*
4545Convex c1-*-*, c2-*-*
9846de1b 4546Pyramid pyramid-*-*
ed9a39eb 4547ARM RISCix arm-*-* (as host)
104c1213 4548Tahoe tahoe-*-*
7a292a7a 4549
9debab2f
AC
4550Configurations that have been declared obsolete will be commented out,
4551but the code will be left in place. If there is no activity to revive
4552these configurations before the next release of GDB, the sources will
4553be permanently REMOVED.
4554
5330533d
SS
4555* Gould support removed
4556
4557Support for the Gould PowerNode and NP1 has been removed.
4558
bc9e5bbf
AC
4559* New features for SVR4
4560
4561On SVR4 native platforms (such as Solaris), if you attach to a process
4562without first loading a symbol file, GDB will now attempt to locate and
4563load symbols from the running process's executable file.
4564
4565* Many C++ enhancements
4566
4567C++ support has been greatly improved. Overload resolution now works properly
4568in almost all cases. RTTI support is on the way.
4569
adf40b2e
JM
4570* Remote targets can connect to a sub-program
4571
4572A popen(3) style serial-device has been added. This device starts a
4573sub-process (such as a stand-alone simulator) and then communicates
4574with that. The sub-program to run is specified using the syntax
4575``|<program> <args>'' vis:
4576
4577 (gdb) set remotedebug 1
4578 (gdb) target extended-remote |mn10300-elf-sim program-args
4579
43e526b9
JM
4580* MIPS 64 remote protocol
4581
4582A long standing bug in the mips64 remote protocol where by GDB
4583expected certain 32 bit registers (ex SR) to be transfered as 32
4584instead of 64 bits has been fixed.
4585
4586The command ``set remote-mips64-transfers-32bit-regs on'' has been
4587added to provide backward compatibility with older versions of GDB.
4588
96baa820
JM
4589* ``set remotebinarydownload'' replaced by ``set remote X-packet''
4590
4591The command ``set remotebinarydownload'' command has been replaced by
4592``set remote X-packet''. Other commands in ``set remote'' family
4593include ``set remote P-packet''.
4594
11cf8741
JM
4595* Breakpoint commands accept ranges.
4596
4597The breakpoint commands ``enable'', ``disable'', and ``delete'' now
4598accept a range of breakpoints, e.g. ``5-7''. The tracepoint command
4599``tracepoint passcount'' also accepts a range of tracepoints.
4600
7876dd43
DB
4601* ``apropos'' command added.
4602
4603The ``apropos'' command searches through command names and
4604documentation strings, printing out matches, making it much easier to
4605try to find a command that does what you are looking for.
4606
bc9e5bbf
AC
4607* New MI interface
4608
4609A new machine oriented interface (MI) has been added to GDB. This
4610interface is designed for debug environments running GDB as a separate
7162c0ca
EZ
4611process. This is part of the long term libGDB project. See the
4612"GDB/MI" chapter of the GDB manual for further information. It can be
4613enabled by configuring with:
bc9e5bbf
AC
4614
4615 .../configure --enable-gdbmi
4616
c906108c
SS
4617*** Changes in GDB-4.18:
4618
4619* New native configurations
4620
4621HP-UX 10.20 hppa*-*-hpux10.20
4622HP-UX 11.x hppa*-*-hpux11.0*
55241689 4623M68K GNU/Linux m68*-*-linux*
c906108c
SS
4624
4625* New targets
4626
4627Fujitsu FR30 fr30-*-elf*
4628Intel StrongARM strongarm-*-*
4629Mitsubishi D30V d30v-*-*
4630
4631* OBSOLETE configurations
4632
4633Gould PowerNode, NP1 np1-*-*, pn-*-*
4634
4635Configurations that have been declared obsolete will be commented out,
4636but the code will be left in place. If there is no activity to revive
4637these configurations before the next release of GDB, the sources will
4638be permanently REMOVED.
4639
4640* ANSI/ISO C
4641
4642As a compatibility experiment, GDB's source files buildsym.h and
4643buildsym.c have been converted to pure standard C, no longer
4644containing any K&R compatibility code. We believe that all systems in
4645use today either come with a standard C compiler, or have a GCC port
4646available. If this is not true, please report the affected
4647configuration to bug-gdb@gnu.org immediately. See the README file for
4648information about getting a standard C compiler if you don't have one
4649already.
4650
4651* Readline 2.2
4652
4653GDB now uses readline 2.2.
4654
4655* set extension-language
4656
4657You can now control the mapping between filename extensions and source
4658languages by using the `set extension-language' command. For instance,
4659you can ask GDB to treat .c files as C++ by saying
4660 set extension-language .c c++
4661The command `info extensions' lists all of the recognized extensions
4662and their associated languages.
4663
4664* Setting processor type for PowerPC and RS/6000
4665
4666When GDB is configured for a powerpc*-*-* or an rs6000*-*-* target,
4667you can use the `set processor' command to specify what variant of the
4668PowerPC family you are debugging. The command
4669
4670 set processor NAME
4671
4672sets the PowerPC/RS6000 variant to NAME. GDB knows about the
4673following PowerPC and RS6000 variants:
4674
4675 ppc-uisa PowerPC UISA - a PPC processor as viewed by user-level code
4676 rs6000 IBM RS6000 ("POWER") architecture, user-level view
4677 403 IBM PowerPC 403
4678 403GC IBM PowerPC 403GC
4679 505 Motorola PowerPC 505
4680 860 Motorola PowerPC 860 or 850
4681 601 Motorola PowerPC 601
4682 602 Motorola PowerPC 602
4683 603 Motorola/IBM PowerPC 603 or 603e
4684 604 Motorola PowerPC 604 or 604e
4685 750 Motorola/IBM PowerPC 750 or 750
4686
4687At the moment, this command just tells GDB what to name the
4688special-purpose processor registers. Since almost all the affected
4689registers are inaccessible to user-level programs, this command is
4690only useful for remote debugging in its present form.
4691
4692* HP-UX support
4693
4694Thanks to a major code donation from Hewlett-Packard, GDB now has much
4695more extensive support for HP-UX. Added features include shared
4696library support, kernel threads and hardware watchpoints for 11.00,
4697support for HP's ANSI C and C++ compilers, and a compatibility mode
4698for xdb and dbx commands.
4699
4700* Catchpoints
4701
4702HP's donation includes the new concept of catchpoints, which is a
4703generalization of the old catch command. On HP-UX, it is now possible
4704to catch exec, fork, and vfork, as well as library loading.
4705
4706This means that the existing catch command has changed; its first
4707argument now specifies the type of catch to be set up. See the
4708output of "help catch" for a list of catchpoint types.
4709
4710* Debugging across forks
4711
4712On HP-UX, you can choose which process to debug when a fork() happens
4713in the inferior.
4714
4715* TUI
4716
4717HP has donated a curses-based terminal user interface (TUI). To get
4718it, build with --enable-tui. Although this can be enabled for any
4719configuration, at present it only works for native HP debugging.
4720
4721* GDB remote protocol additions
4722
4723A new protocol packet 'X' that writes binary data is now available.
4724Default behavior is to try 'X', then drop back to 'M' if the stub
4725fails to respond. The settable variable `remotebinarydownload'
4726allows explicit control over the use of 'X'.
4727
4728For 64-bit targets, the memory packets ('M' and 'm') can now contain a
4729full 64-bit address. The command
4730
4731 set remoteaddresssize 32
4732
4733can be used to revert to the old behaviour. For existing remote stubs
4734the change should not be noticed, as the additional address information
4735will be discarded.
4736
4737In order to assist in debugging stubs, you may use the maintenance
4738command `packet' to send any text string to the stub. For instance,
4739
4740 maint packet heythere
4741
4742sends the packet "$heythere#<checksum>". Note that it is very easy to
4743disrupt a debugging session by sending the wrong packet at the wrong
4744time.
4745
4746The compare-sections command allows you to compare section data on the
4747target to what is in the executable file without uploading or
4748downloading, by comparing CRC checksums.
4749
4750* Tracing can collect general expressions
4751
4752You may now collect general expressions at tracepoints. This requires
4753further additions to the target-side stub; see tracepoint.c and
4754doc/agentexpr.texi for further details.
4755
4756* mask-address variable for Mips
4757
4758For Mips targets, you may control the zeroing of the upper 32 bits of
4759a 64-bit address by entering `set mask-address on'. This is mainly
4760of interest to users of embedded R4xxx and R5xxx processors.
4761
4762* Higher serial baud rates
4763
4764GDB's serial code now allows you to specify baud rates 57600, 115200,
4765230400, and 460800 baud. (Note that your host system may not be able
4766to achieve all of these rates.)
4767
4768* i960 simulator
4769
4770The i960 configuration now includes an initial implementation of a
4771builtin simulator, contributed by Jim Wilson.
4772
4773
4774*** Changes in GDB-4.17:
4775
4776* New native configurations
4777
4778Alpha GNU/Linux alpha*-*-linux*
4779Unixware 2.x i[3456]86-unixware2*
4780Irix 6.x mips*-sgi-irix6*
4781PowerPC GNU/Linux powerpc-*-linux*
4782PowerPC Solaris powerpcle-*-solaris*
4783Sparc GNU/Linux sparc-*-linux*
4784Motorola sysV68 R3V7.1 m68k-motorola-sysv
4785
4786* New targets
4787
4788Argonaut Risc Chip (ARC) arc-*-*
4789Hitachi H8/300S h8300*-*-*
4790Matsushita MN10200 w/simulator mn10200-*-*
4791Matsushita MN10300 w/simulator mn10300-*-*
4792MIPS NEC VR4100 mips64*vr4100*{,el}-*-elf*
4793MIPS NEC VR5000 mips64*vr5000*{,el}-*-elf*
4794MIPS Toshiba TX39 mips64*tx39*{,el}-*-elf*
4795Mitsubishi D10V w/simulator d10v-*-*
4796Mitsubishi M32R/D w/simulator m32r-*-elf*
4797Tsqware Sparclet sparclet-*-*
4798NEC V850 w/simulator v850-*-*
4799
4800* New debugging protocols
4801
4802ARM with RDI protocol arm*-*-*
4803M68K with dBUG monitor m68*-*-{aout,coff,elf}
4804DDB and LSI variants of PMON protocol mips*-*-*
4805PowerPC with DINK32 monitor powerpc{,le}-*-eabi
4806PowerPC with SDS protocol powerpc{,le}-*-eabi
4807Macraigor OCD (Wiggler) devices powerpc{,le}-*-eabi
4808
4809* DWARF 2
4810
4811All configurations can now understand and use the DWARF 2 debugging
4812format. The choice is automatic, if the symbol file contains DWARF 2
4813information.
4814
4815* Java frontend
4816
4817GDB now includes basic Java language support. This support is
4818only useful with Java compilers that produce native machine code.
4819
4820* solib-absolute-prefix and solib-search-path
4821
4822For SunOS and SVR4 shared libraries, you may now set the prefix for
4823loading absolute shared library symbol files, and the search path for
4824locating non-absolute shared library symbol files.
4825
4826* Live range splitting
4827
4828GDB can now effectively debug code for which GCC has performed live
4829range splitting as part of its optimization. See gdb/doc/LRS for
4830more details on the expected format of the stabs information.
4831
4832* Hurd support
4833
4834GDB's support for the GNU Hurd, including thread debugging, has been
4835updated to work with current versions of the Hurd.
4836
4837* ARM Thumb support
4838
4839GDB's ARM target configuration now handles the ARM7T (Thumb) 16-bit
4840instruction set. ARM GDB automatically detects when Thumb
4841instructions are in use, and adjusts disassembly and backtracing
4842accordingly.
4843
4844* MIPS16 support
4845
4846GDB's MIPS target configurations now handle the MIP16 16-bit
4847instruction set.
4848
4849* Overlay support
4850
4851GDB now includes support for overlays; if an executable has been
4852linked such that multiple sections are based at the same address, GDB
4853will decide which section to use for symbolic info. You can choose to
4854control the decision manually, using overlay commands, or implement
4855additional target-side support and use "overlay load-target" to bring
4856in the overlay mapping. Do "help overlay" for more detail.
4857
4858* info symbol
4859
4860The command "info symbol <address>" displays information about
4861the symbol at the specified address.
4862
4863* Trace support
4864
4865The standard remote protocol now includes an extension that allows
4866asynchronous collection and display of trace data. This requires
4867extensive support in the target-side debugging stub. Tracing mode
4868includes a new interaction mode in GDB and new commands: see the
4869file tracepoint.c for more details.
4870
4871* MIPS simulator
4872
4873Configurations for embedded MIPS now include a simulator contributed
4874by Cygnus Solutions. The simulator supports the instruction sets
4875of most MIPS variants.
4876
4877* Sparc simulator
4878
4879Sparc configurations may now include the ERC32 simulator contributed
4880by the European Space Agency. The simulator is not built into
4881Sparc targets by default; configure with --enable-sim to include it.
4882
4883* set architecture
4884
4885For target configurations that may include multiple variants of a
4886basic architecture (such as MIPS and SH), you may now set the
4887architecture explicitly. "set arch" sets, "info arch" lists
4888the possible architectures.
4889
4890*** Changes in GDB-4.16:
4891
4892* New native configurations
4893
4894Windows 95, x86 Windows NT i[345]86-*-cygwin32
4895M68K NetBSD m68k-*-netbsd*
4896PowerPC AIX 4.x powerpc-*-aix*
4897PowerPC MacOS powerpc-*-macos*
4898PowerPC Windows NT powerpcle-*-cygwin32
4899RS/6000 AIX 4.x rs6000-*-aix4*
4900
4901* New targets
4902
4903ARM with RDP protocol arm-*-*
4904I960 with MON960 i960-*-coff
4905MIPS VxWorks mips*-*-vxworks*
4906MIPS VR4300 with PMON mips64*vr4300{,el}-*-elf*
4907PowerPC with PPCBUG monitor powerpc{,le}-*-eabi*
4908Hitachi SH3 sh-*-*
4909Matra Sparclet sparclet-*-*
4910
4911* PowerPC simulator
4912
4913The powerpc-eabi configuration now includes the PSIM simulator,
4914contributed by Andrew Cagney, with assistance from Mike Meissner.
4915PSIM is a very elaborate model of the PowerPC, including not only
4916basic instruction set execution, but also details of execution unit
4917performance and I/O hardware. See sim/ppc/README for more details.
4918
4919* Solaris 2.5
4920
4921GDB now works with Solaris 2.5.
4922
4923* Windows 95/NT native
4924
4925GDB will now work as a native debugger on Windows 95 and Windows NT.
4926To build it from source, you must use the "gnu-win32" environment,
4927which uses a DLL to emulate enough of Unix to run the GNU tools.
4928Further information, binaries, and sources are available at
4929ftp.cygnus.com, under pub/gnu-win32.
4930
4931* dont-repeat command
4932
4933If a user-defined command includes the command `dont-repeat', then the
4934command will not be repeated if the user just types return. This is
4935useful if the command is time-consuming to run, so that accidental
4936extra keystrokes don't run the same command many times.
4937
4938* Send break instead of ^C
4939
4940The standard remote protocol now includes an option to send a break
4941rather than a ^C to the target in order to interrupt it. By default,
4942GDB will send ^C; to send a break, set the variable `remotebreak' to 1.
4943
4944* Remote protocol timeout
4945
4946The standard remote protocol includes a new variable `remotetimeout'
4947that allows you to set the number of seconds before GDB gives up trying
4948to read from the target. The default value is 2.
4949
4950* Automatic tracking of dynamic object loading (HPUX and Solaris only)
4951
4952By default GDB will automatically keep track of objects as they are
4953loaded and unloaded by the dynamic linker. By using the command `set
4954stop-on-solib-events 1' you can arrange for GDB to stop the inferior
4955when shared library events occur, thus allowing you to set breakpoints
4956in shared libraries which are explicitly loaded by the inferior.
4957
4958Note this feature does not work on hpux8. On hpux9 you must link
4959/usr/lib/end.o into your program. This feature should work
4960automatically on hpux10.
4961
4962* Irix 5.x hardware watchpoint support
4963
4964Irix 5 configurations now support the use of hardware watchpoints.
4965
4966* Mips protocol "SYN garbage limit"
4967
4968When debugging a Mips target using the `target mips' protocol, you
4969may set the number of characters that GDB will ignore by setting
4970the `syn-garbage-limit'. A value of -1 means that GDB will ignore
4971every character. The default value is 1050.
4972
4973* Recording and replaying remote debug sessions
4974
4975If you set `remotelogfile' to the name of a file, gdb will write to it
4976a recording of a remote debug session. This recording may then be
4977replayed back to gdb using "gdbreplay". See gdbserver/README for
4978details. This is useful when you have a problem with GDB while doing
4979remote debugging; you can make a recording of the session and send it
4980to someone else, who can then recreate the problem.
4981
4982* Speedups for remote debugging
4983
4984GDB includes speedups for downloading and stepping MIPS systems using
4985the IDT monitor, fast downloads to the Hitachi SH E7000 emulator,
4986and more efficient S-record downloading.
4987
4988* Memory use reductions and statistics collection
4989
4990GDB now uses less memory and reports statistics about memory usage.
4991Try the `maint print statistics' command, for example.
4992
4993*** Changes in GDB-4.15:
4994
4995* Psymtabs for XCOFF
4996
4997The symbol reader for AIX GDB now uses partial symbol tables. This
4998can greatly improve startup time, especially for large executables.
4999
5000* Remote targets use caching
5001
5002Remote targets now use a data cache to speed up communication with the
5003remote side. The data cache could lead to incorrect results because
5004it doesn't know about volatile variables, thus making it impossible to
5005debug targets which use memory mapped I/O devices. `set remotecache
5006off' turns the the data cache off.
5007
5008* Remote targets may have threads
5009
5010The standard remote protocol now includes support for multiple threads
5011in the target system, using new protocol commands 'H' and 'T'. See
5012gdb/remote.c for details.
5013
5014* NetROM support
5015
5016If GDB is configured with `--enable-netrom', then it will include
5017support for the NetROM ROM emulator from XLNT Designs. The NetROM
5018acts as though it is a bank of ROM on the target board, but you can
5019write into it over the network. GDB's support consists only of
5020support for fast loading into the emulated ROM; to debug, you must use
5021another protocol, such as standard remote protocol. The usual
5022sequence is something like
5023
5024 target nrom <netrom-hostname>
5025 load <prog>
5026 target remote <netrom-hostname>:1235
5027
5028* Macintosh host
5029
5030GDB now includes support for the Apple Macintosh, as a host only. It
5031may be run as either an MPW tool or as a standalone application, and
5032it can debug through the serial port. All the usual GDB commands are
5033available, but to the target command, you must supply "serial" as the
5034device type instead of "/dev/ttyXX". See mpw-README in the main
5035directory for more information on how to build. The MPW configuration
5036scripts */mpw-config.in support only a few targets, and only the
5037mips-idt-ecoff target has been tested.
5038
5039* Autoconf
5040
5041GDB configuration now uses autoconf. This is not user-visible,
5042but does simplify configuration and building.
5043
5044* hpux10
5045
5046GDB now supports hpux10.
5047
5048*** Changes in GDB-4.14:
5049
5050* New native configurations
5051
5052x86 FreeBSD i[345]86-*-freebsd
5053x86 NetBSD i[345]86-*-netbsd
5054NS32k NetBSD ns32k-*-netbsd
5055Sparc NetBSD sparc-*-netbsd
5056
5057* New targets
5058
5059A29K VxWorks a29k-*-vxworks
5060HP PA PRO embedded (WinBond W89K & Oki OP50N) hppa*-*-pro*
5061CPU32 EST-300 emulator m68*-*-est*
5062PowerPC ELF powerpc-*-elf
5063WDC 65816 w65-*-*
5064
5065* Alpha OSF/1 support for procfs
5066
5067GDB now supports procfs under OSF/1-2.x and higher, which makes it
5068possible to attach to running processes. As the mounting of the /proc
5069filesystem is optional on the Alpha, GDB automatically determines
5070the availability of /proc during startup. This can lead to problems
5071if /proc is unmounted after GDB has been started.
5072
5073* Arguments to user-defined commands
5074
5075User commands may accept up to 10 arguments separated by whitespace.
5076Arguments are accessed within the user command via $arg0..$arg9. A
5077trivial example:
5078define adder
5079 print $arg0 + $arg1 + $arg2
5080
5081To execute the command use:
5082adder 1 2 3
5083
5084Defines the command "adder" which prints the sum of its three arguments.
5085Note the arguments are text substitutions, so they may reference variables,
5086use complex expressions, or even perform inferior function calls.
5087
5088* New `if' and `while' commands
5089
5090This makes it possible to write more sophisticated user-defined
5091commands. Both commands take a single argument, which is the
5092expression to evaluate, and must be followed by the commands to
5093execute, one per line, if the expression is nonzero, the list being
5094terminated by the word `end'. The `if' command list may include an
5095`else' word, which causes the following commands to be executed only
5096if the expression is zero.
5097
5098* Fortran source language mode
5099
5100GDB now includes partial support for Fortran 77. It will recognize
5101Fortran programs and can evaluate a subset of Fortran expressions, but
5102variables and functions may not be handled correctly. GDB will work
5103with G77, but does not yet know much about symbols emitted by other
5104Fortran compilers.
5105
5106* Better HPUX support
5107
5108Most debugging facilities now work on dynamic executables for HPPAs
5109running hpux9 or later. You can attach to running dynamically linked
5110processes, but by default the dynamic libraries will be read-only, so
5111for instance you won't be able to put breakpoints in them. To change
5112that behavior do the following before running the program:
5113
5114 adb -w a.out
5115 __dld_flags?W 0x5
5116 control-d
5117
5118This will cause the libraries to be mapped private and read-write.
5119To revert to the normal behavior, do this:
5120
5121 adb -w a.out
5122 __dld_flags?W 0x4
5123 control-d
5124
5125You cannot set breakpoints or examine data in the library until after
5126the library is loaded if the function/data symbols do not have
5127external linkage.
5128
5129GDB can now also read debug symbols produced by the HP C compiler on
5130HPPAs (sorry, no C++, Fortran or 68k support).
5131
5132* Target byte order now dynamically selectable
5133
5134You can choose which byte order to use with a target system, via the
5135commands "set endian big" and "set endian little", and you can see the
5136current setting by using "show endian". You can also give the command
5137"set endian auto", in which case GDB will use the byte order
5138associated with the executable. Currently, only embedded MIPS
5139configurations support dynamic selection of target byte order.
5140
5141* New DOS host serial code
5142
5143This version uses DPMI interrupts to handle buffered I/O, so you
5144no longer need to run asynctsr when debugging boards connected to
5145a PC's serial port.
5146
5147*** Changes in GDB-4.13:
5148
5149* New "complete" command
5150
5151This lists all the possible completions for the rest of the line, if it
5152were to be given as a command itself. This is intended for use by emacs.
5153
5154* Trailing space optional in prompt
5155
5156"set prompt" no longer adds a space for you after the prompt you set. This
5157allows you to set a prompt which ends in a space or one that does not.
5158
5159* Breakpoint hit counts
5160
5161"info break" now displays a count of the number of times the breakpoint
5162has been hit. This is especially useful in conjunction with "ignore"; you
5163can ignore a large number of breakpoint hits, look at the breakpoint info
5164to see how many times the breakpoint was hit, then run again, ignoring one
5165less than that number, and this will get you quickly to the last hit of
5166that breakpoint.
5167
5168* Ability to stop printing at NULL character
5169
5170"set print null-stop" will cause GDB to stop printing the characters of
5171an array when the first NULL is encountered. This is useful when large
5172arrays actually contain only short strings.
5173
5174* Shared library breakpoints
5175
5176In SunOS 4.x, SVR4, and Alpha OSF/1 configurations, you can now set
5177breakpoints in shared libraries before the executable is run.
5178
5179* Hardware watchpoints
5180
5181There is a new hardware breakpoint for the watch command for sparclite
5182targets. See gdb/sparclite/hw_breakpoint.note.
5183
55241689 5184Hardware watchpoints are also now supported under GNU/Linux.
c906108c
SS
5185
5186* Annotations
5187
5188Annotations have been added. These are for use with graphical interfaces,
5189and are still experimental. Currently only gdba.el uses these.
5190
5191* Improved Irix 5 support
5192
5193GDB now works properly with Irix 5.2.
5194
5195* Improved HPPA support
5196
5197GDB now works properly with the latest GCC and GAS.
5198
5199* New native configurations
5200
5201Sequent PTX4 i[34]86-sequent-ptx4
5202HPPA running OSF/1 hppa*-*-osf*
5203Atari TT running SVR4 m68*-*-sysv4*
5204RS/6000 LynxOS rs6000-*-lynxos*
5205
5206* New targets
5207
5208OS/9000 i[34]86-*-os9k
5209MIPS R4000 mips64*{,el}-*-{ecoff,elf}
5210Sparc64 sparc64-*-*
5211
5212* Hitachi SH7000 and E7000-PC ICE support
5213
5214There is now support for communicating with the Hitachi E7000-PC ICE.
5215This is available automatically when GDB is configured for the SH.
5216
5217* Fixes
5218
5219As usual, a variety of small fixes and improvements, both generic
5220and configuration-specific. See the ChangeLog for more detail.
5221
5222*** Changes in GDB-4.12:
5223
5224* Irix 5 is now supported
5225
5226* HPPA support
5227
5228GDB-4.12 on the HPPA has a number of changes which make it unable
5229to debug the output from the currently released versions of GCC and
5230GAS (GCC 2.5.8 and GAS-2.2 or PAGAS-1.36). Until the next major release
5231of GCC and GAS, versions of these tools designed to work with GDB-4.12
5232can be retrieved via anonymous ftp from jaguar.cs.utah.edu:/dist.
5233
5234
5235*** Changes in GDB-4.11:
5236
5237* User visible changes:
5238
5239* Remote Debugging
5240
5241The "set remotedebug" option is now consistent between the mips remote
5242target, remote targets using the gdb-specific protocol, UDI (AMD's
5243debug protocol for the 29k) and the 88k bug monitor. It is now an
5244integer specifying a debug level (normally 0 or 1, but 2 means more
5245debugging info for the mips target).
5246
5247* DEC Alpha native support
5248
5249GDB now works on the DEC Alpha. GCC 2.4.5 does not produce usable
5250debug info, but GDB works fairly well with the DEC compiler and should
5251work with a future GCC release. See the README file for a few
5252Alpha-specific notes.
5253
5254* Preliminary thread implementation
5255
5256GDB now has preliminary thread support for both SGI/Irix and LynxOS.
5257
5258* LynxOS native and target support for 386
5259
5260This release has been hosted on LynxOS 2.2, and also can be configured
5261to remotely debug programs running under LynxOS (see gdb/gdbserver/README
5262for details).
5263
5264* Improvements in C++ mangling/demangling.
5265
5266This release has much better g++ debugging, specifically in name
5267mangling/demangling, virtual function calls, print virtual table,
5268call methods, ...etc.
5269
5270*** Changes in GDB-4.10:
5271
5272 * User visible changes:
5273
5274Remote debugging using the GDB-specific (`target remote') protocol now
5275supports the `load' command. This is only useful if you have some
5276other way of getting the stub to the target system, and you can put it
5277somewhere in memory where it won't get clobbered by the download.
5278
5279Filename completion now works.
5280
5281When run under emacs mode, the "info line" command now causes the
5282arrow to point to the line specified. Also, "info line" prints
5283addresses in symbolic form (as well as hex).
5284
5285All vxworks based targets now support a user settable option, called
5286vxworks-timeout. This option represents the number of seconds gdb
5287should wait for responses to rpc's. You might want to use this if
5288your vxworks target is, perhaps, a slow software simulator or happens
5289to be on the far side of a thin network line.
5290
5291 * DEC alpha support
5292
5293This release contains support for using a DEC alpha as a GDB host for
5294cross debugging. Native alpha debugging is not supported yet.
5295
5296
5297*** Changes in GDB-4.9:
5298
5299 * Testsuite
5300
5301This is the first GDB release which is accompanied by a matching testsuite.
5302The testsuite requires installation of dejagnu, which should be available
5303via ftp from most sites that carry GNU software.
5304
5305 * C++ demangling
5306
5307'Cfront' style demangling has had its name changed to 'ARM' style, to
5308emphasize that it was written from the specifications in the C++ Annotated
5309Reference Manual, not necessarily to be compatible with AT&T cfront. Despite
5310disclaimers, it still generated too much confusion with users attempting to
5311use gdb with AT&T cfront.
5312
5313 * Simulators
5314
5315GDB now uses a standard remote interface to a simulator library.
5316So far, the library contains simulators for the Zilog Z8001/2, the
5317Hitachi H8/300, H8/500 and Super-H.
5318
5319 * New targets supported
5320
5321H8/300 simulator h8300-hitachi-hms or h8300hms
5322H8/500 simulator h8500-hitachi-hms or h8500hms
5323SH simulator sh-hitachi-hms or sh
5324Z8000 simulator z8k-zilog-none or z8ksim
5325IDT MIPS board over serial line mips-idt-ecoff
5326
5327Cross-debugging to GO32 targets is supported. It requires a custom
5328version of the i386-stub.c module which is integrated with the
5329GO32 memory extender.
5330
5331 * New remote protocols
5332
5333MIPS remote debugging protocol.
5334
5335 * New source languages supported
5336
5337This version includes preliminary support for Chill, a Pascal like language
5338used by telecommunications companies. Chill support is also being integrated
5339into the GNU compiler, but we don't know when it will be publically available.
5340
5341
5342*** Changes in GDB-4.8:
5343
5344 * HP Precision Architecture supported
5345
5346GDB now supports HP PA-RISC machines running HPUX. A preliminary
5347version of this support was available as a set of patches from the
5348University of Utah. GDB does not support debugging of programs
5349compiled with the HP compiler, because HP will not document their file
5350format. Instead, you must use GCC (version 2.3.2 or later) and PA-GAS
5351(as available from jaguar.cs.utah.edu:/dist/pa-gas.u4.tar.Z).
5352
5353Many problems in the preliminary version have been fixed.
5354
5355 * Faster and better demangling
5356
5357We have improved template demangling and fixed numerous bugs in the GNU style
5358demangler. It can now handle type modifiers such as `static' or `const'. Wide
5359character types (wchar_t) are now supported. Demangling of each symbol is now
5360only done once, and is cached when the symbol table for a file is read in.
5361This results in a small increase in memory usage for C programs, a moderate
5362increase in memory usage for C++ programs, and a fantastic speedup in
5363symbol lookups.
5364
5365`Cfront' style demangling still doesn't work with AT&T cfront. It was written
5366from the specifications in the Annotated Reference Manual, which AT&T's
5367compiler does not actually implement.
5368
5369 * G++ multiple inheritance compiler problem
5370
5371In the 2.3.2 release of gcc/g++, how the compiler resolves multiple
5372inheritance lattices was reworked to properly discover ambiguities. We
5373recently found an example which causes this new algorithm to fail in a
5374very subtle way, producing bad debug information for those classes.
5375The file 'gcc.patch' (in this directory) can be applied to gcc to
5376circumvent the problem. A future GCC release will contain a complete
5377fix.
5378
5379The previous G++ debug info problem (mentioned below for the gdb-4.7
5380release) is fixed in gcc version 2.3.2.
5381
5382 * Improved configure script
5383
5384The `configure' script will now attempt to guess your system type if
5385you don't supply a host system type. The old scheme of supplying a
5386host system triplet is preferable over using this. All the magic is
5387done in the new `config.guess' script. Examine it for details.
5388
5389We have also brought our configure script much more in line with the FSF's
5390version. It now supports the --with-xxx options. In particular,
5391`--with-minimal-bfd' can be used to make the GDB binary image smaller.
5392The resulting GDB will not be able to read arbitrary object file formats --
5393only the format ``expected'' to be used on the configured target system.
5394We hope to make this the default in a future release.
5395
5396 * Documentation improvements
5397
5398There's new internal documentation on how to modify GDB, and how to
5399produce clean changes to the code. We implore people to read it
5400before submitting changes.
5401
5402The GDB manual uses new, sexy Texinfo conditionals, rather than arcane
5403M4 macros. The new texinfo.tex is provided in this release. Pre-built
5404`info' files are also provided. To build `info' files from scratch,
5405you will need the latest `makeinfo' release, which will be available in
5406a future texinfo-X.Y release.
5407
5408*NOTE* The new texinfo.tex can cause old versions of TeX to hang.
5409We're not sure exactly which versions have this problem, but it has
5410been seen in 3.0. We highly recommend upgrading to TeX version 3.141
5411or better. If that isn't possible, there is a patch in
5412`texinfo/tex3patch' that will modify `texinfo/texinfo.tex' to work
5413around this problem.
5414
5415 * New features
5416
5417GDB now supports array constants that can be used in expressions typed in by
5418the user. The syntax is `{element, element, ...}'. Ie: you can now type
5419`print {1, 2, 3}', and it will build up an array in memory malloc'd in
5420the target program.
5421
5422The new directory `gdb/sparclite' contains a program that demonstrates
5423how the sparc-stub.c remote stub runs on a Fujitsu SPARClite processor.
5424
5425 * New native hosts supported
5426
5427HP/PA-RISC under HPUX using GNU tools hppa1.1-hp-hpux
5428386 CPUs running SCO Unix 3.2v4 i386-unknown-sco3.2v4
5429
5430 * New targets supported
5431
5432AMD 29k family via UDI a29k-amd-udi or udi29k
5433
5434 * New file formats supported
5435
5436BFD now supports reading HP/PA-RISC executables (SOM file format?),
5437HPUX core files, and SCO 3.2v2 core files.
5438
5439 * Major bug fixes
5440
5441Attaching to processes now works again; thanks for the many bug reports.
5442
5443We have also stomped on a bunch of core dumps caused by
5444printf_filtered("%s") problems.
5445
5446We eliminated a copyright problem on the rpc and ptrace header files
5447for VxWorks, which was discovered at the last minute during the 4.7
5448release. You should now be able to build a VxWorks GDB.
5449
5450You can now interrupt gdb while an attached process is running. This
5451will cause the attached process to stop, and give control back to GDB.
5452
5453We fixed problems caused by using too many file descriptors
5454for reading symbols from object files and libraries. This was
5455especially a problem for programs that used many (~100) shared
5456libraries.
5457
5458The `step' command now only enters a subroutine if there is line number
5459information for the subroutine. Otherwise it acts like the `next'
5460command. Previously, `step' would enter subroutines if there was
5461any debugging information about the routine. This avoids problems
5462when using `cc -g1' on MIPS machines.
5463
5464 * Internal improvements
5465
5466GDB's internal interfaces have been improved to make it easier to support
5467debugging of multiple languages in the future.
5468
5469GDB now uses a common structure for symbol information internally.
5470Minimal symbols (derived from linkage symbols in object files), partial
5471symbols (from a quick scan of debug information), and full symbols
5472contain a common subset of information, making it easier to write
5473shared code that handles any of them.
5474
5475 * New command line options
5476
5477We now accept --silent as an alias for --quiet.
5478
5479 * Mmalloc licensing
5480
5481The memory-mapped-malloc library is now licensed under the GNU Library
5482General Public License.
5483
5484*** Changes in GDB-4.7:
5485
5486 * Host/native/target split
5487
5488GDB has had some major internal surgery to untangle the support for
5489hosts and remote targets. Now, when you configure GDB for a remote
5490target, it will no longer load in all of the support for debugging
5491local programs on the host. When fully completed and tested, this will
5492ensure that arbitrary host/target combinations are possible.
5493
5494The primary conceptual shift is to separate the non-portable code in
5495GDB into three categories. Host specific code is required any time GDB
5496is compiled on that host, regardless of the target. Target specific
5497code relates to the peculiarities of the target, but can be compiled on
5498any host. Native specific code is everything else: it can only be
5499built when the host and target are the same system. Child process
5500handling and core file support are two common `native' examples.
5501
5502GDB's use of /proc for controlling Unix child processes is now cleaner.
5503It has been split out into a single module under the `target_ops' vector,
5504plus two native-dependent functions for each system that uses /proc.
5505
5506 * New hosts supported
5507
5508HP/Apollo 68k (under the BSD domain) m68k-apollo-bsd or apollo68bsd
5509386 CPUs running various BSD ports i386-unknown-bsd or 386bsd
5510386 CPUs running SCO Unix i386-unknown-scosysv322 or i386sco
5511
5512 * New targets supported
5513
5514Fujitsu SPARClite sparclite-fujitsu-none or sparclite
551568030 and CPU32 m68030-*-*, m68332-*-*
5516
5517 * New native hosts supported
5518
5519386 CPUs running various BSD ports i386-unknown-bsd or 386bsd
5520 (386bsd is not well tested yet)
5521386 CPUs running SCO Unix i386-unknown-scosysv322 or sco
5522
5523 * New file formats supported
5524
5525BFD now supports COFF files for the Zilog Z8000 microprocessor. It
5526supports reading of `a.out.adobe' object files, which are an a.out
5527format extended with minimal information about multiple sections.
5528
5529 * New commands
5530
5531`show copying' is the same as the old `info copying'.
5532`show warranty' is the same as `info warrantee'.
5533These were renamed for consistency. The old commands continue to work.
5534
5535`info handle' is a new alias for `info signals'.
5536
5537You can now define pre-command hooks, which attach arbitrary command
5538scripts to any command. The commands in the hook will be executed
5539prior to the user's command. You can also create a hook which will be
5540executed whenever the program stops. See gdb.texinfo.
5541
5542 * C++ improvements
5543
5544We now deal with Cfront style name mangling, and can even extract type
5545info from mangled symbols. GDB can automatically figure out which
5546symbol mangling style your C++ compiler uses.
5547
5548Calling of methods and virtual functions has been improved as well.
5549
5550 * Major bug fixes
5551
5552The crash that occured when debugging Sun Ansi-C compiled binaries is
5553fixed. This was due to mishandling of the extra N_SO stabs output
5554by the compiler.
5555
5556We also finally got Ultrix 4.2 running in house, and fixed core file
5557support, with help from a dozen people on the net.
5558
5559John M. Farrell discovered that the reason that single-stepping was so
5560slow on all of the Mips based platforms (primarily SGI and DEC) was
5561that we were trying to demangle and lookup a symbol used for internal
5562purposes on every instruction that was being stepped through. Changing
5563the name of that symbol so that it couldn't be mistaken for a C++
5564mangled symbol sped things up a great deal.
5565
5566Rich Pixley sped up symbol lookups in general by getting much smarter
5567about when C++ symbol mangling is necessary. This should make symbol
5568completion (TAB on the command line) much faster. It's not as fast as
5569we'd like, but it's significantly faster than gdb-4.6.
5570
5571 * AMD 29k support
5572
5573A new user controllable variable 'call_scratch_address' can
5574specify the location of a scratch area to be used when GDB
5575calls a function in the target. This is necessary because the
5576usual method of putting the scratch area on the stack does not work
5577in systems that have separate instruction and data spaces.
5578
5579We integrated changes to support the 29k UDI (Universal Debugger
5580Interface), but discovered at the last minute that we didn't have all
5581of the appropriate copyright paperwork. We are working with AMD to
5582resolve this, and hope to have it available soon.
5583
5584 * Remote interfaces
5585
5586We have sped up the remote serial line protocol, especially for targets
5587with lots of registers. It now supports a new `expedited status' ('T')
5588message which can be used in place of the existing 'S' status message.
5589This allows the remote stub to send only the registers that GDB
5590needs to make a quick decision about single-stepping or conditional
5591breakpoints, eliminating the need to fetch the entire register set for
5592each instruction being stepped through.
5593
5594The GDB remote serial protocol now implements a write-through cache for
5595registers, only re-reading the registers if the target has run.
5596
5597There is also a new remote serial stub for SPARC processors. You can
5598find it in gdb-4.7/gdb/sparc-stub.c. This was written to support the
5599Fujitsu SPARClite processor, but will run on any stand-alone SPARC
5600processor with a serial port.
5601
5602 * Configuration
5603
5604Configure.in files have become much easier to read and modify. A new
5605`table driven' format makes it more obvious what configurations are
5606supported, and what files each one uses.
5607
5608 * Library changes
5609
5610There is a new opcodes library which will eventually contain all of the
5611disassembly routines and opcode tables. At present, it only contains
5612Sparc and Z8000 routines. This will allow the assembler, debugger, and
5613disassembler (binutils/objdump) to share these routines.
5614
5615The libiberty library is now copylefted under the GNU Library General
5616Public License. This allows more liberal use, and was done so libg++
5617can use it. This makes no difference to GDB, since the Library License
5618grants all the rights from the General Public License.
5619
5620 * Documentation
5621
5622The file gdb-4.7/gdb/doc/stabs.texinfo is a (relatively) complete
5623reference to the stabs symbol info used by the debugger. It is (as far
5624as we know) the only published document on this fascinating topic. We
5625encourage you to read it, compare it to the stabs information on your
5626system, and send improvements on the document in general (to
5627bug-gdb@prep.ai.mit.edu).
5628
5629And, of course, many bugs have been fixed.
5630
5631
5632*** Changes in GDB-4.6:
5633
5634 * Better support for C++ function names
5635
5636GDB now accepts as input the "demangled form" of C++ overloaded function
5637names and member function names, and can do command completion on such names
5638(using TAB, TAB-TAB, and ESC-?). The names have to be quoted with a pair of
5639single quotes. Examples are 'func (int, long)' and 'obj::operator==(obj&)'.
5640Make use of command completion, it is your friend.
5641
5642GDB also now accepts a variety of C++ mangled symbol formats. They are
5643the GNU g++ style, the Cfront (ARM) style, and the Lucid (lcc) style.
5644You can tell GDB which format to use by doing a 'set demangle-style {gnu,
5645lucid, cfront, auto}'. 'gnu' is the default. Do a 'set demangle-style foo'
5646for the list of formats.
5647
5648 * G++ symbol mangling problem
5649
5650Recent versions of gcc have a bug in how they emit debugging information for
5651C++ methods (when using dbx-style stabs). The file 'gcc.patch' (in this
5652directory) can be applied to gcc to fix the problem. Alternatively, if you
5653can't fix gcc, you can #define GCC_MANGLE_BUG when compling gdb/symtab.c. The
5654usual symptom is difficulty with setting breakpoints on methods. GDB complains
5655about the method being non-existent. (We believe that version 2.2.2 of GCC has
5656this problem.)
5657
5658 * New 'maintenance' command
5659
5660All of the commands related to hacking GDB internals have been moved out of
5661the main command set, and now live behind the 'maintenance' command. This
5662can also be abbreviated as 'mt'. The following changes were made:
5663
5664 dump-me -> maintenance dump-me
5665 info all-breakpoints -> maintenance info breakpoints
5666 printmsyms -> maintenance print msyms
5667 printobjfiles -> maintenance print objfiles
5668 printpsyms -> maintenance print psymbols
5669 printsyms -> maintenance print symbols
5670
5671The following commands are new:
5672
5673 maintenance demangle Call internal GDB demangler routine to
5674 demangle a C++ link name and prints the result.
5675 maintenance print type Print a type chain for a given symbol
5676
5677 * Change to .gdbinit file processing
5678
5679We now read the $HOME/.gdbinit file before processing the argv arguments
5680(e.g. reading symbol files or core files). This allows global parameters to
5681be set, which will apply during the symbol reading. The ./.gdbinit is still
5682read after argv processing.
5683
5684 * New hosts supported
5685
5686Solaris-2.0 !!! sparc-sun-solaris2 or sun4sol2
5687
55241689 5688GNU/Linux support i386-unknown-linux or linux
c906108c
SS
5689
5690We are also including code to support the HP/PA running BSD and HPUX. This
5691is almost guaranteed not to work, as we didn't have time to test or build it
5692for this release. We are including it so that the more adventurous (or
5693masochistic) of you can play with it. We also had major problems with the
5694fact that the compiler that we got from HP doesn't support the -g option.
5695It costs extra.
5696
5697 * New targets supported
5698
5699Hitachi H8/300 h8300-hitachi-hms or h8300hms
5700
5701 * More smarts about finding #include files
5702
5703GDB now remembers the compilation directory for all include files, and for
5704all files from which C is generated (like yacc and lex sources). This
5705greatly improves GDB's ability to find yacc/lex sources, and include files,
5706especially if you are debugging your program from a directory different from
5707the one that contains your sources.
5708
5709We also fixed a bug which caused difficulty with listing and setting
5710breakpoints in include files which contain C code. (In the past, you had to
5711try twice in order to list an include file that you hadn't looked at before.)
5712
5713 * Interesting infernals change
5714
5715GDB now deals with arbitrary numbers of sections, where the symbols for each
5716section must be relocated relative to that section's landing place in the
5717target's address space. This work was needed to support ELF with embedded
5718stabs used by Solaris-2.0.
5719
5720 * Bug fixes (of course!)
5721
5722There have been loads of fixes for the following things:
5723 mips, rs6000, 29k/udi, m68k, g++, type handling, elf/dwarf, m88k,
5724 i960, stabs, DOS(GO32), procfs, etc...
5725
5726See the ChangeLog for details.
5727
5728*** Changes in GDB-4.5:
5729
5730 * New machines supported (host and target)
5731
5732IBM RS6000 running AIX rs6000-ibm-aix or rs6000
5733
5734SGI Irix-4.x mips-sgi-irix4 or iris4
5735
5736 * New malloc package
5737
5738GDB now uses a new memory manager called mmalloc, based on gmalloc.
5739Mmalloc is capable of handling mutiple heaps of memory. It is also
5740capable of saving a heap to a file, and then mapping it back in later.
5741This can be used to greatly speedup the startup of GDB by using a
5742pre-parsed symbol table which lives in a mmalloc managed heap. For
5743more details, please read mmalloc/mmalloc.texi.
5744
5745 * info proc
5746
5747The 'info proc' command (SVR4 only) has been enhanced quite a bit. See
5748'help info proc' for details.
5749
5750 * MIPS ecoff symbol table format
5751
5752The code that reads MIPS symbol table format is now supported on all hosts.
5753Thanks to MIPS for releasing the sym.h and symconst.h files to make this
5754possible.
5755
5756 * File name changes for MS-DOS
5757
5758Many files in the config directories have been renamed to make it easier to
5759support GDB on MS-DOSe systems (which have very restrictive file name
5760conventions :-( ). MS-DOSe host support (under DJ Delorie's GO32
5761environment) is close to working but has some remaining problems. Note
5762that debugging of DOS programs is not supported, due to limitations
5763in the ``operating system'', but it can be used to host cross-debugging.
5764
5765 * Cross byte order fixes
5766
5767Many fixes have been made to support cross debugging of Sparc and MIPS
5768targets from hosts whose byte order differs.
5769
5770 * New -mapped and -readnow options
5771
5772If memory-mapped files are available on your system through the 'mmap'
5773system call, you can use the -mapped option on the `file' or
5774`symbol-file' commands to cause GDB to write the symbols from your
5775program into a reusable file. If the program you are debugging is
5776called `/path/fred', the mapped symbol file will be `./fred.syms'.
5777Future GDB debugging sessions will notice the presence of this file,
5778and will quickly map in symbol information from it, rather than reading
5779the symbol table from the executable program. Using the '-mapped'
5780option in a GDB `file' or `symbol-file' command has the same effect as
5781starting GDB with the '-mapped' command-line option.
5782
5783You can cause GDB to read the entire symbol table immediately by using
5784the '-readnow' option with any of the commands that load symbol table
5785information (or on the GDB command line). This makes the command
5786slower, but makes future operations faster.
5787
5788The -mapped and -readnow options are typically combined in order to
5789build a `fred.syms' file that contains complete symbol information.
5790A simple GDB invocation to do nothing but build a `.syms' file for future
5791use is:
5792
5793 gdb -batch -nx -mapped -readnow programname
5794
5795The `.syms' file is specific to the host machine on which GDB is run.
5796It holds an exact image of GDB's internal symbol table. It cannot be
5797shared across multiple host platforms.
5798
5799 * longjmp() handling
5800
5801GDB is now capable of stepping and nexting over longjmp(), _longjmp(), and
5802siglongjmp() without losing control. This feature has not yet been ported to
5803all systems. It currently works on many 386 platforms, all MIPS-based
5804platforms (SGI, DECstation, etc), and Sun3/4.
5805
5806 * Solaris 2.0
5807
5808Preliminary work has been put in to support the new Solaris OS from Sun. At
5809this time, it can control and debug processes, but it is not capable of
5810reading symbols.
5811
5812 * Bug fixes
5813
5814As always, many many bug fixes. The major areas were with g++, and mipsread.
5815People using the MIPS-based platforms should experience fewer mysterious
5816crashes and trashed symbol tables.
5817
5818*** Changes in GDB-4.4:
5819
5820 * New machines supported (host and target)
5821
5822SCO Unix on i386 IBM PC clones i386-sco-sysv or i386sco
5823 (except core files)
5824BSD Reno on Vax vax-dec-bsd
5825Ultrix on Vax vax-dec-ultrix
5826
5827 * New machines supported (target)
5828
5829AMD 29000 embedded, using EBMON a29k-none-none
5830
5831 * C++ support
5832
5833GDB continues to improve its handling of C++. `References' work better.
5834The demangler has also been improved, and now deals with symbols mangled as
5835per the Annotated C++ Reference Guide.
5836
5837GDB also now handles `stabs' symbol information embedded in MIPS
5838`ecoff' symbol tables. Since the ecoff format was not easily
5839extensible to handle new languages such as C++, this appeared to be a
5840good way to put C++ debugging info into MIPS binaries. This option
5841will be supported in the GNU C compiler, version 2, when it is
5842released.
5843
5844 * New features for SVR4
5845
5846GDB now handles SVR4 shared libraries, in the same fashion as SunOS
5847shared libraries. Debugging dynamically linked programs should present
5848only minor differences from debugging statically linked programs.
5849
5850The `info proc' command will print out information about any process
5851on an SVR4 system (including the one you are debugging). At the moment,
5852it prints the address mappings of the process.
5853
5854If you bring up GDB on another SVR4 system, please send mail to
5855bug-gdb@prep.ai.mit.edu to let us know what changes were reqired (if any).
5856
5857 * Better dynamic linking support in SunOS
5858
5859Reading symbols from shared libraries which contain debugging symbols
5860now works properly. However, there remain issues such as automatic
5861skipping of `transfer vector' code during function calls, which
5862make it harder to debug code in a shared library, than to debug the
5863same code linked statically.
5864
5865 * New Getopt
5866
5867GDB is now using the latest `getopt' routines from the FSF. This
5868version accepts the -- prefix for options with long names. GDB will
5869continue to accept the old forms (-option and +option) as well.
5870Various single letter abbreviations for options have been explicity
5871added to the option table so that they won't get overshadowed in the
5872future by other options that begin with the same letter.
5873
5874 * Bugs fixed
5875
5876The `cleanup_undefined_types' bug that many of you noticed has been squashed.
5877Many assorted bugs have been handled. Many more remain to be handled.
5878See the various ChangeLog files (primarily in gdb and bfd) for details.
5879
5880
5881*** Changes in GDB-4.3:
5882
5883 * New machines supported (host and target)
5884
5885Amiga 3000 running Amix m68k-cbm-svr4 or amix
5886NCR 3000 386 running SVR4 i386-ncr-svr4 or ncr3000
5887Motorola Delta 88000 running Sys V m88k-motorola-sysv or delta88
5888
5889 * Almost SCO Unix support
5890
5891We had hoped to support:
5892SCO Unix on i386 IBM PC clones i386-sco-sysv or i386sco
5893(except for core file support), but we discovered very late in the release
5894that it has problems with process groups that render gdb unusable. Sorry
5895about that. I encourage people to fix it and post the fixes.
5896
5897 * Preliminary ELF and DWARF support
5898
5899GDB can read ELF object files on System V Release 4, and can handle
5900debugging records for C, in DWARF format, in ELF files. This support
5901is preliminary. If you bring up GDB on another SVR4 system, please
5902send mail to bug-gdb@prep.ai.mit.edu to let us know what changes were
5903reqired (if any).
5904
5905 * New Readline
5906
5907GDB now uses the latest `readline' library. One user-visible change
5908is that two tabs will list possible command completions, which previously
5909required typing M-? (meta-question mark, or ESC ?).
5910
5911 * Bugs fixed
5912
5913The `stepi' bug that many of you noticed has been squashed.
5914Many bugs in C++ have been handled. Many more remain to be handled.
5915See the various ChangeLog files (primarily in gdb and bfd) for details.
5916
5917 * State of the MIPS world (in case you wondered):
5918
5919GDB can understand the symbol tables emitted by the compilers
5920supplied by most vendors of MIPS-based machines, including DEC. These
5921symbol tables are in a format that essentially nobody else uses.
5922
5923Some versions of gcc come with an assembler post-processor called
5924mips-tfile. This program is required if you want to do source-level
5925debugging of gcc-compiled programs. I believe FSF does not ship
5926mips-tfile with gcc version 1, but it will eventually come with gcc
5927version 2.
5928
5929Debugging of g++ output remains a problem. g++ version 1.xx does not
5930really support it at all. (If you're lucky, you should be able to get
5931line numbers and stack traces to work, but no parameters or local
5932variables.) With some work it should be possible to improve the
5933situation somewhat.
5934
5935When gcc version 2 is released, you will have somewhat better luck.
5936However, even then you will get confusing results for inheritance and
5937methods.
5938
5939We will eventually provide full debugging of g++ output on
5940DECstations. This will probably involve some kind of stabs-in-ecoff
5941encapulation, but the details have not been worked out yet.
5942
5943
5944*** Changes in GDB-4.2:
5945
5946 * Improved configuration
5947
5948Only one copy of `configure' exists now, and it is not self-modifying.
5949Porting BFD is simpler.
5950
5951 * Stepping improved
5952
5953The `step' and `next' commands now only stop at the first instruction
5954of a source line. This prevents the multiple stops that used to occur
5955in switch statements, for-loops, etc. `Step' continues to stop if a
5956function that has debugging information is called within the line.
5957
5958 * Bug fixing
5959
5960Lots of small bugs fixed. More remain.
5961
5962 * New host supported (not target)
5963
5964Intel 386 PC clone running Mach i386-none-mach
5965
5966
5967*** Changes in GDB-4.1:
5968
5969 * Multiple source language support
5970
5971GDB now has internal scaffolding to handle several source languages.
5972It determines the type of each source file from its filename extension,
5973and will switch expression parsing and number formatting to match the
5974language of the function in the currently selected stack frame.
5975You can also specifically set the language to be used, with
5976`set language c' or `set language modula-2'.
5977
5978 * GDB and Modula-2
5979
5980GDB now has preliminary support for the GNU Modula-2 compiler,
5981currently under development at the State University of New York at
5982Buffalo. Development of both GDB and the GNU Modula-2 compiler will
5983continue through the fall of 1991 and into 1992.
5984
5985Other Modula-2 compilers are currently not supported, and attempting to
5986debug programs compiled with them will likely result in an error as the
5987symbol table is read. Feel free to work on it, though!
5988
5989There are hooks in GDB for strict type checking and range checking,
5990in the `Modula-2 philosophy', but they do not currently work.
5991
5992 * set write on/off
5993
5994GDB can now write to executable and core files (e.g. patch
5995a variable's value). You must turn this switch on, specify
5996the file ("exec foo" or "core foo"), *then* modify it, e.g.
5997by assigning a new value to a variable. Modifications take
5998effect immediately.
5999
6000 * Automatic SunOS shared library reading
6001
6002When you run your program, GDB automatically determines where its
6003shared libraries (if any) have been loaded, and reads their symbols.
6004The `share' command is no longer needed. This also works when
6005examining core files.
6006
6007 * set listsize
6008
6009You can specify the number of lines that the `list' command shows.
6010The default is 10.
6011
6012 * New machines supported (host and target)
6013
6014SGI Iris (MIPS) running Irix V3: mips-sgi-irix or iris
6015Sony NEWS (68K) running NEWSOS 3.x: m68k-sony-sysv or news
6016Ultracomputer (29K) running Sym1: a29k-nyu-sym1 or ultra3
6017
6018 * New hosts supported (not targets)
6019
6020IBM RT/PC: romp-ibm-aix or rtpc
6021
6022 * New targets supported (not hosts)
6023
6024AMD 29000 embedded with COFF a29k-none-coff
6025AMD 29000 embedded with a.out a29k-none-aout
6026Ultracomputer remote kernel debug a29k-nyu-kern
6027
6028 * New remote interfaces
6029
6030AMD 29000 Adapt
6031AMD 29000 Minimon
6032
6033
6034*** Changes in GDB-4.0:
6035
6036 * New Facilities
6037
6038Wide output is wrapped at good places to make the output more readable.
6039
6040Gdb now supports cross-debugging from a host machine of one type to a
6041target machine of another type. Communication with the target system
6042is over serial lines. The ``target'' command handles connecting to the
6043remote system; the ``load'' command will download a program into the
6044remote system. Serial stubs for the m68k and i386 are provided. Gdb
6045also supports debugging of realtime processes running under VxWorks,
6046using SunRPC Remote Procedure Calls over TCP/IP to talk to a debugger
6047stub on the target system.
6048
6049New CPUs supported include the AMD 29000 and Intel 960.
6050
6051GDB now reads object files and symbol tables via a ``binary file''
6052library, which allows a single copy of GDB to debug programs of multiple
6053object file types such as a.out and coff.
6054
6055There is now a GDB reference card in "doc/refcard.tex". (Make targets
6056refcard.dvi and refcard.ps are available to format it).
6057
6058
6059 * Control-Variable user interface simplified
6060
6061All variables that control the operation of the debugger can be set
6062by the ``set'' command, and displayed by the ``show'' command.
6063
6064For example, ``set prompt new-gdb=>'' will change your prompt to new-gdb=>.
6065``Show prompt'' produces the response:
6066Gdb's prompt is new-gdb=>.
6067
6068What follows are the NEW set commands. The command ``help set'' will
6069print a complete list of old and new set commands. ``help set FOO''
6070will give a longer description of the variable FOO. ``show'' will show
6071all of the variable descriptions and their current settings.
6072
6073confirm on/off: Enables warning questions for operations that are
6074 hard to recover from, e.g. rerunning the program while
6075 it is already running. Default is ON.
6076
6077editing on/off: Enables EMACS style command line editing
6078 of input. Previous lines can be recalled with
6079 control-P, the current line can be edited with control-B,
6080 you can search for commands with control-R, etc.
6081 Default is ON.
6082
6083history filename NAME: NAME is where the gdb command history
6084 will be stored. The default is .gdb_history,
6085 or the value of the environment variable
6086 GDBHISTFILE.
6087
6088history size N: The size, in commands, of the command history. The
6089 default is 256, or the value of the environment variable
6090 HISTSIZE.
6091
6092history save on/off: If this value is set to ON, the history file will
6093 be saved after exiting gdb. If set to OFF, the
6094 file will not be saved. The default is OFF.
6095
6096history expansion on/off: If this value is set to ON, then csh-like
6097 history expansion will be performed on
6098 command line input. The default is OFF.
6099
6100radix N: Sets the default radix for input and output. It can be set
6101 to 8, 10, or 16. Note that the argument to "radix" is interpreted
6102 in the current radix, so "set radix 10" is always a no-op.
6103
6104height N: This integer value is the number of lines on a page. Default
6105 is 24, the current `stty rows'' setting, or the ``li#''
6106 setting from the termcap entry matching the environment
6107 variable TERM.
6108
6109width N: This integer value is the number of characters on a line.
6110 Default is 80, the current `stty cols'' setting, or the ``co#''
6111 setting from the termcap entry matching the environment
6112 variable TERM.
6113
6114Note: ``set screensize'' is obsolete. Use ``set height'' and
6115``set width'' instead.
6116
6117print address on/off: Print memory addresses in various command displays,
6118 such as stack traces and structure values. Gdb looks
6119 more ``symbolic'' if you turn this off; it looks more
6120 ``machine level'' with it on. Default is ON.
6121
6122print array on/off: Prettyprint arrays. New convenient format! Default
6123 is OFF.
6124
6125print demangle on/off: Print C++ symbols in "source" form if on,
6126 "raw" form if off.
6127
6128print asm-demangle on/off: Same, for assembler level printouts
6129 like instructions.
6130
6131print vtbl on/off: Prettyprint C++ virtual function tables. Default is OFF.
6132
6133
6134 * Support for Epoch Environment.
6135
6136The epoch environment is a version of Emacs v18 with windowing. One
6137new command, ``inspect'', is identical to ``print'', except that if you
6138are running in the epoch environment, the value is printed in its own
6139window.
6140
6141
6142 * Support for Shared Libraries
6143
6144GDB can now debug programs and core files that use SunOS shared libraries.
6145Symbols from a shared library cannot be referenced
6146before the shared library has been linked with the program (this
6147happens after you type ``run'' and before the function main() is entered).
6148At any time after this linking (including when examining core files
6149from dynamically linked programs), gdb reads the symbols from each
6150shared library when you type the ``sharedlibrary'' command.
6151It can be abbreviated ``share''.
6152
6153sharedlibrary REGEXP: Load shared object library symbols for files
6154 matching a unix regular expression. No argument
6155 indicates to load symbols for all shared libraries.
6156
6157info sharedlibrary: Status of loaded shared libraries.
6158
6159
6160 * Watchpoints
6161
6162A watchpoint stops execution of a program whenever the value of an
6163expression changes. Checking for this slows down execution
6164tremendously whenever you are in the scope of the expression, but is
6165quite useful for catching tough ``bit-spreader'' or pointer misuse
6166problems. Some machines such as the 386 have hardware for doing this
6167more quickly, and future versions of gdb will use this hardware.
6168
6169watch EXP: Set a watchpoint (breakpoint) for an expression.
6170
6171info watchpoints: Information about your watchpoints.
6172
6173delete N: Deletes watchpoint number N (same as breakpoints).
6174disable N: Temporarily turns off watchpoint number N (same as breakpoints).
6175enable N: Re-enables watchpoint number N (same as breakpoints).
6176
6177
6178 * C++ multiple inheritance
6179
6180When used with a GCC version 2 compiler, GDB supports multiple inheritance
6181for C++ programs.
6182
6183 * C++ exception handling
6184
6185Gdb now supports limited C++ exception handling. Besides the existing
6186ability to breakpoint on an exception handler, gdb can breakpoint on
6187the raising of an exception (before the stack is peeled back to the
6188handler's context).
6189
6190catch FOO: If there is a FOO exception handler in the dynamic scope,
6191 set a breakpoint to catch exceptions which may be raised there.
6192 Multiple exceptions (``catch foo bar baz'') may be caught.
6193
6194info catch: Lists all exceptions which may be caught in the
6195 current stack frame.
6196
6197
6198 * Minor command changes
6199
6200The command ``call func (arg, arg, ...)'' now acts like the print
6201command, except it does not print or save a value if the function's result
6202is void. This is similar to dbx usage.
6203
6204The ``up'' and ``down'' commands now always print the frame they end up
6205at; ``up-silently'' and `down-silently'' can be used in scripts to change
6206frames without printing.
6207
6208 * New directory command
6209
6210'dir' now adds directories to the FRONT of the source search path.
6211The path starts off empty. Source files that contain debug information
6212about the directory in which they were compiled can be found even
6213with an empty path; Sun CC and GCC include this information. If GDB can't
6214find your source file in the current directory, type "dir .".
6215
6216 * Configuring GDB for compilation
6217
6218For normal use, type ``./configure host''. See README or gdb.texinfo
6219for more details.
6220
6221GDB now handles cross debugging. If you are remotely debugging between
6222two different machines, type ``./configure host -target=targ''.
6223Host is the machine where GDB will run; targ is the machine
6224where the program that you are debugging will run.
This page took 1.136385 seconds and 4 git commands to generate.