diff options
Diffstat (limited to 'gdb/NEWS')
| -rw-r--r-- | gdb/NEWS | 253 |
1 files changed, 250 insertions, 3 deletions
@@ -1,7 +1,116 @@ What has changed in GDB? (Organized release by release) -*** Changes since GDB 16 +*** Changes since GDB 17 + +* Support for .gdb_index sections with version less than 7 has been + removed. + +* GDB now accepts --no-escape-args as an alternative to --args on the + command line. GDB will not escape special shell characters within + arguments after --no-escape-args. + +* gdbserver now accepts --no-escape-args as a command line flag. When + this flag is used gdbserver will not escape special shell characters + within the inferior arguments. + +* The add-inferior, clone-inferior, and MI -add-inferior commands will + now give a warning, and create the new inferior without a + connection, when the current inferior's connection, at the time the + command is given, is unshareable. For example, the core-file target + cannot be shared between inferiors, nor can the Window native + target. These targets could never really be shared. Attempting to + share them would usually lead to GDB crashing. GDB now prevents + this invalid sharing. + +* When connecting to a remote server, if the server supports the new + qExecAndArgs packet, then GDB will copy the argument string from the + server and update the 'args' setting, as if 'set args ...' had been + used. This means that the arguments are visible from GDB using + 'show args', and that, if using the extended-remote protocol, + subsequent runs of the inferior will use the same arguments as the + first run. + +* New targets + +GNU/Linux/MicroBlaze (gdbserver) microblazeel-*linux* + +* New commands + +maintenance test-remote-args ARGS + Test splitting and joining of inferior arguments ARGS as they would + be split and joined when being passed to a remote target. + +* Changed commands + +maintenance info program-spaces + This command no longer displays the core file name. + +info inferiors + If an inferior has a core file loaded, then this will be displayed + as an additional line under the inferior's table entry in the + output. + +* Changed remote packets + +single-inf-arg in qSupported + The new single-inf-arg feature within the qSupported packet allows + GDB to inform the stub that it would like to send the inferior + arguments as a single string within the vRun packet. The stub can + reply with the single-inf-arg feature to indicate that it is able to + accept arguments as a single string. + +* New remote packets + +qExecAndArgs + This packet returns the executable filename and argument string with + which the server was started. If no such information was given to + the server then this is reflected in the reply. + +* Python API + + ** New class gdb.Style for representing styles, a collection of + foreground and background gdb.Color objects, and an intensity. + + ** New constants gdb.INTENSITY_NORMAL, gdb.INTENSITY_BOLD, and + gdb.INTENSITY_DIM for use with gdb.Style when representing + intensities. + + ** New gdb.StyleParameterSet for creating custom style settings. + Use gdb.StyleParameterSet(NAME) to create 'set style NAME ...' + and 'show style NAME ...' parameters. + + ** The gdb.write() function now takes an additional, optional, + 'style' argument, which can be used to style the output. + + ** New gdb.Corefile class which represents a loaded core file. This + has an attribute Corefile.filename, the file name of the loaded + core file, and a method Corefile.is_valid(), which returns False + when a Corefile object becomes invalid (e.g. when the core file + is unloaded). There is also Corefile.mapped_files() which + returns a list of CorefileMappedFile objects, representing files + that were mapped into the core file when it was created. + + ** New gdb.CorefileMappedFile type representing a file that was + mapped when the core file was created. Has read-only attributes + filename (string), build_id (string), is_main_executable + (boolean), and regions (list of CorefileMappedFileRegion objects). + + ** New gdb.CorefileMappedFileRegion type, which represents a mapped + region of a file (see gdb.CorefileMappedFile above). Has + read-only attributes start, end, and file_offset. + + ** New Inferior.corefile attribute. This read only attribute + contains the gdb.Corefile object if a core file is loaded into + the inferior, otherwise, this contains None. + +*** Changes in GDB 17 + +* Debugging Linux programs that use x86-64 or x86-64 with 32-bit pointer + size (X32) Shadow Stacks are now supported. + +* Support for the shadow stack pointer register on x86-64 or x86-64 with + 32-bit pointer size (X32) GNU/Linux. * Debugger Adapter Protocol changes @@ -35,11 +144,31 @@ a -h or --help option, which prints each options and a brief description. -* On systems that support linkage namespaces, the output of the command +* The gcore script now has a -g option that lets you specify the GDB + binary invoked by gcore. + +* On systems that support linker namespaces, the output of the command "info sharedlibraries" may add one more column, NS, which identifies the namespace into which the library was loaded, if more than one namespace is active. +* New built-in convenience variables $linker_namespace_count and + $_linker_namespace. These show the number of active linker + namespaces, and the namespace to which the current location belongs to. + In systems that don't support linker namespaces, or if the inferior hasn't + started yet, these always return the integer 0. + +* Add record full support for rv64gc architectures + +* Debugging Linux programs that use AArch64 Guarded Control Stacks is now + supported. + +* New "--binary-output" command line option instructs GDB to set the + translation mode of its stdout/stderr to binary mode. This disables + Line Feed translation. MS-Windows only. + +* The "catch syscall" command now works on riscv*-linux* targets. + * New commands maintenance check psymtabs @@ -48,12 +177,33 @@ maintenance check psymtabs maintenance check symtabs Renamed from maintenance check-symtabs +maintenance canonicalize + Show the canonical form of a C++ name. + set riscv numeric-register-names on|off show riscv numeric-register-names Controls whether GDB refers to risc-v registers by their numeric names (e.g 'x1') or their abi names (e.g. 'ra'). Defaults to 'off', matching the old behaviour (abi names). +set style emoji on|off|auto +show style emoji + Controls whether GDB can display emoji. The default is "auto", + which means emoji will be displayed in some situations when + the host charset is UTF-8. + +set style warning-prefix STRING +set style error-prefix STRING + These commands control the prefix that is printed before warnings + and errors, respectively. This functionality is intended for use + with emoji display, and so the prefixes are only displayed if emoji + styling is enabled. + +info linker-namespaces +info linker-namespaces [[N]] + Print information about the given linker namespace (identified as N), + or about all the namespaces if no argument is given. + * Changed commands info sharedlibrary @@ -61,8 +211,42 @@ info sharedlibrary command are now for the full memory range allocated to the shared library. +info threads [-gid] [-stopped] [-running] [ID]... + If no threads match the given ID(s) or filter options, GDB now prints + + No threads matched. + + without printing the provided arguments. The newly added '-stopped' + option makes GDB list the stopped threads only. Similarly, + '-running' makes GDB list the running threads only. If both options + are given together, both stopped and running threads are listed. + These new flags can be useful to get a reduced list when there is a + large number of threads. + +* GDB-internal Thread Local Storage (TLS) support + + ** Linux targets for the x86_64, aarch64, ppc64, s390x, and riscv + architectures now have GDB-internal support for TLS address + lookup in addition to that traditionally provided by the + libthread_db library. This internal support works for programs + linked against either the GLIBC or MUSL C libraries. For + programs linked against MUSL, this new internal support provides + new debug functionality, allowing access to TLS variables, due to + the fact that MUSL does not implement the libthread_db library. + Internal TLS support is also useful in cross-debugging + situations, debugging statically linked binaries, and debugging + programs linked against GLIBC 2.33 and earlier, but which are not + linked against libpthread. + + ** The command 'maint set force-internal-tls-address-lookup on' may + be used to force the internal TLS lookup mechanisms to be used. + Otherwise, TLS lookup via libthread_db will still be preferred, + when available. + * Python API + ** GDB no longer supports Python versions less than 3.4. + ** New class gdb.Color for dealing with colors. ** New constant gdb.PARAM_COLOR represents color type of a @@ -79,6 +263,27 @@ info sharedlibrary when output is going to standard output, and False when output is going to a string. + ** Setting the documentation string (__doc__) of a gdb.Parameter + sub-class to the empty string, means GDB will only display the + set_doc or show_doc strings in the set/show help output. + + ** New gdb.ParameterPrefix class. This can be used to create 'set' + and 'show' gdb.Command prefixes, suitable for use with new + gdb.Parameters. + + ** Prefix commands (gdb.Command sub-classes) that don't have an + invoke method will now behave like builtin prefix commands when + invoked without a sub-command name. This means printing the help + text for all sub-commands, unless the prefix command is a 'show' + command, in which case the value of all sub-commands is printed. + + ** New gdb.warning() function that takes a string and prints it as a + warning, with GDB's standard 'warning' prefix. + + ** New attribute gdb.Value.is_unavailable, this checks for + unavailability like gdb.Value.is_optimized_out checks for + optimized out values. + * Guile API ** New type <gdb:color> for dealing with colors. @@ -86,6 +291,17 @@ info sharedlibrary ** New constant PARAM_COLOR represents color type of a value of a <gdb:parameter> object. Parameter's value is <gdb::color> instance. + ** Eliding the #:doc string from make-parameter now means that GDB + will use a default documentation string. Setting #:doc to the + empty string for make-parameter means GDB will only display the + #:set_doc or #:show_doc strings in the set/show help output. + + ** Prefix commands (using make-command) that don't have a #:invoke + property will now behave like builtin prefix commands when + invoked without a sub-command name. This means printing the help + text for all sub-commands, unless the prefix command is a 'show' + command, in which case the value of all sub-commands is printed. + * New remote packets binary-upload in qSupported reply @@ -94,6 +310,11 @@ binary-upload in qSupported reply stub doesn't report this feature supported, then GDB will not use the 'x' packet. +vFile:lstat + Return information about files on the remote system. Like + vFile:stat but if the filename is a symbolic link, return + information about the link itself, the file the link refers to. + * Changed remote packets qXfer:threads:read @@ -102,6 +323,11 @@ qXfer:threads:read should print as the target ID of the thread, for example in the "info threads" command or when switching to the thread. +vFile:stat + Previously, gdbserver incorrectly implemented this packet using + lstat rather than stat. This has now been corrected. The + documentation has also been clarified. + * MI changes ** The =library-unloaded event now includes the 'ranges' field, which @@ -117,10 +343,31 @@ qXfer:threads:read * Support for stabs debugging format and the a.out/dbx object format is deprecated, and will be removed in GDB 18. +* Configure changes + +--enable-binary-file-formats=[FORMAT,...] +--enable-binary-file-formats=all + A user can now decide to only compile support for certain file formats. + The available formats at this point are: dbx, coff, xcoff, elf, mach-o + and mips. Some targets require specific file formats to be available, + and in such cases, the configure script will warn the user and add + support anyway. By default, all formats will be compiled in, to + continue the behavior from before adding the switch. + * A new configure option was added, allowing support for the compile subsystem to be disabled at configure time, in the form of --disable-gdb-compile. +* A new configure option was added, allowing support for DWARF debug + information to be disabled at configure time. The flag is + --disable-gdb-dwarf-support. + +* A new configure option was added, allowing support for mdebug/ecoff + debug information to be disabled at configure time. The flag to do + that is --disable-gdb-mdebug-support. + +* The Alpha target now supports target descriptions. + *** Changes in GDB 16 * Support for Nios II targets has been removed as this architecture @@ -7496,7 +7743,7 @@ for DW_OP_piece is still missing). A number of long standing bugs that caused GDB to die while starting a Java application have been fixed. GDB's Java support is now -considered "useable". +considered "usable". * GNU/Linux support for fork, vfork, and exec. |