summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDevang Patel <dpatel@apple.com>2009-06-26 01:49:18 +0000
committerDevang Patel <dpatel@apple.com>2009-06-26 01:49:18 +0000
commit13e16b65ddd679d6edb5f182d683701fdea37b85 (patch)
treeb73d5e5903a3b25c45ca6c05ab1c575b4adc49e4 /docs
parent6f8f6066fdeafc75277a73c55cc9b0832d845d0e (diff)
downloadllvm-13e16b65ddd679d6edb5f182d683701fdea37b85.tar.gz
llvm-13e16b65ddd679d6edb5f182d683701fdea37b85.tar.bz2
llvm-13e16b65ddd679d6edb5f182d683701fdea37b85.tar.xz
Remove debug info anchors - llvm.dbg.compile_units, llvm.dbg.subprograms
and llvm.dbg.global_variables. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@74251 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs')
-rw-r--r--docs/SourceLevelDebugging.html53
1 files changed, 0 insertions, 53 deletions
diff --git a/docs/SourceLevelDebugging.html b/docs/SourceLevelDebugging.html
index 0b6ed477e0..11b3600bdb 100644
--- a/docs/SourceLevelDebugging.html
+++ b/docs/SourceLevelDebugging.html
@@ -24,7 +24,6 @@
<ol>
<li><a href="#debug_info_descriptors">Debug information descriptors</a>
<ul>
- <li><a href="#format_anchors">Anchor descriptors</a></li>
<li><a href="#format_compile_units">Compile unit descriptors</a></li>
<li><a href="#format_global_variables">Global variable descriptors</a></li>
<li><a href="#format_subprograms">Subprogram descriptors</a></li>
@@ -336,58 +335,6 @@ height="369">
<!-- ======================================================================= -->
<div class="doc_subsubsection">
- <a name="format_anchors">Anchor descriptors</a>
-</div>
-
-<div class="doc_text">
-
-<div class="doc_code">
-<pre>
-%<a href="#format_anchors">llvm.dbg.anchor.type</a> = type {
- i32, ;; Tag = 0 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a>
- i32 ;; Tag of descriptors grouped by the anchor
-}
-</pre>
-</div>
-
-<p>One important aspect of the LLVM debug representation is that it allows the
- LLVM debugger to efficiently index all of the global objects without having
- to scan the program. To do this, all of the global objects use "anchor"
- descriptors with designated names. All of the global objects of a particular
- type (e.g., compile units) contain a pointer to the anchor. This pointer
- allows a debugger to use def-use chains to find all global objects of that
- type.</p>
-
-<p>The following names are recognized as anchors by LLVM:</p>
-
-<div class="doc_code">
-<pre>
-%<a href="#format_compile_units">llvm.dbg.compile_units</a> = linkonce constant %<a href="#format_anchors">llvm.dbg.anchor.type</a> {
- i32 0,
- i32 17
-} ;; DW_TAG_compile_unit
-%<a href="#format_global_variables">llvm.dbg.global_variables</a> = linkonce constant %<a href="#format_anchors">llvm.dbg.anchor.type</a> {
- i32 0,
- i32 52
-} ;; DW_TAG_variable
-%<a href="#format_subprograms">llvm.dbg.subprograms</a> = linkonce constant %<a href="#format_anchors">llvm.dbg.anchor.type</a> {
- i32 0,
- i32 46
-} ;; DW_TAG_subprogram
-</pre>
-</div>
-
-<p>Using anchors in this way (where the compile unit descriptor points to the
- anchors, as opposed to having a list of compile unit descriptors) allows for
- the standard dead global elimination and merging passes to automatically
- remove unused debugging information. If the globals were kept track of
- through lists, there would always be an object pointing to the descriptors,
- thus would never be deleted.</p>
-
-</div>
-
-<!-- ======================================================================= -->
-<div class="doc_subsubsection">
<a name="format_compile_units">Compile unit descriptors</a>
</div>