forked from Imagelibrary/binutils-gdb
e88f8e00b1
After allowing a location description to be placed on a DWARF stack, in an effort to achieve a full composability of the DWARF expression, it is necessary to enable forming of a nested composite location descriptions. To be able do this, a new operation DW_OP_LLVM_piece_end needs to be introduced, along with some additional rules on the way how the composite location description is formed using the existing DW_OP_piece and DW_OP_bit_piece operations. These new rules are fully compatible with the composite forming rules from the DWARF 5 standard. More details on the new operation and added rules can be found here: https://llvm.org/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.html The dwarf_composite also needed to be modified to make a distinction between completed composite locationd description and not completed one. This also mean that some DWARF expression operations can duplicate a composite location description that is not completed and end up with more then one different composite location description on the stack. To be able to do this, classes that derive from a DWARF entry class need to have a clone method. gdb/ChangeLog: * compile/compile-loc2c.c (compute_stack_depth_worker): Add new DW_OP_LLVM_piece_end operation support. * dwarf2/expr.c (dwarf_composite::m_completed): New data member. (dwarf_entry::dwarf_entry): New copy constructor. (dwarf_location::dwarf_location): New copy constructor. (dwarf_value::dwarf_value): New copy constructor. (dwarf_undefined::dwarf_undefined): New copy constructor. (dwarf_memory::dwarf_memory): New copy constructor. (dwarf_register::dwarf_register): New copy constructor. (dwarf_implicit::dwarf_implicit): New method. (dwarf_implicit_pointer::dwarf_implicit_pointer): New copy constructor. (dwarf_composite::dwarf_composite): New copy constructor. (dwarf_entry::clone): New method. (dwarf_location::clone): New method. (dwarf_value::clone): New method. (dwarf_undefined::clone): New method. (dwarf_memory::clone): New method. (dwarf_register::clone): New method. (dwarf_implicit::clone): New method. (dwarf_implicit_pointer::clone): New method. (dwarf_composite::clone): New method. (dwarf_composite::is_completed): New method. (dwarf_composite::set_completed): New method. (dwarf_expr_context::add_piece): Use new composite forming rules. (dwarf_expr_context::execute_stack_op): Add new DW_OP_LLVM_piece_end operation support. * dwarf2/loc.c (dwarf2_get_symbol_read_needs): Add new DW_OP_LLVM_piece_end operation support. include/ChangeLog: * dwarf2.def (DW_OP_DUP): Add new DW_OP_LLVM_piece_end enumeration. gdb/testsuite/ChangeLog: * gdb.dwarf2/dw2-llvm-piece-end.exp: New test.
README for GNU development tools This directory contains various GNU compilers, assemblers, linkers, debuggers, etc., plus their support routines, definitions, and documentation. If you are receiving this as part of a GDB release, see the file gdb/README. If with a binutils release, see binutils/README; if with a libg++ release, see libg++/README, etc. That'll give you info about this package -- supported targets, how to use it, how to report bugs, etc. It is now possible to automatically configure and build a variety of tools with one command. To build all of the tools contained herein, run the ``configure'' script here, e.g.: ./configure make To install them (by default in /usr/local/bin, /usr/local/lib, etc), then do: make install (If the configure script can't determine your type of computer, give it the name as an argument, for instance ``./configure sun4''. You can use the script ``config.sub'' to test whether a name is recognized; if it is, config.sub translates it to a triplet specifying CPU, vendor, and OS.) If you have more than one compiler on your system, it is often best to explicitly set CC in the environment before running configure, and to also set CC when running make. For example (assuming sh/bash/ksh): CC=gcc ./configure make A similar example using csh: setenv CC gcc ./configure make Much of the code and documentation enclosed is copyright by the Free Software Foundation, Inc. See the file COPYING or COPYING.LIB in the various directories, for a description of the GNU General Public License terms under which you can copy the files. REPORTING BUGS: Again, see gdb/README, binutils/README, etc., for info on where and how to report problems.