1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 2 "http://www.w3.org/TR/html4/strict.dtd"> 3 <html> 4 <head> 5 <title>Documentation for the LLVM System at SVN head</title> 6 <link rel="stylesheet" href="llvm.css" type="text/css"> 7 </head> 8 <body> 9 10 <h1>Documentation for the LLVM System at SVN head</h1> 11 12 <p class="doc_warning">If you are using a released version of LLVM, 13 see <a href="http://llvm.org/releases/">the download page</a> to find 14 your documentation.</p> 15 16 <table class="layout" width="95%"><tr class="layout"><td class="left"> 17 <ul> 18 <li><a href="#llvmdesign">LLVM Design</a></li> 19 <li><a href="/pubs/">LLVM Publications</a></li> 20 <li><a href="#userguide">LLVM User Guides</a></li> 21 <li><a href="#llvmprog">General LLVM Programming Documentation</a></li> 22 <li><a href="#subsystems">LLVM Subsystem Documentation</a></li> 23 <li><a href="#maillist">LLVM Mailing Lists</a></li> 24 </ul> 25 </td><td class="right"> 26 <form action="http://www.google.com/search" method=get> 27 <p> 28 <input type="hidden" name="sitesearch" value="llvm.org/docs"> 29 <input type=text name=q size=25><br> 30 <input type=submit value="Search the LLVM Docs" name="submit"> 31 </p> 32 </form> 33 </td></tr></table> 34 35 <div class="doc_author"> 36 <p>Written by <a href="http://llvm.org/">The LLVM Team</a></p> 37 </div> 38 39 <!--=======================================================================--> 40 <h2><a name="llvmdesign">LLVM Design & Overview</a></h2> 41 <!--=======================================================================--> 42 43 <ul> 44 <li><a href="LangRef.html">LLVM Language Reference Manual</a> - Defines the LLVM 45 intermediate representation.</li> 46 <li><a href="http://llvm.org/pubs/2008-10-04-ACAT-LLVM-Intro.html">Introduction to the LLVM Compiler </a> - Presentation providing a users introduction to LLVM.</li> 47 <li><a href="http://www.aosabook.org/en/llvm.html">Intro to LLVM</a> - book chapter providing a compiler hacker's introduction to LLVM.</li> 48 <li><a href="http://llvm.org/pubs/2004-01-30-CGO-LLVM.html">LLVM: A Compilation Framework for 49 Lifelong Program Analysis & Transformation</a> - Design overview.</li> 50 <li><a href="http://llvm.org/pubs/2002-12-LattnerMSThesis.html">LLVM: An Infrastructure for 51 Multi-Stage Optimization</a> - More details (quite old now).</li> 52 <li><a href="GetElementPtr.html">GetElementPtr FAQ</a> - Answers to some very 53 frequent questions about LLVM's most frequently misunderstood instruction.</li> 54 </ul> 55 56 <!--=======================================================================--> 57 <h2><a name="userguide">LLVM User Guides</a></h2> 58 <!--=======================================================================--> 59 60 <ul> 61 <li><a href="GettingStarted.html">The LLVM Getting Started Guide</a> - 62 Discusses how to get up and running quickly with the LLVM infrastructure. 63 Everything from unpacking and compilation of the distribution to execution of 64 some tools.</li> 65 66 <li><a href="GettingStartedVS.html">Getting Started with the LLVM System using 67 Microsoft Visual Studio</a> - An addendum to the main Getting Started guide for 68 those using Visual Studio on Windows.</li> 69 70 <li><a href="tutorial/">LLVM Tutorial</a> - A walk through the process of using 71 LLVM for a custom language, and the facilities LLVM offers in tutorial form.</li> 72 <li><a href="DeveloperPolicy.html">Developer Policy</a> - The LLVM project's 73 policy towards developers and their contributions.</li> 74 75 <li><a href="CommandGuide/index.html">LLVM Command Guide</a> - A reference 76 manual for the LLVM command line utilities ("man" pages for LLVM tools).<br> 77 Current tools: 78 <a href="/cmds/llvm-ar.html">llvm-ar</a>, 79 <a href="/cmds/llvm-as.html">llvm-as</a>, 80 <a href="/cmds/llvm-dis.html">llvm-dis</a>, 81 <a href="/cmds/llvm-extract.html">llvm-extract</a>, 82 <a href="/cmds/llvm-ld.html">llvm-ld</a>, 83 <a href="/cmds/llvm-link.html">llvm-link</a>, 84 <a href="/cmds/llvm-nm.html">llvm-nm</a>, 85 <a href="/cmds/llvm-prof.html">llvm-prof</a>, 86 <a href="/cmds/llvm-ranlib.html">llvm-ranlib</a>, 87 <a href="/cmds/opt.html">opt</a>, 88 <a href="/cmds/llc.html">llc</a>, 89 <a href="/cmds/lli.html">lli</a>, 90 <a href="/cmds/llvmc.html">llvmc</a> 91 <a href="/cmds/llvmgcc.html">llvm-gcc</a>, 92 <a href="/cmds/llvmgxx.html">llvm-g++</a>, 93 <a href="/cmds/bugpoint.html">bugpoint</a>, 94 <a href="/cmds/llvm-bcanalyzer.html">llvm-bcanalyzer</a>, 95 </li> 96 97 <li><a href="Passes.html">LLVM's Analysis and Transform Passes</a> - A list of 98 optimizations and analyses implemented in LLVM.</li> 99 100 <li><a href="FAQ.html">Frequently Asked Questions</a> - A list of common 101 questions and problems and their solutions.</li> 102 103 <li><a href="ReleaseNotes.html">Release notes for the current release</a> 104 - This describes new features, known bugs, and other limitations.</li> 105 106 <li><a href="HowToSubmitABug.html">How to Submit A Bug Report</a> - 107 Instructions for properly submitting information about any bugs you run into in 108 the LLVM system.</li> 109 110 <li><a href="TestingGuide.html">LLVM Testing Infrastructure Guide</a> - A reference 111 manual for using the LLVM testing infrastructure.</li> 112 113 <li><a href="GCCFEBuildInstrs.html">How to build the Ada/C/C++/Fortran front-ends</a> - 114 Instructions for building gcc front-ends from source.</li> 115 116 <li><a href="Packaging.html">Packaging guide</a> - Advice on packaging 117 LLVM into a distribution.</li> 118 119 <li><a href="Lexicon.html">The LLVM Lexicon</a> - Definition of acronyms, terms 120 and concepts used in LLVM.</li> 121 122 <li><a name="irc">You can probably find help on the unofficial LLVM IRC 123 channel</a>. We often are on irc.oftc.net in the #llvm channel. If you are 124 using the mozilla browser, and have chatzilla installed, you can <a 125 href="irc://irc.oftc.net/llvm">join #llvm on irc.oftc.net</a> directly.</li> 126 127 </ul> 128 129 130 <!--=======================================================================--> 131 <h2><a name="llvmprog">General LLVM Programming Documentation</a></h2> 132 <!--=======================================================================--> 133 134 <ul> 135 <li><a href="LangRef.html">LLVM Language Reference Manual</a> - Defines the LLVM 136 intermediate representation and the assembly form of the different nodes.</li> 137 138 <li><a href="ProgrammersManual.html">The LLVM Programmers Manual</a> - 139 Introduction to the general layout of the LLVM sourcebase, important classes 140 and APIs, and some tips & tricks.</li> 141 142 <li><a href="Projects.html">LLVM Project Guide</a> - How-to guide and 143 templates for new projects that <em>use</em> the LLVM infrastructure. The 144 templates (directory organization, Makefiles, and test tree) allow the project 145 code to be located outside (or inside) the <tt>llvm/</tt> tree, while using LLVM 146 header files and libraries.</li> 147 148 <li><a href="MakefileGuide.html">LLVM Makefile Guide</a> - Describes how the 149 LLVM makefiles work and how to use them.</li> 150 151 <li><a href="CommandLine.html">CommandLine library Reference Manual</a> - 152 Provides information on using the command line parsing library.</li> 153 154 <li><a href="CodingStandards.html">LLVM Coding standards</a> - 155 Details the LLVM coding standards and provides useful information on writing 156 efficient C++ code.</li> 157 158 <li><a href="ExtendingLLVM.html">Extending LLVM</a> - Look here to see how 159 to add instructions and intrinsics to LLVM.</li> 160 161 <li><a href="UsingLibraries.html">Using LLVM Libraries</a> - Look here to 162 understand how to use the libraries produced when LLVM is compiled.</li> 163 164 <li><a href="HowToReleaseLLVM.html">How To Release LLVM To The Public</a> - This 165 is a guide to preparing LLVM releases. Most developers can ignore it.</li> 166 167 168 <li><a href="http://llvm.org/doxygen/">Doxygen generated 169 documentation</a> (<a 170 href="http://llvm.org/doxygen/inherits.html">classes</a>) 171 172 (<a href="http://llvm.org/doxygen/doxygen.tar.gz">tarball</a>) 173 </li> 174 175 <li><a href="http://llvm.org/viewvc/">ViewVC Repository Browser</a></li> 176 177 </ul> 178 179 <!--=======================================================================--> 180 <h2><a name="subsystems">LLVM Subsystem Documentation</a></h2> 181 <!--=======================================================================--> 182 183 <ul> 184 185 <li><a href="WritingAnLLVMPass.html">Writing an LLVM Pass</a> - Information 186 on how to write LLVM transformations and analyses.</li> 187 188 <li><a href="WritingAnLLVMBackend.html">Writing an LLVM Backend</a> - Information 189 on how to write LLVM backends for machine targets.</li> 190 191 <li><a href="CodeGenerator.html">The LLVM Target-Independent Code 192 Generator</a> - The design and implementation of the LLVM code generator. 193 Useful if you are working on retargetting LLVM to a new architecture, designing 194 a new codegen pass, or enhancing existing components.</li> 195 196 <li><a href="TableGenFundamentals.html">TableGen Fundamentals</a> - 197 Describes the TableGen tool, which is used heavily by the LLVM code 198 generator.</li> 199 200 <li><a href="AliasAnalysis.html">Alias Analysis in LLVM</a> - Information 201 on how to write a new alias analysis implementation or how to use existing 202 analyses.</li> 203 204 <li><a href="GarbageCollection.html">Accurate Garbage Collection with 205 LLVM</a> - The interfaces source-language compilers should use for compiling 206 GC'd programs.</li> 207 208 <li><a href="SourceLevelDebugging.html">Source Level Debugging with 209 LLVM</a> - This document describes the design and philosophy behind the LLVM 210 source-level debugger.</li> 211 212 <li><a href="ExceptionHandling.html">Zero Cost Exception handling in LLVM</a> 213 - This document describes the design and implementation of exception handling 214 in LLVM.</li> 215 216 <li><a href="Bugpoint.html">Bugpoint</a> - automatic bug finder and test-case 217 reducer description and usage information.</li> 218 219 <li><a href="CompilerDriverTutorial.html">Compiler Driver (llvmc) Tutorial</a> 220 - This document is a tutorial introduction to the usage and 221 configuration of the LLVM compiler driver tool, <tt>llvmc</tt>.</li> 222 223 <li><a href="CompilerDriver.html">Compiler Driver (llvmc) 224 Reference</a> - This document describes the design and configuration 225 of <tt>llvmc</tt> in more detail.</li> 226 227 <li><a href="BitCodeFormat.html">LLVM Bitcode File Format</a> - This describes 228 the file format and encoding used for LLVM "bc" files.</li> 229 230 <li><a href="SystemLibrary.html">System Library</a> - This document describes 231 the LLVM System Library (<tt>lib/System</tt>) and how to keep LLVM source code 232 portable</li> 233 234 <li><a href="LinkTimeOptimization.html">Link Time Optimization</a> - This 235 document describes the interface between LLVM intermodular optimizer and 236 the linker and its design</li> 237 238 <li><a href="GoldPlugin.html">The LLVM gold plugin</a> - How to build your 239 programs with link-time optimization on Linux.</li> 240 241 <li><a href="DebuggingJITedCode.html">The GDB JIT interface</a> - How to debug 242 JITed code with GDB.</li> 243 244 <li><a href="BranchWeightMetadata.html">Branch Weight Metadata</a> - Provides 245 information about Branch Prediction Information.</li> 246 247 </ul> 248 249 250 <!--=======================================================================--> 251 <h2><a name="maillist">LLVM Mailing Lists</a></h2> 252 <!--=======================================================================--> 253 254 <ul> 255 <li>The <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvm-announce"> 256 LLVM Announcements List</a>: This is a low volume list that provides important 257 announcements regarding LLVM. It gets email about once a month.</li> 258 259 <li>The <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">Developer's 260 List</a>: This list is for people who want to be included in technical 261 discussions of LLVM. People post to this list when they have questions about 262 writing code for or using the LLVM tools. It is relatively low volume.</li> 263 264 <li>The <a href="http://lists.cs.uiuc.edu/pipermail/llvmbugs/">Bugs & 265 Patches Archive</a>: This list gets emailed every time a bug is opened and 266 closed, and when people submit patches to be included in LLVM. It is higher 267 volume than the LLVMdev list.</li> 268 269 <li>The <a href="http://lists.cs.uiuc.edu/pipermail/llvm-commits/">Commits 270 Archive</a>: This list contains all commit messages that are made when LLVM 271 developers commit code changes to the repository. It is useful for those who 272 want to stay on the bleeding edge of LLVM development. This list is very high 273 volume.</li> 274 275 <li>The <a href="http://lists.cs.uiuc.edu/pipermail/llvm-testresults/"> 276 Test Results Archive</a>: A message is automatically sent to this list by every 277 active nightly tester when it completes. As such, this list gets email several 278 times each day, making it a high volume list.</li> 279 280 </ul> 281 282 <!-- *********************************************************************** --> 283 284 <hr> 285 <address> 286 <a href="http://jigsaw.w3.org/css-validator/check/referer"><img 287 src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a> 288 <a href="http://validator.w3.org/check/referer"><img 289 src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a> 290 291 <a href="http://llvm.org/">LLVM Compiler Infrastructure</a><br> 292 Last modified: $Date$ 293 </address> 294 </body></html> 295 296