maxjhandsome
/
llvm-project
forked from OSchip/llvm-project
1
0
Fork 0
Code Issues Pull Requests Packages Releases Wiki Activity
llvm-project/llvm/docs/SourceLevelDebugging.html

2825 lines
95 KiB
HTML
Raw Normal View History

First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<title>Source Level Debugging with LLVM</title>
<link rel="stylesheet" href="llvm.css" type="text/css">
</head>
<body>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h1>Source Level Debugging with LLVM</h1>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Minor format tweask for tables. llvm-svn: 17394
2004-11-01 16:19:36 +08:00
<table class="layout" style="width:100%">
<tr class="layout">
<td class="left">
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<ul>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<li><a href="#introduction">Introduction</a>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<ol>
<li><a href="#phil">Philosophy behind LLVM debugging information</a></li>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<li><a href="#consumers">Debug information consumers</a></li>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<li><a href="#debugopt">Debugging optimized code</a></li>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</ol></li>
<li><a href="#format">Debugging information format</a>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<ol>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<li><a href="#debug_info_descriptors">Debug information descriptors</a>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<ul>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<li><a href="#format_compile_units">Compile unit descriptors</a></li>
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
<li><a href="#format_files">File descriptors</a></li>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<li><a href="#format_global_variables">Global variable descriptors</a></li>
<li><a href="#format_subprograms">Subprogram descriptors</a></li>
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
<li><a href="#format_blocks">Block descriptors</a></li>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<li><a href="#format_basic_type">Basic type descriptors</a></li>
<li><a href="#format_derived_type">Derived type descriptors</a></li>
<li><a href="#format_composite_type">Composite type descriptors</a></li>
<li><a href="#format_subrange">Subrange descriptors</a></li>
<li><a href="#format_enumeration">Enumerator descriptors</a></li>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<li><a href="#format_variables">Local variables</a></li>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</ul></li>
<li><a href="#format_common_intrinsics">Debugger intrinsic functions</a>
<ul>
<li><a href="#format_common_declare">llvm.dbg.declare</a></li>
Add documentation for llvm.dbg.value intrinsic llvm-svn: 93203
2010-01-12 06:53:48 +08:00
<li><a href="#format_common_value">llvm.dbg.value</a></li>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</ul></li>
</ol></li>
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
<li><a href="#format_common_lifetime">Object lifetimes and scoping</a></li>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<li><a href="#ccxx_frontend">C/C++ front-end specific debug information</a>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<ol>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<li><a href="#ccxx_compile_units">C/C++ source file information</a></li>
<li><a href="#ccxx_global_variable">C/C++ global variable information</a></li>
<li><a href="#ccxx_subprogram">C/C++ function information</a></li>
<li><a href="#ccxx_basic_types">C/C++ basic types</a></li>
<li><a href="#ccxx_derived_types">C/C++ derived types</a></li>
<li><a href="#ccxx_composite_types">C/C++ struct/union types</a></li>
<li><a href="#ccxx_enumeration_types">C/C++ enumeration types</a></li>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</ol></li>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
<li><a href="#llvmdwarfextension">LLVM Dwarf Extensions</a>
<ol>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<li><a href="#objcproperty">Debugging Information Extension
Fix validation errors. llvm-svn: 152112
2012-03-06 17:17:39 +08:00
for Objective C Properties</a>
<ul>
<li><a href="#objcpropertyintroduction">Introduction</a></li>
<li><a href="#objcpropertyproposal">Proposal</a></li>
<li><a href="#objcpropertynewattributes">New DWARF Attributes</a></li>
<li><a href="#objcpropertynewconstants">New DWARF Constants</a></li>
</ul>
</li>
<li><a href="#acceltable">Name Accelerator Tables</a>
<ul>
<li><a href="#acceltableintroduction">Introduction</a></li>
<li><a href="#acceltablehashes">Hash Tables</a></li>
<li><a href="#acceltabledetails">Details</a></li>
<li><a href="#acceltablecontents">Contents</a></li>
<li><a href="#acceltableextensions">Language Extensions and File Format Changes</a></li>
</ul>
</li>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</ol>
</li>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</ul>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</td>
Minor format tweask for tables. llvm-svn: 17394
2004-11-01 16:19:36 +08:00
<td class="right">
Use the images in the img/ directory. llvm-svn: 13509
2004-05-13 05:26:16 +08:00
<img src="img/venusflytrap.jpg" alt="A leafy and green bug eater" width="247"
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
height="369">
</td>
Minor format tweask for tables. llvm-svn: 17394
2004-11-01 16:19:36 +08:00
</tr></table>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
Make use of the new doc_author class. "Seperate content from presentation" they said. llvm-svn: 13675
2004-05-24 05:07:27 +08:00
<div class="doc_author">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>Written by <a href="mailto:sabre@nondot.org">Chris Lattner</a>
Change e-mail address. llvm-svn: 35103
2007-03-15 03:32:21 +08:00
and <a href="mailto:jlaskey@mac.com">Jim Laskey</a></p>
Make use of the new doc_author class. "Seperate content from presentation" they said. llvm-svn: 13675
2004-05-24 05:07:27 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- *********************************************************************** -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h2><a name="introduction">Introduction</a></h2>
* Straighten a comment to a single line * Block off the section correctly with <!-- ***** --> llvm-svn: 18721
2004-12-10 04:27:37 +08:00
<!-- *********************************************************************** -->
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<p>This document is the central repository for all information pertaining to
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
debug information in LLVM. It describes the <a href="#format">actual format
that the LLVM debug information</a> takes, which is useful for those
interested in creating front-ends or dealing directly with the information.
fix some typos pointed out by Hidenobu Seki llvm-svn: 76342
2009-07-19 05:47:15 +08:00
Further, this document provides specific examples of what debug information
finish a sentence. llvm-svn: 123750
2011-01-18 14:12:10 +08:00
for C/C++ looks like.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<a name="phil">Philosophy behind LLVM debugging information</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<p>The idea of the LLVM debugging information is to capture how the important
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
pieces of the source-language's Abstract Syntax Tree map onto LLVM code.
Several design aspects have shaped the solution that appears here. The
important ones are:</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<ul>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<li>Debugging information should have very little impact on the rest of the
compiler. No transformations, analyses, or code generators should need to
be modified because of debugging information.</li>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<li>LLVM optimizations should interact in <a href="#debugopt">well-defined and
easily described ways</a> with the debugging information.</li>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<li>Because LLVM is designed to support arbitrary programming languages,
LLVM-to-LLVM tools should not need to know anything about the semantics of
the source-level-language.</li>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<li>Source-level languages are often <b>widely</b> different from one another.
LLVM should not put any restrictions of the flavor of the source-language,
and the debugging information should work with any language.</li>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<li>With code generator support, it should be possible to use an LLVM compiler
to compile a program to native machine code and standard debugging
formats. This allows compatibility with traditional machine-code level
debuggers, like GDB or DBX.</li>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</ul>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<p>The approach used by the LLVM implementation is to use a small set
of <a href="#format_common_intrinsics">intrinsic functions</a> to define a
mapping between LLVM program objects and the source-level objects. The
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
description of the source-level program is maintained in LLVM metadata
in an <a href="#ccxx_frontend">implementation-defined format</a>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
(the C/C++ front-end currently uses working draft 7 of
the <a href="http://www.eagercon.com/dwarf/dwarf3std.htm">DWARF 3
standard</a>).</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>When a program is being debugged, a debugger interacts with the user and
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
turns the stored debug information into source-language specific information.
As such, a debugger must be aware of the source-language, and is thus tied to
a specific language or family of languages.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<a name="consumers">Debug information consumers</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<p>The role of debug information is to provide meta information normally
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
stripped away during the compilation process. This meta information provides
an LLVM user a relationship between generated code and the original program
source code.</p>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
don't reference DwarfWriter llvm-svn: 100401
2010-04-05 12:11:11 +08:00
<p>Currently, debug information is consumed by DwarfDebug to produce dwarf
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
information used by the gdb debugger. Other targets could use the same
information to produce stabs or other debug forms.</p>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<p>It would also be reasonable to use debug information to feed profiling tools
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
for analysis of generated code, or, tools for reconstructing the original
source from generated code.</p>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<p>TODO - expound a bit more.</p>
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<a name="debugopt">Debugging optimized code</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<p>An extremely high priority of LLVM debugging information is to make it
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
interact well with optimizations and analysis. In particular, the LLVM debug
information provides the following guarantees:</p>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<ul>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<li>LLVM debug information <b>always provides information to accurately read
the source-level state of the program</b>, regardless of which LLVM
optimizations have been run, and without any modification to the
optimizations themselves. However, some optimizations may impact the
ability to modify the current state of the program with a debugger, such
as setting program variables, or calling functions that have been
deleted.</li>
<li>As desired, LLVM optimizations can be upgraded to be aware of the LLVM
debugging information, allowing them to update the debugging information
as they perform aggressive optimizations. This means that, with effort,
the LLVM optimizers could optimize debug code just as well as non-debug
code.</li>
Clarify documentation and remove guarantees that are not fulfilled. llvm-svn: 132344
2011-06-01 01:45:27 +08:00
<li>LLVM debug information does not prevent optimizations from
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
happening (for example inlining, basic block reordering/merging/cleanup,
Fix html formatting. llvm-svn: 132345
2011-06-01 02:06:14 +08:00
tail duplication, etc).</li>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<li>LLVM debug information is automatically optimized along with the rest of
the program, using existing facilities. For example, duplicate
information is automatically merged by the linker, and unused information
is automatically removed.</li>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</ul>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<p>Basically, the debug information allows you to compile a program with
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
"<tt>-O0 -g</tt>" and get full debug information, allowing you to arbitrarily
modify the program as it executes from a debugger. Compiling a program with
"<tt>-O3 -g</tt>" gives you full debug information that is always available
and accurate for reading (e.g., you get accurate stack traces despite tail
call elimination and inlining), but you might lose the ability to modify the
program and call functions where were optimized out of the program, or
inlined away completely.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p><a href="TestingGuide.html#quicktestsuite">LLVM test suite</a> provides a
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
framework to test optimizer's handling of debugging information. It can be
run like this:</p>
Document TEST=dbgopt llvm-svn: 59839
2008-11-22 03:35:57 +08:00
<div class="doc_code">
<pre>
% cd llvm/projects/test-suite/MultiSource/Benchmarks # or some other level
% make TEST=dbgopt
</pre>
</div>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<p>This will test impact of debugging information on optimization passes. If
debugging information influences optimization passes then it will be reported
as a failure. See <a href="TestingGuide.html">TestingGuide</a> for more
information on LLVM test infrastructure and how to run various tests.</p>
Document TEST=dbgopt llvm-svn: 59839
2008-11-22 03:35:57 +08:00
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- *********************************************************************** -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h2>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format">Debugging information format</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h2>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- *********************************************************************** -->
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>LLVM debugging information has been carefully designed to make it possible
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
for the optimizer to optimize the program and debugging information without
necessarily having to know anything about debugging information. In
Fixed spelling errors. llvm-svn: 98724
2010-03-17 23:01:50 +08:00
particular, the use of metadata avoids duplicated debugging information from
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
the beginning, and the global dead code elimination pass automatically
deletes debugging information for a function if it decides to delete the
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
function. </p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>To do this, most of the debugging information (descriptors for types,
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
variables, functions, source files, etc) is inserted by the language
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
front-end in the form of LLVM metadata. </p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>Debug information is designed to be agnostic about the target debugger and
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
debugging information representation (e.g. DWARF/Stabs/etc). It uses a
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
generic pass to decode the information that represents variables, types,
functions, namespaces, etc: this allows for arbitrary source-language
semantics and type-systems to be used, as long as there is a module
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
written for the target debugger to interpret the information. </p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>To provide basic functionality, the LLVM debugger does have to make some
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
assumptions about the source-level language being debugged, though it keeps
these to a minimum. The only common features that the LLVM debugger assumes
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
exist are <a href="#format_files">source files</a>,
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
and <a href="#format_global_variables">program objects</a>. These abstract
objects are used by a debugger to form stack traces, show information about
local variables, etc.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>This section of the documentation first describes the representation aspects
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
common to any source-language. The <a href="#ccxx_frontend">next section</a>
describes the data layout conventions used by the C and C++ front-ends.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="debug_info_descriptors">Debug information descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>In consideration of the complexity and volume of debug information, LLVM
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
provides a specification for well formed debug descriptors. </p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>Consumers of LLVM debug information expect the descriptors for program
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
objects to start in a canonical format, but the descriptors can include
additional information appended at the end that is source-language
specific. All LLVM debugging information is versioned, allowing backwards
compatibility in the case that the core structures need to change in some
way. Also, all debugging information objects start with a tag to indicate
what type of object it is. The source-language is allowed to define its own
objects, by using unreserved tag numbers. We recommend using with tags in
Documentation: Perform automated correction of common typos. llvm-svn: 83849
2009-10-12 22:46:08 +08:00
the range 0x1000 through 0x2000 (there is a defined enum DW_TAG_user_base =
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
0x1000.)</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p>The fields of debug descriptors used internally by LLVM
Small fixes to this documentation. Remove mention of uint/int type, fix typo in 'number'. llvm-svn: 100001
2010-03-31 15:50:17 +08:00
are restricted to only the simple data types <tt>i32</tt>, <tt>i1</tt>,
<tt>float</tt>, <tt>double</tt>, <tt>mdstring</tt> and <tt>mdnode</tt>. </p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!1 = metadata !{
Small fixes to this documentation. Remove mention of uint/int type, fix typo in 'number'. llvm-svn: 100001
2010-03-31 15:50:17 +08:00
i32, ;; A tag
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
...
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
1. Revise vector debug support. 2. Update docs for vector debug support and new version control. 3. Simplify serialization of DebugDescInfo subclasses. llvm-svn: 28816
2006-06-16 21:14:03 +08:00
<p><a name="LLVMDebugVersion">The first field of a descriptor is always an
Small fixes to this documentation. Remove mention of uint/int type, fix typo in 'number'. llvm-svn: 100001
2010-03-31 15:50:17 +08:00
<tt>i32</tt> containing a tag value identifying the content of the
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
descriptor. The remaining fields are specific to the descriptor. The values
of tags are loosely bound to the tag values of DWARF information entries.
However, that does not restrict the use of the information supplied to DWARF
targets. To facilitate versioning of debug information, the tag is augmented
80 columns. llvm-svn: 135972
2011-07-26 05:13:23 +08:00
with the current debug version (LLVMDebugVersion = 8 &lt;&lt; 16 or
0x80000 or 524288.)</a></p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p>The details of the various descriptors follow.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_compile_units">Compile unit descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!0 = metadata !{
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i32, ;; Tag = 17 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
;; (DW_TAG_compile_unit)
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i32, ;; Unused field.
i32, ;; DWARF language identifier (ex. DW_LANG_C89)
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata, ;; Source file name
metadata, ;; Source file directory (includes trailing slash)
metadata ;; Producer (ex. "4.0.1 LLVM (LLVM research group)")
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i1, ;; True if this is a main compile unit.
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i1, ;; True if this is optimized.
metadata, ;; Flags
i32 ;; Runtime version
Update docs to reflect recent addition of new CompileUnit elements. llvm-svn: 139374
2011-09-10 01:07:15 +08:00
metadata ;; List of enums types
metadata ;; List of retained types
metadata ;; List of subprograms
metadata ;; List of global variables
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
<p>These descriptors contain a source language ID for the file (we use the DWARF
3.0 ID numbers, such as <tt>DW_LANG_C89</tt>, <tt>DW_LANG_C_plus_plus</tt>,
<tt>DW_LANG_Cobol74</tt>, etc), three strings describing the filename,
working directory of the compiler, and an identifier string for the compiler
that produced it.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<p>Compile unit descriptors provide the root context for objects declared in a
Use llvm.dbg.cu named metadata to collect compile units. llvm-svn: 130756
2011-05-04 00:18:28 +08:00
specific compilation unit. File descriptors are defined using this context.
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
These descriptors are collected by a named metadata
Update docs to reflect recent addition of new CompileUnit elements. llvm-svn: 139374
2011-09-10 01:07:15 +08:00
<tt>!llvm.dbg.cu</tt>. Compile unit descriptor keeps track of subprograms,
global variables and type information.
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
<a name="format_files">File descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
<div class="doc_code">
<pre>
!0 = metadata !{
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i32, ;; Tag = 41 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a>
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
;; (DW_TAG_file_type)
metadata, ;; Source file name
metadata, ;; Source file directory (includes trailing slash)
Until now all debug info MDNodes referred to a root MDNode, a compile unit. This simplified handling of these needs in dwarf writer. However, one side effect of this is that during link time optimization all these MDNodes are _not_ uniqued. In other words there will be N number of MDNodes describing "int", "char" and all other types, which would suddenly grow when each object file starts using libraries like STL. MDNodes graph structure such that compiler unit keeps track of important MDNodes and update dwarf writer to process mdnodes top-down instead of bottom up. llvm-svn: 137778
2011-08-17 06:09:43 +08:00
metadata ;; Unused
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
}
</pre>
</div>
Fixed spelling errors. llvm-svn: 98724
2010-03-17 23:01:50 +08:00
<p>These descriptors contain information for a file. Global variables and top
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
level functions would be defined using this context.k File descriptors also
provide context for source line correspondence. </p>
<p>Each input file is encoded as a separate file descriptor in LLVM debugging
Until now all debug info MDNodes referred to a root MDNode, a compile unit. This simplified handling of these needs in dwarf writer. However, one side effect of this is that during link time optimization all these MDNodes are _not_ uniqued. In other words there will be N number of MDNodes describing "int", "char" and all other types, which would suddenly grow when each object file starts using libraries like STL. MDNodes graph structure such that compiler unit keeps track of important MDNodes and update dwarf writer to process mdnodes top-down instead of bottom up. llvm-svn: 137778
2011-08-17 06:09:43 +08:00
information output. </p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_global_variables">Global variable descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!1 = metadata !{
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i32, ;; Tag = 52 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
;; (DW_TAG_variable)
i32, ;; Unused field.
metadata, ;; Reference to context descriptor
metadata, ;; Name
metadata, ;; Display name (fully qualified C++ name)
metadata, ;; MIPS linkage name (for C++)
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata, ;; Reference to file where defined
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32, ;; Line number where defined
metadata, ;; Reference to type descriptor
i1, ;; True if the global is local to compile unit (static)
i1, ;; True if the global is defined in the compile unit (not extern)
Fix more whitespace to be consistent with AsmPrinter. llvm-svn: 104963
2010-05-29 01:13:49 +08:00
{}* ;; Reference to the global variable
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>These descriptors provide debug information about globals variables. The
Document llvm.dbg.sp, llvm.dbg.gv and llvm.dbg.enum llvm-svn: 128466
2011-03-30 01:27:08 +08:00
provide details such as name, type and where the variable is defined. All
global variables are collected by named metadata <tt>!llvm.dbg.gv</tt>.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_subprograms">Subprogram descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
i32, ;; Tag = 46 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a>
;; (DW_TAG_subprogram)
i32, ;; Unused field.
metadata, ;; Reference to context descriptor
metadata, ;; Name
metadata, ;; Display name (fully qualified C++ name)
metadata, ;; MIPS linkage name (for C++)
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata, ;; Reference to file where defined
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32, ;; Line number where defined
metadata, ;; Reference to type descriptor
i1, ;; True if the global is local to compile unit (static)
Let front-end tie subprogram declaration with subprogram definition directly. llvm-svn: 130028
2011-04-23 07:10:17 +08:00
i1, ;; True if the global is defined in the compile unit (not extern)
i32, ;; Virtuality, e.g. dwarf::DW_VIRTUALITY__virtual
i32, ;; Index into a virtual function
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
metadata, ;; indicates which base type contains the vtable pointer for the
Update docs to reflect new DISubprogram elements. llvm-svn: 105495
2010-06-05 06:49:55 +08:00
;; derived class
Clarify and fix subprogram description. llvm-svn: 146743
2011-12-17 01:50:04 +08:00
i32, ;; Flags - Artifical, Private, Protected, Explicit, Prototyped.
Let front-end tie subprogram declaration with subprogram definition directly. llvm-svn: 130028
2011-04-23 07:10:17 +08:00
i1, ;; isOptimized
Function *,;; Pointer to LLVM function
metadata, ;; Lists function template parameters
metadata ;; Function declaration descriptor
Do not use named md nodes to track variables that are completely optimized. This does not scale while doing LTO with debug info. New approach is to include list of variables in the subprogram info directly. llvm-svn: 138145
2011-08-20 07:28:12 +08:00
metadata ;; List of function variables
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>These descriptors provide debug information about functions, methods and
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
subprograms. They provide details such as name, return types and the source
Document llvm.dbg.sp, llvm.dbg.gv and llvm.dbg.enum llvm-svn: 128466
2011-03-30 01:27:08 +08:00
location where the subprogram is defined.
</p>
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
</div>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
<a name="format_blocks">Block descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!3 = metadata !{
Fix lexical block's tag number. llvm-svn: 115516
2010-10-05 00:51:59 +08:00
i32, ;; Tag = 11 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a> (DW_TAG_lexical_block)
Fix block descriptor documentation. llvm-svn: 115362
2010-10-02 06:45:00 +08:00
metadata,;; Reference to context descriptor
i32, ;; Line number
Update DILexicalBlock doc to mention new fields. llvm-svn: 127249
2011-03-09 00:25:29 +08:00
i32, ;; Column number
metadata,;; Reference to source file
i32 ;; Unique ID to identify blocks from a template function
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
Add a new wrapper node for a DILexicalBlock that encapsulates it and a file. Since it should only be used when necessary propagate it through the backend code generation and tweak testcases accordingly. This helps with code like in clang's test/CodeGen/debug-info-line.c where we have multiple #line directives within a single lexical block and want to generate only a single block that contains each file change. Part of rdar://10246360 llvm-svn: 141729
2011-10-12 06:59:11 +08:00
<p>This descriptor provides debug information about nested blocks within a
Fix block descriptor documentation. llvm-svn: 115362
2010-10-02 06:45:00 +08:00
subprogram. The line number and column numbers are used to dinstinguish
two lexical blocks at same depth. </p>
Update doc to reflect changes in subprogram and block descriptors. llvm-svn: 26783
2006-03-16 03:10:52 +08:00
Add a new wrapper node for a DILexicalBlock that encapsulates it and a file. Since it should only be used when necessary propagate it through the backend code generation and tweak testcases accordingly. This helps with code like in clang's test/CodeGen/debug-info-line.c where we have multiple #line directives within a single lexical block and want to generate only a single block that contains each file change. Part of rdar://10246360 llvm-svn: 141729
2011-10-12 06:59:11 +08:00
<div class="doc_code">
<pre>
!3 = metadata !{
i32, ;; Tag = 11 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a> (DW_TAG_lexical_block)
metadata ;; Reference to the scope we're annotating with a file change
metadata,;; Reference to the file the scope is enclosed in.
}
</pre>
</div>
<p>This descriptor provides a wrapper around a lexical scope to handle file
changes in the middle of a lexical block.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_basic_type">Basic type descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!4 = metadata !{
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i32, ;; Tag = 36 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
;; (DW_TAG_base_type)
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
metadata, ;; Reference to context
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata, ;; Name (may be "" for anonymous types)
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata, ;; Reference to file where defined (may be NULL)
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32, ;; Line number where defined (may be 0)
i64, ;; Size in bits
i64, ;; Alignment in bits
i64, ;; Offset in bits
i32, ;; Flags
i32 ;; DWARF type encoding
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>These descriptors define primitive types used in the code. Example int, bool
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
and float. The context provides the scope of the type, which is usually the
Until now all debug info MDNodes referred to a root MDNode, a compile unit. This simplified handling of these needs in dwarf writer. However, one side effect of this is that during link time optimization all these MDNodes are _not_ uniqued. In other words there will be N number of MDNodes describing "int", "char" and all other types, which would suddenly grow when each object file starts using libraries like STL. MDNodes graph structure such that compiler unit keeps track of important MDNodes and update dwarf writer to process mdnodes top-down instead of bottom up. llvm-svn: 137778
2011-08-17 06:09:43 +08:00
top level. Since basic types are not usually user defined the context
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
and line number can be left as NULL and 0. The size, alignment and offset
are expressed in bits and can be 64 bit values. The alignment is used to
round the offset when embedded in a
<a href="#format_composite_type">composite type</a> (example to keep float
doubles on 64 bit boundaries.) The offset is the bit offset if embedded in
a <a href="#format_composite_type">composite type</a>.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>The type encoding provides the details of the type. The values are typically
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
one of the following:</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
DW_ATE_address = 1
DW_ATE_boolean = 2
DW_ATE_float = 4
DW_ATE_signed = 5
DW_ATE_signed_char = 6
DW_ATE_unsigned = 7
DW_ATE_unsigned_char = 8
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_derived_type">Derived type descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!5 = metadata !{
i32, ;; Tag (see below)
metadata, ;; Reference to context
metadata, ;; Name (may be "" for anonymous types)
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata, ;; Reference to file where defined (may be NULL)
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32, ;; Line number where defined (may be 0)
Fix DIDerived type fields' type in document. llvm-svn: 115325
2010-10-02 03:19:30 +08:00
i64, ;; Size in bits
i64, ;; Alignment in bits
i64, ;; Offset in bits
Update documentation. llvm-svn: 146781
2011-12-17 07:42:33 +08:00
i32, ;; Flags to encode attributes, e.g. private
Introduce support to encode Objective-C property information in debugging information generated for an interface. llvm-svn: 129624
2011-04-16 08:11:51 +08:00
metadata, ;; Reference to type derived from
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
metadata, ;; (optional) Name of the Objective C property associated with
;; Objective-C an ivar
Introduce support to encode Objective-C property information in debugging information generated for an interface. llvm-svn: 129624
2011-04-16 08:11:51 +08:00
metadata, ;; (optional) Name of the Objective C property getter selector.
metadata, ;; (optional) Name of the Objective C property setter selector.
i32 ;; (optional) Objective C property attributes.
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>These descriptors are used to define types derived from other types. The
value of the tag varies depending on the meaning. The following are possible
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
tag values:</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
DW_TAG_formal_parameter = 5
DW_TAG_member = 13
DW_TAG_pointer_type = 15
DW_TAG_reference_type = 16
DW_TAG_typedef = 22
DW_TAG_const_type = 38
DW_TAG_volatile_type = 53
DW_TAG_restrict_type = 55
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<p><tt>DW_TAG_member</tt> is used to define a member of
a <a href="#format_composite_type">composite type</a>
or <a href="#format_subprograms">subprogram</a>. The type of the member is
the <a href="#format_derived_type">derived
type</a>. <tt>DW_TAG_formal_parameter</tt> is used to define a member which
is a formal argument of a subprogram.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<p><tt>DW_TAG_typedef</tt> is used to provide a name for the derived type.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p><tt>DW_TAG_pointer_type</tt>, <tt>DW_TAG_reference_type</tt>,
<tt>DW_TAG_const_type</tt>, <tt>DW_TAG_volatile_type</tt> and
Fix spacing. llvm-svn: 146782
2011-12-17 07:42:35 +08:00
<tt>DW_TAG_restrict_type</tt> are used to qualify
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
the <a href="#format_derived_type">derived type</a>. </p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p><a href="#format_derived_type">Derived type</a> location can be determined
Until now all debug info MDNodes referred to a root MDNode, a compile unit. This simplified handling of these needs in dwarf writer. However, one side effect of this is that during link time optimization all these MDNodes are _not_ uniqued. In other words there will be N number of MDNodes describing "int", "char" and all other types, which would suddenly grow when each object file starts using libraries like STL. MDNodes graph structure such that compiler unit keeps track of important MDNodes and update dwarf writer to process mdnodes top-down instead of bottom up. llvm-svn: 137778
2011-08-17 06:09:43 +08:00
from the context and line number. The size, alignment and offset are
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
expressed in bits and can be 64 bit values. The alignment is used to round
the offset when embedded in a <a href="#format_composite_type">composite
type</a> (example to keep float doubles on 64 bit boundaries.) The offset is
the bit offset if embedded in a <a href="#format_composite_type">composite
type</a>.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Update docs to match reality. llvm-svn: 124761
2011-02-03 08:22:17 +08:00
<p>Note that the <tt>void *</tt> type is expressed as a type derived from NULL.
</p>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_composite_type">Composite type descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!6 = metadata !{
i32, ;; Tag (see below)
metadata, ;; Reference to context
metadata, ;; Name (may be "" for anonymous types)
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata, ;; Reference to file where defined (may be NULL)
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32, ;; Line number where defined (may be 0)
i64, ;; Size in bits
i64, ;; Alignment in bits
i64, ;; Offset in bits
i32, ;; Flags
metadata, ;; Reference to type derived from
metadata, ;; Reference to array of member descriptors
i32 ;; Runtime languages
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>These descriptors are used to define types that are composed of 0 or more
elements. The value of the tag varies depending on the meaning. The following
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
are possible tag values:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
DW_TAG_array_type = 1
DW_TAG_enumeration_type = 4
DW_TAG_structure_type = 19
DW_TAG_union_type = 23
DW_TAG_vector_type = 259
Fix some typos llvm-svn: 72579
2009-05-30 01:08:57 +08:00
DW_TAG_subroutine_type = 21
DW_TAG_inheritance = 28
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
1. Support standard dwarf format (was bootstrapping in Apple format.) 2. Add vector support. llvm-svn: 28807
2006-06-16 04:51:43 +08:00
<p>The vector flag indicates that an array type is a native packed vector.</p>
1. Revise vector debug support. 2. Update docs for vector debug support and new version control. 3. Simplify serialization of DebugDescInfo subclasses. llvm-svn: 28816
2006-06-16 21:14:03 +08:00
<p>The members of array types (tag = <tt>DW_TAG_array_type</tt>) or vector types
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
(tag = <tt>DW_TAG_vector_type</tt>) are <a href="#format_subrange">subrange
descriptors</a>, each representing the range of subscripts at that level of
indexing.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>The members of enumeration types (tag = <tt>DW_TAG_enumeration_type</tt>) are
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<a href="#format_enumeration">enumerator descriptors</a>, each representing
Document llvm.dbg.sp, llvm.dbg.gv and llvm.dbg.enum llvm-svn: 128466
2011-03-30 01:27:08 +08:00
the definition of enumeration value for the set. All enumeration type
descriptors are collected by named metadata <tt>!llvm.dbg.enum</tt>.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>The members of structure (tag = <tt>DW_TAG_structure_type</tt>) or union (tag
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
= <tt>DW_TAG_union_type</tt>) types are any one of
the <a href="#format_basic_type">basic</a>,
<a href="#format_derived_type">derived</a>
or <a href="#format_composite_type">composite</a> type descriptors, each
representing a field member of the structure or union.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Update debugging documents. llvm-svn: 29800
2006-08-22 05:21:06 +08:00
<p>For C++ classes (tag = <tt>DW_TAG_structure_type</tt>), member descriptors
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
provide information about base classes, static members and member
functions. If a member is a <a href="#format_derived_type">derived type
descriptor</a> and has a tag of <tt>DW_TAG_inheritance</tt>, then the type
represents a base class. If the member of is
a <a href="#format_global_variables">global variable descriptor</a> then it
represents a static member. And, if the member is
a <a href="#format_subprograms">subprogram descriptor</a> then it represents
a member function. For static members and member
functions, <tt>getName()</tt> returns the members link or the C++ mangled
name. <tt>getDisplayName()</tt> the simplied version of the name.</p>
<p>The first member of subroutine (tag = <tt>DW_TAG_subroutine_type</tt>) type
elements is the return type for the subroutine. The remaining elements are
the formal arguments to the subroutine.</p>
add subroutine types llvm-svn: 28878
2006-06-21 05:13:20 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p><a href="#format_composite_type">Composite type</a> location can be
Until now all debug info MDNodes referred to a root MDNode, a compile unit. This simplified handling of these needs in dwarf writer. However, one side effect of this is that during link time optimization all these MDNodes are _not_ uniqued. In other words there will be N number of MDNodes describing "int", "char" and all other types, which would suddenly grow when each object file starts using libraries like STL. MDNodes graph structure such that compiler unit keeps track of important MDNodes and update dwarf writer to process mdnodes top-down instead of bottom up. llvm-svn: 137778
2011-08-17 06:09:43 +08:00
determined from the context and line number. The size, alignment and
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
offset are expressed in bits and can be 64 bit values. The alignment is used
to round the offset when embedded in
a <a href="#format_composite_type">composite type</a> (as an example, to keep
float doubles on 64 bit boundaries.) The offset is the bit offset if embedded
in a <a href="#format_composite_type">composite type</a>.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_subrange">Subrange descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Update docs to match reality. llvm-svn: 124761
2011-02-03 08:22:17 +08:00
!42 = metadata !{
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
i32, ;; Tag = 33 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a> (DW_TAG_subrange_type)
i64, ;; Low value
i64 ;; High value
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>These descriptors are used to define ranges of array subscripts for an array
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<a href="#format_composite_type">composite type</a>. The low value defines
the lower bounds typically zero for C/C++. The high value is the upper
bounds. Values are 64 bit. High - low + 1 is the size of the array. If low
Simplify array bound checks and clarify comments. One element array can have same non-zero number as lower bound as well as upper bound. llvm-svn: 129170
2011-04-09 07:39:38 +08:00
> high the array bounds are not included in generated debugging information.
</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_enumeration">Enumerator descriptors</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!6 = metadata !{
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i32, ;; Tag = 40 + <a href="#LLVMDebugVersion">LLVMDebugVersion</a>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
;; (DW_TAG_enumerator)
metadata, ;; Name
i64 ;; Value
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<p>These descriptors are used to define members of an
enumeration <a href="#format_composite_type">composite type</a>, it
associates the name to the value.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<a name="format_variables">Local variables</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!7 = metadata !{
i32, ;; Tag (see below)
metadata, ;; Context
metadata, ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata, ;; Reference to file where defined
Since last couple of days, argument number is encoded using 8 bits from line number field in argument's debug info. llvm-svn: 127250
2011-03-09 00:29:40 +08:00
i32, ;; 24 bit - Line number where defined
;; 8 bit - Argument number. 1 indicates 1st argument.
Update document listing DIVariable elements to reflect recent changes. llvm-svn: 136228
2011-07-28 02:14:50 +08:00
metadata, ;; Type descriptor
i32, ;; flags
metadata ;; (optional) Reference to inline location
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
}
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<p>These descriptors are used to define variables local to a sub program. The
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
value of the tag depends on the usage of the variable:</p>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
DW_TAG_auto_variable = 256
DW_TAG_arg_variable = 257
DW_TAG_return_variable = 258
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
<p>An auto variable is any variable declared in the body of the function. An
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
argument variable is any variable that appears as a formal argument to the
function. A return variable is used to track the result of a function and
has no source correspondent.</p>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
Fixed some grammer and spelling. llvm-svn: 27062
2006-03-24 17:20:27 +08:00
<p>The context is either the subprogram or block where the variable is defined.
Until now all debug info MDNodes referred to a root MDNode, a compile unit. This simplified handling of these needs in dwarf writer. However, one side effect of this is that during link time optimization all these MDNodes are _not_ uniqued. In other words there will be N number of MDNodes describing "int", "char" and all other types, which would suddenly grow when each object file starts using libraries like STL. MDNodes graph structure such that compiler unit keeps track of important MDNodes and update dwarf writer to process mdnodes top-down instead of bottom up. llvm-svn: 137778
2011-08-17 06:09:43 +08:00
Name the source variable name. Context and line indicate where the
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
variable was defined. Type descriptor defines the declared type of the
variable.</p>
Updated information related to local variables and scopes. llvm-svn: 26982
2006-03-24 01:54:33 +08:00
</div>
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
</div>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_common_intrinsics">Debugger intrinsic functions</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>LLVM uses several intrinsic functions (name prefixed with "llvm.dbg") to
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
provide debug information at various points in generated code.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="format_common_declare">llvm.dbg.declare</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
Fix dbg_declare signature in document. llvm-svn: 115326
2010-10-02 03:22:16 +08:00
void %<a href="#format_common_declare">llvm.dbg.declare</a>(metadata, metadata)
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Fix documentation. llvm-svn: 150860
2012-02-18 09:38:41 +08:00
<p>This intrinsic provides information about a local element (e.g., variable). The
first argument is metadata holding the alloca for the variable. The
second argument is metadata containing a description of the variable.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
Add documentation for llvm.dbg.value intrinsic llvm-svn: 93203
2010-01-12 06:53:48 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Add documentation for llvm.dbg.value intrinsic llvm-svn: 93203
2010-01-12 06:53:48 +08:00
<a name="format_common_value">llvm.dbg.value</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Add documentation for llvm.dbg.value intrinsic llvm-svn: 93203
2010-01-12 06:53:48 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Add documentation for llvm.dbg.value intrinsic llvm-svn: 93203
2010-01-12 06:53:48 +08:00
<pre>
Fix whitespace to be more consistent with AsmPrinter's style. llvm-svn: 104962
2010-05-29 01:07:41 +08:00
void %<a href="#format_common_value">llvm.dbg.value</a>(metadata, i64, metadata)
Add documentation for llvm.dbg.value intrinsic llvm-svn: 93203
2010-01-12 06:53:48 +08:00
</pre>
<p>This intrinsic provides information when a user source variable is set to a
new value. The first argument is the new value (wrapped as metadata). The
second argument is the offset in the user source variable where the new value
Fix documentation. llvm-svn: 150860
2012-02-18 09:38:41 +08:00
is written. The third argument is metadata containing a description of the
user source variable.</p>
Add documentation for llvm.dbg.value intrinsic llvm-svn: 93203
2010-01-12 06:53:48 +08:00
</div>
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
<a name="format_common_lifetime">Object lifetimes and scoping</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
<p>In many languages, the local variables in functions can have their lifetimes
or scopes limited to a subset of a function. In the C family of languages,
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
for example, variables are only live (readable and writable) within the
source block that they are defined in. In functional languages, values are
only readable after they have been defined. Though this is a very obvious
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
concept, it is non-trivial to model in LLVM, because it has no notion of
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
scoping in this sense, and does not want to be tied to a language's scoping
rules.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
<p>In order to handle this, the LLVM debug format uses the metadata attached to
Small fixes to this documentation. Remove mention of uint/int type, fix typo in 'number'. llvm-svn: 100001
2010-03-31 15:50:17 +08:00
llvm instructions to encode line number and scoping information. Consider
the following C fragment, for example:</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
1. void foo() {
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
2. int X = 21;
3. int Y = 22;
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
4. {
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
5. int Z = 23;
6. Z = X;
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
7. }
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
8. X = Y;
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
9. }
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>Compiled to LLVM, this function would be represented like this:</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
define void @foo() nounwind ssp {
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
entry:
Remove some validation errors. llvm-svn: 90184
2009-12-01 08:59:58 +08:00
%X = alloca i32, align 4 ; &lt;i32*&gt; [#uses=4]
%Y = alloca i32, align 4 ; &lt;i32*&gt; [#uses=4]
%Z = alloca i32, align 4 ; &lt;i32*&gt; [#uses=3]
Fix more whitespace to be consistent with AsmPrinter. llvm-svn: 104963
2010-05-29 01:13:49 +08:00
%0 = bitcast i32* %X to {}* ; &lt;{}*&gt; [#uses=1]
Update docs to match reality. llvm-svn: 124761
2011-02-03 08:22:17 +08:00
call void @llvm.dbg.declare(metadata !{i32 * %X}, metadata !0), !dbg !7
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
store i32 21, i32* %X, !dbg !8
Fix more whitespace to be consistent with AsmPrinter. llvm-svn: 104963
2010-05-29 01:13:49 +08:00
%1 = bitcast i32* %Y to {}* ; &lt;{}*&gt; [#uses=1]
Update docs to match reality. llvm-svn: 124761
2011-02-03 08:22:17 +08:00
call void @llvm.dbg.declare(metadata !{i32 * %Y}, metadata !9), !dbg !10
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
store i32 22, i32* %Y, !dbg !11
Fix more whitespace to be consistent with AsmPrinter. llvm-svn: 104963
2010-05-29 01:13:49 +08:00
%2 = bitcast i32* %Z to {}* ; &lt;{}*&gt; [#uses=1]
Update docs to match reality. llvm-svn: 124761
2011-02-03 08:22:17 +08:00
call void @llvm.dbg.declare(metadata !{i32 * %Z}, metadata !12), !dbg !14
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
store i32 23, i32* %Z, !dbg !15
Remove some validation errors. llvm-svn: 90184
2009-12-01 08:59:58 +08:00
%tmp = load i32* %X, !dbg !16 ; &lt;i32&gt; [#uses=1]
%tmp1 = load i32* %Y, !dbg !16 ; &lt;i32&gt; [#uses=1]
%add = add nsw i32 %tmp, %tmp1, !dbg !16 ; &lt;i32&gt; [#uses=1]
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
store i32 %add, i32* %Z, !dbg !16
Remove some validation errors. llvm-svn: 90184
2009-12-01 08:59:58 +08:00
%tmp2 = load i32* %Y, !dbg !17 ; &lt;i32&gt; [#uses=1]
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
store i32 %tmp2, i32* %X, !dbg !17
ret void, !dbg !18
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
}
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
Update docs to match reality. llvm-svn: 124761
2011-02-03 08:22:17 +08:00
declare void @llvm.dbg.declare(metadata, metadata) nounwind readnone
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!0 = metadata !{i32 459008, metadata !1, metadata !"X",
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
metadata !3, i32 2, metadata !6}; [ DW_TAG_auto_variable ]
!1 = metadata !{i32 458763, metadata !2}; [DW_TAG_lexical_block ]
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!2 = metadata !{i32 458798, i32 0, metadata !3, metadata !"foo", metadata !"foo",
metadata !"foo", metadata !3, i32 1, metadata !4,
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
i1 false, i1 true}; [DW_TAG_subprogram ]
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!3 = metadata !{i32 458769, i32 0, i32 12, metadata !"foo.c",
metadata !"/private/tmp", metadata !"clang 1.1", i1 true,
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
i1 false, metadata !"", i32 0}; [DW_TAG_compile_unit ]
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!4 = metadata !{i32 458773, metadata !3, metadata !"", null, i32 0, i64 0, i64 0,
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
i64 0, i32 0, null, metadata !5, i32 0}; [DW_TAG_subroutine_type ]
!5 = metadata !{null}
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!6 = metadata !{i32 458788, metadata !3, metadata !"int", metadata !3, i32 0,
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
i64 32, i64 32, i64 0, i32 0, i32 5}; [DW_TAG_base_type ]
!7 = metadata !{i32 2, i32 7, metadata !1, null}
!8 = metadata !{i32 2, i32 3, metadata !1, null}
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!9 = metadata !{i32 459008, metadata !1, metadata !"Y", metadata !3, i32 3,
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
metadata !6}; [ DW_TAG_auto_variable ]
!10 = metadata !{i32 3, i32 7, metadata !1, null}
!11 = metadata !{i32 3, i32 3, metadata !1, null}
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!12 = metadata !{i32 459008, metadata !13, metadata !"Z", metadata !3, i32 5,
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
metadata !6}; [ DW_TAG_auto_variable ]
!13 = metadata !{i32 458763, metadata !1}; [DW_TAG_lexical_block ]
!14 = metadata !{i32 5, i32 9, metadata !13, null}
!15 = metadata !{i32 5, i32 5, metadata !13, null}
!16 = metadata !{i32 6, i32 5, metadata !13, null}
!17 = metadata !{i32 8, i32 3, metadata !1, null}
!18 = metadata !{i32 9, i32 1, metadata !2, null}
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
<p>This example illustrates a few important details about LLVM debugging
information. In particular, it shows how the <tt>llvm.dbg.declare</tt>
intrinsic and location information, which are attached to an instruction,
are applied together to allow a debugger to analyze the relationship between
statements, variable definitions, and the code used to implement the
function.</p>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
<div class="doc_code">
Remove some validation errors. llvm-svn: 90184
2009-12-01 08:59:58 +08:00
<pre>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
call void @llvm.dbg.declare(metadata, metadata !0), !dbg !7
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
</pre>
</div>
<p>The first intrinsic
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
<tt>%<a href="#format_common_declare">llvm.dbg.declare</a></tt>
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
encodes debugging information for the variable <tt>X</tt>. The metadata
<tt>!dbg !7</tt> attached to the intrinsic provides scope information for the
variable <tt>X</tt>.</p>
<div class="doc_code">
<pre>
!7 = metadata !{i32 2, i32 7, metadata !1, null}
!1 = metadata !{i32 458763, metadata !2}; [DW_TAG_lexical_block ]
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
!2 = metadata !{i32 458798, i32 0, metadata !3, metadata !"foo",
metadata !"foo", metadata !"foo", metadata !3, i32 1,
metadata !4, i1 false, i1 true}; [DW_TAG_subprogram ]
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
</pre>
</div>
<p>Here <tt>!7</tt> is metadata providing location information. It has four
fields: line number, column number, scope, and original scope. The original
scope represents inline location if this instruction is inlined inside a
caller, and is null otherwise. In this example, scope is encoded by
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
<tt>!1</tt>. <tt>!1</tt> represents a lexical block inside the scope
<tt>!2</tt>, where <tt>!2</tt> is a
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
<a href="#format_subprograms">subprogram descriptor</a>. This way the
location information attached to the intrinsics indicates that the
variable <tt>X</tt> is declared at line number 2 at a function level scope in
function <tt>foo</tt>.</p>
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
<p>Now lets take another example.</p>
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
<div class="doc_code">
Remove some validation errors. llvm-svn: 90184
2009-12-01 08:59:58 +08:00
<pre>
Update docs to match reality. llvm-svn: 124761
2011-02-03 08:22:17 +08:00
call void @llvm.dbg.declare(metadata, metadata !12), !dbg !14
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
</pre>
</div>
<p>The second intrinsic
Update to reflect recent debugging information encoding changes. llvm-svn: 89896
2009-11-26 07:28:01 +08:00
<tt>%<a href="#format_common_declare">llvm.dbg.declare</a></tt>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
encodes debugging information for variable <tt>Z</tt>. The metadata
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
<tt>!dbg !14</tt> attached to the intrinsic provides scope information for
the variable <tt>Z</tt>.</p>
<div class="doc_code">
<pre>
!13 = metadata !{i32 458763, metadata !1}; [DW_TAG_lexical_block ]
!14 = metadata !{i32 5, i32 9, metadata !13, null}
</pre>
</div>
Fixed spelling errors. llvm-svn: 98724
2010-03-17 23:01:50 +08:00
<p>Here <tt>!14</tt> indicates that <tt>Z</tt> is declared at line number 5 and
Some formatting and spelling fixes. llvm-svn: 90182
2009-12-01 08:53:11 +08:00
column number 9 inside of lexical scope <tt>!13</tt>. The lexical scope
itself resides inside of lexical scope <tt>!1</tt> described above.</p>
<p>The scope information attached with each instruction provides a
straightforward way to find instructions covered by a scope.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- *********************************************************************** -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h2>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_frontend">C/C++ front-end specific debug information</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h2>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- *********************************************************************** -->
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>The C and C++ front-ends represent information about the program in a format
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
that is effectively identical
to <a href="http://www.eagercon.com/dwarf/dwarf3std.htm">DWARF 3.0</a> in
terms of information content. This allows code generators to trivially
support native debuggers by generating standard dwarf information, and
contains enough information for non-dwarf targets to translate it as
needed.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>This section describes the forms used to represent C and C++ programs. Other
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
languages could pattern themselves after this (which itself is tuned to
representing programs in the same way that DWARF 3 does), or they could
choose to provide completely different forms if they don't fit into the DWARF
model. As support for debugging information gets added to the various LLVM
source-language front-ends, the information used should be documented
here.</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<p>The following sections provide examples of various C/C++ constructs and the
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
debug information that would best describe those constructs.</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_compile_units">C/C++ source file information</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<p>Given the source files <tt>MySource.cpp</tt> and <tt>MyHeader.h</tt> located
in the directory <tt>/Users/mine/sources</tt>, the following code:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
#include "MyHeader.h"
int main(int argc, char *argv[]) {
return 0;
}
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>a C/C++ front-end would generate the following descriptors:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
...
Revert 79977. It causes llvm-gcc bootstrap failures on some platforms. llvm-svn: 80073
2009-08-26 13:01:18 +08:00
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
;; Define the compile unit for the main source file "/Users/mine/sources/MySource.cpp".
Revert 79977. It causes llvm-gcc bootstrap failures on some platforms. llvm-svn: 80073
2009-08-26 13:01:18 +08:00
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
!2 = metadata !{
i32 524305, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Unused
i32 4, ;; Language Id
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
metadata !"MySource.cpp",
metadata !"/Users/mine/sources",
metadata !"4.2.1 (Based on Apple Inc. build 5649) (LLVM build 00)",
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i1 true, ;; Main Compile Unit
i1 false, ;; Optimized compile unit
metadata !"", ;; Compiler flags
i32 0} ;; Runtime version
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
;; Define the file for the file "/Users/mine/sources/MySource.cpp".
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!1 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524329, ;; Tag
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
metadata !"MySource.cpp",
metadata !"/Users/mine/sources",
Fix compile unit in example. Thanks Renato Golin! llvm-svn: 108246
2010-07-14 00:53:20 +08:00
metadata !2 ;; Compile unit
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
}
;;
;; Define the file for the file "/Users/mine/sources/Myheader.h"
;;
!3 = metadata !{
i32 524329, ;; Tag
metadata !"Myheader.h"
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
metadata !"/Users/mine/sources",
Fix compile unit in example. Thanks Renato Golin! llvm-svn: 108246
2010-07-14 00:53:20 +08:00
metadata !2 ;; Compile unit
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
...
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p>llvm::Instruction provides easy access to metadata attached with an
Add a paragram describing how to extract line number information. llvm-svn: 99636
2010-03-27 03:08:36 +08:00
instruction. One can extract line number information encoded in LLVM IR
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
using <tt>Instruction::getMetadata()</tt> and
Add a paragram describing how to extract line number information. llvm-svn: 99636
2010-03-27 03:08:36 +08:00
<tt>DILocation::getLineNumber()</tt>.
<pre>
if (MDNode *N = I->getMetadata("dbg")) { // Here I is an LLVM instruction
DILocation Loc(N); // DILocation is in DebugInfo.h
unsigned Line = Loc.getLineNumber();
StringRef File = Loc.getFilename();
StringRef Dir = Loc.getDirectory();
}
</pre>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_global_variable">C/C++ global variable information</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>Given an integer global variable declared as follows:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
int MyGlobal = 100;
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>a C/C++ front-end would generate the following descriptors:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
;;
;; Define the global itself.
;;
%MyGlobal = global int 100
...
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
;; List of debug info of globals
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!llvm.dbg.gv = !{!0}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the global variable descriptor. Note the reference to the global
;; variable anchor and the global variable itself.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!0 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524340, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Unused
metadata !1, ;; Context
metadata !"MyGlobal", ;; Name
metadata !"MyGlobal", ;; Display Name
metadata !"MyGlobal", ;; Linkage Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !3, ;; Compile Unit
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 1, ;; Line Number
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !4, ;; Type
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i1 false, ;; Is a local variable
i1 true, ;; Is this a definition
i32* @MyGlobal ;; The global variable
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the basic type of 32 bit signed integer. Note that since int is an
;; intrinsic type the source file is NULL and line 0.
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
!4 = metadata !{
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"int", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 32, ;; Size in Bits
i64 32, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 5 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_subprogram">C/C++ function information</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>Given a function declared as follows:</p>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
int main(int argc, char *argv[]) {
return 0;
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
}
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>a C/C++ front-end would generate the following descriptors:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
;;
;; Define the anchor for subprograms. Note that the second field of the
;; anchor is 46, which is the same as the tag for subprograms
;; (46 = DW_TAG_subprogram.)
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
!6 = metadata !{
i32 524334, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Unused
metadata !1, ;; Context
metadata !"main", ;; Name
metadata !"main", ;; Display name
metadata !"main", ;; Linkage name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 1, ;; Line number
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !4, ;; Type
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
i1 false, ;; Is local
Add support to encode function's template parameters. llvm-svn: 128947
2011-04-06 06:52:06 +08:00
i1 true, ;; Is definition
i32 0, ;; Virtuality attribute, e.g. pure virtual function
i32 0, ;; Index into virtual table for C++ methods
i32 0, ;; Type that holds virtual table.
i32 0, ;; Flags
i1 false, ;; True if this function is optimized
Function *, ;; Pointer to llvm::Function
null ;; Function template parameters
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the subprogram itself.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
define i32 @main(i32 %argc, i8** %argv) {
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
...
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_types">C/C++ basic types</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>The following are the basic type descriptors for C/C++ core types:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_type_bool">bool</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"bool", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 8, ;; Size in Bits
i64 8, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 2 ;; Encoding
}
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_char">char</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"char", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 8, ;; Size in Bits
i64 8, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 6 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_unsigned_char">unsigned char</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
metadata !"unsigned char",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 8, ;; Size in Bits
i64 8, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 8 ;; Encoding
}
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_short">short</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"short int",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 16, ;; Size in Bits
i64 16, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 5 ;; Encoding
}
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_unsigned_short">unsigned short</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"short unsigned int",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 16, ;; Size in Bits
i64 16, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 7 ;; Encoding
}
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_int">int</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"int", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 32, ;; Size in Bits
i64 32, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 5 ;; Encoding
}
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</pre></div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_unsigned_int">unsigned int</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"unsigned int",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 32, ;; Size in Bits
i64 32, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 7 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_long_long">long long</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"long long int",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 64, ;; Size in Bits
i64 64, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 5 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_unsigned_long_long">unsigned long long</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"long long unsigned int",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 64, ;; Size in Bits
i64 64, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 7 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_float">float</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"float",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 32, ;; Size in Bits
i64 32, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 4 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_basic_double">double</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h4>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"double",;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 64, ;; Size in Bits
i64 64, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 4 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_derived_types">C/C++ derived types</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>Given the following as an example of C/C++ derived type:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
typedef const int *IntPtr;
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>a C/C++ front-end would generate the following descriptors:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
;;
;; Define the typedef "IntPtr".
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524310, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"IntPtr", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !3, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 0, ;; Size in bits
i64 0, ;; Align in bits
i64 0, ;; Offset in bits
i32 0, ;; Flags
metadata !4 ;; Derived From type
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the pointer type.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!4 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524303, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 64, ;; Size in bits
i64 64, ;; Align in bits
i64 0, ;; Offset in bits
i32 0, ;; Flags
metadata !5 ;; Derived From type
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the const type.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!5 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524326, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 32, ;; Size in bits
i64 32, ;; Align in bits
i64 0, ;; Offset in bits
i32 0, ;; Flags
metadata !6 ;; Derived From type
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the int type.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!6 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"int", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 32, ;; Size in bits
i64 32, ;; Align in bits
i64 0, ;; Offset in bits
i32 0, ;; Flags
5 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_composite_types">C/C++ struct/union types</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
Add links to SLD from the LangRef.html doc Clean up the SLD document a LOT Fill in a lot of details in the SLD document update the formats for the object descriptors llvm-svn: 10698
2004-01-06 13:31:32 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>Given the following as an example of C/C++ struct type:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
struct Color {
unsigned Red;
unsigned Green;
unsigned Blue;
};
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>a C/C++ front-end would generate the following descriptors:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
;;
;; Define basic type for unsigned int.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!5 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524324, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"unsigned int",
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 0, ;; Line number
i64 32, ;; Size in Bits
i64 32, ;; Align in Bits
i64 0, ;; Offset in Bits
i32 0, ;; Flags
i32 7 ;; Encoding
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define composite type for struct Color.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524307, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"Color", ;; Name
metadata !1, ;; Compile unit
i32 1, ;; Line number
i64 96, ;; Size in bits
i64 32, ;; Align in bits
i64 0, ;; Offset in bits
i32 0, ;; Flags
null, ;; Derived From
metadata !3, ;; Elements
i32 0 ;; Runtime Language
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the Red field.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!4 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524301, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"Red", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 2, ;; Line number
i64 32, ;; Size in bits
i64 32, ;; Align in bits
i64 0, ;; Offset in bits
i32 0, ;; Flags
metadata !5 ;; Derived From type
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the Green field.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!6 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524301, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"Green", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 3, ;; Line number
i64 32, ;; Size in bits
i64 32, ;; Align in bits
i64 32, ;; Offset in bits
i32 0, ;; Flags
metadata !5 ;; Derived From type
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the Blue field.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!7 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524301, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"Blue", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 4, ;; Line number
i64 32, ;; Size in bits
i64 32, ;; Align in bits
i64 64, ;; Offset in bits
i32 0, ;; Flags
metadata !5 ;; Derived From type
}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define the array of fields used by the composite type Color.
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!3 = metadata !{metadata !4, metadata !6, metadata !7}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
<!-- ======================================================================= -->
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
<h3>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<a name="ccxx_enumeration_types">C/C++ enumeration types</a>
docs: Use <Hn> as Heading elements instead of <DIV class="doc_foo">. H1 ... doc_title H2 ... doc_section H3 ... doc_subsection H4 ... doc_subsubsection llvm-svn: 129736
2011-04-19 07:59:50 +08:00
</h3>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
<div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>Given the following as an example of C/C++ enumeration type:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
enum Trees {
Spruce = 100,
Oak = 200,
Maple = 300
};
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
* Comply with HTML 4.01 Strict standard * Converted absolute links to llvm.org/docs to relative links * Fixed spelling and s/;/:/, as needed llvm-svn: 61071
2008-12-16 10:54:22 +08:00
<p>a C/C++ front-end would generate the following descriptors:</p>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
<div class="doc_code">
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
<pre>
;;
;; Define composite type for enum Trees
;;
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
!2 = metadata !{
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
i32 524292, ;; Tag
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
metadata !1, ;; Context
metadata !"Trees", ;; Name
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
metadata !1, ;; File
Reapply 79977. Use MDNodes to encode debug info in llvm IR. llvm-svn: 80406
2009-08-29 07:24:31 +08:00
i32 1, ;; Line number
i64 32, ;; Size in bits
i64 32, ;; Align in bits
i64 0, ;; Offset in bits
i32 0, ;; Flags
null, ;; Derived From type
metadata !3, ;; Elements
i32 0 ;; Runtime language
}
;;
;; Define the array of enumerators used by composite type Trees.
;;
!3 = metadata !{metadata !4, metadata !5, metadata !6}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define Spruce enumerator.
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
!4 = metadata !{i32 524328, metadata !"Spruce", i64 100}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define Oak enumerator.
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
!5 = metadata !{i32 524328, metadata !"Oak", i64 200}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
;;
;; Define Maple enumerator.
;;
Start using DIFile. See updated SourceLevelDebugging.html for more information. This patch updates LLVMDebugVersion to 8. Debug info descriptors encoded using LLVMDebugVersion 7 is supported. Corresponding llvmgcc and clang FE commits are required. llvm-svn: 98020
2010-03-09 08:44:10 +08:00
!6 = metadata !{i32 524328, metadata !"Maple", i64 300}
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</pre>
Formatting. Some updating of data structures. More work needs to be done to update the examples. llvm-svn: 71974
2009-05-17 13:52:39 +08:00
</div>
Bring debugging information up to date. llvm-svn: 26759
2006-03-15 02:08:46 +08:00
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
docs: Introduce cascading style <div> and <p> continued on <h[2-5]>. <h2>Section Example</h2> <div> <!-- h2+div is applied --> <p>Section preamble.</p> <h3>Subsection Example</h3> <p> <!-- h3+p is applied --> Subsection body </p> <!-- End of section body --> </div> FIXME: Care H5 better. llvm-svn: 130040
2011-04-23 08:30:22 +08:00
</div>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
<!-- *********************************************************************** -->
<h2>
<a name="llvmdwarfextension">Debugging information format</a>
</h2>
<!-- *********************************************************************** -->
<div>
<!-- ======================================================================= -->
<h3>
Fix validation errors. llvm-svn: 152112
2012-03-06 17:17:39 +08:00
<a name="objcproperty">Debugging Information Extension for Objective C Properties</a>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</h3>
<div>
<!-- *********************************************************************** -->
<h4>
<a name="objcpropertyintroduction">Introduction</a>
</h4>
<!-- *********************************************************************** -->
<div>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p>Objective C provides a simpler way to declare and define accessor methods
using declared properties. The language provides features to declare a
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
property and to let compiler synthesize accessor methods.
</p>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p>The debugger lets developer inspect Objective C interfaces and their
instance variables and class variables. However, the debugger does not know
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
anything about the properties defined in Objective C interfaces. The debugger
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
consumes information generated by compiler in DWARF format. The format does
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
not support encoding of Objective C properties. This proposal describes DWARF
extensions to encode Objective C properties, which the debugger can use to let
developers inspect Objective C properties.
</p>
</div>
<!-- *********************************************************************** -->
<h4>
<a name="objcpropertyproposal">Proposal</a>
</h4>
<!-- *********************************************************************** -->
<div>
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
<p>Objective C properties exist separately from class members. A property
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
can be defined only by &quot;setter&quot; and &quot;getter&quot; selectors, and
be calculated anew on each access. Or a property can just be a direct access
to some declared ivar. Finally it can have an ivar &quot;automatically
synthesized&quot; for it by the compiler, in which case the property can be
referred to in user code directly using the standard C dereference syntax as
well as through the property &quot;dot&quot; syntax, but there is no entry in
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
the @interface declaration corresponding to this ivar.
</p>
<p>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
To facilitate debugging, these properties we will add a new DWARF TAG into the
DW_TAG_structure_type definition for the class to hold the description of a
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
given property, and a set of DWARF attributes that provide said description.
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
The property tag will also contain the name and declared type of the property.
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
</p>
<p>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
If there is a related ivar, there will also be a DWARF property attribute placed
in the DW_TAG_member DIE for that ivar referring back to the property TAG for
that property. And in the case where the compiler synthesizes the ivar directly,
the compiler is expected to generate a DW_TAG_member for that ivar (with the
DW_AT_artificial set to 1), whose name will be the name used to access this
ivar directly in code, and with the property attribute pointing back to the
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
property it is backing.
</p>
<p>
The following examples will serve as illustration for our discussion:
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</p>
<div class="doc_code">
<pre>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
@interface I1 {
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
int n2;
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
}
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
@property int p1;
@property int p2;
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
@end
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
@implementation I1
@synthesize p1;
@synthesize p2 = n2;
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
@end
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
</pre>
</div>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
<p>
This produces the following DWARF (this is a &quot;pseudo dwarfdump&quot; output):
</p>
<div class="doc_code">
<pre>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
0x00000100: TAG_structure_type [7] *
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
AT_APPLE_runtime_class( 0x10 )
AT_name( "I1" )
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
AT_decl_file( "Objc_Property.m" )
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
AT_decl_line( 3 )
0x00000110 TAG_APPLE_property
AT_name ( "p1" )
AT_type ( {0x00000150} ( int ) )
0x00000120: TAG_APPLE_property
AT_name ( "p2" )
AT_type ( {0x00000150} ( int ) )
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
0x00000130: TAG_member [8]
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
AT_name( "_p1" )
AT_APPLE_property ( {0x00000110} "p1" )
AT_type( {0x00000150} ( int ) )
AT_artificial ( 0x1 )
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
0x00000140: TAG_member [8]
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
AT_name( "n2" )
AT_APPLE_property ( {0x00000120} "p2" )
AT_type( {0x00000150} ( int ) )
0x00000150: AT_type( ( int ) )
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</pre>
</div>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p> Note, the current convention is that the name of the ivar for an
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
auto-synthesized property is the name of the property from which it derives with
an underscore prepended, as is shown in the example.
But we actually don't need to know this convention, since we are given the name
of the ivar directly.
</p>
<p>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
Also, it is common practice in ObjC to have different property declarations in
the @interface and @implementation - e.g. to provide a read-only property in
the interface,and a read-write interface in the implementation. In that case,
the compiler should emit whichever property declaration will be in force in the
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
current translation unit.
</p>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p> Developers can decorate a property with attributes which are encoded using
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
DW_AT_APPLE_property_attribute.
</p>
<div class="doc_code">
<pre>
@property (readonly, nonatomic) int pr;
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
</pre>
</div>
<p>
Which produces a property tag:
<p>
<div class="doc_code">
<pre>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
TAG_APPLE_property [8]
AT_name( "pr" )
AT_type ( {0x00000147} (int) )
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
AT_APPLE_property_attribute (DW_APPLE_PROPERTY_readonly, DW_APPLE_PROPERTY_nonatomic)
</pre>
</div>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
<p> The setter and getter method names are attached to the property using
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
DW_AT_APPLE_property_setter and DW_AT_APPLE_property_getter attributes.
</p>
<div class="doc_code">
<pre>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
@interface I1
@property (setter=myOwnP3Setter:) int p3;
-(void)myOwnP3Setter:(int)a;
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
@end
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
@implementation I1
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
@synthesize p3;
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
-(void)myOwnP3Setter:(int)a{ }
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
@end
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
</pre>
</div>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
<p>
The DWARF for this would be:
</p>
<div class="doc_code">
<pre>
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
0x000003bd: TAG_structure_type [7] *
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
AT_APPLE_runtime_class( 0x10 )
AT_name( "I1" )
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
AT_decl_file( "Objc_Property.m" )
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
AT_decl_line( 3 )
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
0x000003cd TAG_APPLE_property
AT_name ( "p3" )
AT_APPLE_property_setter ( "myOwnP3Setter:" )
AT_type( {0x00000147} ( int ) )
Delete trailing whitespace to clean up. llvm-svn: 152092
2012-03-06 10:25:36 +08:00
0x000003f3: TAG_member [8]
AT_name( "_p3" )
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
AT_type ( {0x00000147} ( int ) )
AT_APPLE_property ( {0x000003cd} )
AT_artificial ( 0x1 )
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</pre>
</div>
</div>
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
<!-- *********************************************************************** -->
<h4>
<a name="objcpropertynewtags">New DWARF Tags</a>
</h4>
<!-- *********************************************************************** -->
<div>
<table border="1" cellspacing="0">
Remove short tag marker. llvm-svn: 152114
2012-03-06 17:22:03 +08:00
<col width="200">
<col width="200">
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<th>TAG</th>
<th>Value</th>
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_TAG_APPLE_property</td>
<td>0x4200</td>
Update docs describing objective-c property encoding. This includes support for properties that are not backed by an ivar. llvm-svn: 149879
2012-02-07 02:18:25 +08:00
</tr>
</table>
</div>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
<!-- *********************************************************************** -->
<h4>
<a name="objcpropertynewattributes">New DWARF Attributes</a>
</h4>
<!-- *********************************************************************** -->
<div>
<table border="1" cellspacing="0">
Remove short tag marker. llvm-svn: 152114
2012-03-06 17:22:03 +08:00
<col width="200">
<col width="200">
<col width="200">
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<th>Attribute</th>
<th>Value</th>
<th>Classes</th>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_property</td>
<td>0x3fed</td>
<td>Reference</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_property_getter</td>
<td>0x3fe9</td>
<td>String</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_property_setter</td>
<td>0x3fea</td>
<td>String</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_property_attribute</td>
<td>0x3feb</td>
<td>Constant</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
</table>
</div>
<!-- *********************************************************************** -->
<h4>
<a name="objcpropertynewconstants">New DWARF Constants</a>
</h4>
<!-- *********************************************************************** -->
<div>
<table border="1" cellspacing="0">
Remove short tag marker. llvm-svn: 152114
2012-03-06 17:22:03 +08:00
<col width="200">
<col width="200">
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<th>Name</th>
<th>Value</th>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_PROPERTY_readonly</td>
<td>0x1</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_PROPERTY_readwrite</td>
<td>0x2</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_PROPERTY_assign</td>
<td>0x4</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_PROPERTY_retain</td>
<td>0x8</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_PROPERTY_copy</td>
<td>0x10</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
<tr>
Appease the HTML validation gods. llvm-svn: 152113
2012-03-06 17:20:59 +08:00
<td>DW_AT_APPLE_PROPERTY_nonatomic</td>
<td>0x20</td>
Merge ObjCPropertyDebugInfo.html into SourceLevelDebugging.html llvm-svn: 144724
2011-11-16 06:59:54 +08:00
</tr>
</table>
</div>
</div>
</div>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div>
<!-- ======================================================================= -->
<h3>
<a name="acceltable">Name Accelerator Tables</a>
</h3>
<!-- ======================================================================= -->
<!-- ======================================================================= -->
<h4>
Fix up link and a couple small edits. llvm-svn: 152094
2012-03-06 10:25:41 +08:00
<a name="acceltableintroduction">Introduction</a>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
</h4>
<!-- ======================================================================= -->
<div>
<p>The .debug_pubnames and .debug_pubtypes formats are not what a debugger
needs. The "pub" in the section name indicates that the entries in the
table are publicly visible names only. This means no static or hidden
functions show up in the .debug_pubnames. No static variables or private class
variables are in the .debug_pubtypes. Many compilers add different things to
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
these tables, so we can't rely upon the contents between gcc, icc, or clang.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>The typical query given by users tends not to match up with the contents of
these tables. For example, the DWARF spec states that "In the case of the
name of a function member or static data member of a C++ structure, class or
union, the name presented in the .debug_pubnames section is not the simple
name given by the DW_AT_name attribute of the referenced debugging information
entry, but rather the fully qualified name of the data or function member."
So the only names in these tables for complex C++ entries is a fully
qualified name. Debugger users tend not to enter their search strings as
"a::b::c(int,const Foo&) const", but rather as "c", "b::c" , or "a::b::c". So
the name entered in the name table must be demangled in order to chop it up
appropriately and additional names must be manually entered into the table
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
to make it effective as a name lookup table for debuggers to use.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>All debuggers currently ignore the .debug_pubnames table as a result of
its inconsistent and useless public-only name content making it a waste of
space in the object file. These tables, when they are written to disk, are
not sorted in any way, leaving every debugger to do its own parsing
and sorting. These tables also include an inlined copy of the string values
in the table itself making the tables much larger than they need to be on
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
disk, especially for large C++ programs.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>Can't we just fix the sections by adding all of the names we need to this
table? No, because that is not what the tables are defined to contain and we
won't know the difference between the old bad tables and the new good tables.
At best we could make our own renamed sections that contain all of the data
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
we need.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>These tables are also insufficient for what a debugger like LLDB needs.
LLDB uses clang for its expression parsing where LLDB acts as a PCH. LLDB is
then often asked to look for type "foo" or namespace "bar", or list items in
namespace "baz". Namespaces are not included in the pubnames or pubtypes
tables. Since clang asks a lot of questions when it is parsing an expression,
we need to be very fast when looking up names, as it happens a lot. Having new
accelerator tables that are optimized for very quick lookups will benefit
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
this type of debugging experience greatly.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>We would like to generate name lookup tables that can be mapped into
memory from disk, and used as is, with little or no up-front parsing. We would
also be able to control the exact content of these different tables so they
contain exactly what we need. The Name Accelerator Tables were designed
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
to fix these issues. In order to solve these issues we need to:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<ul>
<li>Have a format that can be mapped into memory from disk and used as is</li>
<li>Lookups should be very fast</li>
<li>Extensible table format so these tables can be made by many producers</li>
<li>Contain all of the names needed for typical lookups out of the box</li>
<li>Strict rules for the contents of tables</li>
</ul>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>Table size is important and the accelerator table format should allow the
reuse of strings from common string tables so the strings for the names are
not duplicated. We also want to make sure the table is ready to be used as-is
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
by simply mapping the table into memory with minimal header parsing.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>The name lookups need to be fast and optimized for the kinds of lookups
that debuggers tend to do. Optimally we would like to touch as few parts of
the mapped table as possible when doing a name lookup and be able to quickly
find the name entry we are looking for, or discover there are no matches. In
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
the case of debuggers we optimized for lookups that fail most of the time.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>Each table that is defined should have strict rules on exactly what is in
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
the accelerator tables and documented so clients can rely on the content.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<!-- ======================================================================= -->
<h4>
<a name="acceltablehashes">Hash Tables</a>
</h4>
<!-- ======================================================================= -->
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div>
<h5>Standard Hash Tables</h5>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>Typical hash tables have a header, buckets, and each bucket points to the
bucket contents:
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.------------.
| HEADER |
|------------|
| BUCKETS |
|------------|
| DATA |
`------------'
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
<p>The BUCKETS are an array of offsets to DATA for each hash:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.------------.
| 0x00001000 | BUCKETS[0]
| 0x00002000 | BUCKETS[1]
| 0x00002200 | BUCKETS[2]
| 0x000034f0 | BUCKETS[3]
| | ...
| 0xXXXXXXXX | BUCKETS[n_buckets]
'------------'
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>So for bucket[3] in the example above, we have an offset into the table
0x000034f0 which points to a chain of entries for the bucket. Each bucket
must contain a next pointer, full 32 bit hash value, the string itself,
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
and the data for the current string value.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.------------.
0x000034f0: | 0x00003500 | next pointer
| 0x12345678 | 32 bit hash
| "erase" | string value
| data[n] | HashData for this bucket
|------------|
0x00003500: | 0x00003550 | next pointer
| 0x29273623 | 32 bit hash
| "dump" | string value
| data[n] | HashData for this bucket
|------------|
0x00003550: | 0x00000000 | next pointer
| 0x82638293 | 32 bit hash
| "main" | string value
| data[n] | HashData for this bucket
`------------'
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>The problem with this layout for debuggers is that we need to optimize for
the negative lookup case where the symbol we're searching for is not present.
So if we were to lookup "printf" in the table above, we would make a 32 hash
for "printf", it might match bucket[3]. We would need to go to the offset
0x000034f0 and start looking to see if our 32 bit hash matches. To do so, we
need to read the next pointer, then read the hash, compare it, and skip to
the next bucket. Each time we are skipping many bytes in memory and touching
new cache pages just to do the compare on the full 32 bit hash. All of these
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
accesses then tell us that we didn't have a match.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<h5>Name Hash Tables</h5>
<p>To solve the issues mentioned above we have structured the hash tables
a bit differently: a header, buckets, an array of all unique 32 bit hash
values, followed by an array of hash value data offsets, one for each hash
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
value, then the data for all hash values:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.-------------.
| HEADER |
|-------------|
| BUCKETS |
|-------------|
| HASHES |
|-------------|
| OFFSETS |
|-------------|
| DATA |
`-------------'
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Fix up link and a couple small edits. llvm-svn: 152094
2012-03-06 10:25:41 +08:00
<p>The BUCKETS in the name tables are an index into the HASHES array. By
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
making all of the full 32 bit hash values contiguous in memory, we allow
ourselves to efficiently check for a match while touching as little
Fix up link and a couple small edits. llvm-svn: 152094
2012-03-06 10:25:41 +08:00
memory as possible. Most often checking the 32 bit hash values is as far as
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
the lookup goes. If it does match, it usually is a match with no collisions.
So for a table with "n_buckets" buckets, and "n_hashes" unique 32 bit hash
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
values, we can clarify the contents of the BUCKETS, HASHES and OFFSETS as:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.-------------------------.
| HEADER.magic | uint32_t
| HEADER.version | uint16_t
| HEADER.hash_function | uint16_t
| HEADER.bucket_count | uint32_t
| HEADER.hashes_count | uint32_t
| HEADER.header_data_len | uint32_t
| HEADER_DATA | HeaderData
|-------------------------|
| BUCKETS | uint32_t[n_buckets] // 32 bit hash indexes
|-------------------------|
| HASHES | uint32_t[n_buckets] // 32 bit hash values
|-------------------------|
| OFFSETS | uint32_t[n_buckets] // 32 bit offsets to hash value data
|-------------------------|
| ALL HASH DATA |
`-------------------------'
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>So taking the exact same data from the standard hash example above we end up
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
with:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.------------.
| HEADER |
|------------|
| 0 | BUCKETS[0]
| 2 | BUCKETS[1]
| 5 | BUCKETS[2]
| 6 | BUCKETS[3]
| | ...
| ... | BUCKETS[n_buckets]
|------------|
| 0x........ | HASHES[0]
| 0x........ | HASHES[1]
| 0x........ | HASHES[2]
| 0x........ | HASHES[3]
| 0x........ | HASHES[4]
| 0x........ | HASHES[5]
| 0x12345678 | HASHES[6] hash for BUCKETS[3]
| 0x29273623 | HASHES[7] hash for BUCKETS[3]
| 0x82638293 | HASHES[8] hash for BUCKETS[3]
| 0x........ | HASHES[9]
| 0x........ | HASHES[10]
| 0x........ | HASHES[11]
| 0x........ | HASHES[12]
| 0x........ | HASHES[13]
| 0x........ | HASHES[n_hashes]
|------------|
| 0x........ | OFFSETS[0]
| 0x........ | OFFSETS[1]
| 0x........ | OFFSETS[2]
| 0x........ | OFFSETS[3]
| 0x........ | OFFSETS[4]
| 0x........ | OFFSETS[5]
| 0x000034f0 | OFFSETS[6] offset for BUCKETS[3]
| 0x00003500 | OFFSETS[7] offset for BUCKETS[3]
| 0x00003550 | OFFSETS[8] offset for BUCKETS[3]
| 0x........ | OFFSETS[9]
| 0x........ | OFFSETS[10]
| 0x........ | OFFSETS[11]
| 0x........ | OFFSETS[12]
| 0x........ | OFFSETS[13]
| 0x........ | OFFSETS[n_hashes]
|------------|
| |
| |
| |
| |
| |
|------------|
0x000034f0: | 0x00001203 | .debug_str ("erase")
| 0x00000004 | A 32 bit array count - number of HashData with name "erase"
| 0x........ | HashData[0]
| 0x........ | HashData[1]
| 0x........ | HashData[2]
| 0x........ | HashData[3]
| 0x00000000 | String offset into .debug_str (terminate data for hash)
|------------|
0x00003500: | 0x00001203 | String offset into .debug_str ("collision")
| 0x00000002 | A 32 bit array count - number of HashData with name "collision"
| 0x........ | HashData[0]
| 0x........ | HashData[1]
| 0x00001203 | String offset into .debug_str ("dump")
| 0x00000003 | A 32 bit array count - number of HashData with name "dump"
| 0x........ | HashData[0]
| 0x........ | HashData[1]
| 0x........ | HashData[2]
| 0x00000000 | String offset into .debug_str (terminate data for hash)
|------------|
0x00003550: | 0x00001203 | String offset into .debug_str ("main")
| 0x00000009 | A 32 bit array count - number of HashData with name "main"
| 0x........ | HashData[0]
| 0x........ | HashData[1]
| 0x........ | HashData[2]
| 0x........ | HashData[3]
| 0x........ | HashData[4]
| 0x........ | HashData[5]
| 0x........ | HashData[6]
| 0x........ | HashData[7]
| 0x........ | HashData[8]
| 0x00000000 | String offset into .debug_str (terminate data for hash)
`------------'
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>So we still have all of the same data, we just organize it more efficiently
for debugger lookup. If we repeat the same "printf" lookup from above, we
would hash "printf" and find it matches BUCKETS[3] by taking the 32 bit hash
value and modulo it by n_buckets. BUCKETS[3] contains "6" which is the index
into the HASHES table. We would then compare any consecutive 32 bit hashes
values in the HASHES array as long as the hashes would be in BUCKETS[3]. We
do this by verifying that each subsequent hash value modulo n_buckets is still
3. In the case of a failed lookup we would access the memory for BUCKETS[3], and
then compare a few consecutive 32 bit hashes before we know that we have no match.
We don't end up marching through multiple words of memory and we really keep the
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
number of processor data cache lines being accessed as small as possible.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>The string hash that is used for these lookup tables is the Daniel J.
Bernstein hash which is also used in the ELF GNU_HASH sections. It is a very
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
good hash for all kinds of names in programs with very few hash collisions.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
<p>Empty buckets are designated by using an invalid hash index of UINT32_MAX.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<!-- ======================================================================= -->
<h4>
<a name="acceltabledetails">Details</a>
</h4>
<!-- ======================================================================= -->
<div>
<p>These name hash tables are designed to be generic where specializations of
the table get to define additional data that goes into the header
("HeaderData"), how the string value is stored ("KeyType") and the content
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
of the data for each hash value.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<h5>Header Layout</h5>
<p>The header has a fixed part, and the specialized part. The exact format of
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
the header is:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
struct Header
{
uint32_t magic; // 'HASH' magic value to allow endian detection
uint16_t version; // Version number
uint16_t hash_function; // The hash function enumeration that was used
uint32_t bucket_count; // The number of buckets in this hash table
uint32_t hashes_count; // The total number of unique hash values and hash data offsets in this table
uint32_t header_data_len; // The bytes to skip to get to the hash indexes (buckets) for correct alignment
// Specifically the length of the following HeaderData field - this does not
// include the size of the preceding fields
HeaderData header_data; // Implementation specific header data
};
</pre>
</div>
<p>The header starts with a 32 bit "magic" value which must be 'HASH' encoded as
an ASCII integer. This allows the detection of the start of the hash table and
also allows the table's byte order to be determined so the table can be
correctly extracted. The "magic" value is followed by a 16 bit version number
which allows the table to be revised and modified in the future. The current
version number is 1. "hash_function" is a uint16_t enumeration that specifies
which hash function was used to produce this table. The current values for the
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
hash function enumerations include:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
enum HashFunctionType
{
eHashFunctionDJB = 0u, // Daniel J Bernstein hash function
};
</pre>
</div>
<p>"bucket_count" is a 32 bit unsigned integer that represents how many buckets
are in the BUCKETS array. "hashes_count" is the number of unique 32 bit hash
values that are in the HASHES array, and is the same number of offsets are
contained in the OFFSETS array. "header_data_len" specifies the size in
bytes of the HeaderData that is filled in by specialized versions of this
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
table.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<h5>Fixed Lookup</h5>
<p>The header is followed by the buckets, hashes, offsets, and hash value
data.
<div class="doc_code">
<pre>
struct FixedTable
{
uint32_t buckets[Header.bucket_count]; // An array of hash indexes into the "hashes[]" array below
uint32_t hashes [Header.hashes_count]; // Every unique 32 bit hash for the entire table is in this table
uint32_t offsets[Header.hashes_count]; // An offset that corresponds to each item in the "hashes[]" array above
};
</pre>
</div>
<p>"buckets" is an array of 32 bit indexes into the "hashes" array. The
"hashes" array contains all of the 32 bit hash values for all names in the
hash table. Each hash in the "hashes" table has an offset in the "offsets"
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
array that points to the data for the hash value.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>This table setup makes it very easy to repurpose these tables to contain
different data, while keeping the lookup mechanism the same for all tables.
This layout also makes it possible to save the table to disk and map it in
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
later and do very efficient name lookups with little or no parsing.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>DWARF lookup tables can be implemented in a variety of ways and can store
a lot of information for each name. We want to make the DWARF tables
extensible and able to store the data efficiently so we have used some of the
DWARF features that enable efficient data storage to define exactly what kind
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
of data we store for each name.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>The "HeaderData" contains a definition of the contents of each HashData
chunk. We might want to store an offset to all of the debug information
entries (DIEs) for each name. To keep things extensible, we create a list of
items, or Atoms, that are contained in the data for each name. First comes the
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
type of the data in each atom:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
enum AtomType
{
eAtomTypeNULL = 0u,
eAtomTypeDIEOffset = 1u, // DIE offset, check form for encoding
eAtomTypeCUOffset = 2u, // DIE offset of the compiler unit header that contains the item in question
eAtomTypeTag = 3u, // DW_TAG_xxx value, should be encoded as DW_FORM_data1 (if no tags exceed 255) or DW_FORM_data2
eAtomTypeNameFlags = 4u, // Flags from enum NameFlags
eAtomTypeTypeFlags = 5u, // Flags from enum TypeFlags
};
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
<p>The enumeration values and their meanings are:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
eAtomTypeNULL - a termination atom that specifies the end of the atom list
eAtomTypeDIEOffset - an offset into the .debug_info section for the DWARF DIE for this name
eAtomTypeCUOffset - an offset into the .debug_info section for the CU that contains the DIE
eAtomTypeDIETag - The DW_TAG_XXX enumeration value so you don't have to parse the DWARF to see what it is
eAtomTypeNameFlags - Flags for functions and global variables (isFunction, isInlined, isExternal...)
eAtomTypeTypeFlags - Flags for types (isCXXClass, isObjCClass, ...)
</pre>
</div>
<p>Then we allow each atom type to define the atom type and how the data for
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
each atom type data is encoded:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
struct Atom
{
uint16_t type; // AtomType enum value
uint16_t form; // DWARF DW_FORM_XXX defines
};
</pre>
</div>
<p>The "form" type above is from the DWARF specification and defines the
exact encoding of the data for the Atom type. See the DWARF specification for
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
the DW_FORM_ definitions.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
struct HeaderData
{
uint32_t die_offset_base;
uint32_t atom_count;
Atoms atoms[atom_count0];
};
</pre>
</div>
<p>"HeaderData" defines the base DIE offset that should be added to any atoms
that are encoded using the DW_FORM_ref1, DW_FORM_ref2, DW_FORM_ref4,
DW_FORM_ref8 or DW_FORM_ref_udata. It also defines what is contained in
each "HashData" object -- Atom.form tells us how large each field will be in
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
the HashData and the Atom.type tells us how this data should be interpreted.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>For the current implementations of the ".apple_names" (all functions + globals),
the ".apple_types" (names of all types that are defined), and the
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
".apple_namespaces" (all namespaces), we currently set the Atom array to be:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
HeaderData.atom_count = 1;
HeaderData.atoms[0].type = eAtomTypeDIEOffset;
HeaderData.atoms[0].form = DW_FORM_data4;
</pre>
</div>
<p>This defines the contents to be the DIE offset (eAtomTypeDIEOffset) that is
encoded as a 32 bit value (DW_FORM_data4). This allows a single name to have
multiple matching DIEs in a single file, which could come up with an inlined
function for instance. Future tables could include more information about the
DIE such as flags indicating if the DIE is a function, method, block,
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
or inlined.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>The KeyType for the DWARF table is a 32 bit string table offset into the
".debug_str" table. The ".debug_str" is the string table for the DWARF which
may already contain copies of all of the strings. This helps make sure, with
help from the compiler, that we reuse the strings between all of the DWARF
sections and keeps the hash table size down. Another benefit to having the
compiler generate all strings as DW_FORM_strp in the debug info, is that
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
DWARF parsing can be made much faster.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>After a lookup is made, we get an offset into the hash data. The hash data
needs to be able to deal with 32 bit hash collisions, so the chunk of data
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
at the offset in the hash data consists of a triple:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
uint32_t str_offset
uint32_t hash_data_count
HashData[hash_data_count]
</pre>
</div>
<p>If "str_offset" is zero, then the bucket contents are done. 99.9% of the
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
hash data chunks contain a single item (no 32 bit hash collision):</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.------------.
| 0x00001023 | uint32_t KeyType (.debug_str[0x0001023] => "main")
| 0x00000004 | uint32_t HashData count
| 0x........ | uint32_t HashData[0] DIE offset
| 0x........ | uint32_t HashData[1] DIE offset
| 0x........ | uint32_t HashData[2] DIE offset
| 0x........ | uint32_t HashData[3] DIE offset
| 0x00000000 | uint32_t KeyType (end of hash chain)
`------------'
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
<p>If there are collisions, you will have multiple valid string offsets:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
.------------.
| 0x00001023 | uint32_t KeyType (.debug_str[0x0001023] => "main")
| 0x00000004 | uint32_t HashData count
| 0x........ | uint32_t HashData[0] DIE offset
| 0x........ | uint32_t HashData[1] DIE offset
| 0x........ | uint32_t HashData[2] DIE offset
| 0x........ | uint32_t HashData[3] DIE offset
| 0x00002023 | uint32_t KeyType (.debug_str[0x0002023] => "print")
| 0x00000002 | uint32_t HashData count
| 0x........ | uint32_t HashData[0] DIE offset
| 0x........ | uint32_t HashData[1] DIE offset
| 0x00000000 | uint32_t KeyType (end of hash chain)
`------------'
</pre>
</div>
<p>Current testing with real world C++ binaries has shown that there is around 1
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
32 bit hash collision per 100,000 name entries.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
</div>
<!-- ======================================================================= -->
<h4>
<a name="acceltablecontents">Contents</a>
</h4>
<!-- ======================================================================= -->
<div>
<p>As we said, we want to strictly define exactly what is included in the
different tables. For DWARF, we have 3 tables: ".apple_names", ".apple_types",
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
and ".apple_namespaces".</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>".apple_names" sections should contain an entry for each DWARF DIE whose
DW_TAG is a DW_TAG_label, DW_TAG_inlined_subroutine, or DW_TAG_subprogram that
has address attributes: DW_AT_low_pc, DW_AT_high_pc, DW_AT_ranges or
DW_AT_entry_pc. It also contains DW_TAG_variable DIEs that have a DW_OP_addr
in the location (global and static variables). All global and static variables
should be included, including those scoped withing functions and classes. For
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
example using the following code:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
static int var = 0;
void f ()
{
static int var = 0;
}
</pre>
</div>
<p>Both of the static "var" variables would be included in the table. All
functions should emit both their full names and their basenames. For C or C++,
the full name is the mangled name (if available) which is usually in the
DW_AT_MIPS_linkage_name attribute, and the DW_AT_name contains the function
basename. If global or static variables have a mangled name in a
DW_AT_MIPS_linkage_name attribute, this should be emitted along with the
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
simple name found in the DW_AT_name attribute.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>".apple_types" sections should contain an entry for each DWARF DIE whose
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
tag is one of:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<ul>
<li>DW_TAG_array_type</li>
<li>DW_TAG_class_type</li>
<li>DW_TAG_enumeration_type</li>
<li>DW_TAG_pointer_type</li>
<li>DW_TAG_reference_type</li>
<li>DW_TAG_string_type</li>
<li>DW_TAG_structure_type</li>
<li>DW_TAG_subroutine_type</li>
<li>DW_TAG_typedef</li>
<li>DW_TAG_union_type</li>
<li>DW_TAG_ptr_to_member_type</li>
<li>DW_TAG_set_type</li>
<li>DW_TAG_subrange_type</li>
<li>DW_TAG_base_type</li>
<li>DW_TAG_const_type</li>
<li>DW_TAG_constant</li>
<li>DW_TAG_file_type</li>
<li>DW_TAG_namelist</li>
<li>DW_TAG_packed_type</li>
<li>DW_TAG_volatile_type</li>
<li>DW_TAG_restrict_type</li>
<li>DW_TAG_interface_type</li>
<li>DW_TAG_unspecified_type</li>
<li>DW_TAG_shared_type</li>
</ul>
<p>Only entries with a DW_AT_name attribute are included, and the entry must
not be a forward declaration (DW_AT_declaration attribute with a non-zero value).
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
For example, using the following code:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
int main ()
{
int *b = 0;
return *b;
}
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
<p>We get a few type DIEs:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<div class="doc_code">
<pre>
0x00000067: TAG_base_type [5]
AT_encoding( DW_ATE_signed )
AT_name( "int" )
AT_byte_size( 0x04 )
0x0000006e: TAG_pointer_type [6]
AT_type( {0x00000067} ( int ) )
AT_byte_size( 0x08 )
</pre>
</div>
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
<p>The DW_TAG_pointer_type is not included because it does not have a DW_AT_name.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>".apple_namespaces" section should contain all DW_TAG_namespace DIEs. If
we run into a namespace that has no name this is an anonymous namespace,
and the name should be output as "(anonymous namespace)" (without the quotes).
Why? This matches the output of the abi::cxa_demangle() that is in the standard
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
C++ library that demangles mangled names.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
</div>
<!-- ======================================================================= -->
<h4>
<a name="acceltableextensions">Language Extensions and File Format Changes</a>
</h4>
<!-- ======================================================================= -->
<div>
<h5>Objective-C Extensions</h5>
<p>".apple_objc" section should contain all DW_TAG_subprogram DIEs for an
Objective-C class. The name used in the hash table is the name of the
Objective-C class itself. If the Objective-C class has a category, then an
entry is made for both the class name without the category, and for the class
name with the category. So if we have a DIE at offset 0x1234 with a name
of method "-[NSString(my_additions) stringWithSpecialString:]", we would add
an entry for "NSString" that points to DIE 0x1234, and an entry for
"NSString(my_additions)" that points to 0x1234. This allows us to quickly
track down all Objective-C methods for an Objective-C class when doing
expressions. It is needed because of the dynamic nature of Objective-C where
anyone can add methods to a class. The DWARF for Objective-C methods is also
emitted differently from C++ classes where the methods are not usually
contained in the class definition, they are scattered about across one or more
compile units. Categories can also be defined in different shared libraries.
So we need to be able to quickly find all of the methods and class functions
given the Objective-C class name, or quickly find all methods and class
functions for a class + category name. This table does not contain any selector
names, it just maps Objective-C class names (or class names + category) to all
of the methods and class functions. The selectors are added as function
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
basenames in the .debug_names section.</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<p>In the ".apple_names" section for Objective-C functions, the full name is the
entire function name with the brackets ("-[NSString stringWithCString:]") and the
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
basename is the selector only ("stringWithCString:").</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<h5>Mach-O Changes</h5>
<p>The sections names for the apple hash tables are for non mach-o files. For
mach-o files, the sections should be contained in the "__DWARF" segment with
Add missing end tags. llvm-svn: 152110
2012-03-06 16:59:13 +08:00
names as follows:</p>
Add the beginnings of documentation for the Name Accelerator Tables. Based on a writeup originally by Greg Clayton. Abuse div and pre tags horribly. Needs a bit more cleanup. llvm-svn: 152093
2012-03-06 10:25:38 +08:00
<ul>
<li>".apple_names" -> "__apple_names"</li>
<li>".apple_types" -> "__apple_types"</li>
<li>".apple_namespaces" -> "__apple_namespac" (16 character limit)</li>
<li> ".apple_objc" -> "__apple_objc"</li>
</ul>
</div>
</div>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<!-- *********************************************************************** -->
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
<hr>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<address>
<a href="http://jigsaw.w3.org/css-validator/check/referer"><img
Global replace of yellow W3C "valid HTML/CSS" icons with blue ones. llvm-svn: 60880
2008-12-12 01:34:48 +08:00
src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<a href="http://validator.w3.org/check/referer"><img
Global replace of yellow W3C "valid HTML/CSS" icons with blue ones. llvm-svn: 60880
2008-12-12 01:34:48 +08:00
src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a>
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
<a href="mailto:sabre@nondot.org">Chris Lattner</a><br>
docs: Canonicalize URLs. llvm-svn: 129181
2011-04-09 10:13:37 +08:00
<a href="http://llvm.org/">LLVM Compiler Infrastructure</a><br>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
Last modified: $Date$
Made file comply with HTML-4.01 (Strict) llvm-svn: 13503
2004-05-13 03:21:57 +08:00
</address>
First version of this document. It is still missing some pretty big pieces, and the debugging information formats will likely change, but it's a start, and I have to move on to other things in the short-term, so it might be a while before I get back to working on this. llvm-svn: 10683
2004-01-05 13:06:33 +08:00
</body>
</html>