[dwarf-doc.git] / dwarf5 / latexdoc / selectedglossary.tex
1 \chapter[Selected Glossary (Informative)]{Selected Glossary$^0$ (Informative)}\r
2 \footnotetext[0]{\textcolor{green!30!black}{Note to Reviewers--This new Appendix is\r
3 an experiment. Comments regarding whether it should be\r
4 retained and expanded are solicited. --Ed.}}\r
5 \label{app:selectedglossary}\r
6 \r
7 This appendix contains descriptions for selected terms\r
8 and vocabulary used in this document. The focus is on groups\r
9 of related terms that may sound similar and/or have similar \r
10 meanings but do need to be distinguished. These descriptions\r
11 are informal and cannot be used to contradict or change the\r
12 meaning given in the main text. \r
13     \r
14 \section{Classification of Object Files}\r
15 \r
16 \begin{description}\r
17 \itembf{DWARF object file}: an object file that includes \r
18 DWARF information (includes relocatable, hybrid, split, executable,\r
19 shareable and package object files).\r
20 \r
21 \itembf{relocatable DWARF object file (.o\footnote{These \r
22 file extensions are typical of Linux and other Unix-based \r
23 operating systems, but other extensions are used in other \r
24 environments.} file)}: an object file that includes \r
25 relocatable program text (code) and data as well as either\r
26 one or more DWARF conventional units, or a skeleton unit.\r
27 \r
28 \itembf{split DWARF object file (.dwo$^1$ file)}: an object \r
29 file that contains no program text (code) or data, but does \r
30 contain the split units that are associated with a specific \r
31 skeleton unit of a different file.\r
32  \r
33 \itembf{hybrid DWARF object file (.o$^1$ file)}: an object \r
34 file that contains relocatable program text (code) and data,\r
35 the skeleton unit for that code and data, as well as the \r
36 split units that are associated with that skeleton unit.\r
37 \r
38 \itembf{split/hybrid object file}: an object file that is \r
39 either a split DWARF object file (.dwo) or a hybrid DWARF \r
40 object file (.o), that is, an object file that contains \r
41 one or more split units.\r
42 \r
43 \itembf{supplementary object file}: an object file (typically\r
44 a shareable image object file) that contains macro units and\r
45 related string information that can be shared with other\r
46 object files.\r
47 \end{description}\r
48 \r
49 \section{Kinds of Units}\r
50 \r
51 \begin{table}[ht]\r
52 \caption{Kinds of Units and Their Characteristics}\r
53 \label{tab:kindsofunitsandtheir characteristics}\r
54 \footnotesize\r
55 \begin{tabular}{P{3.6cm}llP{3.3cm}}\r
56 \hline\r
57 \bfseries\r
58 Type of unit &\bfseries Unit Type Code &\bfseries Root DIE TAG &\bfseries Other Key \\\r
59 (short name) &                &              &\bfseries Characteristics \\\r
60 \hline\r
61 conventional full compilation unit \newline(full unit) &\DWUTcompile     &\DWTAGcompileunit&\dotdebuginfo \\\r
62 \hline\r
63 conventional type unit \newline(type unit)             &\DWUTtype        &\DWTAGtypeunit   &\dotdebuginfo \\\r
64 \hline\r
65 conventional partial unit (partial unit)       &\DWUTpartial     &\DWTAGpartialunit&\dotdebuginfo \\\r
66 \hline\r
67 skeleton unit \newline (skeleton unit)                 &\DWUTskeleton    &\DWTAGcompileunit&\dotdebuginfo{}\r
68                                                                                             \DWATdwoname{}\r
69                                                                                             \DWATdwoid \\\r
70 \hline\r
71 split full compilation unit (split full unit)           &\DWUTsplitcompile&\DWTAGcompileunit&\dotdebuginfodwo{}                                                                                            \DWATdwoid \\\r
72 \hline\r
73 split type unit                                        &\DWUTsplittype   &\DWTAGtypeunit   &\dotdebuginfodwo \\\r
74 \hline\r
75 \end{tabular} \r
76 \end{table}\r
77 \r
78 Macro units defined in Section \refersec{chap:macroinformation}\r
79 are distinctly different from the above units.\r
80 \r