Cross Reference: /external/valgrind/main/coregrind/m_debuginfo/

On 4 Apr 06, the debuginfo reader (m_debuginfo) was majorly cleaned up
and restructured.  It has been a bit of a tangle for a while.  The new
structure looks like this:

                  debuginfo.c

                   readelf.c

        readdwarf.c        readstabs.c

                   storage.c

Each .c can only call those below it on the page.

storage.c contains the SegInfo structure and stuff for
maintaining/searching arrays of symbols, line-numbers, and Dwarf CF
info records.

readdwarf.c and readstabs.c parse the relevant kind of info and
call storage.c to store the results.

readelf.c reads ELF format, hands syms directly to storage.c,
then delegates to readdwarf.c/readstabs.c for debug info.  All
straightforward.

debuginfo.c is the top-level file, and is quite small.

There are 3 goals to this:

(1) Generally tidy up something which needs tidying up

(2) Introduce more modularity, so as to make it easier to add
    readers for other formats, if needed

(3) Simplify the stabs reader.

Rationale for (1) and (2) are obvious.

Re (3), the stabs reader has for a good year contained a sophisticated
and impressive parser for stabs strings, with the aim of recording in
detail the types of variables (I think) (Jeremy's work).  Unfortunately
that has caused various segfaults reading stabs info in the past few months
(#77869, #117936, #119914, #120345 and another to do with deeply nested
template types).

The worst thing is that it is the stabs type reader that is crashing,
not the stabs line-number reader, but the type info is only used by
Helgrind, which is looking pretty dead at the moment.  So I have lifed
out the type-reader code and put it in UNUSED_STABS.txt for safe
storage, just leaving the line-number reader in place.

If Helgrind ever does come back to life we will need to reinstate the
type storage/reader stuff but with DWARF as its primary target.
Placing the existing stabs type-reader in hibernation improves
stability whilst retaining the development effort/expertise that went
into it for possible future reinstatement.
Name	Date	Size
..	12-Mar-2015	4 KiB
d3basics.c	12-Mar-2015	45.9 KiB
debuginfo.c	12-Mar-2015	135.9 KiB
image.c	12-Mar-2015	35 KiB
lzoconf.h	12-Mar-2015	14.9 KiB
lzodefs.h	12-Mar-2015	66.8 KiB
minilzo-inl.c	12-Mar-2015	138.1 KiB
minilzo.h	12-Mar-2015	3.6 KiB
misc.c	12-Mar-2015	7.3 KiB
priv_d3basics.h	12-Mar-2015	21.1 KiB
priv_image.h	12-Mar-2015	12.4 KiB
priv_misc.h	12-Mar-2015	2.8 KiB
priv_readdwarf.h	12-Mar-2015	2.6 KiB
priv_readdwarf3.h	12-Mar-2015	2.3 KiB
priv_readelf.h	12-Mar-2015	2.2 KiB
priv_readmacho.h	12-Mar-2015	2.1 KiB
priv_readpdb.h	12-Mar-2015	2.4 KiB
priv_readstabs.h	12-Mar-2015	1.9 KiB
priv_storage.h	12-Mar-2015	33.8 KiB
priv_tytypes.h	12-Mar-2015	7.9 KiB
readdwarf.c	12-Mar-2015	147.6 KiB
readdwarf3.c	12-Mar-2015	165.9 KiB
readelf.c	12-Mar-2015	111.1 KiB
readmacho.c	12-Mar-2015	42.6 KiB
README.txt	12-Mar-2015	2 KiB
readpdb.c	12-Mar-2015	81.3 KiB
readstabs.c	12-Mar-2015	13.3 KiB
storage.c	12-Mar-2015	61.8 KiB
tytypes.c	12-Mar-2015	31.5 KiB
UNUSED_STABS.txt	12-Mar-2015	38.5 KiB