1 /* DWARF debugging format support for GDB.
2 Copyright (C) 1991, 1992 Free Software Foundation, Inc.
3 Written by Fred Fish at Cygnus Support. Portions based on dbxread.c,
4 mipsread.c, coffread.c, and dwarfread.c from a Data General SVR4 gdb port.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
24 FIXME: Figure out how to get the frame pointer register number in the
25 execution environment of the target. Remove R_FP kludge
27 FIXME: Add generation of dependencies list to partial symtab code.
29 FIXME: Resolve minor differences between what information we put in the
30 partial symbol table and what dbxread puts in. For example, we don't yet
31 put enum constants there. And dbxread seems to invent a lot of typedefs
32 we never see. Use the new printpsym command to see the partial symbol table
35 FIXME: Figure out a better way to tell gdb about the name of the function
36 contain the user's entry point (I.E. main())
38 FIXME: See other FIXME's and "ifdef 0" scattered throughout the code for
39 other things to work on, if you get bored. :-)
49 #include "libbfd.h" /* FIXME Secret Internal BFD stuff (bfd_read) */
50 #include "elf/dwarf.h"
53 #include "expression.h" /* Needed for enum exp_opcode in language.h, sigh... */
55 #include "complaints.h"
59 #include <sys/types.h>
65 /* FIXME -- convert this to SEEK_SET a la POSIX, move to config files. */
70 /* Some macros to provide DIE info for complaints. */
72 #define DIE_ID (curdie!=NULL ? curdie->die_ref : 0)
73 #define DIE_NAME (curdie!=NULL && curdie->at_name!=NULL) ? curdie->at_name : ""
75 /* Complaints that can be issued during DWARF debug info reading. */
77 struct complaint no_bfd_get_N
=
79 "DIE @ 0x%x \"%s\", no bfd support for %d byte data object", 0, 0
82 struct complaint malformed_die
=
84 "DIE @ 0x%x \"%s\", malformed DIE, bad length (%d bytes)", 0, 0
87 struct complaint bad_die_ref
=
89 "DIE @ 0x%x \"%s\", reference to DIE (0x%x) outside compilation unit", 0, 0
92 struct complaint unknown_attribute_form
=
94 "DIE @ 0x%x \"%s\", unknown attribute form (0x%x)", 0, 0
97 struct complaint unknown_attribute_length
=
99 "DIE @ 0x%x \"%s\", unknown attribute length, skipped remaining attributes", 0, 0
102 struct complaint unexpected_fund_type
=
104 "DIE @ 0x%x \"%s\", unexpected fundamental type 0x%x", 0, 0
107 struct complaint unknown_type_modifier
=
109 "DIE @ 0x%x \"%s\", unknown type modifier %u", 0, 0
112 struct complaint volatile_ignored
=
114 "DIE @ 0x%x \"%s\", type modifier 'volatile' ignored", 0, 0
117 struct complaint const_ignored
=
119 "DIE @ 0x%x \"%s\", type modifier 'const' ignored", 0, 0
122 struct complaint botched_modified_type
=
124 "DIE @ 0x%x \"%s\", botched modified type decoding (mtype 0x%x)", 0, 0
127 struct complaint op_deref2
=
129 "DIE @ 0x%x \"%s\", OP_DEREF2 address 0x%x not handled", 0, 0
132 struct complaint op_deref4
=
134 "DIE @ 0x%x \"%s\", OP_DEREF4 address 0x%x not handled", 0, 0
137 struct complaint basereg_not_handled
=
139 "DIE @ 0x%x \"%s\", BASEREG %d not handled", 0, 0
142 struct complaint dup_user_type_allocation
=
144 "DIE @ 0x%x \"%s\", internal error: duplicate user type allocation", 0, 0
147 struct complaint dup_user_type_definition
=
149 "DIE @ 0x%x \"%s\", internal error: duplicate user type definition", 0, 0
152 struct complaint missing_tag
=
154 "DIE @ 0x%x \"%s\", missing class, structure, or union tag", 0, 0
157 struct complaint bad_array_element_type
=
159 "DIE @ 0x%x \"%s\", bad array element type attribute 0x%x", 0, 0
162 struct complaint subscript_data_items
=
164 "DIE @ 0x%x \"%s\", can't decode subscript data items", 0, 0
167 struct complaint unhandled_array_subscript_format
=
169 "DIE @ 0x%x \"%s\", array subscript format 0x%x not handled yet", 0, 0
172 struct complaint unknown_array_subscript_format
=
174 "DIE @ 0x%x \"%s\", unknown array subscript format %x", 0, 0
177 struct complaint not_row_major
=
179 "DIE @ 0x%x \"%s\", array not row major; not handled correctly", 0, 0
182 #ifndef R_FP /* FIXME */
183 #define R_FP 14 /* Kludge to get frame pointer register number */
186 typedef unsigned int DIE_REF
; /* Reference to a DIE */
189 #define GCC_PRODUCER "GNU C "
192 #ifndef GPLUS_PRODUCER
193 #define GPLUS_PRODUCER "GNU C++ "
197 #define LCC_PRODUCER "NCR C/C++"
200 #ifndef CHILL_PRODUCER
201 #define CHILL_PRODUCER "GNU Chill "
204 /* Flags to target_to_host() that tell whether or not the data object is
205 expected to be signed. Used, for example, when fetching a signed
206 integer in the target environment which is used as a signed integer
207 in the host environment, and the two environments have different sized
208 ints. In this case, *somebody* has to sign extend the smaller sized
211 #define GET_UNSIGNED 0 /* No sign extension required */
212 #define GET_SIGNED 1 /* Sign extension required */
214 /* Defines for things which are specified in the document "DWARF Debugging
215 Information Format" published by UNIX International, Programming Languages
216 SIG. These defines are based on revision 1.0.0, Jan 20, 1992. */
218 #define SIZEOF_DIE_LENGTH 4
219 #define SIZEOF_DIE_TAG 2
220 #define SIZEOF_ATTRIBUTE 2
221 #define SIZEOF_FORMAT_SPECIFIER 1
222 #define SIZEOF_FMT_FT 2
223 #define SIZEOF_LINETBL_LENGTH 4
224 #define SIZEOF_LINETBL_LINENO 4
225 #define SIZEOF_LINETBL_STMT 2
226 #define SIZEOF_LINETBL_DELTA 4
227 #define SIZEOF_LOC_ATOM_CODE 1
229 #define FORM_FROM_ATTR(attr) ((attr) & 0xF) /* Implicitly specified */
231 /* Macros that return the sizes of various types of data in the target
234 FIXME: Currently these are just compile time constants (as they are in
235 other parts of gdb as well). They need to be able to get the right size
236 either from the bfd or possibly from the DWARF info. It would be nice if
237 the DWARF producer inserted DIES that describe the fundamental types in
238 the target environment into the DWARF info, similar to the way dbx stabs
239 producers produce information about their fundamental types. */
241 #define TARGET_FT_POINTER_SIZE(objfile) (TARGET_PTR_BIT / TARGET_CHAR_BIT)
242 #define TARGET_FT_LONG_SIZE(objfile) (TARGET_LONG_BIT / TARGET_CHAR_BIT)
244 /* The Amiga SVR4 header file <dwarf.h> defines AT_element_list as a
245 FORM_BLOCK2, and this is the value emitted by the AT&T compiler.
246 However, the Issue 2 DWARF specification from AT&T defines it as
247 a FORM_BLOCK4, as does the latest specification from UI/PLSIG.
248 For backwards compatibility with the AT&T compiler produced executables
249 we define AT_short_element_list for this variant. */
251 #define AT_short_element_list (0x00f0|FORM_BLOCK2)
253 /* External variables referenced. */
255 extern int info_verbose
; /* From main.c; nonzero => verbose */
256 extern char *warning_pre_print
; /* From utils.c */
258 /* The DWARF debugging information consists of two major pieces,
259 one is a block of DWARF Information Entries (DIE's) and the other
260 is a line number table. The "struct dieinfo" structure contains
261 the information for a single DIE, the one currently being processed.
263 In order to make it easier to randomly access the attribute fields
264 of the current DIE, which are specifically unordered within the DIE,
265 each DIE is scanned and an instance of the "struct dieinfo"
266 structure is initialized.
268 Initialization is done in two levels. The first, done by basicdieinfo(),
269 just initializes those fields that are vital to deciding whether or not
270 to use this DIE, how to skip past it, etc. The second, done by the
271 function completedieinfo(), fills in the rest of the information.
273 Attributes which have block forms are not interpreted at the time
274 the DIE is scanned, instead we just save pointers to the start
275 of their value fields.
277 Some fields have a flag <name>_p that is set when the value of the
278 field is valid (I.E. we found a matching attribute in the DIE). Since
279 we may want to test for the presence of some attributes in the DIE,
280 such as AT_low_pc, without restricting the values of the field,
281 we need someway to note that we found such an attribute.
288 char * die
; /* Pointer to the raw DIE data */
289 unsigned long die_length
; /* Length of the raw DIE data */
290 DIE_REF die_ref
; /* Offset of this DIE */
291 unsigned short die_tag
; /* Tag for this DIE */
292 unsigned long at_padding
;
293 unsigned long at_sibling
;
296 unsigned short at_fund_type
;
297 BLOCK
* at_mod_fund_type
;
298 unsigned long at_user_def_type
;
299 BLOCK
* at_mod_u_d_type
;
300 unsigned short at_ordering
;
301 BLOCK
* at_subscr_data
;
302 unsigned long at_byte_size
;
303 unsigned short at_bit_offset
;
304 unsigned long at_bit_size
;
305 BLOCK
* at_element_list
;
306 unsigned long at_stmt_list
;
307 unsigned long at_low_pc
;
308 unsigned long at_high_pc
;
309 unsigned long at_language
;
310 unsigned long at_member
;
311 unsigned long at_discr
;
312 BLOCK
* at_discr_value
;
313 BLOCK
* at_string_length
;
316 unsigned long at_start_scope
;
317 unsigned long at_stride_size
;
318 unsigned long at_src_info
;
319 char * at_prototyped
;
320 unsigned int has_at_low_pc
:1;
321 unsigned int has_at_stmt_list
:1;
322 unsigned int has_at_byte_size
:1;
323 unsigned int short_element_list
:1;
326 static int diecount
; /* Approximate count of dies for compilation unit */
327 static struct dieinfo
*curdie
; /* For warnings and such */
329 static char *dbbase
; /* Base pointer to dwarf info */
330 static int dbsize
; /* Size of dwarf info in bytes */
331 static int dbroff
; /* Relative offset from start of .debug section */
332 static char *lnbase
; /* Base pointer to line section */
333 static int isreg
; /* Kludge to identify register variables */
334 static int offreg
; /* Kludge to identify basereg references */
336 /* This value is added to each symbol value. FIXME: Generalize to
337 the section_offsets structure used by dbxread (once this is done,
338 pass the appropriate section number to end_symtab). */
339 static CORE_ADDR baseaddr
; /* Add to each symbol value */
341 /* The section offsets used in the current psymtab or symtab. FIXME,
342 only used to pass one value (baseaddr) at the moment. */
343 static struct section_offsets
*base_section_offsets
;
345 /* Each partial symbol table entry contains a pointer to private data for the
346 read_symtab() function to use when expanding a partial symbol table entry
347 to a full symbol table entry. For DWARF debugging info, this data is
348 contained in the following structure and macros are provided for easy
349 access to the members given a pointer to a partial symbol table entry.
351 dbfoff Always the absolute file offset to the start of the ".debug"
352 section for the file containing the DIE's being accessed.
354 dbroff Relative offset from the start of the ".debug" access to the
355 first DIE to be accessed. When building the partial symbol
356 table, this value will be zero since we are accessing the
357 entire ".debug" section. When expanding a partial symbol
358 table entry, this value will be the offset to the first
359 DIE for the compilation unit containing the symbol that
360 triggers the expansion.
362 dblength The size of the chunk of DIE's being examined, in bytes.
364 lnfoff The absolute file offset to the line table fragment. Ignored
365 when building partial symbol tables, but used when expanding
366 them, and contains the absolute file offset to the fragment
367 of the ".line" section containing the line numbers for the
368 current compilation unit.
372 file_ptr dbfoff
; /* Absolute file offset to start of .debug section */
373 int dbroff
; /* Relative offset from start of .debug section */
374 int dblength
; /* Size of the chunk of DIE's being examined */
375 file_ptr lnfoff
; /* Absolute file offset to line table fragment */
378 #define DBFOFF(p) (((struct dwfinfo *)((p)->read_symtab_private))->dbfoff)
379 #define DBROFF(p) (((struct dwfinfo *)((p)->read_symtab_private))->dbroff)
380 #define DBLENGTH(p) (((struct dwfinfo *)((p)->read_symtab_private))->dblength)
381 #define LNFOFF(p) (((struct dwfinfo *)((p)->read_symtab_private))->lnfoff)
383 /* The generic symbol table building routines have separate lists for
384 file scope symbols and all all other scopes (local scopes). So
385 we need to select the right one to pass to add_symbol_to_list().
386 We do it by keeping a pointer to the correct list in list_in_scope.
388 FIXME: The original dwarf code just treated the file scope as the first
389 local scope, and all other local scopes as nested local scopes, and worked
390 fine. Check to see if we really need to distinguish these in buildsym.c */
392 struct pending
**list_in_scope
= &file_symbols
;
394 /* DIES which have user defined types or modified user defined types refer to
395 other DIES for the type information. Thus we need to associate the offset
396 of a DIE for a user defined type with a pointer to the type information.
398 Originally this was done using a simple but expensive algorithm, with an
399 array of unsorted structures, each containing an offset/type-pointer pair.
400 This array was scanned linearly each time a lookup was done. The result
401 was that gdb was spending over half it's startup time munging through this
402 array of pointers looking for a structure that had the right offset member.
404 The second attempt used the same array of structures, but the array was
405 sorted using qsort each time a new offset/type was recorded, and a binary
406 search was used to find the type pointer for a given DIE offset. This was
407 even slower, due to the overhead of sorting the array each time a new
408 offset/type pair was entered.
410 The third attempt uses a fixed size array of type pointers, indexed by a
411 value derived from the DIE offset. Since the minimum DIE size is 4 bytes,
412 we can divide any DIE offset by 4 to obtain a unique index into this fixed
413 size array. Since each element is a 4 byte pointer, it takes exactly as
414 much memory to hold this array as to hold the DWARF info for a given
415 compilation unit. But it gets freed as soon as we are done with it.
416 This has worked well in practice, as a reasonable tradeoff between memory
417 consumption and speed, without having to resort to much more complicated
420 static struct type
**utypes
; /* Pointer to array of user type pointers */
421 static int numutypes
; /* Max number of user type pointers */
423 /* Maintain an array of referenced fundamental types for the current
424 compilation unit being read. For DWARF version 1, we have to construct
425 the fundamental types on the fly, since no information about the
426 fundamental types is supplied. Each such fundamental type is created by
427 calling a language dependent routine to create the type, and then a
428 pointer to that type is then placed in the array at the index specified
429 by it's FT_<TYPENAME> value. The array has a fixed size set by the
430 FT_NUM_MEMBERS compile time constant, which is the number of predefined
431 fundamental types gdb knows how to construct. */
433 static struct type
*ftypes
[FT_NUM_MEMBERS
]; /* Fundamental types */
435 /* Record the language for the compilation unit which is currently being
436 processed. We know it once we have seen the TAG_compile_unit DIE,
437 and we need it while processing the DIE's for that compilation unit.
438 It is eventually saved in the symtab structure, but we don't finalize
439 the symtab struct until we have processed all the DIE's for the
440 compilation unit. We also need to get and save a pointer to the
441 language struct for this language, so we can call the language
442 dependent routines for doing things such as creating fundamental
445 static enum language cu_language
;
446 static const struct language_defn
*cu_language_defn
;
448 /* Forward declarations of static functions so we don't have to worry
449 about ordering within this file. */
452 attribute_size
PARAMS ((unsigned int));
455 target_to_host
PARAMS ((char *, int, int, struct objfile
*));
458 add_enum_psymbol
PARAMS ((struct dieinfo
*, struct objfile
*));
461 handle_producer
PARAMS ((char *));
464 read_file_scope
PARAMS ((struct dieinfo
*, char *, char *, struct objfile
*));
467 read_func_scope
PARAMS ((struct dieinfo
*, char *, char *, struct objfile
*));
470 read_lexical_block_scope
PARAMS ((struct dieinfo
*, char *, char *,
474 scan_partial_symbols
PARAMS ((char *, char *, struct objfile
*));
477 scan_compilation_units
PARAMS ((char *, char *, file_ptr
,
478 file_ptr
, struct objfile
*));
481 add_partial_symbol
PARAMS ((struct dieinfo
*, struct objfile
*));
484 init_psymbol_list
PARAMS ((struct objfile
*, int));
487 basicdieinfo
PARAMS ((struct dieinfo
*, char *, struct objfile
*));
490 completedieinfo
PARAMS ((struct dieinfo
*, struct objfile
*));
493 dwarf_psymtab_to_symtab
PARAMS ((struct partial_symtab
*));
496 psymtab_to_symtab_1
PARAMS ((struct partial_symtab
*));
499 read_ofile_symtab
PARAMS ((struct partial_symtab
*));
502 process_dies
PARAMS ((char *, char *, struct objfile
*));
505 read_structure_scope
PARAMS ((struct dieinfo
*, char *, char *,
509 decode_array_element_type
PARAMS ((char *));
512 decode_subscript_data_item
PARAMS ((char *, char *));
515 dwarf_read_array_type
PARAMS ((struct dieinfo
*));
518 read_tag_pointer_type
PARAMS ((struct dieinfo
*dip
));
521 read_tag_string_type
PARAMS ((struct dieinfo
*dip
));
524 read_subroutine_type
PARAMS ((struct dieinfo
*, char *, char *));
527 read_enumeration
PARAMS ((struct dieinfo
*, char *, char *, struct objfile
*));
530 struct_type
PARAMS ((struct dieinfo
*, char *, char *, struct objfile
*));
533 enum_type
PARAMS ((struct dieinfo
*, struct objfile
*));
536 decode_line_numbers
PARAMS ((char *));
539 decode_die_type
PARAMS ((struct dieinfo
*));
542 decode_mod_fund_type
PARAMS ((char *));
545 decode_mod_u_d_type
PARAMS ((char *));
548 decode_modified_type
PARAMS ((char *, unsigned int, int));
551 decode_fund_type
PARAMS ((unsigned int));
554 create_name
PARAMS ((char *, struct obstack
*));
557 lookup_utype
PARAMS ((DIE_REF
));
560 alloc_utype
PARAMS ((DIE_REF
, struct type
*));
562 static struct symbol
*
563 new_symbol
PARAMS ((struct dieinfo
*, struct objfile
*));
566 synthesize_typedef
PARAMS ((struct dieinfo
*, struct objfile
*,
570 locval
PARAMS ((char *));
573 record_minimal_symbol
PARAMS ((char *, CORE_ADDR
, enum minimal_symbol_type
,
577 set_cu_language
PARAMS ((struct dieinfo
*));
580 dwarf_fundamental_type
PARAMS ((struct objfile
*, int));
587 dwarf_fundamental_type -- lookup or create a fundamental type
592 dwarf_fundamental_type (struct objfile *objfile, int typeid)
596 DWARF version 1 doesn't supply any fundamental type information,
597 so gdb has to construct such types. It has a fixed number of
598 fundamental types that it knows how to construct, which is the
599 union of all types that it knows how to construct for all languages
600 that it knows about. These are enumerated in gdbtypes.h.
602 As an example, assume we find a DIE that references a DWARF
603 fundamental type of FT_integer. We first look in the ftypes
604 array to see if we already have such a type, indexed by the
605 gdb internal value of FT_INTEGER. If so, we simply return a
606 pointer to that type. If not, then we ask an appropriate
607 language dependent routine to create a type FT_INTEGER, using
608 defaults reasonable for the current target machine, and install
609 that type in ftypes for future reference.
613 Pointer to a fundamental type.
618 dwarf_fundamental_type (objfile
, typeid)
619 struct objfile
*objfile
;
622 if (typeid < 0 || typeid >= FT_NUM_MEMBERS
)
624 error ("internal error - invalid fundamental type id %d", typeid);
627 /* Look for this particular type in the fundamental type vector. If one is
628 not found, create and install one appropriate for the current language
629 and the current target machine. */
631 if (ftypes
[typeid] == NULL
)
633 ftypes
[typeid] = cu_language_defn
-> la_fund_type(objfile
, typeid);
636 return (ftypes
[typeid]);
643 set_cu_language -- set local copy of language for compilation unit
648 set_cu_language (struct dieinfo *dip)
652 Decode the language attribute for a compilation unit DIE and
653 remember what the language was. We use this at various times
654 when processing DIE's for a given compilation unit.
663 set_cu_language (dip
)
666 switch (dip
-> at_language
)
670 cu_language
= language_c
;
672 case LANG_C_PLUS_PLUS
:
673 cu_language
= language_cplus
;
676 cu_language
= language_chill
;
679 cu_language
= language_m2
;
687 /* We don't know anything special about these yet. */
688 cu_language
= language_unknown
;
691 /* If no at_language, try to deduce one from the filename */
692 cu_language
= deduce_language_from_filename (dip
-> at_name
);
695 cu_language_defn
= language_def (cu_language
);
702 dwarf_build_psymtabs -- build partial symtabs from DWARF debug info
706 void dwarf_build_psymtabs (struct objfile *objfile,
707 struct section_offsets *section_offsets,
708 int mainline, file_ptr dbfoff, unsigned int dbfsize,
709 file_ptr lnoffset, unsigned int lnsize)
713 This function is called upon to build partial symtabs from files
714 containing DIE's (Dwarf Information Entries) and DWARF line numbers.
716 It is passed a bfd* containing the DIES
717 and line number information, the corresponding filename for that
718 file, a base address for relocating the symbols, a flag indicating
719 whether or not this debugging information is from a "main symbol
720 table" rather than a shared library or dynamically linked file,
721 and file offset/size pairs for the DIE information and line number
731 dwarf_build_psymtabs (objfile
, section_offsets
, mainline
, dbfoff
, dbfsize
,
733 struct objfile
*objfile
;
734 struct section_offsets
*section_offsets
;
737 unsigned int dbfsize
;
741 bfd
*abfd
= objfile
->obfd
;
742 struct cleanup
*back_to
;
744 current_objfile
= objfile
;
746 dbbase
= xmalloc (dbsize
);
748 if ((bfd_seek (abfd
, dbfoff
, L_SET
) != 0) ||
749 (bfd_read (dbbase
, dbsize
, 1, abfd
) != dbsize
))
752 error ("can't read DWARF data from '%s'", bfd_get_filename (abfd
));
754 back_to
= make_cleanup (free
, dbbase
);
756 /* If we are reinitializing, or if we have never loaded syms yet, init.
757 Since we have no idea how many DIES we are looking at, we just guess
758 some arbitrary value. */
760 if (mainline
|| objfile
-> global_psymbols
.size
== 0 ||
761 objfile
-> static_psymbols
.size
== 0)
763 init_psymbol_list (objfile
, 1024);
766 /* Save the relocation factor where everybody can see it. */
768 base_section_offsets
= section_offsets
;
769 baseaddr
= ANOFFSET (section_offsets
, 0);
771 /* Follow the compilation unit sibling chain, building a partial symbol
772 table entry for each one. Save enough information about each compilation
773 unit to locate the full DWARF information later. */
775 scan_compilation_units (dbbase
, dbbase
+ dbsize
, dbfoff
, lnoffset
, objfile
);
777 do_cleanups (back_to
);
778 current_objfile
= NULL
;
786 record_minimal_symbol -- add entry to gdb's minimal symbol table
790 static void record_minimal_symbol (char *name, CORE_ADDR address,
791 enum minimal_symbol_type ms_type,
792 struct objfile *objfile)
796 Given a pointer to the name of a symbol that should be added to the
797 minimal symbol table, and the address associated with that
798 symbol, records this information for later use in building the
799 minimal symbol table.
804 record_minimal_symbol (name
, address
, ms_type
, objfile
)
807 enum minimal_symbol_type ms_type
;
808 struct objfile
*objfile
;
810 name
= obsavestring (name
, strlen (name
), &objfile
-> symbol_obstack
);
811 prim_record_minimal_symbol (name
, address
, ms_type
);
818 read_lexical_block_scope -- process all dies in a lexical block
822 static void read_lexical_block_scope (struct dieinfo *dip,
823 char *thisdie, char *enddie)
827 Process all the DIES contained within a lexical block scope.
828 Start a new scope, process the dies, and then close the scope.
833 read_lexical_block_scope (dip
, thisdie
, enddie
, objfile
)
837 struct objfile
*objfile
;
839 register struct context_stack
*new;
841 push_context (0, dip
-> at_low_pc
);
842 process_dies (thisdie
+ dip
-> die_length
, enddie
, objfile
);
843 new = pop_context ();
844 if (local_symbols
!= NULL
)
846 finish_block (0, &local_symbols
, new -> old_blocks
, new -> start_addr
,
847 dip
-> at_high_pc
, objfile
);
849 local_symbols
= new -> locals
;
856 lookup_utype -- look up a user defined type from die reference
860 static type *lookup_utype (DIE_REF die_ref)
864 Given a DIE reference, lookup the user defined type associated with
865 that DIE, if it has been registered already. If not registered, then
866 return NULL. Alloc_utype() can be called to register an empty
867 type for this reference, which will be filled in later when the
868 actual referenced DIE is processed.
872 lookup_utype (die_ref
)
875 struct type
*type
= NULL
;
878 utypeidx
= (die_ref
- dbroff
) / 4;
879 if ((utypeidx
< 0) || (utypeidx
>= numutypes
))
881 complain (&bad_die_ref
, DIE_ID
, DIE_NAME
);
885 type
= *(utypes
+ utypeidx
);
895 alloc_utype -- add a user defined type for die reference
899 static type *alloc_utype (DIE_REF die_ref, struct type *utypep)
903 Given a die reference DIE_REF, and a possible pointer to a user
904 defined type UTYPEP, register that this reference has a user
905 defined type and either use the specified type in UTYPEP or
906 make a new empty type that will be filled in later.
908 We should only be called after calling lookup_utype() to verify that
909 there is not currently a type registered for DIE_REF.
913 alloc_utype (die_ref
, utypep
)
920 utypeidx
= (die_ref
- dbroff
) / 4;
921 typep
= utypes
+ utypeidx
;
922 if ((utypeidx
< 0) || (utypeidx
>= numutypes
))
924 utypep
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
925 complain (&bad_die_ref
, DIE_ID
, DIE_NAME
);
927 else if (*typep
!= NULL
)
930 complain (&dup_user_type_allocation
, DIE_ID
, DIE_NAME
);
936 utypep
= alloc_type (current_objfile
);
947 decode_die_type -- return a type for a specified die
951 static struct type *decode_die_type (struct dieinfo *dip)
955 Given a pointer to a die information structure DIP, decode the
956 type of the die and return a pointer to the decoded type. All
957 dies without specific types default to type int.
961 decode_die_type (dip
)
964 struct type
*type
= NULL
;
966 if (dip
-> at_fund_type
!= 0)
968 type
= decode_fund_type (dip
-> at_fund_type
);
970 else if (dip
-> at_mod_fund_type
!= NULL
)
972 type
= decode_mod_fund_type (dip
-> at_mod_fund_type
);
974 else if (dip
-> at_user_def_type
)
976 if ((type
= lookup_utype (dip
-> at_user_def_type
)) == NULL
)
978 type
= alloc_utype (dip
-> at_user_def_type
, NULL
);
981 else if (dip
-> at_mod_u_d_type
)
983 type
= decode_mod_u_d_type (dip
-> at_mod_u_d_type
);
987 type
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
996 struct_type -- compute and return the type for a struct or union
1000 static struct type *struct_type (struct dieinfo *dip, char *thisdie,
1001 char *enddie, struct objfile *objfile)
1005 Given pointer to a die information structure for a die which
1006 defines a union or structure (and MUST define one or the other),
1007 and pointers to the raw die data that define the range of dies which
1008 define the members, compute and return the user defined type for the
1012 static struct type
*
1013 struct_type (dip
, thisdie
, enddie
, objfile
)
1014 struct dieinfo
*dip
;
1017 struct objfile
*objfile
;
1021 struct nextfield
*next
;
1024 struct nextfield
*list
= NULL
;
1025 struct nextfield
*new;
1031 #if !BITS_BIG_ENDIAN
1035 if ((type
= lookup_utype (dip
-> die_ref
)) == NULL
)
1037 /* No forward references created an empty type, so install one now */
1038 type
= alloc_utype (dip
-> die_ref
, NULL
);
1040 INIT_CPLUS_SPECIFIC(type
);
1041 switch (dip
-> die_tag
)
1043 case TAG_class_type
:
1044 TYPE_CODE (type
) = TYPE_CODE_CLASS
;
1047 case TAG_structure_type
:
1048 TYPE_CODE (type
) = TYPE_CODE_STRUCT
;
1051 case TAG_union_type
:
1052 TYPE_CODE (type
) = TYPE_CODE_UNION
;
1056 /* Should never happen */
1057 TYPE_CODE (type
) = TYPE_CODE_UNDEF
;
1059 complain (&missing_tag
, DIE_ID
, DIE_NAME
);
1062 /* Some compilers try to be helpful by inventing "fake" names for
1063 anonymous enums, structures, and unions, like "~0fake" or ".0fake".
1064 Thanks, but no thanks... */
1065 if (dip
-> at_name
!= NULL
1066 && *dip
-> at_name
!= '~'
1067 && *dip
-> at_name
!= '.')
1069 TYPE_NAME (type
) = obconcat (&objfile
-> type_obstack
,
1070 tpart1
, " ", dip
-> at_name
);
1072 /* Use whatever size is known. Zero is a valid size. We might however
1073 wish to check has_at_byte_size to make sure that some byte size was
1074 given explicitly, but DWARF doesn't specify that explicit sizes of
1075 zero have to present, so complaining about missing sizes should
1076 probably not be the default. */
1077 TYPE_LENGTH (type
) = dip
-> at_byte_size
;
1078 thisdie
+= dip
-> die_length
;
1079 while (thisdie
< enddie
)
1081 basicdieinfo (&mbr
, thisdie
, objfile
);
1082 completedieinfo (&mbr
, objfile
);
1083 if (mbr
.die_length
<= SIZEOF_DIE_LENGTH
)
1087 else if (mbr
.at_sibling
!= 0)
1089 nextdie
= dbbase
+ mbr
.at_sibling
- dbroff
;
1093 nextdie
= thisdie
+ mbr
.die_length
;
1095 switch (mbr
.die_tag
)
1098 /* Get space to record the next field's data. */
1099 new = (struct nextfield
*) alloca (sizeof (struct nextfield
));
1102 /* Save the data. */
1103 list
-> field
.name
=
1104 obsavestring (mbr
.at_name
, strlen (mbr
.at_name
),
1105 &objfile
-> type_obstack
);
1106 list
-> field
.type
= decode_die_type (&mbr
);
1107 list
-> field
.bitpos
= 8 * locval (mbr
.at_location
);
1108 /* Handle bit fields. */
1109 list
-> field
.bitsize
= mbr
.at_bit_size
;
1111 /* For big endian bits, the at_bit_offset gives the additional
1112 bit offset from the MSB of the containing anonymous object to
1113 the MSB of the field. We don't have to do anything special
1114 since we don't need to know the size of the anonymous object. */
1115 list
-> field
.bitpos
+= mbr
.at_bit_offset
;
1117 /* For little endian bits, we need to have a non-zero at_bit_size,
1118 so that we know we are in fact dealing with a bitfield. Compute
1119 the bit offset to the MSB of the anonymous object, subtract off
1120 the number of bits from the MSB of the field to the MSB of the
1121 object, and then subtract off the number of bits of the field
1122 itself. The result is the bit offset of the LSB of the field. */
1123 if (mbr
.at_bit_size
> 0)
1125 if (mbr
.has_at_byte_size
)
1127 /* The size of the anonymous object containing the bit field
1128 is explicit, so use the indicated size (in bytes). */
1129 anonymous_size
= mbr
.at_byte_size
;
1133 /* The size of the anonymous object containing the bit field
1134 matches the size of an object of the bit field's type.
1135 DWARF allows at_byte_size to be left out in such cases,
1136 as a debug information size optimization. */
1137 anonymous_size
= TYPE_LENGTH (list
-> field
.type
);
1139 list
-> field
.bitpos
+=
1140 anonymous_size
* 8 - mbr
.at_bit_offset
- mbr
.at_bit_size
;
1146 process_dies (thisdie
, nextdie
, objfile
);
1151 /* Now create the vector of fields, and record how big it is. We may
1152 not even have any fields, if this DIE was generated due to a reference
1153 to an anonymous structure or union. In this case, TYPE_FLAG_STUB is
1154 set, which clues gdb in to the fact that it needs to search elsewhere
1155 for the full structure definition. */
1158 TYPE_FLAGS (type
) |= TYPE_FLAG_STUB
;
1162 TYPE_NFIELDS (type
) = nfields
;
1163 TYPE_FIELDS (type
) = (struct field
*)
1164 TYPE_ALLOC (type
, sizeof (struct field
) * nfields
);
1165 /* Copy the saved-up fields into the field vector. */
1166 for (n
= nfields
; list
; list
= list
-> next
)
1168 TYPE_FIELD (type
, --n
) = list
-> field
;
1178 read_structure_scope -- process all dies within struct or union
1182 static void read_structure_scope (struct dieinfo *dip,
1183 char *thisdie, char *enddie, struct objfile *objfile)
1187 Called when we find the DIE that starts a structure or union
1188 scope (definition) to process all dies that define the members
1189 of the structure or union. DIP is a pointer to the die info
1190 struct for the DIE that names the structure or union.
1194 Note that we need to call struct_type regardless of whether or not
1195 the DIE has an at_name attribute, since it might be an anonymous
1196 structure or union. This gets the type entered into our set of
1199 However, if the structure is incomplete (an opaque struct/union)
1200 then suppress creating a symbol table entry for it since gdb only
1201 wants to find the one with the complete definition. Note that if
1202 it is complete, we just call new_symbol, which does it's own
1203 checking about whether the struct/union is anonymous or not (and
1204 suppresses creating a symbol table entry itself).
1209 read_structure_scope (dip
, thisdie
, enddie
, objfile
)
1210 struct dieinfo
*dip
;
1213 struct objfile
*objfile
;
1218 type
= struct_type (dip
, thisdie
, enddie
, objfile
);
1219 if (!(TYPE_FLAGS (type
) & TYPE_FLAG_STUB
))
1221 sym
= new_symbol (dip
, objfile
);
1224 SYMBOL_TYPE (sym
) = type
;
1225 if (cu_language
== language_cplus
)
1227 synthesize_typedef (dip
, objfile
, type
);
1237 decode_array_element_type -- decode type of the array elements
1241 static struct type *decode_array_element_type (char *scan, char *end)
1245 As the last step in decoding the array subscript information for an
1246 array DIE, we need to decode the type of the array elements. We are
1247 passed a pointer to this last part of the subscript information and
1248 must return the appropriate type. If the type attribute is not
1249 recognized, just warn about the problem and return type int.
1252 static struct type
*
1253 decode_array_element_type (scan
)
1258 unsigned short attribute
;
1259 unsigned short fundtype
;
1262 attribute
= target_to_host (scan
, SIZEOF_ATTRIBUTE
, GET_UNSIGNED
,
1264 scan
+= SIZEOF_ATTRIBUTE
;
1265 if ((nbytes
= attribute_size (attribute
)) == -1)
1267 complain (&bad_array_element_type
, DIE_ID
, DIE_NAME
, attribute
);
1268 typep
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
1275 fundtype
= target_to_host (scan
, nbytes
, GET_UNSIGNED
,
1277 typep
= decode_fund_type (fundtype
);
1279 case AT_mod_fund_type
:
1280 typep
= decode_mod_fund_type (scan
);
1282 case AT_user_def_type
:
1283 die_ref
= target_to_host (scan
, nbytes
, GET_UNSIGNED
,
1285 if ((typep
= lookup_utype (die_ref
)) == NULL
)
1287 typep
= alloc_utype (die_ref
, NULL
);
1290 case AT_mod_u_d_type
:
1291 typep
= decode_mod_u_d_type (scan
);
1294 complain (&bad_array_element_type
, DIE_ID
, DIE_NAME
, attribute
);
1295 typep
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
1306 decode_subscript_data_item -- decode array subscript item
1310 static struct type *
1311 decode_subscript_data_item (char *scan, char *end)
1315 The array subscripts and the data type of the elements of an
1316 array are described by a list of data items, stored as a block
1317 of contiguous bytes. There is a data item describing each array
1318 dimension, and a final data item describing the element type.
1319 The data items are ordered the same as their appearance in the
1320 source (I.E. leftmost dimension first, next to leftmost second,
1323 The data items describing each array dimension consist of four
1324 parts: (1) a format specifier, (2) type type of the subscript
1325 index, (3) a description of the low bound of the array dimension,
1326 and (4) a description of the high bound of the array dimension.
1328 The last data item is the description of the type of each of
1331 We are passed a pointer to the start of the block of bytes
1332 containing the remaining data items, and a pointer to the first
1333 byte past the data. This function recursively decodes the
1334 remaining data items and returns a type.
1336 If we somehow fail to decode some data, we complain about it
1337 and return a type "array of int".
1340 FIXME: This code only implements the forms currently used
1341 by the AT&T and GNU C compilers.
1343 The end pointer is supplied for error checking, maybe we should
1347 static struct type
*
1348 decode_subscript_data_item (scan
, end
)
1352 struct type
*typep
= NULL
; /* Array type we are building */
1353 struct type
*nexttype
; /* Type of each element (may be array) */
1354 struct type
*indextype
; /* Type of this index */
1355 struct type
*rangetype
;
1356 unsigned int format
;
1357 unsigned short fundtype
;
1358 unsigned long lowbound
;
1359 unsigned long highbound
;
1362 format
= target_to_host (scan
, SIZEOF_FORMAT_SPECIFIER
, GET_UNSIGNED
,
1364 scan
+= SIZEOF_FORMAT_SPECIFIER
;
1368 typep
= decode_array_element_type (scan
);
1371 fundtype
= target_to_host (scan
, SIZEOF_FMT_FT
, GET_UNSIGNED
,
1373 indextype
= decode_fund_type (fundtype
);
1374 scan
+= SIZEOF_FMT_FT
;
1375 nbytes
= TARGET_FT_LONG_SIZE (current_objfile
);
1376 lowbound
= target_to_host (scan
, nbytes
, GET_UNSIGNED
, current_objfile
);
1378 highbound
= target_to_host (scan
, nbytes
, GET_UNSIGNED
, current_objfile
);
1380 nexttype
= decode_subscript_data_item (scan
, end
);
1381 if (nexttype
== NULL
)
1383 /* Munged subscript data or other problem, fake it. */
1384 complain (&subscript_data_items
, DIE_ID
, DIE_NAME
);
1385 nexttype
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
1387 rangetype
= create_range_type ((struct type
*) NULL
, indextype
,
1388 lowbound
, highbound
);
1389 typep
= create_array_type ((struct type
*) NULL
, nexttype
, rangetype
);
1398 complain (&unhandled_array_subscript_format
, DIE_ID
, DIE_NAME
, format
);
1399 nexttype
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
1400 rangetype
= create_range_type ((struct type
*) NULL
, nexttype
, 0, 0);
1401 typep
= create_array_type ((struct type
*) NULL
, nexttype
, rangetype
);
1404 complain (&unknown_array_subscript_format
, DIE_ID
, DIE_NAME
, format
);
1405 nexttype
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
1406 rangetype
= create_range_type ((struct type
*) NULL
, nexttype
, 0, 0);
1407 typep
= create_array_type ((struct type
*) NULL
, nexttype
, rangetype
);
1417 dwarf_read_array_type -- read TAG_array_type DIE
1421 static void dwarf_read_array_type (struct dieinfo *dip)
1425 Extract all information from a TAG_array_type DIE and add to
1426 the user defined type vector.
1430 dwarf_read_array_type (dip
)
1431 struct dieinfo
*dip
;
1437 unsigned short blocksz
;
1440 if (dip
-> at_ordering
!= ORD_row_major
)
1442 /* FIXME: Can gdb even handle column major arrays? */
1443 complain (¬_row_major
, DIE_ID
, DIE_NAME
);
1445 if ((sub
= dip
-> at_subscr_data
) != NULL
)
1447 nbytes
= attribute_size (AT_subscr_data
);
1448 blocksz
= target_to_host (sub
, nbytes
, GET_UNSIGNED
, current_objfile
);
1449 subend
= sub
+ nbytes
+ blocksz
;
1451 type
= decode_subscript_data_item (sub
, subend
);
1452 if ((utype
= lookup_utype (dip
-> die_ref
)) == NULL
)
1454 /* Install user defined type that has not been referenced yet. */
1455 alloc_utype (dip
-> die_ref
, type
);
1457 else if (TYPE_CODE (utype
) == TYPE_CODE_UNDEF
)
1459 /* Ick! A forward ref has already generated a blank type in our
1460 slot, and this type probably already has things pointing to it
1461 (which is what caused it to be created in the first place).
1462 If it's just a place holder we can plop our fully defined type
1463 on top of it. We can't recover the space allocated for our
1464 new type since it might be on an obstack, but we could reuse
1465 it if we kept a list of them, but it might not be worth it
1471 /* Double ick! Not only is a type already in our slot, but
1472 someone has decorated it. Complain and leave it alone. */
1473 complain (&dup_user_type_definition
, DIE_ID
, DIE_NAME
);
1482 read_tag_pointer_type -- read TAG_pointer_type DIE
1486 static void read_tag_pointer_type (struct dieinfo *dip)
1490 Extract all information from a TAG_pointer_type DIE and add to
1491 the user defined type vector.
1495 read_tag_pointer_type (dip
)
1496 struct dieinfo
*dip
;
1501 type
= decode_die_type (dip
);
1502 if ((utype
= lookup_utype (dip
-> die_ref
)) == NULL
)
1504 utype
= lookup_pointer_type (type
);
1505 alloc_utype (dip
-> die_ref
, utype
);
1509 TYPE_TARGET_TYPE (utype
) = type
;
1510 TYPE_POINTER_TYPE (type
) = utype
;
1512 /* We assume the machine has only one representation for pointers! */
1513 /* FIXME: This confuses host<->target data representations, and is a
1514 poor assumption besides. */
1516 TYPE_LENGTH (utype
) = sizeof (char *);
1517 TYPE_CODE (utype
) = TYPE_CODE_PTR
;
1525 read_tag_string_type -- read TAG_string_type DIE
1529 static void read_tag_string_type (struct dieinfo *dip)
1533 Extract all information from a TAG_string_type DIE and add to
1534 the user defined type vector. It isn't really a user defined
1535 type, but it behaves like one, with other DIE's using an
1536 AT_user_def_type attribute to reference it.
1540 read_tag_string_type (dip
)
1541 struct dieinfo
*dip
;
1544 struct type
*indextype
;
1545 struct type
*rangetype
;
1546 unsigned long lowbound
= 0;
1547 unsigned long highbound
;
1549 if (dip
-> has_at_byte_size
)
1551 /* A fixed bounds string */
1552 highbound
= dip
-> at_byte_size
- 1;
1556 /* A varying length string. Stub for now. (FIXME) */
1559 indextype
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
1560 rangetype
= create_range_type ((struct type
*) NULL
, indextype
, lowbound
,
1563 utype
= lookup_utype (dip
-> die_ref
);
1566 /* No type defined, go ahead and create a blank one to use. */
1567 utype
= alloc_utype (dip
-> die_ref
, (struct type
*) NULL
);
1571 /* Already a type in our slot due to a forward reference. Make sure it
1572 is a blank one. If not, complain and leave it alone. */
1573 if (TYPE_CODE (utype
) != TYPE_CODE_UNDEF
)
1575 complain (&dup_user_type_definition
, DIE_ID
, DIE_NAME
);
1580 /* Create the string type using the blank type we either found or created. */
1581 utype
= create_string_type (utype
, rangetype
);
1588 read_subroutine_type -- process TAG_subroutine_type dies
1592 static void read_subroutine_type (struct dieinfo *dip, char thisdie,
1597 Handle DIES due to C code like:
1600 int (*funcp)(int a, long l); (Generates TAG_subroutine_type DIE)
1606 The parameter DIES are currently ignored. See if gdb has a way to
1607 include this info in it's type system, and decode them if so. Is
1608 this what the type structure's "arg_types" field is for? (FIXME)
1612 read_subroutine_type (dip
, thisdie
, enddie
)
1613 struct dieinfo
*dip
;
1617 struct type
*type
; /* Type that this function returns */
1618 struct type
*ftype
; /* Function that returns above type */
1620 /* Decode the type that this subroutine returns */
1622 type
= decode_die_type (dip
);
1624 /* Check to see if we already have a partially constructed user
1625 defined type for this DIE, from a forward reference. */
1627 if ((ftype
= lookup_utype (dip
-> die_ref
)) == NULL
)
1629 /* This is the first reference to one of these types. Make
1630 a new one and place it in the user defined types. */
1631 ftype
= lookup_function_type (type
);
1632 alloc_utype (dip
-> die_ref
, ftype
);
1634 else if (TYPE_CODE (ftype
) == TYPE_CODE_UNDEF
)
1636 /* We have an existing partially constructed type, so bash it
1637 into the correct type. */
1638 TYPE_TARGET_TYPE (ftype
) = type
;
1639 TYPE_FUNCTION_TYPE (type
) = ftype
;
1640 TYPE_LENGTH (ftype
) = 1;
1641 TYPE_CODE (ftype
) = TYPE_CODE_FUNC
;
1645 complain (&dup_user_type_definition
, DIE_ID
, DIE_NAME
);
1653 read_enumeration -- process dies which define an enumeration
1657 static void read_enumeration (struct dieinfo *dip, char *thisdie,
1658 char *enddie, struct objfile *objfile)
1662 Given a pointer to a die which begins an enumeration, process all
1663 the dies that define the members of the enumeration.
1667 Note that we need to call enum_type regardless of whether or not we
1668 have a symbol, since we might have an enum without a tag name (thus
1669 no symbol for the tagname).
1673 read_enumeration (dip
, thisdie
, enddie
, objfile
)
1674 struct dieinfo
*dip
;
1677 struct objfile
*objfile
;
1682 type
= enum_type (dip
, objfile
);
1683 sym
= new_symbol (dip
, objfile
);
1686 SYMBOL_TYPE (sym
) = type
;
1687 if (cu_language
== language_cplus
)
1689 synthesize_typedef (dip
, objfile
, type
);
1698 enum_type -- decode and return a type for an enumeration
1702 static type *enum_type (struct dieinfo *dip, struct objfile *objfile)
1706 Given a pointer to a die information structure for the die which
1707 starts an enumeration, process all the dies that define the members
1708 of the enumeration and return a type pointer for the enumeration.
1710 At the same time, for each member of the enumeration, create a
1711 symbol for it with namespace VAR_NAMESPACE and class LOC_CONST,
1712 and give it the type of the enumeration itself.
1716 Note that the DWARF specification explicitly mandates that enum
1717 constants occur in reverse order from the source program order,
1718 for "consistency" and because this ordering is easier for many
1719 compilers to generate. (Draft 6, sec 3.8.5, Enumeration type
1720 Entries). Because gdb wants to see the enum members in program
1721 source order, we have to ensure that the order gets reversed while
1722 we are processing them.
1725 static struct type
*
1726 enum_type (dip
, objfile
)
1727 struct dieinfo
*dip
;
1728 struct objfile
*objfile
;
1732 struct nextfield
*next
;
1735 struct nextfield
*list
= NULL
;
1736 struct nextfield
*new;
1741 unsigned short blocksz
;
1745 if ((type
= lookup_utype (dip
-> die_ref
)) == NULL
)
1747 /* No forward references created an empty type, so install one now */
1748 type
= alloc_utype (dip
-> die_ref
, NULL
);
1750 TYPE_CODE (type
) = TYPE_CODE_ENUM
;
1751 /* Some compilers try to be helpful by inventing "fake" names for
1752 anonymous enums, structures, and unions, like "~0fake" or ".0fake".
1753 Thanks, but no thanks... */
1754 if (dip
-> at_name
!= NULL
1755 && *dip
-> at_name
!= '~'
1756 && *dip
-> at_name
!= '.')
1758 TYPE_NAME (type
) = obconcat (&objfile
-> type_obstack
, "enum",
1759 " ", dip
-> at_name
);
1761 if (dip
-> at_byte_size
!= 0)
1763 TYPE_LENGTH (type
) = dip
-> at_byte_size
;
1765 if ((scan
= dip
-> at_element_list
) != NULL
)
1767 if (dip
-> short_element_list
)
1769 nbytes
= attribute_size (AT_short_element_list
);
1773 nbytes
= attribute_size (AT_element_list
);
1775 blocksz
= target_to_host (scan
, nbytes
, GET_UNSIGNED
, objfile
);
1776 listend
= scan
+ nbytes
+ blocksz
;
1778 while (scan
< listend
)
1780 new = (struct nextfield
*) alloca (sizeof (struct nextfield
));
1783 list
-> field
.type
= NULL
;
1784 list
-> field
.bitsize
= 0;
1785 list
-> field
.bitpos
=
1786 target_to_host (scan
, TARGET_FT_LONG_SIZE (objfile
), GET_SIGNED
,
1788 scan
+= TARGET_FT_LONG_SIZE (objfile
);
1789 list
-> field
.name
= obsavestring (scan
, strlen (scan
),
1790 &objfile
-> type_obstack
);
1791 scan
+= strlen (scan
) + 1;
1793 /* Handcraft a new symbol for this enum member. */
1794 sym
= (struct symbol
*) obstack_alloc (&objfile
->symbol_obstack
,
1795 sizeof (struct symbol
));
1796 memset (sym
, 0, sizeof (struct symbol
));
1797 SYMBOL_NAME (sym
) = create_name (list
-> field
.name
,
1798 &objfile
->symbol_obstack
);
1799 SYMBOL_INIT_LANGUAGE_SPECIFIC (sym
, cu_language
);
1800 SYMBOL_NAMESPACE (sym
) = VAR_NAMESPACE
;
1801 SYMBOL_CLASS (sym
) = LOC_CONST
;
1802 SYMBOL_TYPE (sym
) = type
;
1803 SYMBOL_VALUE (sym
) = list
-> field
.bitpos
;
1804 add_symbol_to_list (sym
, list_in_scope
);
1806 /* Now create the vector of fields, and record how big it is. This is
1807 where we reverse the order, by pulling the members off the list in
1808 reverse order from how they were inserted. If we have no fields
1809 (this is apparently possible in C++) then skip building a field
1813 TYPE_NFIELDS (type
) = nfields
;
1814 TYPE_FIELDS (type
) = (struct field
*)
1815 obstack_alloc (&objfile
->symbol_obstack
, sizeof (struct field
) * nfields
);
1816 /* Copy the saved-up fields into the field vector. */
1817 for (n
= 0; (n
< nfields
) && (list
!= NULL
); list
= list
-> next
)
1819 TYPE_FIELD (type
, n
++) = list
-> field
;
1830 read_func_scope -- process all dies within a function scope
1834 Process all dies within a given function scope. We are passed
1835 a die information structure pointer DIP for the die which
1836 starts the function scope, and pointers into the raw die data
1837 that define the dies within the function scope.
1839 For now, we ignore lexical block scopes within the function.
1840 The problem is that AT&T cc does not define a DWARF lexical
1841 block scope for the function itself, while gcc defines a
1842 lexical block scope for the function. We need to think about
1843 how to handle this difference, or if it is even a problem.
1848 read_func_scope (dip
, thisdie
, enddie
, objfile
)
1849 struct dieinfo
*dip
;
1852 struct objfile
*objfile
;
1854 register struct context_stack
*new;
1856 if (objfile
-> ei
.entry_point
>= dip
-> at_low_pc
&&
1857 objfile
-> ei
.entry_point
< dip
-> at_high_pc
)
1859 objfile
-> ei
.entry_func_lowpc
= dip
-> at_low_pc
;
1860 objfile
-> ei
.entry_func_highpc
= dip
-> at_high_pc
;
1862 if (STREQ (dip
-> at_name
, "main")) /* FIXME: hardwired name */
1864 objfile
-> ei
.main_func_lowpc
= dip
-> at_low_pc
;
1865 objfile
-> ei
.main_func_highpc
= dip
-> at_high_pc
;
1867 new = push_context (0, dip
-> at_low_pc
);
1868 new -> name
= new_symbol (dip
, objfile
);
1869 list_in_scope
= &local_symbols
;
1870 process_dies (thisdie
+ dip
-> die_length
, enddie
, objfile
);
1871 new = pop_context ();
1872 /* Make a block for the local symbols within. */
1873 finish_block (new -> name
, &local_symbols
, new -> old_blocks
,
1874 new -> start_addr
, dip
-> at_high_pc
, objfile
);
1875 list_in_scope
= &file_symbols
;
1883 handle_producer -- process the AT_producer attribute
1887 Perform any operations that depend on finding a particular
1888 AT_producer attribute.
1893 handle_producer (producer
)
1897 /* If this compilation unit was compiled with g++ or gcc, then set the
1898 processing_gcc_compilation flag. */
1900 processing_gcc_compilation
=
1901 STREQN (producer
, GPLUS_PRODUCER
, strlen (GPLUS_PRODUCER
))
1902 || STREQN (producer
, CHILL_PRODUCER
, strlen (CHILL_PRODUCER
))
1903 || STREQN (producer
, GCC_PRODUCER
, strlen (GCC_PRODUCER
));
1905 /* Select a demangling style if we can identify the producer and if
1906 the current style is auto. We leave the current style alone if it
1907 is not auto. We also leave the demangling style alone if we find a
1908 gcc (cc1) producer, as opposed to a g++ (cc1plus) producer. */
1910 if (AUTO_DEMANGLING
)
1912 if (STREQN (producer
, GPLUS_PRODUCER
, strlen (GPLUS_PRODUCER
)))
1914 set_demangling_style (GNU_DEMANGLING_STYLE_STRING
);
1916 else if (STREQN (producer
, LCC_PRODUCER
, strlen (LCC_PRODUCER
)))
1918 set_demangling_style (LUCID_DEMANGLING_STYLE_STRING
);
1928 read_file_scope -- process all dies within a file scope
1932 Process all dies within a given file scope. We are passed a
1933 pointer to the die information structure for the die which
1934 starts the file scope, and pointers into the raw die data which
1935 mark the range of dies within the file scope.
1937 When the partial symbol table is built, the file offset for the line
1938 number table for each compilation unit is saved in the partial symbol
1939 table entry for that compilation unit. As the symbols for each
1940 compilation unit are read, the line number table is read into memory
1941 and the variable lnbase is set to point to it. Thus all we have to
1942 do is use lnbase to access the line number table for the current
1947 read_file_scope (dip
, thisdie
, enddie
, objfile
)
1948 struct dieinfo
*dip
;
1951 struct objfile
*objfile
;
1953 struct cleanup
*back_to
;
1954 struct symtab
*symtab
;
1956 if (objfile
-> ei
.entry_point
>= dip
-> at_low_pc
&&
1957 objfile
-> ei
.entry_point
< dip
-> at_high_pc
)
1959 objfile
-> ei
.entry_file_lowpc
= dip
-> at_low_pc
;
1960 objfile
-> ei
.entry_file_highpc
= dip
-> at_high_pc
;
1962 set_cu_language (dip
);
1963 if (dip
-> at_producer
!= NULL
)
1965 handle_producer (dip
-> at_producer
);
1967 numutypes
= (enddie
- thisdie
) / 4;
1968 utypes
= (struct type
**) xmalloc (numutypes
* sizeof (struct type
*));
1969 back_to
= make_cleanup (free
, utypes
);
1970 memset (utypes
, 0, numutypes
* sizeof (struct type
*));
1971 memset (ftypes
, 0, FT_NUM_MEMBERS
* sizeof (struct type
*));
1972 start_symtab (dip
-> at_name
, dip
-> at_comp_dir
, dip
-> at_low_pc
);
1973 decode_line_numbers (lnbase
);
1974 process_dies (thisdie
+ dip
-> die_length
, enddie
, objfile
);
1976 symtab
= end_symtab (dip
-> at_high_pc
, 0, 0, objfile
, 0);
1979 symtab
-> language
= cu_language
;
1981 do_cleanups (back_to
);
1990 process_dies -- process a range of DWARF Information Entries
1994 static void process_dies (char *thisdie, char *enddie,
1995 struct objfile *objfile)
1999 Process all DIE's in a specified range. May be (and almost
2000 certainly will be) called recursively.
2004 process_dies (thisdie
, enddie
, objfile
)
2007 struct objfile
*objfile
;
2012 while (thisdie
< enddie
)
2014 basicdieinfo (&di
, thisdie
, objfile
);
2015 if (di
.die_length
< SIZEOF_DIE_LENGTH
)
2019 else if (di
.die_tag
== TAG_padding
)
2021 nextdie
= thisdie
+ di
.die_length
;
2025 completedieinfo (&di
, objfile
);
2026 if (di
.at_sibling
!= 0)
2028 nextdie
= dbbase
+ di
.at_sibling
- dbroff
;
2032 nextdie
= thisdie
+ di
.die_length
;
2036 case TAG_compile_unit
:
2037 read_file_scope (&di
, thisdie
, nextdie
, objfile
);
2039 case TAG_global_subroutine
:
2040 case TAG_subroutine
:
2041 if (di
.has_at_low_pc
)
2043 read_func_scope (&di
, thisdie
, nextdie
, objfile
);
2046 case TAG_lexical_block
:
2047 read_lexical_block_scope (&di
, thisdie
, nextdie
, objfile
);
2049 case TAG_class_type
:
2050 case TAG_structure_type
:
2051 case TAG_union_type
:
2052 read_structure_scope (&di
, thisdie
, nextdie
, objfile
);
2054 case TAG_enumeration_type
:
2055 read_enumeration (&di
, thisdie
, nextdie
, objfile
);
2057 case TAG_subroutine_type
:
2058 read_subroutine_type (&di
, thisdie
, nextdie
);
2060 case TAG_array_type
:
2061 dwarf_read_array_type (&di
);
2063 case TAG_pointer_type
:
2064 read_tag_pointer_type (&di
);
2066 case TAG_string_type
:
2067 read_tag_string_type (&di
);
2070 new_symbol (&di
, objfile
);
2082 decode_line_numbers -- decode a line number table fragment
2086 static void decode_line_numbers (char *tblscan, char *tblend,
2087 long length, long base, long line, long pc)
2091 Translate the DWARF line number information to gdb form.
2093 The ".line" section contains one or more line number tables, one for
2094 each ".line" section from the objects that were linked.
2096 The AT_stmt_list attribute for each TAG_source_file entry in the
2097 ".debug" section contains the offset into the ".line" section for the
2098 start of the table for that file.
2100 The table itself has the following structure:
2102 <table length><base address><source statement entry>
2103 4 bytes 4 bytes 10 bytes
2105 The table length is the total size of the table, including the 4 bytes
2106 for the length information.
2108 The base address is the address of the first instruction generated
2109 for the source file.
2111 Each source statement entry has the following structure:
2113 <line number><statement position><address delta>
2114 4 bytes 2 bytes 4 bytes
2116 The line number is relative to the start of the file, starting with
2119 The statement position either -1 (0xFFFF) or the number of characters
2120 from the beginning of the line to the beginning of the statement.
2122 The address delta is the difference between the base address and
2123 the address of the first instruction for the statement.
2125 Note that we must copy the bytes from the packed table to our local
2126 variables before attempting to use them, to avoid alignment problems
2127 on some machines, particularly RISC processors.
2131 Does gdb expect the line numbers to be sorted? They are now by
2132 chance/luck, but are not required to be. (FIXME)
2134 The line with number 0 is unused, gdb apparently can discover the
2135 span of the last line some other way. How? (FIXME)
2139 decode_line_numbers (linetable
)
2144 unsigned long length
;
2149 if (linetable
!= NULL
)
2151 tblscan
= tblend
= linetable
;
2152 length
= target_to_host (tblscan
, SIZEOF_LINETBL_LENGTH
, GET_UNSIGNED
,
2154 tblscan
+= SIZEOF_LINETBL_LENGTH
;
2156 base
= target_to_host (tblscan
, TARGET_FT_POINTER_SIZE (objfile
),
2157 GET_UNSIGNED
, current_objfile
);
2158 tblscan
+= TARGET_FT_POINTER_SIZE (objfile
);
2160 while (tblscan
< tblend
)
2162 line
= target_to_host (tblscan
, SIZEOF_LINETBL_LINENO
, GET_UNSIGNED
,
2164 tblscan
+= SIZEOF_LINETBL_LINENO
+ SIZEOF_LINETBL_STMT
;
2165 pc
= target_to_host (tblscan
, SIZEOF_LINETBL_DELTA
, GET_UNSIGNED
,
2167 tblscan
+= SIZEOF_LINETBL_DELTA
;
2171 record_line (current_subfile
, line
, pc
);
2181 locval -- compute the value of a location attribute
2185 static int locval (char *loc)
2189 Given pointer to a string of bytes that define a location, compute
2190 the location and return the value.
2192 When computing values involving the current value of the frame pointer,
2193 the value zero is used, which results in a value relative to the frame
2194 pointer, rather than the absolute value. This is what GDB wants
2197 When the result is a register number, the global isreg flag is set,
2198 otherwise it is cleared. This is a kludge until we figure out a better
2199 way to handle the problem. Gdb's design does not mesh well with the
2200 DWARF notion of a location computing interpreter, which is a shame
2201 because the flexibility goes unused.
2205 Note that stack[0] is unused except as a default error return.
2206 Note that stack overflow is not yet handled.
2213 unsigned short nbytes
;
2214 unsigned short locsize
;
2215 auto long stack
[64];
2222 nbytes
= attribute_size (AT_location
);
2223 locsize
= target_to_host (loc
, nbytes
, GET_UNSIGNED
, current_objfile
);
2225 end
= loc
+ locsize
;
2230 loc_value_size
= TARGET_FT_LONG_SIZE (current_objfile
);
2233 loc_atom_code
= target_to_host (loc
, SIZEOF_LOC_ATOM_CODE
, GET_UNSIGNED
,
2235 loc
+= SIZEOF_LOC_ATOM_CODE
;
2236 switch (loc_atom_code
)
2243 /* push register (number) */
2244 stack
[++stacki
] = target_to_host (loc
, loc_value_size
,
2245 GET_UNSIGNED
, current_objfile
);
2246 loc
+= loc_value_size
;
2250 /* push value of register (number) */
2251 /* Actually, we compute the value as if register has 0 */
2253 regno
= target_to_host (loc
, loc_value_size
, GET_UNSIGNED
,
2255 loc
+= loc_value_size
;
2258 stack
[++stacki
] = 0;
2262 stack
[++stacki
] = 0;
2264 complain (&basereg_not_handled
, DIE_ID
, DIE_NAME
, regno
);
2268 /* push address (relocated address) */
2269 stack
[++stacki
] = target_to_host (loc
, loc_value_size
,
2270 GET_UNSIGNED
, current_objfile
);
2271 loc
+= loc_value_size
;
2274 /* push constant (number) FIXME: signed or unsigned! */
2275 stack
[++stacki
] = target_to_host (loc
, loc_value_size
,
2276 GET_SIGNED
, current_objfile
);
2277 loc
+= loc_value_size
;
2280 /* pop, deref and push 2 bytes (as a long) */
2281 complain (&op_deref2
, DIE_ID
, DIE_NAME
, stack
[stacki
]);
2283 case OP_DEREF4
: /* pop, deref and push 4 bytes (as a long) */
2284 complain (&op_deref4
, DIE_ID
, DIE_NAME
, stack
[stacki
]);
2286 case OP_ADD
: /* pop top 2 items, add, push result */
2287 stack
[stacki
- 1] += stack
[stacki
];
2292 return (stack
[stacki
]);
2299 read_ofile_symtab -- build a full symtab entry from chunk of DIE's
2303 static void read_ofile_symtab (struct partial_symtab *pst)
2307 When expanding a partial symbol table entry to a full symbol table
2308 entry, this is the function that gets called to read in the symbols
2309 for the compilation unit. A pointer to the newly constructed symtab,
2310 which is now the new first one on the objfile's symtab list, is
2311 stashed in the partial symbol table entry.
2315 read_ofile_symtab (pst
)
2316 struct partial_symtab
*pst
;
2318 struct cleanup
*back_to
;
2319 unsigned long lnsize
;
2322 char lnsizedata
[SIZEOF_LINETBL_LENGTH
];
2324 abfd
= pst
-> objfile
-> obfd
;
2325 current_objfile
= pst
-> objfile
;
2327 /* Allocate a buffer for the entire chunk of DIE's for this compilation
2328 unit, seek to the location in the file, and read in all the DIE's. */
2331 dbsize
= DBLENGTH (pst
);
2332 dbbase
= xmalloc (dbsize
);
2333 dbroff
= DBROFF(pst
);
2334 foffset
= DBFOFF(pst
) + dbroff
;
2335 base_section_offsets
= pst
->section_offsets
;
2336 baseaddr
= ANOFFSET (pst
->section_offsets
, 0);
2337 if (bfd_seek (abfd
, foffset
, L_SET
) ||
2338 (bfd_read (dbbase
, dbsize
, 1, abfd
) != dbsize
))
2341 error ("can't read DWARF data");
2343 back_to
= make_cleanup (free
, dbbase
);
2345 /* If there is a line number table associated with this compilation unit
2346 then read the size of this fragment in bytes, from the fragment itself.
2347 Allocate a buffer for the fragment and read it in for future
2353 if (bfd_seek (abfd
, LNFOFF (pst
), L_SET
) ||
2354 (bfd_read ((PTR
) lnsizedata
, sizeof (lnsizedata
), 1, abfd
) !=
2355 sizeof (lnsizedata
)))
2357 error ("can't read DWARF line number table size");
2359 lnsize
= target_to_host (lnsizedata
, SIZEOF_LINETBL_LENGTH
,
2360 GET_UNSIGNED
, pst
-> objfile
);
2361 lnbase
= xmalloc (lnsize
);
2362 if (bfd_seek (abfd
, LNFOFF (pst
), L_SET
) ||
2363 (bfd_read (lnbase
, lnsize
, 1, abfd
) != lnsize
))
2366 error ("can't read DWARF line numbers");
2368 make_cleanup (free
, lnbase
);
2371 process_dies (dbbase
, dbbase
+ dbsize
, pst
-> objfile
);
2372 do_cleanups (back_to
);
2373 current_objfile
= NULL
;
2374 pst
-> symtab
= pst
-> objfile
-> symtabs
;
2381 psymtab_to_symtab_1 -- do grunt work for building a full symtab entry
2385 static void psymtab_to_symtab_1 (struct partial_symtab *pst)
2389 Called once for each partial symbol table entry that needs to be
2390 expanded into a full symbol table entry.
2395 psymtab_to_symtab_1 (pst
)
2396 struct partial_symtab
*pst
;
2399 struct cleanup
*old_chain
;
2405 warning ("psymtab for %s already read in. Shouldn't happen.",
2410 /* Read in all partial symtabs on which this one is dependent */
2411 for (i
= 0; i
< pst
-> number_of_dependencies
; i
++)
2413 if (!pst
-> dependencies
[i
] -> readin
)
2415 /* Inform about additional files that need to be read in. */
2418 fputs_filtered (" ", stdout
);
2420 fputs_filtered ("and ", stdout
);
2422 printf_filtered ("%s...",
2423 pst
-> dependencies
[i
] -> filename
);
2425 fflush (stdout
); /* Flush output */
2427 psymtab_to_symtab_1 (pst
-> dependencies
[i
]);
2430 if (DBLENGTH (pst
)) /* Otherwise it's a dummy */
2433 old_chain
= make_cleanup (really_free_pendings
, 0);
2434 read_ofile_symtab (pst
);
2437 printf_filtered ("%d DIE's, sorting...", diecount
);
2441 sort_symtab_syms (pst
-> symtab
);
2442 do_cleanups (old_chain
);
2453 dwarf_psymtab_to_symtab -- build a full symtab entry from partial one
2457 static void dwarf_psymtab_to_symtab (struct partial_symtab *pst)
2461 This is the DWARF support entry point for building a full symbol
2462 table entry from a partial symbol table entry. We are passed a
2463 pointer to the partial symbol table entry that needs to be expanded.
2468 dwarf_psymtab_to_symtab (pst
)
2469 struct partial_symtab
*pst
;
2476 warning ("psymtab for %s already read in. Shouldn't happen.",
2481 if (DBLENGTH (pst
) || pst
-> number_of_dependencies
)
2483 /* Print the message now, before starting serious work, to avoid
2484 disconcerting pauses. */
2487 printf_filtered ("Reading in symbols for %s...",
2492 psymtab_to_symtab_1 (pst
);
2494 #if 0 /* FIXME: Check to see what dbxread is doing here and see if
2495 we need to do an equivalent or is this something peculiar to
2497 Match with global symbols. This only needs to be done once,
2498 after all of the symtabs and dependencies have been read in.
2500 scan_file_globals (pst
-> objfile
);
2503 /* Finish up the verbose info message. */
2506 printf_filtered ("done.\n");
2518 init_psymbol_list -- initialize storage for partial symbols
2522 static void init_psymbol_list (struct objfile *objfile, int total_symbols)
2526 Initializes storage for all of the partial symbols that will be
2527 created by dwarf_build_psymtabs and subsidiaries.
2531 init_psymbol_list (objfile
, total_symbols
)
2532 struct objfile
*objfile
;
2535 /* Free any previously allocated psymbol lists. */
2537 if (objfile
-> global_psymbols
.list
)
2539 mfree (objfile
-> md
, (PTR
)objfile
-> global_psymbols
.list
);
2541 if (objfile
-> static_psymbols
.list
)
2543 mfree (objfile
-> md
, (PTR
)objfile
-> static_psymbols
.list
);
2546 /* Current best guess is that there are approximately a twentieth
2547 of the total symbols (in a debugging file) are global or static
2550 objfile
-> global_psymbols
.size
= total_symbols
/ 10;
2551 objfile
-> static_psymbols
.size
= total_symbols
/ 10;
2552 objfile
-> global_psymbols
.next
=
2553 objfile
-> global_psymbols
.list
= (struct partial_symbol
*)
2554 xmmalloc (objfile
-> md
, objfile
-> global_psymbols
.size
2555 * sizeof (struct partial_symbol
));
2556 objfile
-> static_psymbols
.next
=
2557 objfile
-> static_psymbols
.list
= (struct partial_symbol
*)
2558 xmmalloc (objfile
-> md
, objfile
-> static_psymbols
.size
2559 * sizeof (struct partial_symbol
));
2566 add_enum_psymbol -- add enumeration members to partial symbol table
2570 Given pointer to a DIE that is known to be for an enumeration,
2571 extract the symbolic names of the enumeration members and add
2572 partial symbols for them.
2576 add_enum_psymbol (dip
, objfile
)
2577 struct dieinfo
*dip
;
2578 struct objfile
*objfile
;
2582 unsigned short blocksz
;
2585 if ((scan
= dip
-> at_element_list
) != NULL
)
2587 if (dip
-> short_element_list
)
2589 nbytes
= attribute_size (AT_short_element_list
);
2593 nbytes
= attribute_size (AT_element_list
);
2595 blocksz
= target_to_host (scan
, nbytes
, GET_UNSIGNED
, objfile
);
2597 listend
= scan
+ blocksz
;
2598 while (scan
< listend
)
2600 scan
+= TARGET_FT_LONG_SIZE (objfile
);
2601 ADD_PSYMBOL_TO_LIST (scan
, strlen (scan
), VAR_NAMESPACE
, LOC_CONST
,
2602 objfile
-> static_psymbols
, 0, cu_language
,
2604 scan
+= strlen (scan
) + 1;
2613 add_partial_symbol -- add symbol to partial symbol table
2617 Given a DIE, if it is one of the types that we want to
2618 add to a partial symbol table, finish filling in the die info
2619 and then add a partial symbol table entry for it.
2623 The caller must ensure that the DIE has a valid name attribute.
2627 add_partial_symbol (dip
, objfile
)
2628 struct dieinfo
*dip
;
2629 struct objfile
*objfile
;
2631 switch (dip
-> die_tag
)
2633 case TAG_global_subroutine
:
2634 record_minimal_symbol (dip
-> at_name
, dip
-> at_low_pc
, mst_text
,
2636 ADD_PSYMBOL_TO_LIST (dip
-> at_name
, strlen (dip
-> at_name
),
2637 VAR_NAMESPACE
, LOC_BLOCK
,
2638 objfile
-> global_psymbols
,
2639 dip
-> at_low_pc
, cu_language
, objfile
);
2641 case TAG_global_variable
:
2642 record_minimal_symbol (dip
-> at_name
, locval (dip
-> at_location
),
2644 ADD_PSYMBOL_TO_LIST (dip
-> at_name
, strlen (dip
-> at_name
),
2645 VAR_NAMESPACE
, LOC_STATIC
,
2646 objfile
-> global_psymbols
,
2647 0, cu_language
, objfile
);
2649 case TAG_subroutine
:
2650 ADD_PSYMBOL_TO_LIST (dip
-> at_name
, strlen (dip
-> at_name
),
2651 VAR_NAMESPACE
, LOC_BLOCK
,
2652 objfile
-> static_psymbols
,
2653 dip
-> at_low_pc
, cu_language
, objfile
);
2655 case TAG_local_variable
:
2656 ADD_PSYMBOL_TO_LIST (dip
-> at_name
, strlen (dip
-> at_name
),
2657 VAR_NAMESPACE
, LOC_STATIC
,
2658 objfile
-> static_psymbols
,
2659 0, cu_language
, objfile
);
2662 ADD_PSYMBOL_TO_LIST (dip
-> at_name
, strlen (dip
-> at_name
),
2663 VAR_NAMESPACE
, LOC_TYPEDEF
,
2664 objfile
-> static_psymbols
,
2665 0, cu_language
, objfile
);
2667 case TAG_class_type
:
2668 case TAG_structure_type
:
2669 case TAG_union_type
:
2670 case TAG_enumeration_type
:
2671 ADD_PSYMBOL_TO_LIST (dip
-> at_name
, strlen (dip
-> at_name
),
2672 STRUCT_NAMESPACE
, LOC_TYPEDEF
,
2673 objfile
-> static_psymbols
,
2674 0, cu_language
, objfile
);
2675 if (cu_language
== language_cplus
)
2677 /* For C++, these implicitly act as typedefs as well. */
2678 ADD_PSYMBOL_TO_LIST (dip
-> at_name
, strlen (dip
-> at_name
),
2679 VAR_NAMESPACE
, LOC_TYPEDEF
,
2680 objfile
-> static_psymbols
,
2681 0, cu_language
, objfile
);
2691 scan_partial_symbols -- scan DIE's within a single compilation unit
2695 Process the DIE's within a single compilation unit, looking for
2696 interesting DIE's that contribute to the partial symbol table entry
2697 for this compilation unit.
2701 There are some DIE's that may appear both at file scope and within
2702 the scope of a function. We are only interested in the ones at file
2703 scope, and the only way to tell them apart is to keep track of the
2704 scope. For example, consider the test case:
2709 for which the relevant DWARF segment has the structure:
2712 0x23 global subrtn sibling 0x9b
2714 fund_type FT_integer
2719 0x23 local var sibling 0x97
2721 fund_type FT_integer
2722 location OP_BASEREG 0xe
2729 0x1d local var sibling 0xb8
2731 fund_type FT_integer
2732 location OP_ADDR 0x800025dc
2737 We want to include the symbol 'i' in the partial symbol table, but
2738 not the symbol 'j'. In essence, we want to skip all the dies within
2739 the scope of a TAG_global_subroutine DIE.
2741 Don't attempt to add anonymous structures or unions since they have
2742 no name. Anonymous enumerations however are processed, because we
2743 want to extract their member names (the check for a tag name is
2746 Also, for variables and subroutines, check that this is the place
2747 where the actual definition occurs, rather than just a reference
2752 scan_partial_symbols (thisdie
, enddie
, objfile
)
2755 struct objfile
*objfile
;
2761 while (thisdie
< enddie
)
2763 basicdieinfo (&di
, thisdie
, objfile
);
2764 if (di
.die_length
< SIZEOF_DIE_LENGTH
)
2770 nextdie
= thisdie
+ di
.die_length
;
2771 /* To avoid getting complete die information for every die, we
2772 only do it (below) for the cases we are interested in. */
2775 case TAG_global_subroutine
:
2776 case TAG_subroutine
:
2777 completedieinfo (&di
, objfile
);
2778 if (di
.at_name
&& (di
.has_at_low_pc
|| di
.at_location
))
2780 add_partial_symbol (&di
, objfile
);
2781 /* If there is a sibling attribute, adjust the nextdie
2782 pointer to skip the entire scope of the subroutine.
2783 Apply some sanity checking to make sure we don't
2784 overrun or underrun the range of remaining DIE's */
2785 if (di
.at_sibling
!= 0)
2787 temp
= dbbase
+ di
.at_sibling
- dbroff
;
2788 if ((temp
< thisdie
) || (temp
>= enddie
))
2790 complain (&bad_die_ref
, DIE_ID
, DIE_NAME
,
2800 case TAG_global_variable
:
2801 case TAG_local_variable
:
2802 completedieinfo (&di
, objfile
);
2803 if (di
.at_name
&& (di
.has_at_low_pc
|| di
.at_location
))
2805 add_partial_symbol (&di
, objfile
);
2809 case TAG_class_type
:
2810 case TAG_structure_type
:
2811 case TAG_union_type
:
2812 completedieinfo (&di
, objfile
);
2815 add_partial_symbol (&di
, objfile
);
2818 case TAG_enumeration_type
:
2819 completedieinfo (&di
, objfile
);
2822 add_partial_symbol (&di
, objfile
);
2824 add_enum_psymbol (&di
, objfile
);
2836 scan_compilation_units -- build a psymtab entry for each compilation
2840 This is the top level dwarf parsing routine for building partial
2843 It scans from the beginning of the DWARF table looking for the first
2844 TAG_compile_unit DIE, and then follows the sibling chain to locate
2845 each additional TAG_compile_unit DIE.
2847 For each TAG_compile_unit DIE it creates a partial symtab structure,
2848 calls a subordinate routine to collect all the compilation unit's
2849 global DIE's, file scope DIEs, typedef DIEs, etc, and then links the
2850 new partial symtab structure into the partial symbol table. It also
2851 records the appropriate information in the partial symbol table entry
2852 to allow the chunk of DIE's and line number table for this compilation
2853 unit to be located and re-read later, to generate a complete symbol
2854 table entry for the compilation unit.
2856 Thus it effectively partitions up a chunk of DIE's for multiple
2857 compilation units into smaller DIE chunks and line number tables,
2858 and associates them with a partial symbol table entry.
2862 If any compilation unit has no line number table associated with
2863 it for some reason (a missing at_stmt_list attribute, rather than
2864 just one with a value of zero, which is valid) then we ensure that
2865 the recorded file offset is zero so that the routine which later
2866 reads line number table fragments knows that there is no fragment
2876 scan_compilation_units (thisdie
, enddie
, dbfoff
, lnoffset
, objfile
)
2881 struct objfile
*objfile
;
2885 struct partial_symtab
*pst
;
2888 file_ptr curlnoffset
;
2890 while (thisdie
< enddie
)
2892 basicdieinfo (&di
, thisdie
, objfile
);
2893 if (di
.die_length
< SIZEOF_DIE_LENGTH
)
2897 else if (di
.die_tag
!= TAG_compile_unit
)
2899 nextdie
= thisdie
+ di
.die_length
;
2903 completedieinfo (&di
, objfile
);
2904 set_cu_language (&di
);
2905 if (di
.at_sibling
!= 0)
2907 nextdie
= dbbase
+ di
.at_sibling
- dbroff
;
2911 nextdie
= thisdie
+ di
.die_length
;
2913 curoff
= thisdie
- dbbase
;
2914 culength
= nextdie
- thisdie
;
2915 curlnoffset
= di
.has_at_stmt_list
? lnoffset
+ di
.at_stmt_list
: 0;
2917 /* First allocate a new partial symbol table structure */
2919 pst
= start_psymtab_common (objfile
, base_section_offsets
,
2920 di
.at_name
, di
.at_low_pc
,
2921 objfile
-> global_psymbols
.next
,
2922 objfile
-> static_psymbols
.next
);
2924 pst
-> texthigh
= di
.at_high_pc
;
2925 pst
-> read_symtab_private
= (char *)
2926 obstack_alloc (&objfile
-> psymbol_obstack
,
2927 sizeof (struct dwfinfo
));
2928 DBFOFF (pst
) = dbfoff
;
2929 DBROFF (pst
) = curoff
;
2930 DBLENGTH (pst
) = culength
;
2931 LNFOFF (pst
) = curlnoffset
;
2932 pst
-> read_symtab
= dwarf_psymtab_to_symtab
;
2934 /* Now look for partial symbols */
2936 scan_partial_symbols (thisdie
+ di
.die_length
, nextdie
, objfile
);
2938 pst
-> n_global_syms
= objfile
-> global_psymbols
.next
-
2939 (objfile
-> global_psymbols
.list
+ pst
-> globals_offset
);
2940 pst
-> n_static_syms
= objfile
-> static_psymbols
.next
-
2941 (objfile
-> static_psymbols
.list
+ pst
-> statics_offset
);
2942 sort_pst_symbols (pst
);
2943 /* If there is already a psymtab or symtab for a file of this name,
2944 remove it. (If there is a symtab, more drastic things also
2945 happen.) This happens in VxWorks. */
2946 free_named_symtabs (pst
-> filename
);
2956 new_symbol -- make a symbol table entry for a new symbol
2960 static struct symbol *new_symbol (struct dieinfo *dip,
2961 struct objfile *objfile)
2965 Given a pointer to a DWARF information entry, figure out if we need
2966 to make a symbol table entry for it, and if so, create a new entry
2967 and return a pointer to it.
2970 static struct symbol
*
2971 new_symbol (dip
, objfile
)
2972 struct dieinfo
*dip
;
2973 struct objfile
*objfile
;
2975 struct symbol
*sym
= NULL
;
2977 if (dip
-> at_name
!= NULL
)
2979 sym
= (struct symbol
*) obstack_alloc (&objfile
-> symbol_obstack
,
2980 sizeof (struct symbol
));
2981 memset (sym
, 0, sizeof (struct symbol
));
2982 SYMBOL_NAME (sym
) = create_name (dip
-> at_name
,
2983 &objfile
->symbol_obstack
);
2984 /* default assumptions */
2985 SYMBOL_NAMESPACE (sym
) = VAR_NAMESPACE
;
2986 SYMBOL_CLASS (sym
) = LOC_STATIC
;
2987 SYMBOL_TYPE (sym
) = decode_die_type (dip
);
2989 /* If this symbol is from a C++ compilation, then attempt to cache the
2990 demangled form for future reference. This is a typical time versus
2991 space tradeoff, that was decided in favor of time because it sped up
2992 C++ symbol lookups by a factor of about 20. */
2994 SYMBOL_LANGUAGE (sym
) = cu_language
;
2995 SYMBOL_INIT_DEMANGLED_NAME (sym
, &objfile
-> symbol_obstack
);
2996 switch (dip
-> die_tag
)
2999 SYMBOL_VALUE (sym
) = dip
-> at_low_pc
;
3000 SYMBOL_CLASS (sym
) = LOC_LABEL
;
3002 case TAG_global_subroutine
:
3003 case TAG_subroutine
:
3004 SYMBOL_VALUE (sym
) = dip
-> at_low_pc
;
3005 SYMBOL_TYPE (sym
) = lookup_function_type (SYMBOL_TYPE (sym
));
3006 SYMBOL_CLASS (sym
) = LOC_BLOCK
;
3007 if (dip
-> die_tag
== TAG_global_subroutine
)
3009 add_symbol_to_list (sym
, &global_symbols
);
3013 add_symbol_to_list (sym
, list_in_scope
);
3016 case TAG_global_variable
:
3017 if (dip
-> at_location
!= NULL
)
3019 SYMBOL_VALUE (sym
) = locval (dip
-> at_location
);
3020 add_symbol_to_list (sym
, &global_symbols
);
3021 SYMBOL_CLASS (sym
) = LOC_STATIC
;
3022 SYMBOL_VALUE (sym
) += baseaddr
;
3025 case TAG_local_variable
:
3026 if (dip
-> at_location
!= NULL
)
3028 SYMBOL_VALUE (sym
) = locval (dip
-> at_location
);
3029 add_symbol_to_list (sym
, list_in_scope
);
3032 SYMBOL_CLASS (sym
) = LOC_REGISTER
;
3036 SYMBOL_CLASS (sym
) = LOC_LOCAL
;
3040 SYMBOL_CLASS (sym
) = LOC_STATIC
;
3041 SYMBOL_VALUE (sym
) += baseaddr
;
3045 case TAG_formal_parameter
:
3046 if (dip
-> at_location
!= NULL
)
3048 SYMBOL_VALUE (sym
) = locval (dip
-> at_location
);
3050 add_symbol_to_list (sym
, list_in_scope
);
3053 SYMBOL_CLASS (sym
) = LOC_REGPARM
;
3057 SYMBOL_CLASS (sym
) = LOC_ARG
;
3060 case TAG_unspecified_parameters
:
3061 /* From varargs functions; gdb doesn't seem to have any interest in
3062 this information, so just ignore it for now. (FIXME?) */
3064 case TAG_class_type
:
3065 case TAG_structure_type
:
3066 case TAG_union_type
:
3067 case TAG_enumeration_type
:
3068 SYMBOL_CLASS (sym
) = LOC_TYPEDEF
;
3069 SYMBOL_NAMESPACE (sym
) = STRUCT_NAMESPACE
;
3070 add_symbol_to_list (sym
, list_in_scope
);
3073 SYMBOL_CLASS (sym
) = LOC_TYPEDEF
;
3074 SYMBOL_NAMESPACE (sym
) = VAR_NAMESPACE
;
3075 add_symbol_to_list (sym
, list_in_scope
);
3078 /* Not a tag we recognize. Hopefully we aren't processing trash
3079 data, but since we must specifically ignore things we don't
3080 recognize, there is nothing else we should do at this point. */
3091 synthesize_typedef -- make a symbol table entry for a "fake" typedef
3095 static void synthesize_typedef (struct dieinfo *dip,
3096 struct objfile *objfile,
3101 Given a pointer to a DWARF information entry, synthesize a typedef
3102 for the name in the DIE, using the specified type.
3104 This is used for C++ class, structs, unions, and enumerations to
3105 set up the tag name as a type.
3110 synthesize_typedef (dip
, objfile
, type
)
3111 struct dieinfo
*dip
;
3112 struct objfile
*objfile
;
3115 struct symbol
*sym
= NULL
;
3117 if (dip
-> at_name
!= NULL
)
3119 sym
= (struct symbol
*)
3120 obstack_alloc (&objfile
-> symbol_obstack
, sizeof (struct symbol
));
3121 memset (sym
, 0, sizeof (struct symbol
));
3122 SYMBOL_NAME (sym
) = create_name (dip
-> at_name
,
3123 &objfile
->symbol_obstack
);
3124 SYMBOL_INIT_LANGUAGE_SPECIFIC (sym
, cu_language
);
3125 SYMBOL_TYPE (sym
) = type
;
3126 SYMBOL_CLASS (sym
) = LOC_TYPEDEF
;
3127 SYMBOL_NAMESPACE (sym
) = VAR_NAMESPACE
;
3128 add_symbol_to_list (sym
, list_in_scope
);
3136 decode_mod_fund_type -- decode a modified fundamental type
3140 static struct type *decode_mod_fund_type (char *typedata)
3144 Decode a block of data containing a modified fundamental
3145 type specification. TYPEDATA is a pointer to the block,
3146 which starts with a length containing the size of the rest
3147 of the block. At the end of the block is a fundmental type
3148 code value that gives the fundamental type. Everything
3149 in between are type modifiers.
3151 We simply compute the number of modifiers and call the general
3152 function decode_modified_type to do the actual work.
3155 static struct type
*
3156 decode_mod_fund_type (typedata
)
3159 struct type
*typep
= NULL
;
3160 unsigned short modcount
;
3163 /* Get the total size of the block, exclusive of the size itself */
3165 nbytes
= attribute_size (AT_mod_fund_type
);
3166 modcount
= target_to_host (typedata
, nbytes
, GET_UNSIGNED
, current_objfile
);
3169 /* Deduct the size of the fundamental type bytes at the end of the block. */
3171 modcount
-= attribute_size (AT_fund_type
);
3173 /* Now do the actual decoding */
3175 typep
= decode_modified_type (typedata
, modcount
, AT_mod_fund_type
);
3183 decode_mod_u_d_type -- decode a modified user defined type
3187 static struct type *decode_mod_u_d_type (char *typedata)
3191 Decode a block of data containing a modified user defined
3192 type specification. TYPEDATA is a pointer to the block,
3193 which consists of a two byte length, containing the size
3194 of the rest of the block. At the end of the block is a
3195 four byte value that gives a reference to a user defined type.
3196 Everything in between are type modifiers.
3198 We simply compute the number of modifiers and call the general
3199 function decode_modified_type to do the actual work.
3202 static struct type
*
3203 decode_mod_u_d_type (typedata
)
3206 struct type
*typep
= NULL
;
3207 unsigned short modcount
;
3210 /* Get the total size of the block, exclusive of the size itself */
3212 nbytes
= attribute_size (AT_mod_u_d_type
);
3213 modcount
= target_to_host (typedata
, nbytes
, GET_UNSIGNED
, current_objfile
);
3216 /* Deduct the size of the reference type bytes at the end of the block. */
3218 modcount
-= attribute_size (AT_user_def_type
);
3220 /* Now do the actual decoding */
3222 typep
= decode_modified_type (typedata
, modcount
, AT_mod_u_d_type
);
3230 decode_modified_type -- decode modified user or fundamental type
3234 static struct type *decode_modified_type (char *modifiers,
3235 unsigned short modcount, int mtype)
3239 Decode a modified type, either a modified fundamental type or
3240 a modified user defined type. MODIFIERS is a pointer to the
3241 block of bytes that define MODCOUNT modifiers. Immediately
3242 following the last modifier is a short containing the fundamental
3243 type or a long containing the reference to the user defined
3244 type. Which one is determined by MTYPE, which is either
3245 AT_mod_fund_type or AT_mod_u_d_type to indicate what modified
3246 type we are generating.
3248 We call ourself recursively to generate each modified type,`
3249 until MODCOUNT reaches zero, at which point we have consumed
3250 all the modifiers and generate either the fundamental type or
3251 user defined type. When the recursion unwinds, each modifier
3252 is applied in turn to generate the full modified type.
3256 If we find a modifier that we don't recognize, and it is not one
3257 of those reserved for application specific use, then we issue a
3258 warning and simply ignore the modifier.
3262 We currently ignore MOD_const and MOD_volatile. (FIXME)
3266 static struct type
*
3267 decode_modified_type (modifiers
, modcount
, mtype
)
3269 unsigned int modcount
;
3272 struct type
*typep
= NULL
;
3273 unsigned short fundtype
;
3282 case AT_mod_fund_type
:
3283 nbytes
= attribute_size (AT_fund_type
);
3284 fundtype
= target_to_host (modifiers
, nbytes
, GET_UNSIGNED
,
3286 typep
= decode_fund_type (fundtype
);
3288 case AT_mod_u_d_type
:
3289 nbytes
= attribute_size (AT_user_def_type
);
3290 die_ref
= target_to_host (modifiers
, nbytes
, GET_UNSIGNED
,
3292 if ((typep
= lookup_utype (die_ref
)) == NULL
)
3294 typep
= alloc_utype (die_ref
, NULL
);
3298 complain (&botched_modified_type
, DIE_ID
, DIE_NAME
, mtype
);
3299 typep
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
3305 modifier
= *modifiers
++;
3306 typep
= decode_modified_type (modifiers
, --modcount
, mtype
);
3309 case MOD_pointer_to
:
3310 typep
= lookup_pointer_type (typep
);
3312 case MOD_reference_to
:
3313 typep
= lookup_reference_type (typep
);
3316 complain (&const_ignored
, DIE_ID
, DIE_NAME
); /* FIXME */
3319 complain (&volatile_ignored
, DIE_ID
, DIE_NAME
); /* FIXME */
3322 if (!(MOD_lo_user
<= (unsigned char) modifier
3323 && (unsigned char) modifier
<= MOD_hi_user
))
3325 complain (&unknown_type_modifier
, DIE_ID
, DIE_NAME
, modifier
);
3337 decode_fund_type -- translate basic DWARF type to gdb base type
3341 Given an integer that is one of the fundamental DWARF types,
3342 translate it to one of the basic internal gdb types and return
3343 a pointer to the appropriate gdb type (a "struct type *").
3347 For robustness, if we are asked to translate a fundamental
3348 type that we are unprepared to deal with, we return int so
3349 callers can always depend upon a valid type being returned,
3350 and so gdb may at least do something reasonable by default.
3351 If the type is not in the range of those types defined as
3352 application specific types, we also issue a warning.
3355 static struct type
*
3356 decode_fund_type (fundtype
)
3357 unsigned int fundtype
;
3359 struct type
*typep
= NULL
;
3365 typep
= dwarf_fundamental_type (current_objfile
, FT_VOID
);
3368 case FT_boolean
: /* Was FT_set in AT&T version */
3369 typep
= dwarf_fundamental_type (current_objfile
, FT_BOOLEAN
);
3372 case FT_pointer
: /* (void *) */
3373 typep
= dwarf_fundamental_type (current_objfile
, FT_VOID
);
3374 typep
= lookup_pointer_type (typep
);
3378 typep
= dwarf_fundamental_type (current_objfile
, FT_CHAR
);
3381 case FT_signed_char
:
3382 typep
= dwarf_fundamental_type (current_objfile
, FT_SIGNED_CHAR
);
3385 case FT_unsigned_char
:
3386 typep
= dwarf_fundamental_type (current_objfile
, FT_UNSIGNED_CHAR
);
3390 typep
= dwarf_fundamental_type (current_objfile
, FT_SHORT
);
3393 case FT_signed_short
:
3394 typep
= dwarf_fundamental_type (current_objfile
, FT_SIGNED_SHORT
);
3397 case FT_unsigned_short
:
3398 typep
= dwarf_fundamental_type (current_objfile
, FT_UNSIGNED_SHORT
);
3402 typep
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
3405 case FT_signed_integer
:
3406 typep
= dwarf_fundamental_type (current_objfile
, FT_SIGNED_INTEGER
);
3409 case FT_unsigned_integer
:
3410 typep
= dwarf_fundamental_type (current_objfile
, FT_UNSIGNED_INTEGER
);
3414 typep
= dwarf_fundamental_type (current_objfile
, FT_LONG
);
3417 case FT_signed_long
:
3418 typep
= dwarf_fundamental_type (current_objfile
, FT_SIGNED_LONG
);
3421 case FT_unsigned_long
:
3422 typep
= dwarf_fundamental_type (current_objfile
, FT_UNSIGNED_LONG
);
3426 typep
= dwarf_fundamental_type (current_objfile
, FT_LONG_LONG
);
3429 case FT_signed_long_long
:
3430 typep
= dwarf_fundamental_type (current_objfile
, FT_SIGNED_LONG_LONG
);
3433 case FT_unsigned_long_long
:
3434 typep
= dwarf_fundamental_type (current_objfile
, FT_UNSIGNED_LONG_LONG
);
3438 typep
= dwarf_fundamental_type (current_objfile
, FT_FLOAT
);
3441 case FT_dbl_prec_float
:
3442 typep
= dwarf_fundamental_type (current_objfile
, FT_DBL_PREC_FLOAT
);
3445 case FT_ext_prec_float
:
3446 typep
= dwarf_fundamental_type (current_objfile
, FT_EXT_PREC_FLOAT
);
3450 typep
= dwarf_fundamental_type (current_objfile
, FT_COMPLEX
);
3453 case FT_dbl_prec_complex
:
3454 typep
= dwarf_fundamental_type (current_objfile
, FT_DBL_PREC_COMPLEX
);
3457 case FT_ext_prec_complex
:
3458 typep
= dwarf_fundamental_type (current_objfile
, FT_EXT_PREC_COMPLEX
);
3465 typep
= dwarf_fundamental_type (current_objfile
, FT_INTEGER
);
3466 if (!(FT_lo_user
<= fundtype
&& fundtype
<= FT_hi_user
))
3468 complain (&unexpected_fund_type
, DIE_ID
, DIE_NAME
, fundtype
);
3479 create_name -- allocate a fresh copy of a string on an obstack
3483 Given a pointer to a string and a pointer to an obstack, allocates
3484 a fresh copy of the string on the specified obstack.
3489 create_name (name
, obstackp
)
3491 struct obstack
*obstackp
;
3496 length
= strlen (name
) + 1;
3497 newname
= (char *) obstack_alloc (obstackp
, length
);
3498 strcpy (newname
, name
);
3506 basicdieinfo -- extract the minimal die info from raw die data
3510 void basicdieinfo (char *diep, struct dieinfo *dip,
3511 struct objfile *objfile)
3515 Given a pointer to raw DIE data, and a pointer to an instance of a
3516 die info structure, this function extracts the basic information
3517 from the DIE data required to continue processing this DIE, along
3518 with some bookkeeping information about the DIE.
3520 The information we absolutely must have includes the DIE tag,
3521 and the DIE length. If we need the sibling reference, then we
3522 will have to call completedieinfo() to process all the remaining
3525 Note that since there is no guarantee that the data is properly
3526 aligned in memory for the type of access required (indirection
3527 through anything other than a char pointer), and there is no
3528 guarantee that it is in the same byte order as the gdb host,
3529 we call a function which deals with both alignment and byte
3530 swapping issues. Possibly inefficient, but quite portable.
3532 We also take care of some other basic things at this point, such
3533 as ensuring that the instance of the die info structure starts
3534 out completely zero'd and that curdie is initialized for use
3535 in error reporting if we have a problem with the current die.
3539 All DIE's must have at least a valid length, thus the minimum
3540 DIE size is SIZEOF_DIE_LENGTH. In order to have a valid tag, the
3541 DIE size must be at least SIZEOF_DIE_TAG larger, otherwise they
3542 are forced to be TAG_padding DIES.
3544 Padding DIES must be at least SIZEOF_DIE_LENGTH in length, implying
3545 that if a padding DIE is used for alignment and the amount needed is
3546 less than SIZEOF_DIE_LENGTH, then the padding DIE has to be big
3547 enough to align to the next alignment boundry.
3549 We do some basic sanity checking here, such as verifying that the
3550 length of the die would not cause it to overrun the recorded end of
3551 the buffer holding the DIE info. If we find a DIE that is either
3552 too small or too large, we force it's length to zero which should
3553 cause the caller to take appropriate action.
3557 basicdieinfo (dip
, diep
, objfile
)
3558 struct dieinfo
*dip
;
3560 struct objfile
*objfile
;
3563 memset (dip
, 0, sizeof (struct dieinfo
));
3565 dip
-> die_ref
= dbroff
+ (diep
- dbbase
);
3566 dip
-> die_length
= target_to_host (diep
, SIZEOF_DIE_LENGTH
, GET_UNSIGNED
,
3568 if ((dip
-> die_length
< SIZEOF_DIE_LENGTH
) ||
3569 ((diep
+ dip
-> die_length
) > (dbbase
+ dbsize
)))
3571 complain (&malformed_die
, DIE_ID
, DIE_NAME
, dip
-> die_length
);
3572 dip
-> die_length
= 0;
3574 else if (dip
-> die_length
< (SIZEOF_DIE_LENGTH
+ SIZEOF_DIE_TAG
))
3576 dip
-> die_tag
= TAG_padding
;
3580 diep
+= SIZEOF_DIE_LENGTH
;
3581 dip
-> die_tag
= target_to_host (diep
, SIZEOF_DIE_TAG
, GET_UNSIGNED
,
3590 completedieinfo -- finish reading the information for a given DIE
3594 void completedieinfo (struct dieinfo *dip, struct objfile *objfile)
3598 Given a pointer to an already partially initialized die info structure,
3599 scan the raw DIE data and finish filling in the die info structure
3600 from the various attributes found.
3602 Note that since there is no guarantee that the data is properly
3603 aligned in memory for the type of access required (indirection
3604 through anything other than a char pointer), and there is no
3605 guarantee that it is in the same byte order as the gdb host,
3606 we call a function which deals with both alignment and byte
3607 swapping issues. Possibly inefficient, but quite portable.
3611 Each time we are called, we increment the diecount variable, which
3612 keeps an approximate count of the number of dies processed for
3613 each compilation unit. This information is presented to the user
3614 if the info_verbose flag is set.
3619 completedieinfo (dip
, objfile
)
3620 struct dieinfo
*dip
;
3621 struct objfile
*objfile
;
3623 char *diep
; /* Current pointer into raw DIE data */
3624 char *end
; /* Terminate DIE scan here */
3625 unsigned short attr
; /* Current attribute being scanned */
3626 unsigned short form
; /* Form of the attribute */
3627 int nbytes
; /* Size of next field to read */
3631 end
= diep
+ dip
-> die_length
;
3632 diep
+= SIZEOF_DIE_LENGTH
+ SIZEOF_DIE_TAG
;
3635 attr
= target_to_host (diep
, SIZEOF_ATTRIBUTE
, GET_UNSIGNED
, objfile
);
3636 diep
+= SIZEOF_ATTRIBUTE
;
3637 if ((nbytes
= attribute_size (attr
)) == -1)
3639 complain (&unknown_attribute_length
, DIE_ID
, DIE_NAME
);
3646 dip
-> at_fund_type
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3650 dip
-> at_ordering
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3654 dip
-> at_bit_offset
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3658 dip
-> at_sibling
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3662 dip
-> at_stmt_list
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3664 dip
-> has_at_stmt_list
= 1;
3667 dip
-> at_low_pc
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3669 dip
-> at_low_pc
+= baseaddr
;
3670 dip
-> has_at_low_pc
= 1;
3673 dip
-> at_high_pc
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3675 dip
-> at_high_pc
+= baseaddr
;
3678 dip
-> at_language
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3681 case AT_user_def_type
:
3682 dip
-> at_user_def_type
= target_to_host (diep
, nbytes
,
3683 GET_UNSIGNED
, objfile
);
3686 dip
-> at_byte_size
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3688 dip
-> has_at_byte_size
= 1;
3691 dip
-> at_bit_size
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3695 dip
-> at_member
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3699 dip
-> at_discr
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3703 dip
-> at_location
= diep
;
3705 case AT_mod_fund_type
:
3706 dip
-> at_mod_fund_type
= diep
;
3708 case AT_subscr_data
:
3709 dip
-> at_subscr_data
= diep
;
3711 case AT_mod_u_d_type
:
3712 dip
-> at_mod_u_d_type
= diep
;
3714 case AT_element_list
:
3715 dip
-> at_element_list
= diep
;
3716 dip
-> short_element_list
= 0;
3718 case AT_short_element_list
:
3719 dip
-> at_element_list
= diep
;
3720 dip
-> short_element_list
= 1;
3722 case AT_discr_value
:
3723 dip
-> at_discr_value
= diep
;
3725 case AT_string_length
:
3726 dip
-> at_string_length
= diep
;
3729 dip
-> at_name
= diep
;
3732 /* For now, ignore any "hostname:" portion, since gdb doesn't
3733 know how to deal with it. (FIXME). */
3734 dip
-> at_comp_dir
= strrchr (diep
, ':');
3735 if (dip
-> at_comp_dir
!= NULL
)
3737 dip
-> at_comp_dir
++;
3741 dip
-> at_comp_dir
= diep
;
3745 dip
-> at_producer
= diep
;
3747 case AT_start_scope
:
3748 dip
-> at_start_scope
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3751 case AT_stride_size
:
3752 dip
-> at_stride_size
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3756 dip
-> at_src_info
= target_to_host (diep
, nbytes
, GET_UNSIGNED
,
3760 dip
-> at_prototyped
= diep
;
3763 /* Found an attribute that we are unprepared to handle. However
3764 it is specifically one of the design goals of DWARF that
3765 consumers should ignore unknown attributes. As long as the
3766 form is one that we recognize (so we know how to skip it),
3767 we can just ignore the unknown attribute. */
3770 form
= FORM_FROM_ATTR (attr
);
3784 diep
+= TARGET_FT_POINTER_SIZE (objfile
);
3787 diep
+= 2 + target_to_host (diep
, nbytes
, GET_UNSIGNED
, objfile
);
3790 diep
+= 4 + target_to_host (diep
, nbytes
, GET_UNSIGNED
, objfile
);
3793 diep
+= strlen (diep
) + 1;
3796 complain (&unknown_attribute_form
, DIE_ID
, DIE_NAME
, form
);
3807 target_to_host -- swap in target data to host
3811 target_to_host (char *from, int nbytes, int signextend,
3812 struct objfile *objfile)
3816 Given pointer to data in target format in FROM, a byte count for
3817 the size of the data in NBYTES, a flag indicating whether or not
3818 the data is signed in SIGNEXTEND, and a pointer to the current
3819 objfile in OBJFILE, convert the data to host format and return
3820 the converted value.
3824 FIXME: If we read data that is known to be signed, and expect to
3825 use it as signed data, then we need to explicitly sign extend the
3826 result until the bfd library is able to do this for us.
3830 static unsigned long
3831 target_to_host (from
, nbytes
, signextend
, objfile
)
3834 int signextend
; /* FIXME: Unused */
3835 struct objfile
*objfile
;
3837 unsigned long rtnval
;
3842 rtnval
= bfd_get_64 (objfile
-> obfd
, (bfd_byte
*) from
);
3845 rtnval
= bfd_get_32 (objfile
-> obfd
, (bfd_byte
*) from
);
3848 rtnval
= bfd_get_16 (objfile
-> obfd
, (bfd_byte
*) from
);
3851 rtnval
= bfd_get_8 (objfile
-> obfd
, (bfd_byte
*) from
);
3854 complain (&no_bfd_get_N
, DIE_ID
, DIE_NAME
, nbytes
);
3865 attribute_size -- compute size of data for a DWARF attribute
3869 static int attribute_size (unsigned int attr)
3873 Given a DWARF attribute in ATTR, compute the size of the first
3874 piece of data associated with this attribute and return that
3877 Returns -1 for unrecognized attributes.
3882 attribute_size (attr
)
3885 int nbytes
; /* Size of next data for this attribute */
3886 unsigned short form
; /* Form of the attribute */
3888 form
= FORM_FROM_ATTR (attr
);
3891 case FORM_STRING
: /* A variable length field is next */
3894 case FORM_DATA2
: /* Next 2 byte field is the data itself */
3895 case FORM_BLOCK2
: /* Next 2 byte field is a block length */
3898 case FORM_DATA4
: /* Next 4 byte field is the data itself */
3899 case FORM_BLOCK4
: /* Next 4 byte field is a block length */
3900 case FORM_REF
: /* Next 4 byte field is a DIE offset */
3903 case FORM_DATA8
: /* Next 8 byte field is the data itself */
3906 case FORM_ADDR
: /* Next field size is target sizeof(void *) */
3907 nbytes
= TARGET_FT_POINTER_SIZE (objfile
);
3910 complain (&unknown_attribute_form
, DIE_ID
, DIE_NAME
, form
);