Files
binutils-gdb/gdb/dwarf2/tag.h
Tom Tromey 486bc5ac81 Rewrite the .gdb_index reader
This patch rewrites the .gdb_index reader to create the same data
structures that are created by the cooked indexer and the .debug_names
reader.

This is done in support of this series; but also because, from what I
can tell, the "templates.exp" change didn't really work properly with
this reader.

In addition to fixing that problem, this patch removes a lot of code.

Implementing this required a couple of hacks, as .gdb_index does not
contain all the information that's used by the cooked index
implementation.

* The index-searching code likes to differentiate between the various
  DWARF tags when matching, but .gdb_index lumps many things into a
  single "other" category.  To handle this, we introduce a phony tag
  that's used so that the match method can match on multiple domains.

* Similarly, .gdb_index doesn't distinguish between the type and
  struct domains, so another phony tag is used for this.

* The reader must attempt to guess the language of various symbols.
  This is somewhat finicky.  "Plain" (unqualified) symbols are marked
  as language_unknown and then a couple of hacks are used to handle
  these -- one in expand_symtabs_matching and another when recognizing
  "main".

For what it's worth, I consider .gdb_index to be near the end of its
life.  While .debug_names is not perfect -- we found a number of bugs
in the standard while implementing it -- it is better than .gdb_index
and also better documented.

After this patch, we could conceivably remove dwarf_scanner_base.
However, I have not done this.

Finally, this patch also changes this reader to dump the content of
the index, as the other DWARF readers do.  This can be handy when
debugging gdb.

Acked-By: Simon Marchi <simon.marchi@efficios.com>
Bug: https://sourceware.org/bugzilla/show_bug.cgi?id=33316
2025-09-10 16:05:28 -06:00

161 lines
4.3 KiB
C

/* Tag attributes
Copyright (C) 2022-2025 Free Software Foundation, Inc.
This file is part of GDB.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. */
#ifndef GDB_DWARF2_TAG_H
#define GDB_DWARF2_TAG_H
#include "dwarf2.h"
#include "symtab.h"
#include "read-gdb-index.h"
/* Return true if TAG represents a type, false otherwise. */
static inline bool
tag_is_type (dwarf_tag tag)
{
switch (tag)
{
case DW_TAG_array_type:
case DW_TAG_class_type:
case DW_TAG_enumeration_type:
case DW_TAG_pointer_type:
case DW_TAG_reference_type:
case DW_TAG_string_type:
case DW_TAG_structure_type:
case DW_TAG_subroutine_type:
case DW_TAG_typedef:
case DW_TAG_union_type:
case DW_TAG_ptr_to_member_type:
case DW_TAG_set_type:
case DW_TAG_subrange_type:
case DW_TAG_base_type:
case DW_TAG_const_type:
case DW_TAG_packed_type:
case DW_TAG_template_type_param:
case DW_TAG_volatile_type:
case DW_TAG_restrict_type:
case DW_TAG_interface_type:
case DW_TAG_namespace:
case DW_TAG_unspecified_type:
case DW_TAG_shared_type:
case DW_TAG_rvalue_reference_type:
case DW_TAG_coarray_type:
case DW_TAG_dynamic_type:
case DW_TAG_atomic_type:
case DW_TAG_immutable_type:
return true;
default:
return false;
}
}
/* Return true if the given DWARF tag matches the specified search
domain flags. LANG may affect the result, due to the "C++ tag
hack". */
static inline bool
tag_matches_domain (dwarf_tag tag, domain_search_flags search, language lang)
{
domain_search_flags flags = 0;
switch (tag)
{
case DW_TAG_variable:
case DW_TAG_enumerator:
case DW_TAG_constant:
flags = SEARCH_VAR_DOMAIN;
break;
case DW_TAG_subprogram:
case DW_TAG_entry_point:
flags = SEARCH_FUNCTION_DOMAIN;
break;
case DW_TAG_structure_type:
case DW_TAG_class_type:
case DW_TAG_union_type:
case DW_TAG_enumeration_type:
{
if (lang == language_c
|| lang == language_objc
|| lang == language_opencl
|| lang == language_minimal)
flags = SEARCH_STRUCT_DOMAIN;
else if (lang == language_cplus)
flags = SEARCH_STRUCT_DOMAIN | SEARCH_TYPE_DOMAIN;
else
flags = SEARCH_TYPE_DOMAIN;
}
break;
case DW_TAG_imported_declaration:
/* DW_TAG_imported_declaration isn't necessarily a type, but the
scanner doesn't track the referent, and the full reader
also currently puts it in TYPE_DOMAIN. */
case DW_TAG_padding:
case DW_TAG_array_type:
case DW_TAG_pointer_type:
case DW_TAG_reference_type:
case DW_TAG_string_type:
case DW_TAG_subroutine_type:
case DW_TAG_ptr_to_member_type:
case DW_TAG_set_type:
case DW_TAG_subrange_type:
case DW_TAG_base_type:
case DW_TAG_const_type:
case DW_TAG_packed_type:
case DW_TAG_template_type_param:
case DW_TAG_volatile_type:
case DW_TAG_restrict_type:
case DW_TAG_interface_type:
case DW_TAG_namespace:
case DW_TAG_unspecified_type:
case DW_TAG_shared_type:
case DW_TAG_rvalue_reference_type:
case DW_TAG_coarray_type:
case DW_TAG_dynamic_type:
case DW_TAG_atomic_type:
case DW_TAG_immutable_type:
case DW_TAG_typedef:
flags = SEARCH_TYPE_DOMAIN;
break;
case DW_TAG_label:
flags = SEARCH_LABEL_DOMAIN;
break;
case DW_TAG_module:
if (lang == language_ada)
flags = SEARCH_TYPE_DOMAIN;
else
flags = SEARCH_MODULE_DOMAIN;
break;
case DW_TAG_GDB_INDEX_OTHER:
flags = SEARCH_MODULE_DOMAIN | SEARCH_TYPE_DOMAIN;
break;
case DW_TAG_GDB_INDEX_TYPE:
flags = SEARCH_STRUCT_DOMAIN | SEARCH_TYPE_DOMAIN;
break;
}
return (flags & search) != 0;
}
#endif /* GDB_DWARF2_TAG_H */