Home | History | Annotate | Download | only in docs
      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 &amp; 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 &amp; 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 &amp; 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 &amp;
    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