Initial commit of a work-in-progress of latex source
[dwarf-doc.git] / dwarf5 / latexdoc / appendixdebugrelationships.tex
1 |\chapter{Debug Section Relationships (Informative)}
2 \label{app:debugsectionrelationshipsinformative}
3 %
4 \setlength\maxovaldiam{80pt}
5 \thicklines
6 \begin{picture}(0,0)
7   \put(-38,30) { .debug\_aranges }
8   \put(-00,30) { \circle{80}}
9   \put(180,30) { .debug\_frame }
10   \put(210,30) { \circle{80}}
11   \put(365,30) { .debug\_abbrev }
12   \put(400,30) { \circle{80}}
13
14   \put(370,-85) { .debug\_str }
15   \put(400,-75) {\circle{80}}
16
17   \put(-40,-175) { .debug\_info }
18   \put(-00,-180) {\circle{80}}
19
20   \put(370,-190) { .debug\_loc }
21   \put(400,-180) {\circle{80}}
22
23   \put(365,-300) { .debug\_ranges }
24   \put(400,-290) {\circle{80}}
25
26   \put(-40,-398) { .debug\_pubnames }
27   \put(-40,-410) { .debug\_pubtypes } 
28   \put(-00,-400) { \circle{80}}
29   \put(175,-400) { .debug\_line }
30   \put(210,-400) { \circle{80}}
31   \put(365,-400) { .debug\_macinfo}
32   \put(400,-400) { \circle{80}}
33
34 \end{picture}
35
36 \clearpage
37 \begin{enumerate}[(a)]  
38 \item  .debug\_aranges  \\
39 The debug\_info\_offset value in
40 the header is the offset in the .debug\_info section of the
41 corresponding compilation unit header (not the compilation
42 unit entry).
43
44 \item .debug\_pubnames and .debug\_pubtypes \\
45 The debug\_info\_offset value in the header is the offset in the
46 .debug\_info section of the corresponding compilation unit header (not
47 the compilation unit entry). Each pubname/pubtype has the offset (within
48 the corresponding compilation unit) of the applicable debugging
49 information entry.
50
51 \item .debug\_info and .debug\_types \\
52 The debug\_abbrev\_offset value in the header is the offset in the
53 .debug\_abbrev section of the abbreviations for that compilation unit.
54 (d) .debug\_info and .debug\_types
55 Attribute values of class string may have form DW\_FORM\_strp, whose
56 value is the offset in the .debug\_str section of the corresponding string.
57
58 \item  .debug\_info and .debug\_types \\
59 Attribute values of class string may have form DW\_FORM\_strp, whose
60 value is the offset in the .debug\_str section of the corresponding string.
61
62 \item .debug\_loc \\
63 The operand of the DW\_OP\_call\_ref DWARF expression operator is the
64 offset of a debugging information entry in the .debug\_info section.
65
66 \item .debug\_info \\
67 An attribute value of class loclistptr (specifically form
68 DW\_FORM\_sec\_offset) is an offset within the .debug\_loc section of a
69 location list.
70
71 \item .debug\_info \\
72 An attribute value of class rangelistptr (specifically form
73 DW\_FORM\_sec\_offset) is an offset within the .debug\_ranges section of
74 a range list.
75
76
77 \item .debug\_info \\
78 An attribute value of class macptr (specifically form
79 DW\_FORM\_sec\_offset) is an offset within the .debug\_macinfo section
80 of the beginning of the macro information for the referencing unit.
81
82
83 \item .debug\_info \\
84 An attribute value of class lineptr (specifically form
85 DW\_FORM\_sec\_offset) is an offset in the .debug\_line section of the
86 beginning of the line number information for the referencing unit.
87 \end{enumerate}
88
89
90