Reid Spencer | cbadf80 | 2004-11-01 09:21:32 +0000 | [diff] [blame] | 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 2 | <html> |
| 3 | <head> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 4 | <title>Using The LLVM Libraries</title> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 5 | <link rel="stylesheet" href="llvm.css" type="text/css"> |
| 6 | </head> |
| 7 | <body> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 8 | <div class="doc_title">Using The LLVM Libraries</div> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 9 | <ol> |
| 10 | <li><a href="#abstract">Abstract</a></li> |
| 11 | <li><a href="#introduction">Introduction</a></li> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 12 | <li><a href="#descriptions">Library Descriptions</a></li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 13 | <li><a href="#dependencies">Library Dependencies</a></li> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 14 | <li><a href="#rot">Linkage Rules Of Thumb</a> |
| 15 | <ol> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 16 | <li><a href="#always">Always link LLVMCore, LLVMSupport, LLVMSystem</a> |
| 17 | <li><a href="#onlyone">Never link both archive and re-linked</a> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 18 | </ol> |
| 19 | </li> |
| 20 | </ol> |
Chris Lattner | 7911ce2 | 2004-05-23 21:07:27 +0000 | [diff] [blame] | 21 | |
| 22 | <div class="doc_author"> |
| 23 | <p>Written by <a href="mailto:rspencer@x10sys.com">Reid Spencer</a></p> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 24 | </div> |
Chris Lattner | 7911ce2 | 2004-05-23 21:07:27 +0000 | [diff] [blame] | 25 | |
Tanya Lattner | 2b87362 | 2006-04-20 04:57:19 +0000 | [diff] [blame] | 26 | <p class="doc_warning">Warning: This document is out of date, please see <a href="CommandGuide/html/llvm-config.html">llvm-config</a> for more information.</p> |
Tanya Lattner | d006d3a | 2006-04-20 04:55:50 +0000 | [diff] [blame] | 27 | |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 28 | <!-- ======================================================================= --> |
| 29 | <div class="doc_section"><a name="abstract">Abstract</a></div> |
| 30 | <div class="doc_text"> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 31 | <p>Amongst other things, LLVM is a toolkit for building compilers, linkers, |
| 32 | runtime executives, virtual machines, and other program execution related |
| 33 | tools. In addition to the LLVM tool set, the functionality of LLVM is |
| 34 | available through a set of libraries. To use LLVM as a toolkit for |
| 35 | constructing tools, a developer needs to understand what is contained in the |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 36 | various libraries, what they depend on, and how to use them. Fortunately, |
| 37 | there is a tool, <tt>llvm-config</tt> to aid with this. This document |
| 38 | describes the contents of the libraries and how to use <tt>llvm-config</tt> |
| 39 | to generate command line options. |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 40 | </p> |
| 41 | </div> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 42 | |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 43 | <!-- ======================================================================= --> |
| 44 | <div class="doc_section"> <a name="introduction">Introduction</a></div> |
| 45 | <div class="doc_text"> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 46 | <p>If you're writing a compiler, virtual machine, or any other utility based |
| 47 | on LLVM, you'll need to figure out which of the many libraries files you will |
| 48 | need to link with to be successful. An understanding of the contents of these |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 49 | libraries will be useful in coming up with an optimal specification for the |
| 50 | libraries to link with. The purpose of this document is to reduce some of |
| 51 | the trial and error that the author experienced in using LLVM.</p> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 52 | <p>LLVM produces two types of libraries: archives (ending in <tt>.a</tt>) and |
| 53 | objects (ending in <tt>.o</tt>). However, both are libraries. Libraries ending |
| 54 | in <tt>.o</tt> are known as re-linked libraries because they contain all the |
| 55 | compilation units of the library linked together as a single <tt>.o</tt> file. |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 56 | Furthermore, several of the libraries have <em>both</em> forms of library. The |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 57 | re-linked libraries are used whenever you want to include all symbols from the |
| 58 | library. The archive libraries are used whenever you want to only resolve |
| 59 | outstanding symbols at that point in the link without including everything in |
| 60 | the library. </p> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 61 | <p>If you're using the LLVM Makefile system to link your tools,you will use |
| 62 | the <tt>LLVMLIBS</tt> make variable. |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 63 | (see the <a href="MakefileGuide.html#LLVMLIBS">Makefile Guide</a> for |
| 64 | details). This variable specifies which LLVM libraries to link into your tool |
| 65 | and the order in which they will be linked. You specify re-linked libraries by |
| 66 | naming the library without a suffix. You specify archive libraries by naming |
| 67 | the library with a <tt>.a</tt> suffix but without the <tt>lib</tt> prefix. The |
| 68 | order in which the libraries appear in the <tt>LLVMLIBS</tt> variable |
| 69 | definition is the order in which they will be linked. Getting this order |
| 70 | correct for your tool can sometimes be challenging. |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 71 | </div> |
| 72 | <!-- ======================================================================= --> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 73 | <div class="doc_section"><a name="descriptions"></a>Library Descriptions</div> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 74 | <div class="doc_text"> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 75 | <p>The table below categorizes each library |
| 76 | <table style="text-align:left"> |
| 77 | <tr><th>Library</th><th>Forms</th><th>Description</th></tr> |
Reid Spencer | 0a4e8b3 | 2004-11-01 09:22:49 +0000 | [diff] [blame] | 78 | <tr><th colspan="3">Core Libraries</th></tr> |
Reid Spencer | 139e166 | 2004-12-31 00:13:14 +0000 | [diff] [blame] | 79 | <tr><td>LLVMArchive</td><td><tt>.a</tt></td> |
| 80 | <td>LLVM archive reading and writing</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 81 | <tr><td>LLVMAsmParser</td><td><tt>.a</tt></td> |
Reid Spencer | 139e166 | 2004-12-31 00:13:14 +0000 | [diff] [blame] | 82 | <td>LLVM assembly parsing</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 83 | <tr><td>LLVMBCReader</td><td><tt>.a</tt></td> |
Reid Spencer | 139e166 | 2004-12-31 00:13:14 +0000 | [diff] [blame] | 84 | <td>LLVM bytecode reading</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 85 | <tr><td>LLVMBCWriter</td><td><tt>.a</tt></td> |
Reid Spencer | 139e166 | 2004-12-31 00:13:14 +0000 | [diff] [blame] | 86 | <td>LLVM bytecode writing</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 87 | <tr><td>LLVMCore</td><td><tt>.a</tt></td> |
Reid Spencer | 139e166 | 2004-12-31 00:13:14 +0000 | [diff] [blame] | 88 | <td>LLVM core intermediate representation</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 89 | <tr><td>LLVMDebugger</td><td><tt>.a</tt></td> |
Reid Spencer | 139e166 | 2004-12-31 00:13:14 +0000 | [diff] [blame] | 90 | <td>Source level debugging support</td></tr> |
| 91 | <tr><td>LLVMLinker</td><td><tt>.a</tt></td> |
| 92 | <td>Bytecode and archive linking interface</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 93 | <tr><td>LLVMSupport</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 94 | <td>General support utilities</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 95 | <tr><td>LLVMSystem</td><td><tt>.a</tt></td> |
Reid Spencer | 139e166 | 2004-12-31 00:13:14 +0000 | [diff] [blame] | 96 | <td>Operating system abstraction layer</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 97 | <tr><td>LLVMbzip2</td><td><tt>.a</tt></td> |
| 98 | <td>BZip2 compression library</td></tr> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 99 | |
Reid Spencer | 0a4e8b3 | 2004-11-01 09:22:49 +0000 | [diff] [blame] | 100 | <tr><th colspan="3">Analysis Libraries</th></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 101 | <tr><td>LLVMAnalysis</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 102 | <td>Various analysis passes.</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 103 | <tr><td>LLVMDataStructure</td><td><tt>.o</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 104 | <td>Data structure analysis passes.</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 105 | <tr><td>LLVMipa</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 106 | <td>Inter-procedural analysis passes.</td></tr> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 107 | |
Reid Spencer | 0a4e8b3 | 2004-11-01 09:22:49 +0000 | [diff] [blame] | 108 | <tr><th colspan="3">Transformation Libraries</th></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 109 | <tr><td>LLVMInstrumentation</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 110 | <td>Instrumentation passes.</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 111 | <tr><td>LLVMipo</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 112 | <td>All inter-procedural optimization passes.</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 113 | <tr><td>LLVMScalarOpts</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 114 | <td>All scalar optimization passes.</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 115 | <tr><td>LLVMTransforms</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 116 | <td>Uncategorized transformation passes.</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 117 | <tr><td>LLVMTransformUtils</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 118 | <td>Transformation utilities.</td></tr> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 119 | |
Reid Spencer | 0a4e8b3 | 2004-11-01 09:22:49 +0000 | [diff] [blame] | 120 | <tr><th colspan="3">Code Generation Libraries </th></tr> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 121 | <tr><td>LLVMCodeGen</td><td><tt>.o</tt></td> |
| 122 | <td>Native code generation infrastructure</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 123 | <tr><td>LLVMSelectionDAG</td><td><tt>.o</tt></td> |
| 124 | <td>Aggressive instruction selector for directed acyclic graphs</td></tr> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 125 | |
Reid Spencer | 0a4e8b3 | 2004-11-01 09:22:49 +0000 | [diff] [blame] | 126 | <tr><th colspan="3">Target Libraries</th></tr> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 127 | <tr><td>LLVMAlpha</td><td><tt>.o</tt></td> |
| 128 | <td>Code generation for Alpha architecture</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 129 | <tr><td>LLVMARM</td><td><tt>.o</tt></td> |
| 130 | <td>Code generation for ARM architecture</td></tr> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 131 | <tr><td>LLVMCBackend</td><td><tt>.o</tt></td> |
| 132 | <td>'C' language code generator.</td></tr> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 133 | <tr><td>LLVMIA64</td><td><tt>.o</tt></td> |
| 134 | <td>Code generation for IA64 architecture</td></tr> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 135 | <tr><td>LLVMPowerPC</td><td><tt>.o</tt></td> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 136 | <td>Code generation for PowerPC architecture</td></tr> |
Chris Lattner | 029e844 | 2006-02-05 06:40:12 +0000 | [diff] [blame] | 137 | <tr><td>LLVMSparc</td><td><tt>.o</tt></td> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 138 | <td>Code generation for Sparc architecture</td></tr> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 139 | <tr><td>LLVMTarget</td><td><tt>.a</tt></td> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 140 | <td>Generic code generation utilities.</td></tr> |
| 141 | <tr><td>LLVMX86</td><td><tt>.o</tt></td> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 142 | <td>Code generation for Intel x86 architecture</td></tr> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 143 | |
Reid Spencer | 0a4e8b3 | 2004-11-01 09:22:49 +0000 | [diff] [blame] | 144 | <tr><th colspan="3">Runtime Libraries</th></tr> |
Reid Spencer | 4148266 | 2004-10-31 23:24:31 +0000 | [diff] [blame] | 145 | <tr><td>LLVMInterpreter</td><td><tt>.o</tt></td> |
| 146 | <td>Bytecode Interpreter</td></tr> |
| 147 | <tr><td>LLVMJIT</td><td><tt>.o</tt></td> |
| 148 | <td>Bytecode JIT Compiler</td></tr> |
| 149 | <tr><td>LLVMExecutionEngine</td><td><tt>.o</tt></td> |
| 150 | <td>Virtual machine engine</td></tr> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 151 | </table> |
| 152 | </div> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 153 | |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 154 | <!-- ======================================================================= --> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 155 | <div class="doc_section"><a name="dependencies"></a>Using llvm-config</div> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 156 | <div class="doc_text"> |
Reid Spencer | 704e81f | 2006-08-01 16:23:54 +0000 | [diff] [blame^] | 157 | <p>The <tt>llvm-config</tt> tool is a perl script that produces on its output |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 158 | various kinds of information. For example, the source or object directories |
| 159 | used to build LLVM can be accessed by passing options to <tt>llvm-config</tt>. |
| 160 | For complete details on this tool, please see the |
| 161 | <a href="CommandGuide/html/llvm-config.html">manual page</a>.</p> |
| 162 | <p>To understand the relationships between libraries, the <tt>llvm-config</tt> |
| 163 | can be very useful. If all you know is that you want certain libraries to |
| 164 | be available, you can generate the complete set of libraries to link with |
| 165 | using one of four options, as below:</p> |
| 166 | <ol> |
| 167 | <li><tt>--ldflags</tt>. This generates the command line options necessary to |
| 168 | be passed to the <tt>ld</tt> tool in order to link with LLVM. Most notably, |
| 169 | the <tt>-L</tt> option is provided to specify a library search directory |
Reid Spencer | 704e81f | 2006-08-01 16:23:54 +0000 | [diff] [blame^] | 170 | that contains the LLVM libraries.</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 171 | <li><tt>--libs</tt>. This generates command line options suitable for |
| 172 | use with a gcc-style linker. That is, libraries are given with a -l option |
| 173 | and object files are given with a full path.</li> |
| 174 | <li><tt>--libnames</tt>. This generates a list of just the library file |
| 175 | names. If you know the directory in which these files reside (see --ldflags) |
| 176 | then you can find the libraries there.</li> |
Reid Spencer | 704e81f | 2006-08-01 16:23:54 +0000 | [diff] [blame^] | 177 | <li><tt>--libfiles</tt>. This generates the full path names of the |
| 178 | LLVM library files.</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 179 | </ol> |
| 180 | <p>If you wish to delve further into how <tt>llvm-config</tt> generates the |
| 181 | correct order (based on library dependencies), please see the tool named |
| 182 | <tt>GenLibDeps.pl</tt> in the <tt>utils</tt> source directory of LLVM.</p> |
| 183 | |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 184 | <!-- =======NOTE: =========================================================--> |
Reid Spencer | 43ff900 | 2005-01-03 05:46:46 +0000 | [diff] [blame] | 185 | <!-- === The following graphs and <dl> list are generated automatically ===--> |
| 186 | <!-- === by the util named GenLibDeps.pl in the llvm/utils directory. ===--> |
| 187 | <!-- === This should be updated whenever new libraries are added, ===--> |
| 188 | <!-- === removed, or changed ===--> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 189 | <!-- =======NOTE: =========================================================--> |
Reid Spencer | 43ff900 | 2005-01-03 05:46:46 +0000 | [diff] [blame] | 190 | <h2>Dependency Relationships Of Libraries</h2> |
| 191 | <p>This graph shows the dependency of archive libraries on other archive |
| 192 | libraries or objects. Where a library has both archive and object forms, only |
| 193 | the archive form is shown.</p> |
| 194 | <img src="img/libdeps.gif" alt="Library Dependencies"/> |
| 195 | <h2>Dependency Relationships Of Object Files</h2> |
| 196 | <p>This graph shows the dependency of object files on archive libraries or |
| 197 | other objects. Where a library has both object and archive forms, only the |
| 198 | dependency to the archive form is shown.</p> |
| 199 | <img src="img/objdeps.gif" alt="Object File Dependencies"/> |
| 200 | <p>The following list shows the dependency relationships between libraries in |
| 201 | textual form. The information is the same as shown on the graphs but arranged |
| 202 | alphabetically.</p> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 203 | <dl> |
| 204 | <dt><b>libLLVMAnalysis.a</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 205 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 206 | <li>libLLVMSupport.a</li> |
| 207 | <li>libLLVMSystem.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 208 | <li>libLLVMTarget.a</li> |
| 209 | </ul></dd> |
| 210 | <dt><b>libLLVMArchive.a</b</dt><dd><ul> |
| 211 | <li>libLLVMBCReader.a</li> |
| 212 | <li>libLLVMCore.a</li> |
| 213 | <li>libLLVMSupport.a</li> |
| 214 | <li>libLLVMSystem.a</li> |
| 215 | </ul></dd> |
| 216 | <dt><b>libLLVMAsmParser.a</b</dt><dd><ul> |
| 217 | <li>libLLVMCore.a</li> |
| 218 | <li>libLLVMSupport.a</li> |
| 219 | <li>libLLVMSystem.a</li> |
| 220 | </ul></dd> |
| 221 | <dt><b>libLLVMBCReader.a</b</dt><dd><ul> |
| 222 | <li>libLLVMCore.a</li> |
| 223 | <li>libLLVMSupport.a</li> |
| 224 | <li>libLLVMSystem.a</li> |
| 225 | </ul></dd> |
| 226 | <dt><b>libLLVMBCWriter.a</b</dt><dd><ul> |
| 227 | <li>libLLVMCore.a</li> |
| 228 | <li>libLLVMSupport.a</li> |
| 229 | <li>libLLVMSystem.a</li> |
| 230 | </ul></dd> |
| 231 | <dt><b>libLLVMCodeGen.a</b</dt><dd><ul> |
| 232 | <li>libLLVMAnalysis.a</li> |
| 233 | <li>libLLVMCore.a</li> |
| 234 | <li>libLLVMSupport.a</li> |
| 235 | <li>libLLVMSystem.a</li> |
| 236 | <li>libLLVMTarget.a</li> |
| 237 | </ul></dd> |
| 238 | <dt><b>libLLVMCore.a</b</dt><dd><ul> |
| 239 | <li>libLLVMSupport.a</li> |
| 240 | <li>libLLVMSystem.a</li> |
| 241 | </ul></dd> |
| 242 | <dt><b>libLLVMDebugger.a</b</dt><dd><ul> |
| 243 | <li>libLLVMBCReader.a</li> |
| 244 | <li>libLLVMCore.a</li> |
| 245 | <li>libLLVMSupport.a</li> |
| 246 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 247 | </ul></dd> |
| 248 | <dt><b>libLLVMInstrumentation.a</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 249 | <li>libLLVMCore.a</li> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 250 | <li>libLLVMScalarOpts.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 251 | <li>libLLVMSupport.a</li> |
| 252 | <li>libLLVMTransformUtils.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 253 | </ul></dd> |
| 254 | <dt><b>libLLVMLinker.a</b</dt><dd><ul> |
| 255 | <li>libLLVMArchive.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 256 | <li>libLLVMBCReader.a</li> |
| 257 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 258 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 259 | </ul></dd> |
| 260 | <dt><b>libLLVMScalarOpts.a</b</dt><dd><ul> |
| 261 | <li>libLLVMAnalysis.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 262 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 263 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 264 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 265 | <li>libLLVMTarget.a</li> |
| 266 | <li>libLLVMTransformUtils.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 267 | </ul></dd> |
| 268 | <dt><b>libLLVMSelectionDAG.a</b</dt><dd><ul> |
| 269 | <li>libLLVMCodeGen.a</li> |
| 270 | <li>libLLVMCore.a</li> |
| 271 | <li>libLLVMSupport.a</li> |
| 272 | <li>libLLVMSystem.a</li> |
| 273 | <li>libLLVMTarget.a</li> |
| 274 | <li>libLLVMTransformUtils.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 275 | </ul></dd> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 276 | <dt><b>libLLVMSupport.a</b</dt><dd><ul> |
| 277 | <li>libLLVMSystem.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 278 | <li>libLLVMbzip2.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 279 | </ul></dd> |
Reid Spencer | 704e81f | 2006-08-01 16:23:54 +0000 | [diff] [blame^] | 280 | <dt><b>libLLVMSystem.a</b</dt><dd></dd> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 281 | <dt><b>libLLVMTarget.a</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 282 | <li>libLLVMCodeGen.a</li> |
| 283 | <li>libLLVMCore.a</li> |
| 284 | <li>libLLVMSelectionDAG.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 285 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 286 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 287 | </ul></dd> |
| 288 | <dt><b>libLLVMTransformUtils.a</b</dt><dd><ul> |
| 289 | <li>libLLVMAnalysis.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 290 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 291 | <li>libLLVMScalarOpts.a</li> |
| 292 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 293 | <li>libLLVMSystem.a</li> |
| 294 | <li>libLLVMipa.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 295 | </ul></dd> |
| 296 | <dt><b>libLLVMTransforms.a</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 297 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 298 | <li>libLLVMSupport.a</li> |
| 299 | <li>libLLVMTarget.a</li> |
| 300 | <li>libLLVMTransformUtils.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 301 | </ul></dd> |
Reid Spencer | 704e81f | 2006-08-01 16:23:54 +0000 | [diff] [blame^] | 302 | <dt><b>libLLVMbzip2.a</b</dt><dd></dd> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 303 | <dt><b>libLLVMipa.a</b</dt><dd><ul> |
| 304 | <li>libLLVMAnalysis.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 305 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 306 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 307 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 308 | </ul></dd> |
| 309 | <dt><b>libLLVMipo.a</b</dt><dd><ul> |
| 310 | <li>libLLVMAnalysis.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 311 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 312 | <li>libLLVMSupport.a</li> |
| 313 | <li>libLLVMSystem.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 314 | <li>libLLVMTarget.a</li> |
| 315 | <li>libLLVMTransformUtils.a</li> |
| 316 | <li>libLLVMipa.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 317 | </ul></dd> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 318 | <dt><b>LLVMARM.o</b</dt><dd><ul> |
| 319 | <li>libLLVMCodeGen.a</li> |
| 320 | <li>libLLVMCore.a</li> |
| 321 | <li>libLLVMScalarOpts.a</li> |
| 322 | <li>libLLVMSelectionDAG.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 323 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 324 | <li>libLLVMSystem.a</li> |
| 325 | <li>libLLVMTarget.a</li> |
| 326 | </ul></dd> |
| 327 | <dt><b>LLVMAlpha.o</b</dt><dd><ul> |
| 328 | <li>libLLVMCodeGen.a</li> |
| 329 | <li>libLLVMCore.a</li> |
| 330 | <li>libLLVMScalarOpts.a</li> |
| 331 | <li>libLLVMSelectionDAG.a</li> |
| 332 | <li>libLLVMSupport.a</li> |
| 333 | <li>libLLVMSystem.a</li> |
| 334 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 335 | </ul></dd> |
| 336 | <dt><b>LLVMCBackend.o</b</dt><dd><ul> |
| 337 | <li>libLLVMAnalysis.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 338 | <li>libLLVMCodeGen.a</li> |
| 339 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 340 | <li>libLLVMScalarOpts.a</li> |
| 341 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 342 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 343 | <li>libLLVMTarget.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 344 | <li>libLLVMipa.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 345 | </ul></dd> |
| 346 | <dt><b>LLVMDataStructure.o</b</dt><dd><ul> |
| 347 | <li>libLLVMAnalysis.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 348 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 349 | <li>libLLVMSupport.a</li> |
| 350 | <li>libLLVMSystem.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 351 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 352 | </ul></dd> |
| 353 | <dt><b>LLVMExecutionEngine.o</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 354 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 355 | <li>libLLVMSupport.a</li> |
| 356 | <li>libLLVMSystem.a</li> |
| 357 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 358 | </ul></dd> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 359 | <dt><b>LLVMIA64.o</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 360 | <li>libLLVMCodeGen.a</li> |
| 361 | <li>libLLVMCore.a</li> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 362 | <li>libLLVMScalarOpts.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 363 | <li>libLLVMSelectionDAG.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 364 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 365 | <li>libLLVMSystem.a</li> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 366 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 367 | </ul></dd> |
| 368 | <dt><b>LLVMInterpreter.o</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 369 | <li>LLVMExecutionEngine.o</li> |
| 370 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 371 | <li>libLLVMSupport.a</li> |
| 372 | <li>libLLVMSystem.a</li> |
| 373 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 374 | </ul></dd> |
| 375 | <dt><b>LLVMJIT.o</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 376 | <li>LLVMExecutionEngine.o</li> |
| 377 | <li>libLLVMCodeGen.a</li> |
| 378 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 379 | <li>libLLVMSupport.a</li> |
| 380 | <li>libLLVMSystem.a</li> |
| 381 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 382 | </ul></dd> |
| 383 | <dt><b>LLVMPowerPC.o</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 384 | <li>libLLVMCodeGen.a</li> |
| 385 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 386 | <li>libLLVMScalarOpts.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 387 | <li>libLLVMSelectionDAG.a</li> |
Reid Spencer | d42037a | 2006-05-13 02:22:01 +0000 | [diff] [blame] | 388 | <li>libLLVMSupport.a</li> |
| 389 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 390 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 391 | </ul></dd> |
Chris Lattner | 029e844 | 2006-02-05 06:40:12 +0000 | [diff] [blame] | 392 | <dt><b>LLVMSparc.o</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 393 | <li>libLLVMCodeGen.a</li> |
| 394 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 395 | <li>libLLVMScalarOpts.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 396 | <li>libLLVMSelectionDAG.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 397 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 398 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 399 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 400 | </ul></dd> |
| 401 | <dt><b>LLVMX86.o</b</dt><dd><ul> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 402 | <li>libLLVMCodeGen.a</li> |
| 403 | <li>libLLVMCore.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 404 | <li>libLLVMScalarOpts.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 405 | <li>libLLVMSelectionDAG.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 406 | <li>libLLVMSupport.a</li> |
Reid Spencer | e131ec9 | 2006-08-01 07:32:01 +0000 | [diff] [blame] | 407 | <li>libLLVMSystem.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 408 | <li>libLLVMTarget.a</li> |
Reid Spencer | e0f33ae | 2004-12-30 23:12:04 +0000 | [diff] [blame] | 409 | </ul></dd> |
| 410 | </dl> |
| 411 | </div> |
| 412 | |
| 413 | <!-- ======================================================================= --> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 414 | <div class="doc_section"><a name="rot">Linkage Rules Of Thumb</a></div> |
| 415 | <div class="doc_text"> |
| 416 | <p>This section contains various "rules of thumb" about what files you |
| 417 | should link into your programs.</p> |
| 418 | </div> |
| 419 | <!-- ======================================================================= --> |
Misha Brukman | 6fb5166 | 2004-11-08 00:22:22 +0000 | [diff] [blame] | 420 | <div class="doc_subsection"><a name="always">Always Link LLVMCore, LLVMSupport, |
| 421 | and LLVMSystem</a></div> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 422 | <div class="doc_text"> |
Reid Spencer | 52afa7e | 2004-11-08 00:26:32 +0000 | [diff] [blame] | 423 | <p>No matter what you do with LLVM, the last three entries in the value of |
| 424 | your LLVMLIBS make variable should always be: |
| 425 | <tt>LLVMCore LLVMSupport.a LLVMSystem.a</tt>. There are no <tt>LLVM</tt> |
| 426 | programs that don't depend on these three.</p> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 427 | </div> |
| 428 | <!-- ======================================================================= --> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 429 | <div class="doc_subsection"><a name="onlyone">Never link both archive and |
| 430 | re-linked library</a></div> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 431 | <div class="doc_text"> |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 432 | <p>There is never any point to linking both the re-linked (<tt>.o</tt>) and |
| 433 | the archive (<tt>.a</tt>) versions of a library. Since the re-linked version |
| 434 | includes the entire library, the archive version will not resolve any symbols. |
Reid Spencer | 347e288 | 2004-11-08 00:24:43 +0000 | [diff] [blame] | 435 | You could even end up with link error if you place the archive version before |
Reid Spencer | 341d714 | 2004-10-31 23:00:25 +0000 | [diff] [blame] | 436 | the re-linked version on the linker's command line.</p> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 437 | </div> |
| 438 | <!-- ======================================================================= --> |
| 439 | <hr> |
| 440 | <div class="doc_footer"> |
Reid Spencer | bd72241 | 2004-11-01 09:19:53 +0000 | [diff] [blame] | 441 | <address> |
| 442 | <a href="http://jigsaw.w3.org/css-validator/check/referer"><img |
| 443 | src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"/></a> |
| 444 | <a href="http://validator.w3.org/check/referer"><img |
| 445 | src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!" /></a> |
| 446 | <a href="mailto:rspencer@x10sys.com">Reid Spencer</a> |
| 447 | </address> |
Reid Spencer | 05fe4b0 | 2006-03-14 05:39:39 +0000 | [diff] [blame] | 448 | <a href="http://llvm.org">The LLVM Compiler Infrastructure</a> |
Chris Lattner | 6175735 | 2004-02-27 06:28:34 +0000 | [diff] [blame] | 449 | <br>Last modified: $Date$ </div> |
| 450 | </body> |
| 451 | </html> |
| 452 | <!-- vim: sw=2 ts=2 ai |
| 453 | --> |