• Home
Name Date Size #Lines LOC

..--

README.txtD03-May-20241.5 KiB4629

d3basics.cD03-May-202446.4 KiB1,2281,004

debuginfo.cD03-May-2024150.5 KiB4,4732,984

image.cD03-May-202445 KiB1,323945

lzoconf.hD03-May-202414.9 KiB447280

lzodefs.hD03-May-202466.8 KiB1,8531,805

minilzo-inl.cD03-May-2024138.1 KiB4,5844,279

minilzo.hD03-May-20243.6 KiB11033

misc.cD03-May-20247.4 KiB270208

priv_d3basics.hD03-May-202421.4 KiB695516

priv_image.hD03-May-202412.8 KiB362181

priv_misc.hD03-May-20244.3 KiB13260

priv_readdwarf.hD03-May-20242.6 KiB7922

priv_readdwarf3.hD03-May-20242.3 KiB6015

priv_readelf.hD03-May-20242.3 KiB638

priv_readexidx.hD03-May-20241.9 KiB5110

priv_readmacho.hD03-May-20242.1 KiB567

priv_readpdb.hD03-May-20242.4 KiB6717

priv_storage.hD03-May-202442.2 KiB1,142468

priv_tytypes.hD03-May-20247.9 KiB225129

readdwarf.cD03-May-2024144.9 KiB4,1532,851

readdwarf3.cD03-May-2024194.6 KiB5,2773,564

readelf.cD03-May-2024125.1 KiB3,2212,315

readexidx.cD03-May-202438.9 KiB1,098669

readmacho.cD03-May-202443.9 KiB1,196769

readpdb.cD03-May-202483.9 KiB2,5981,969

storage.cD03-May-202480.6 KiB2,4611,768

tinfl.cD03-May-202428.6 KiB600460

tytypes.cD03-May-202431.5 KiB932785

README.txt

1
2On 4 Apr 06, the debuginfo reader (m_debuginfo) was majorly cleaned up
3and restructured.  It has been a bit of a tangle for a while.  On 18 Sep 14
4the STABS support was completely removed. The new structure looks like this:
5
6                  debuginfo.c
7
8                   readelf.c
9
10                  readdwarf.c
11
12                   storage.c
13
14Each .c can only call those below it on the page.
15
16storage.c contains the SegInfo structure and stuff for
17maintaining/searching arrays of symbols, line-numbers, and Dwarf CF
18info records.
19
20readdwarf.c parses the relevant kind of info and call storage.c to
21store the results.
22
23readelf.c reads ELF format, hands syms directly to storage.c,
24then delegates to readdwarf.c for debug info.  All straightforward.
25
26debuginfo.c is the top-level file, and is quite small.
27
28There are 2 goals to this:
29
30(1) Generally tidy up something which needs tidying up
31
32(2) Introduce more modularity, so as to make it easier to add
33    readers for other formats, if needed
34
35Rationale for (1) and (2) are obvious.
36
37Originally there was also goal (3) Simplify the stabs reader.
38But stabs support was broken since 3.9.0 and completely removed in 3.10.0.
39
40The worst thing is that it is the stabs type reader that was crashing,
41not the stabs line-number reader.
42Old versions of the stabs type reader can be found in the subversion repository
43as m_debuginfo/UNUSED_STABS.txt, the stabs line-number reader was in
44m_debuginfo/readstabs.c. The old version of this file explained more
45about the setup.
46