2004-10-23 07:57:22 +00:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
|
|
|
<title>LLVM Makefile Guide</title>
|
|
|
|
|
<link rel="stylesheet" href="llvm.css" type="text/css">
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
<div class="doc_title">LLVM Makefile Guide</div>
|
|
|
|
|
|
|
|
|
|
<ol>
|
|
|
|
|
<li><a href="#introduction">Introduction</a></li>
|
|
|
|
|
<li><a href="#general">General Concepts</a>
|
|
|
|
|
<ol>
|
|
|
|
|
<li><a href="#projects">Projects</a></li>
|
2004-10-31 17:51:38 +00:00
|
|
|
<li><a href="#varvals">Variable Values</a></li>
|
2004-10-31 17:56:50 +00:00
|
|
|
<li><a href="#including">Including Makefiles</a>
|
|
|
|
|
<ol>
|
|
|
|
|
<li><a href="#Makefile">Makefile</a></li>
|
|
|
|
|
<li><a href="#Makefile.common">Makefile.common</a></li>
|
|
|
|
|
<li><a href="#Makefile.config">Makefile.config</a></li>
|
|
|
|
|
<li><a href="#Makefile.rules">Makefile.rules</a></li>
|
|
|
|
|
</ol>
|
|
|
|
|
</li>
|
2004-10-23 07:57:22 +00:00
|
|
|
<li><a href="#Comments">Comments</a></li>
|
|
|
|
|
</ol>
|
|
|
|
|
</li>
|
2004-10-31 17:51:38 +00:00
|
|
|
<li><a href="#tutorial">Tutorial</a>
|
|
|
|
|
<ol>
|
|
|
|
|
<li><a href="#libraries">Libraries</a></li>
|
|
|
|
|
<li><a href="#tools">Tools</a></li>
|
|
|
|
|
</ol>
|
|
|
|
|
</li>
|
2004-10-23 07:57:22 +00:00
|
|
|
<li><a href="#targets">Targets Supported</a>
|
|
|
|
|
<ol>
|
|
|
|
|
<li><a href="#all">all</a></li>
|
|
|
|
|
<li><a href="#all-local">all-local</a></li>
|
|
|
|
|
<li><a href="#check">check</a></li>
|
|
|
|
|
<li><a href="#check-local">check-local</a></li>
|
|
|
|
|
<li><a href="#clean">clean</a></li>
|
|
|
|
|
<li><a href="#clean-local">clean-local</a></li>
|
|
|
|
|
<li><a href="#dist">dist</a></li>
|
|
|
|
|
<li><a href="#dist-check">dist-check</a></li>
|
|
|
|
|
<li><a href="#dist-clean">dist-clean</a></li>
|
|
|
|
|
<li><a href="#install">install</a></li>
|
2004-10-31 18:50:34 +00:00
|
|
|
<li><a href="#preconditions">preconditions</a></li>
|
2004-10-24 08:48:59 +00:00
|
|
|
<li><a href="#printvars">printvars</a></li>
|
2004-10-23 07:57:22 +00:00
|
|
|
<li><a href="#tags">tags</a></li>
|
|
|
|
|
<li><a href="#uninstall">uninstall</a></li>
|
|
|
|
|
</ol>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="#variables">Using Variables</a>
|
|
|
|
|
<ol>
|
|
|
|
|
<li><a href="#setvars">Control Variables</a></li>
|
|
|
|
|
<li><a href="#overvars">Override Variables</a></li>
|
|
|
|
|
<li><a href="#getvars">Readable Variables</a></li>
|
2004-10-30 21:39:42 +00:00
|
|
|
<li><a href="#intvars">Internal Variables</a></li>
|
2004-10-23 07:57:22 +00:00
|
|
|
</ol>
|
|
|
|
|
</li>
|
|
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
<div class="doc_author">
|
|
|
|
|
<p>Written by <a href="mailto:reid@x10sys.com">Reid Spencer</a></p>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<div class="doc_section"><a name="introduction">Introduction </a></div>
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>This document provides <em>usage</em> information about the LLVM makefile
|
|
|
|
|
system. While loosely patterned after the BSD makefile system, LLVM has taken
|
2004-10-25 19:28:03 +00:00
|
|
|
a departure from BSD in order to implement additional features needed by LLVM.
|
2004-10-31 17:51:38 +00:00
|
|
|
Although makefile systems such as automake were attempted at one point, it
|
|
|
|
|
has become clear that the features needed by LLVM and the Makefile norm are
|
|
|
|
|
too great to use a more limited tool. Consequently, LLVM requires simply GNU
|
|
|
|
|
Make 3.79, a widely portable makefile processor. LLVM unabashedly makes heavy
|
|
|
|
|
use of the features of GNU Make so the dependency on GNU Make is firm. If
|
|
|
|
|
you're not familiar with <tt>make</tt>, it is recommended that you read the
|
|
|
|
|
<a href="http://www.gnu.org/software/make/manual/make.html">GNU Makefile Manual
|
|
|
|
|
</a>.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
<p>While this document is rightly part of the
|
|
|
|
|
<a href="ProgrammersManual.html">LLVM Programmer's Manual</a>, it is treated
|
|
|
|
|
separately here because of the volume of content and because it is often an
|
|
|
|
|
early source of bewilderment for new developers.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<div class="doc_section"><a name="general">General Concepts</a></div>
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
|
|
|
|
|
<div class="doc_text">
|
2004-10-31 17:51:38 +00:00
|
|
|
<p>The LLVM Makefile System is the component of LLVM that is responsible for
|
|
|
|
|
building the software, testing it, generating distributions, checking those
|
|
|
|
|
distributions, installing and uninstalling, etc. It consists of a several
|
|
|
|
|
files throughout the source tree. These files and other general concepts are
|
|
|
|
|
described in this section.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="projects">Projects</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>The LLVM Makefile System is quite generous. It not only builds its own
|
|
|
|
|
software, but it can build yours too. Built into the system is knowledge of
|
|
|
|
|
the <tt>llvm/projects</tt> directory. Any directory under <tt>projects</tt>
|
|
|
|
|
that has both a <tt>configure</tt> script and a <tt>Makefile</tt> is assumed
|
|
|
|
|
to be a project that uses the LLVM Makefile system. This allows your project
|
|
|
|
|
to get up and running quickly by utilizing the built-in features that are used
|
2004-10-31 17:51:38 +00:00
|
|
|
to compile LLVM. LLVM compiles itself using the same features of the makefile
|
|
|
|
|
system as used for projects.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="varvalues">Variable Values</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>To use the makefile system, you simply create a file named
|
|
|
|
|
<tt>Makefile</tt> in your directory and declare values for certain variables.
|
|
|
|
|
The variables and values that you select determine what the makefile system
|
|
|
|
|
will do. These variables enable rules and processing in the makefile system
|
|
|
|
|
that automatically Do The Right Thing™.
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
2004-10-31 17:51:38 +00:00
|
|
|
<div class="doc_subsection"><a name="including">Including Makefiles</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Setting variables alone is not enough. You must include into your Makefile
|
|
|
|
|
additional files that provide the rules of the LLVM Makefile system. The
|
|
|
|
|
various files involved are described in the sections that follow.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsubsection"><a name="Makefile">Makefile</a></div>
|
2004-10-23 07:57:22 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Each directory to participate in the build needs to have a file named
|
|
|
|
|
<tt>Makefile</tt>. This is the file first read by <tt>make</tt>. It has three
|
|
|
|
|
sections:</p>
|
|
|
|
|
<ol>
|
2004-11-07 22:42:37 +00:00
|
|
|
<li><a href="#setvars">Settable Variables</a> - Required that must be set
|
2004-10-23 07:57:22 +00:00
|
|
|
first.</li>
|
2004-11-07 22:42:37 +00:00
|
|
|
<li><a href="#Makefile.common">include <tt>$(LEVEL)/Makefile.common</tt></a>
|
2004-10-23 07:57:22 +00:00
|
|
|
- include the LLVM Makefile system.
|
2004-11-07 22:42:37 +00:00
|
|
|
<li><a href="#overvars">Override Variables</a> - Override variables set by
|
2004-10-23 07:57:22 +00:00
|
|
|
the LLVM Makefile system.
|
|
|
|
|
</ol>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
2004-10-31 17:51:38 +00:00
|
|
|
<div class="doc_subsubsection"><a name="Makefile.common">Makefile.common</a>
|
|
|
|
|
</div>
|
2004-10-23 07:57:22 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Every project must have a <tt>Makefile.common</tt> file at its top source
|
|
|
|
|
directory. This file serves three purposes:</p>
|
|
|
|
|
<ol>
|
|
|
|
|
<li>It includes the project's configuration makefile to obtain values
|
|
|
|
|
determined by the <tt>configure</tt> script. This is done by including the
|
2004-11-07 22:42:37 +00:00
|
|
|
<a href="#Makefile.config"><tt>$(LEVEL)/Makefile.config</tt></a> file.</li>
|
2004-10-23 07:57:22 +00:00
|
|
|
<li>It specifies any other (static) values that are needed throughout the
|
|
|
|
|
project. Only values that are used in all or a large proportion of the
|
|
|
|
|
project's directories should be placed here.</li>
|
2004-10-31 17:51:38 +00:00
|
|
|
<li>It includes the standard rules for the LLVM Makefile system,
|
2004-11-07 22:42:37 +00:00
|
|
|
<a href="#Makefile.rules"><tt>$(LLVM_SRC_ROOT)/Makefile.rules</tt></a>.
|
2004-10-23 07:57:22 +00:00
|
|
|
This file is the "guts" of the LLVM Makefile system.</li>
|
|
|
|
|
</ol>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
2004-10-31 17:51:38 +00:00
|
|
|
<div class="doc_subsubsection"><a name="Makefile.config">Makefile.config</a>
|
|
|
|
|
</div>
|
2004-10-23 07:57:22 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Every project must have a <tt>Makefile.config</tt> at the top of its
|
|
|
|
|
<em>build</em> directory. This file is <b>generated</b> by the
|
|
|
|
|
<tt>configure</tt> script from the pattern provided by the
|
|
|
|
|
<tt>Makefile.config.in</tt> file located at the top of the project's
|
|
|
|
|
<em>source</em> directory. The contents of this file depend largely on what
|
|
|
|
|
configuration items the project uses, however most projects can get what they
|
|
|
|
|
need by just relying on LLVM's configuration found in
|
|
|
|
|
<tt>$(LLVM_OBJ_ROOT)/Makefile.config</tt>.
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
2004-10-31 17:51:38 +00:00
|
|
|
<div class="doc_subsubsection"><a name="Makefile.rules">Makefile.rules</a></div>
|
2004-10-23 07:57:22 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>This file, located at <tt>$(LLVM_SRC_ROOT)/Makefile.rules</tt> is the heart
|
|
|
|
|
of the LLVM Makefile System. It provides all the logic, dependencies, and
|
|
|
|
|
rules for building the targets supported by the system. What it does largely
|
2004-11-07 22:42:37 +00:00
|
|
|
depends on the values of <tt>make</tt> <a href="#variables">variables</a> that
|
2004-10-23 07:57:22 +00:00
|
|
|
have been set <em>before</em> <tt>Makefile.rules</tt> is included.
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="Comments">Comments</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>User Makefiles need not have comments in them unless the construction is
|
|
|
|
|
unusual or it doesn't strictly follow the rules and patterns of the LLVM
|
|
|
|
|
makefile system. Makefile comments are invoked with the pound (#) character.
|
|
|
|
|
The # character and any text following it, to the end of the line, are ignored
|
|
|
|
|
by <tt>make</tt>.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
2004-10-31 17:51:38 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<div class="doc_section"><a name="tutorial">Tutorial</a></div>
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>This section provides some examples of the different kinds of modules you
|
|
|
|
|
can build with the LLVM makefile system. In general, each directory you
|
|
|
|
|
provide will build a single object although that object may be composed of
|
|
|
|
|
additionally compiled components.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="libraries">Libraries</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Only a few variable definitions are needed to build a regular library.
|
|
|
|
|
Normally, the makefile system will build all the software into a single
|
|
|
|
|
<tt>libname.o</tt> (pre-linked) object. This means the library is not
|
|
|
|
|
searchable and that the distinction between compilation units has been
|
|
|
|
|
dissolved. Optionally, you can ask for a shared library (.so), archive library
|
|
|
|
|
(.a) or to not have the default (relinked) library built. For example:</p>
|
|
|
|
|
<pre><tt>
|
|
|
|
|
LIBRARYNAME = mylib
|
|
|
|
|
SHARED_LIBRARY = 1
|
|
|
|
|
ARCHIVE_LIBRARY = 1
|
|
|
|
|
DONT_BUILT_RELINKED = 1
|
|
|
|
|
</tt></pre>
|
|
|
|
|
<p>says to build a library named "mylib" with both a shared library
|
|
|
|
|
(<tt>mylib.so</tt>) and an archive library (<tt>mylib.a</tt>) version but
|
|
|
|
|
not to build the relinked object (<tt>mylib.o</tt>). The contents of all the
|
|
|
|
|
libraries produced will be the same, they are just constructed differently.
|
|
|
|
|
Note that you normally do not need to specify the sources involved. The LLVM
|
|
|
|
|
Makefile system will infer the source files from the contents of the source
|
|
|
|
|
directory.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="tools">Tools</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>For building executable programs (tools), you must provide the name of the
|
|
|
|
|
tool and the names of the libraries you wish to link with the tool. For
|
|
|
|
|
example:</p>
|
|
|
|
|
<pre><tt>
|
|
|
|
|
TOOLNAME = mytool
|
|
|
|
|
USEDLIBS = mylib
|
|
|
|
|
LLVMLIBS = LLVMSupport.a LLVMSystem.a
|
|
|
|
|
</tt></pre>
|
|
|
|
|
<p>says that we are to build a tool name <tt>mytool</tt> and that it requires
|
|
|
|
|
three libraries: <tt>mylib</tt>, <tt>LLVMSupport.a</tt> and
|
|
|
|
|
<tt>LLVMSystem.a</tt>.</p>
|
|
|
|
|
<p>Note that two different variables are use to indicate which libraries are
|
|
|
|
|
linked: <tt>USEDLIBS</tt> and <tt>LLVMLIBS</tt>. This distinction is necessary
|
|
|
|
|
to support projects. <tt>LLVMLIBS</tt> refers to the LLVM libraries found in
|
|
|
|
|
the LLVM object directory. <tt>USEDLIBS</tt> refers to the libraries built by
|
|
|
|
|
your project. In the case of building LLVM tools, <tt>USEDLIBS</tt> and
|
|
|
|
|
<tt>LLVMLIBS</tt> can be used interchangeably since the "project" is LLVM
|
|
|
|
|
itself and <tt>USEDLIBS</tt> refers to the same place as <tt>LLVMLIBS</tt>.
|
|
|
|
|
</p>
|
|
|
|
|
<p>Also note that there are two different ways of specifying a library: with a
|
|
|
|
|
<tt>.a</tt> suffix and without. Without the suffix, the entry refers to the
|
|
|
|
|
re-linked (.o) file which will include <em>all</em> symbols of the library.
|
|
|
|
|
This is useful, for example, to include all passes from a library of passes.
|
|
|
|
|
If the <tt>.a</tt> suffix is used then the library is linked as a searchable
|
|
|
|
|
library (with the <tt>-l</tt> option). In this case, only the symbols that are
|
|
|
|
|
unresolved <em>at that point</em> will be resolved from the library, if they
|
|
|
|
|
exist. Other (unreferenced) symbols will not be included when the <tt>.a</tt>
|
|
|
|
|
syntax is used. Note that in order to use the <tt>.a</tt> suffix, the library
|
|
|
|
|
in question must have been built with the <tt>ARCHIVE_LIBRARY</tt> option set.
|
|
|
|
|
</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
2004-10-23 07:57:22 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<div class="doc_section"><a name="targets">Targets Supported</a></div>
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>This section describes each of the targets that can be built using the LLVM
|
|
|
|
|
Makefile system. Any target can be invoked from any directory but not all are
|
2004-10-25 19:28:03 +00:00
|
|
|
applicable to a given directory (e.g. "dist" and "install" will always operate
|
2004-10-23 07:57:22 +00:00
|
|
|
as if invoked from the top level directory).</p>
|
|
|
|
|
|
|
|
|
|
<table style="text-align:left">
|
|
|
|
|
<tr><th>Target Name</th><th>Implied Targets</th><th>Target Description</th></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#all"><tt>all</tt></a></td><td></td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Compile the software recursively. Default target.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#all-local"><tt>all-local</tt></a></td><td></td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Compile the software in the local directory only.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#check"><tt>check</tt></a></td><td>all</td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Test the software recursively.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#check-local"><tt>check-local</tt></a></td><td>all-local</td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Test the software in the local directory only.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#clean"><tt>clean</tt></a></td><td></td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Remove built objects recursively.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#clean-local"><tt>clean-local</tt></a></td><td></td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Remove built objects from the local directory only.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#dist"><tt>dist</tt></a></td><td>all</td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Prepare a source distribution tarball.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#dist-check"><tt>dist-check</tt></a></td><td>all check</td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Prepare a source distribution tarball and check that it builds.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#dist-clean"><tt>dist-clean</tt></a></td><td>clean</td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Clean source distribution tarball temporary files.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#install"><tt>install</tt></a></td><td>all</td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Copy built objects to installation directory.
|
|
|
|
|
</td></tr>
|
2004-10-31 18:50:34 +00:00
|
|
|
<tr><td><a href="#preconditions"><tt>preconditions</tt></a></td><td>all</td>
|
|
|
|
|
<td>Check to make sure configuration and makefiles are up to date.
|
|
|
|
|
</td></tr>
|
2004-10-30 21:39:42 +00:00
|
|
|
<tr><td><a href="#printvars"><tt>printvars</tt></a></td><td>all</td>
|
|
|
|
|
<td>Prints variables defined by the makefile system (for debugging).
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#tags"><tt>tags</tt></a></td><td></td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Make C and C++ tags files for emacs and vi.
|
|
|
|
|
</td></tr>
|
2004-10-24 08:48:59 +00:00
|
|
|
<tr><td><a href="#uninstall"><tt>uninstall</tt></a></td><td></td>
|
2004-10-23 07:57:22 +00:00
|
|
|
<td>Remove built objects from installation directory.
|
|
|
|
|
</td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="all">all (default)</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>When you invoke <tt>make</tt> with no arguments, you are implicitly
|
|
|
|
|
instructing it to seek the "all" target (goal). This target is used for
|
2004-10-24 08:48:59 +00:00
|
|
|
building the software recursively and will do different things in different
|
|
|
|
|
directories. For example, in a <tt>lib</tt> directory, the "all" target will
|
|
|
|
|
compile source files and generate libraries. But, in a <tt>tools</tt>
|
|
|
|
|
directory, it will link libraries and generate executables.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="all-local">all-local</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target is the same as <a href="#all">all</a> but it operates only on
|
|
|
|
|
the current directory instead of recursively.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="check">check</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target is used to perform any functional, unit or sanity tests as the
|
|
|
|
|
software is being built. The <tt>check</tt> target depends on the
|
|
|
|
|
<a href="#all"><tt>all</tt></a> target so the software is built in each
|
|
|
|
|
directory first and then the "check" is applied.</p>
|
|
|
|
|
<p>The definition of "check" is pretty general. It depends on the value of the
|
|
|
|
|
<a href="#TESTS"><tt>TESTS</tt></a> variable. This variable should be set to a
|
|
|
|
|
list of executables to run in order to test the software. If they all return
|
|
|
|
|
0 then the check succeeds, otherwise not. The programs run can be anything but
|
|
|
|
|
they should either be local to the directory or in your path.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="check-local">check-local</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target does the same thing as <tt>check</tt> but only for the current
|
|
|
|
|
(local) directory.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="clean">clean</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target cleans the build directory, recursively removing all things
|
|
|
|
|
that the Makefile builds. Despite once or twice attempting to remove /*, the
|
2004-10-25 19:28:03 +00:00
|
|
|
cleaning rules have been made guarded so they shouldn't go awry.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="clean-local">clean-local</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target does the same thing as <tt>clean</tt> but only for the current
|
|
|
|
|
(local) directory.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="dist">dist</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target builds a distribution tarball. It first builds the entire
|
|
|
|
|
project using the <tt>all</tt> target and then tars up the necessary files and
|
|
|
|
|
compresses it. The generated tarball is sufficient for a casual source
|
|
|
|
|
distribution, but probably not for a release (see <tt>dist-check</tt>).</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="dist-check">dist-check</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target does the same thing as the <tt>dist</tt> target but also checks
|
|
|
|
|
the distribution tarball. The check is made by unpacking the tarball to a new
|
|
|
|
|
directory, configuring it, building it, installing it, and then verifying that
|
|
|
|
|
the installation results are correct (by comparing to the original build).
|
|
|
|
|
This target can take a long time to run but should be done before a release
|
|
|
|
|
goes out to make sure that the distributed tarball can actually be built into
|
|
|
|
|
a working release.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="dist-clean">dist-clean</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This is a special form of the <tt>clean</tt> clean target. It performs a
|
|
|
|
|
normal <tt>clean</tt> but also removes things pertaining to building the
|
|
|
|
|
distribution.</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="install">install</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target finalizes shared objects and executables and copies all
|
|
|
|
|
libraries, headers and executables to the directory given with the
|
|
|
|
|
<tt>--prefix</tt> option to <tt>configure</tt>. When completed, the prefix
|
|
|
|
|
directory will have everything needed to <b>use</b> LLVM. </p>
|
|
|
|
|
</div>
|
|
|
|
|
|
2004-10-31 18:50:34 +00:00
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="preconditions">preconditions</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>This utility target checks to see if the <tt>Makefile</tt> in the object
|
|
|
|
|
directory is older than the <tt>Makefile</tt> in the source directory and
|
|
|
|
|
copies it if so. It also reruns the <tt>configure</tt> script if that needs to
|
|
|
|
|
be done and rebuilds the <tt>Makefile.config</tt> file similarly. Users may
|
|
|
|
|
overload this target to ensure that sanity checks are run <em>before</em> any
|
|
|
|
|
building of targets as all the targets depend on <tt>preconditions</tt>.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
2004-10-24 08:48:59 +00:00
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="printvars">printvars</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>This utility target just causes LLVM to print out some of its variables so
|
|
|
|
|
that you can double check how things are set. </p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
2004-10-24 08:48:59 +00:00
|
|
|
|
2004-10-23 07:57:22 +00:00
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="tags">tags</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target will generate a <tt>TAGS</tt> file in the top-level source
|
|
|
|
|
directory. It is meant for use with emacs, XEmacs, or ViM. The TAGS file
|
|
|
|
|
provides an index of symbol definitions so that the editor can jump you to the
|
|
|
|
|
definition quickly. </p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="uninstall">uninstall</a></div>
|
|
|
|
|
<div class="doc_text">
|
2004-10-24 08:48:59 +00:00
|
|
|
<p>This target is the opposite of the <tt>install</tt> target. It removes the
|
|
|
|
|
header, library and executable files from the installation directories. Note
|
2004-10-25 19:28:03 +00:00
|
|
|
that the directories themselves are not removed because it is not guaranteed
|
2004-10-24 08:48:59 +00:00
|
|
|
that LLVM is the only thing installing there (e.g. --prefix=/usr).</p>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<div class="doc_section"><a name="variables">Variables</a></div>
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Variables are used to tell the LLVM Makefile System what to do and to
|
2004-10-30 21:39:42 +00:00
|
|
|
obtain information from it. Variables are also used internally by the LLVM
|
|
|
|
|
Makefile System. Variable names that contain only the upper case alphabetic
|
|
|
|
|
letters and underscore are intended for use by the end user. All other
|
|
|
|
|
variables are internal to the LLVM Makefile System and should not be relied
|
|
|
|
|
upon nor modified. The sections below describe how to use the LLVM Makefile
|
2004-10-23 07:57:22 +00:00
|
|
|
variables.</p>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="setvars">Control Variables</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Variables listed in the table below should be set <em>before</em> the
|
2004-11-07 22:42:37 +00:00
|
|
|
inclusion of <a href="#Makefile.common"><tt>$(LEVEL)/Makefile.common</tt></a>.
|
2004-10-23 07:57:22 +00:00
|
|
|
These variables provide input to the LLVM make system that tell it what to do
|
|
|
|
|
for the current directory.</p>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dl>
|
|
|
|
|
<dt><a name="BUILD_ARCHIVE"><tt>BUILD_ARCHIVE</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, causes an archive (.a) library to be built.</dd>
|
|
|
|
|
<dt><a name="BUILT_SOURCES"><tt>BUILT_SOURCES</tt></a></dt>
|
|
|
|
|
<dd>Specifies a set of source files that are generated from other source
|
|
|
|
|
files. These sources will be built before any other target processing to
|
2004-10-31 17:56:50 +00:00
|
|
|
ensure they are present.</dd>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dt><a name="BYTECODE_LIBRARY"><tt>BYTECODE_LIBRARY</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, causes a bytecode library (.bc) to be built.</dd>
|
|
|
|
|
<dt><a name="CONFIG_FILES"><tt>CONFIG_FILES</tt></a></dt>
|
|
|
|
|
<dd>Specifies a set of configuration files to be installed.</dd>
|
|
|
|
|
<dt><a name="DIRS"><tt>DIRS</tt></a></dt>
|
|
|
|
|
<dd>Specifies a set of directories, usually children of the current
|
|
|
|
|
directory, that should also be made using the same goal. These directories
|
|
|
|
|
will be built serially.</dd>
|
|
|
|
|
<dt><a name="DISABLE_AUTO_DEPENDENCIES"><tt>DISABLE_AUTO_DEPENDENCIES</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, causes the makefiles to <b>not</b> automatically
|
|
|
|
|
generate dependencies when running the compiler. Use of this feature is
|
|
|
|
|
discouraged and it may be removed at a later date.</dd>
|
|
|
|
|
<dt><a name="DONT_BUILD_RELINKED"><tt>DONT_BUILD_RELINKED</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, causes a relinked library (.o) not to be built. By
|
|
|
|
|
default, libraries are built as re-linked since most LLVM libraries are
|
|
|
|
|
needed in their entirety and re-linked libraries will be linked more quickly
|
2004-10-31 17:51:38 +00:00
|
|
|
than equivalent archive libraries.</dd>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dt><a name="ENABLE_OPTIMIZED"><tt>ENABLE_OPTIMIZED</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, causes the build to generate optimized objects,
|
|
|
|
|
libraries and executables. This alters the flags specified to the compilers
|
|
|
|
|
and linkers. Generally debugging won't be a fun experience with an optimized
|
|
|
|
|
build.</dd>
|
|
|
|
|
<dt><a name="ENABLE_PROFILING"><tt>ENABLE_PROFILING</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, causes the build to generate both optimized and
|
|
|
|
|
profiled objects, libraries and executables. This alters the flags specified
|
|
|
|
|
to the compilers and linkers to ensure that profile data can be collected
|
|
|
|
|
from the tools built. Use the <tt>gprof</tt> tool to analyze the output from
|
|
|
|
|
the profiled tools (<tt>gmon.out</tt>).</dd>
|
|
|
|
|
<dt><a name="EXPERIMENTAL_DIRS"><tt>EXPERIMENTAL_DIRS</tt></a></dt>
|
|
|
|
|
<dd>Specify a set of directories that should be built, but if they fail, it
|
|
|
|
|
should not cause the build to fail. Note that this should only be used
|
|
|
|
|
temporarily while code is being written.</dd>
|
|
|
|
|
<dt><a name="EXPORTED_SYMBOL_FILE"><tt>EXPORTED_SYMBOL_FILE</tt></a></dt>
|
|
|
|
|
<dd>Specifies the name of a single file that contains a list of the
|
|
|
|
|
symbols to be exported by the linker. One symbol per line.</dd>
|
|
|
|
|
<dt><a name="EXPORTED_SYMBOL_LIST"><tt>EXPORTED_SYMBOL_LIST</tt></a></dt>
|
|
|
|
|
<dd>Specifies a set of symbols to be exported by the linker.</dd>
|
|
|
|
|
<dt><a name="EXTRA_DIST"><tt>EXTRA_DIST</tt></a></dt>
|
|
|
|
|
<dd>Specifies additional files that should be distributed with LLVM. All
|
|
|
|
|
source files, all built sources, all Makefiles, and most documentation files
|
|
|
|
|
will be automatically distributed. Use this variable to distribute any
|
|
|
|
|
files that are not automatically distributed.</dd>
|
|
|
|
|
<dt><a name="KEEP_SYMBOLS"><tt>KEEP_SYMBOLS</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, specifies that when linking executables the
|
|
|
|
|
makefiles should retain debug symbols in the executable. Normally, symbols
|
|
|
|
|
are stripped from the executable.</dd>
|
2004-10-31 17:58:58 +00:00
|
|
|
<dt><a name="LEVEL"><tt>LEVEL</tt></a><small>(required)</small></dt>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dd>Specify the level of nesting from the top level. This variable must be
|
|
|
|
|
set in each makefile as it is used to find the top level and thus the other
|
|
|
|
|
makefiles.</dd>
|
|
|
|
|
<dt><a name="LIBRARYNAME"><tt>LIBRARYNAME</tt></a></dt>
|
2004-10-31 17:56:50 +00:00
|
|
|
<dd>Specify the name of the library to be built. (Required For
|
|
|
|
|
Libraries)</dd>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dt><a name="LLVMLIBS"><tt>LLVMLIBS</tt></a></dt>
|
|
|
|
|
<dd>Specifies the set of libraries from the LLVM $(ObjDir) that will be
|
|
|
|
|
linked into the tool or library.</dd>
|
|
|
|
|
<dt><a name="OPTIONAL_DIRS"><tt>OPTIONAL_DIRS</tt></a></dt>
|
|
|
|
|
<dd>Specify a set of directories that may be built, if they exist, but its
|
|
|
|
|
not an error for them not to exist.</dd>
|
|
|
|
|
<dt><a name="PARALLEL_DIRS"><tt>PARALLEL_DIRS</tt></a></dt>
|
|
|
|
|
<dd>Specify a set of directories to build recursively and in parallel if
|
|
|
|
|
the -j option was used with <tt>make</tt>.</dd>
|
|
|
|
|
<dt><a name="SHARED_LIBRARY"><tt>SHARED_LIBRARY</tt></a></dt>
|
|
|
|
|
<dd>If set to any value, causes a shared library (.so) to be built in
|
|
|
|
|
addition to any other kinds of libraries. Note that this option will cause
|
|
|
|
|
all source files to be built twice: once with options for position
|
|
|
|
|
independent code and once without. Use it only where you really need a
|
|
|
|
|
shared library.</dd>
|
2004-10-31 17:56:50 +00:00
|
|
|
<dt><a name="SOURCES"><tt>SOURCES</tt><small>(optional)</small></a></dt>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dd>Specifies the list of source files in the current directory to be
|
|
|
|
|
built. Source files of any type may be specified (programs, documentation,
|
|
|
|
|
config files, etc.). If not specified, the makefile system will infer the
|
|
|
|
|
set of source files from the files present in the current directory.</dd>
|
|
|
|
|
<dt><a name="SUFFIXES"><tt>SUFFIXES</tt></a></dt>
|
|
|
|
|
<dd>Specifies a set of filename suffixes that occur in suffix match rules.
|
|
|
|
|
Only set this if your local <tt>Makefile</tt> specifies additional suffix
|
|
|
|
|
match rules.</dd>
|
|
|
|
|
<dt><a name="TARGET"><tt>TARGET</tt></a></dt>
|
|
|
|
|
<dd>Specifies the name of the LLVM code generation target that the
|
|
|
|
|
current directory builds. Setting this variable enables additional rules to
|
|
|
|
|
build <tt>.inc</tt> files from <tt>.td</tt> files. </dd>
|
|
|
|
|
<dt><a name="TOOLNAME"><tt>TOOLNAME</tt></a></dt>
|
|
|
|
|
<dd>Specifies the name of the tool that the current directory should
|
|
|
|
|
build.</dd>
|
2004-11-08 17:32:12 +00:00
|
|
|
<dt><a name="TOOL_VERBOSE"><tt>TOOL_VERBOSE</tt></a></dt>
|
|
|
|
|
<dd>Implies VERBOSE and also tells each tool invoked to be verbose. This is
|
|
|
|
|
handy when you're trying to see the sub-tools invoked by each tool invoked
|
|
|
|
|
by the makefile. For example, this will pass <tt>-v</tt> to the GCC
|
|
|
|
|
compilers which causes it to print out the command lines it uses to invoke
|
|
|
|
|
sub-tools (compiler, assembler, linker).</dd>
|
2004-10-31 17:56:50 +00:00
|
|
|
<dt><a name="USEDLIBS"><tt>USEDLIBS</tt></a></dt>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dd>Specifies the list of project libraries that will be linked into the
|
|
|
|
|
tool or library.</dd>
|
2004-10-31 17:56:50 +00:00
|
|
|
<dt><a name="VERBOSE"><tt>VERBOSE</tt></a></dt>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dd>Tells the Makefile system to produce detailed output of what it is doing
|
|
|
|
|
instead of just summary comments. This will generate a LOT of output.</dd>
|
|
|
|
|
</dl>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
2004-10-31 17:51:38 +00:00
|
|
|
<div class="doc_subsection"><a name="overvars">Override Variables</a></div>
|
2004-10-23 07:57:22 +00:00
|
|
|
<div class="doc_text">
|
2004-10-31 17:51:38 +00:00
|
|
|
<p>Override variables can be used to override the default
|
2004-10-30 21:39:42 +00:00
|
|
|
values provided by the LLVM makefile system. These variables can be set in
|
|
|
|
|
several ways:</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>In the environment (e.g. setenv, export) -- not recommended.</li>
|
|
|
|
|
<li>On the <tt>make</tt> command line -- recommended.</li>
|
|
|
|
|
<li>On the <tt>configure</tt> command line</li>
|
|
|
|
|
<li>In the Makefile (only <em>after</em> the inclusion of <a
|
2004-11-07 22:42:37 +00:00
|
|
|
href="#Makefile.common"><tt>$(LEVEL)/Makefile.common</tt></a>).</li>
|
2004-10-30 21:39:42 +00:00
|
|
|
</ul>
|
|
|
|
|
<p>The overridable variables are given below:</p>
|
|
|
|
|
<dl>
|
|
|
|
|
<dt><a name="AR"><tt>AR</tt></a> <small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>ar</tt> tool.</dd>
|
|
|
|
|
<dt><a name="BISON"><tt>BISON</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>bison</tt> tool.</dd>
|
|
|
|
|
<dt><a name="BUILD_OBJ_DIR"><tt>BUILD_OBJ_DIR</tt></a></dt>
|
|
|
|
|
<dd>The directory into which the products of build rules will be placed.
|
|
|
|
|
This might be the same as
|
|
|
|
|
<a href="#BUILD_SRC_DIR"><tt>BUILD_SRC_DIR</tt></a> but typically is
|
|
|
|
|
not.</dd>
|
|
|
|
|
<dt><a name="BUILD_SRC_DIR"><tt>BUILD_SRC_DIR</tt></a></dt>
|
|
|
|
|
<dd>The directory which contains the source files to be built.</dd>
|
|
|
|
|
<dt><a name="BURG"><tt>BURG</tt></a></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>burg</tt> tool.</dd>
|
|
|
|
|
<dt><a name="BZIP2"><tt>BZIP2</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>The path to the <tt>bzip2</tt> tool.</dd>
|
|
|
|
|
<dt><a name="CC"><tt>CC</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>The path to the 'C' compiler.</dd>
|
|
|
|
|
<dt><a name="CFLAGS"><tt>CFLAGS</tt></a></dt>
|
|
|
|
|
<dd>Additional flags to be passed to the 'C' compiler.</dd>
|
|
|
|
|
<dt><a name="CXX"><tt>CXX</tt></a></dt>
|
|
|
|
|
<dd>Specifies the path to the C++ compiler.</dd>
|
|
|
|
|
<dt><a name="CXXFLAGS"><tt>CXXFLAGS</tt></a></dt>
|
|
|
|
|
<dd>Additional flags to be passed to the C++ compiler.</dd>
|
|
|
|
|
<dt><a name="DATE"><tt>DATE<small>(configured)</small></tt></a></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>date</tt> program or any program that can
|
|
|
|
|
generate the current date and time on its standard output</dd>
|
|
|
|
|
<dt><a name="DOT"><tt>DOT</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>dot</tt> tool or <tt>false</tt> if there
|
|
|
|
|
isn't one.</dd>
|
|
|
|
|
<dt><a name="ECHO"><tt>ECHO</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>echo</tt> tool for printing output.</dd>
|
|
|
|
|
<dt><a name="ETAGS"><tt>ETAGS</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>etags</tt> tool.</dd>
|
|
|
|
|
<dt><a name="ETAGSFLAGS"><tt>ETAGSFLAGS</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Provides flags to be passed to the <tt>etags</tt> tool.</dd>
|
|
|
|
|
<dt><a name="EXEEXT"><tt>EXEEXT</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Provides the extension to be used on executables built by the makefiles.
|
|
|
|
|
The value may be empty on platforms that do not use file extensions for
|
|
|
|
|
executables (e.g. Unix).</dd>
|
|
|
|
|
<dt><a name="FLEX"><tt>FLEX</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>flex</tt> tool.</dd>
|
|
|
|
|
<dt><a name="GCCLD"><tt>GCCLD</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>gccld</tt> tool.</dd>
|
|
|
|
|
<dt><a name="HAVE_BZIP2"><tt>HAVE_BZIP2</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>This variable is set automatically if the <tt>configure</tt> script
|
|
|
|
|
could find the bzip2 library.</dd>
|
|
|
|
|
<dt><a name="HAVE_ZLIB"><tt>HAVE_ZLIB</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>This variable is set automatically if the <tt>configure</tt> script
|
|
|
|
|
could find the zlib library.</dd>
|
|
|
|
|
<dt><a name="INSTALL"><tt>INSTALL</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>install</tt> tool.</dd>
|
|
|
|
|
<dt><a name="LDFLAGS"><tt>LDFLAGS</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Allows users to specify additional flags to pass to the linker.</dd>
|
|
|
|
|
<dt><a name="LIBS"><tt>LIBS</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>The list of libraries that should be linked with each tool.</dd>
|
|
|
|
|
<dt><a name="LIBTOOL"><tt>LIBTOOL</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>libtool</tt> tool. This tool is renamed
|
|
|
|
|
<tt>mklib</tt> by the <tt>configure</tt> script and always located in the
|
|
|
|
|
<dt><a name="LLVMAS"><tt>LLVMAS</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>llvm-as</tt> tool.</dd>
|
|
|
|
|
<dt><a name="LLVMGCC"><tt>LLVMGCC</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the LLVM version of the GCC 'C' Compiler</dd>
|
|
|
|
|
<dt><a name="LLVMGXX"><tt>LLVMGXX</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the LLVM version of the GCC C++ Compiler</dd>
|
|
|
|
|
<dt><a name="LLVM_OBJ_ROOT"><tt>LLVM_OBJ_ROOT</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the top directory into which the output of the build is
|
|
|
|
|
placed.</dd>
|
|
|
|
|
<dt><a name="LLVM_SRC_ROOT"><tt>LLVM_SRC_ROOT</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the top directory in which the sources are found.</dd>
|
|
|
|
|
<dt><a name="LLVM_TARBALL_NAME"><tt>LLVM_TARBALL_NAME</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Specifies the name of the distribution tarball to create. This is
|
|
|
|
|
configured from the name of the project and its version number.</dd>
|
|
|
|
|
<dt><a name="MKDIR"><tt>MKDIR</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>mkdir</tt> tool that creates
|
|
|
|
|
directories.</dd>
|
|
|
|
|
<dt><a name="PLATFORMSTRIPOPTS"><tt>PLATFORMSTRIPOPTS</tt></a></dt>
|
|
|
|
|
<dd>The options to provide to the linker to specify that a stripped (no
|
|
|
|
|
symbols) executable should be built.</dd>
|
|
|
|
|
<dt><a name="RANLIB"><tt>RANLIB</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>ranlib</tt> tool.</dd>
|
|
|
|
|
<dt><a name="RM"><tt>RM</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>rm</tt> tool.</dd>
|
|
|
|
|
<dt><a name="SED"><tt>SED</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>sed</tt> tool.</dd>
|
|
|
|
|
<dt><a name="SHLIBEXT"><tt>SHLIBEXT</tt></a><small>(configured)</small></dt>
|
|
|
|
|
<dd>Provides the filename extension to use for shared libraries.</dd>
|
|
|
|
|
<dt><a name="TBLGEN"><tt>TBLGEN</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>tblgen</tt> tool.</dd>
|
|
|
|
|
<dt><a name="TAR"><tt>TAR</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>tar</tt> tool.</dd>
|
|
|
|
|
<dt><a name="ZIP"><tt>ZIP</tt></a><small>(defaulted)</small></dt>
|
|
|
|
|
<dd>Specifies the path to the <tt>zip</tt> tool.</dd>
|
|
|
|
|
</dl>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="getvars">Readable Variables</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Variables listed in the table below can be used by the user's Makefile but
|
|
|
|
|
should not be changed. Changing the value will generally cause the build to go
|
|
|
|
|
wrong, so don't do it.</p>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dl>
|
|
|
|
|
<dt><a name="bindir"><tt>bindir</tt></a></dt>
|
|
|
|
|
<dd>The directory into which executables will ultimately be installed. This
|
|
|
|
|
value is derived from the <tt>--prefix</tt> option given to
|
|
|
|
|
<tt>configure</tt>.</dd>
|
2004-11-01 07:53:17 +00:00
|
|
|
<dt><a name="BuildMode"><tt>BuildMode</tt></a></dt>
|
|
|
|
|
<dd>The name of the type of build being performed: Debug, Release, or
|
|
|
|
|
Profile</dd>
|
2004-10-30 21:39:42 +00:00
|
|
|
<dt><a name="bytecode_libdir"><tt>bytecode_libdir</tt></a></dt>
|
|
|
|
|
<dd>The directory into which bytecode libraries will ultimately be installed.
|
|
|
|
|
This value is derived from the <tt>--prefix</tt> option given to
|
|
|
|
|
<tt>configure</tt>.</dd>
|
|
|
|
|
<dt><a name="ConfigureScriptFLAGS"><tt>ConfigureScriptFLAGS</tt></a></dt>
|
|
|
|
|
<dd>Additional flags given to the <tt>configure</tt> script when
|
|
|
|
|
reconfiguring.</dd>
|
|
|
|
|
<dt><a name="DistDir"><tt>DistDir</tt></a></dt>
|
|
|
|
|
<dd>The <em>current</em> directory for which a distribution copy is being
|
|
|
|
|
made.</dd>
|
|
|
|
|
<dt><a name="Echo"><tt>Echo</tt></a></dt>
|
|
|
|
|
<dd>The LLVM Makefile System output command. This provides the
|
|
|
|
|
<tt>llvm[n]</tt> prefix and starts with @ so the command itself is not
|
|
|
|
|
printed by <tt>make</tt>.</dd>
|
|
|
|
|
<dt><a name="EchoCmd"><tt>EchoCmd</tt></a></dt>
|
|
|
|
|
<dd> Same as <a href="#Echo"><tt>Echo</tt></a> but without the leading @.
|
|
|
|
|
</dd>
|
|
|
|
|
<dt><a name="includedir"><tt>includedir</tt></a></dt>
|
|
|
|
|
<dd>The directory into which include files will ultimately be installed.
|
|
|
|
|
This value is derived from the <tt>--prefix</tt> option given to
|
|
|
|
|
<tt>configure</tt>.</dd>
|
|
|
|
|
<dt><a name="libdir"><tt>libdir</tt></a></dt><dd></dd>
|
|
|
|
|
<dd>The directory into which native libraries will ultimately be installed.
|
|
|
|
|
This value is derived from the <tt>--prefix</tt> option given to
|
|
|
|
|
<tt>configure</tt>.</dd>
|
|
|
|
|
<dt><a name="LibDir"><tt>LibDir</tt></a></dt>
|
|
|
|
|
<dd>The configuration specific directory into which libraries are placed
|
|
|
|
|
before installation.</dd>
|
|
|
|
|
<dt><a name="MakefileConfig"><tt>MakefileConfig</tt></a></dt>
|
|
|
|
|
<dd>Full path of the <tt>Makefile.config</tt> file.</dd>
|
|
|
|
|
<dt><a name="MakefileConfigIn"><tt>MakefileConfigIn</tt></a></dt>
|
|
|
|
|
<dd>Full path of the <tt>Makefile.config.in</tt> file.</dd>
|
|
|
|
|
<dt><a name="ObjDir"><tt>ObjDir</tt></a></dt>
|
|
|
|
|
<dd>The configuration and directory specific directory where build objects
|
|
|
|
|
(compilation results) are placed.</dd>
|
|
|
|
|
<dt><a name="SubDirs"><tt>SubDirs</tt></a></dt>
|
|
|
|
|
<dd>The complete list of sub-directories of the current directory as
|
|
|
|
|
specified by other variables.</dd>
|
|
|
|
|
<dt><a name="Sources"><tt>Sources</tt></a></dt>
|
|
|
|
|
<dd>The complete list of source files.</dd>
|
|
|
|
|
<dt><a name="sysconfdir"><tt>sysconfdir</tt></a></dt>
|
|
|
|
|
<dd>The directory into which configuration files will ulitmately be
|
|
|
|
|
installed. This value is derived from the <tt>--prefix</tt> option given to
|
|
|
|
|
<tt>configure</tt>.</dd>
|
|
|
|
|
<dt><a name="ToolDir"><tt>ToolDir</tt></a></dt>
|
|
|
|
|
<dd>The configuration specific directory into which executables are placed
|
|
|
|
|
before they are installed.</dd>
|
|
|
|
|
<dt><a name="TopDistDir"><tt>TopDistDir</tt></a></dt>
|
|
|
|
|
<dd>The top most directory into which the distribution files are copied.</dd>
|
|
|
|
|
<dt><a name="Verb"><tt>Verb</tt></a></dt>
|
|
|
|
|
<dd>Use this as the first thing on your build script lines to enable or
|
|
|
|
|
disable verbose mode. It expands to either an @ (quiet mode) or nothing
|
|
|
|
|
(verbose mode). </dd>
|
|
|
|
|
</dl>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
|
<div class="doc_subsection"><a name="intvars">Internal Variables</a></div>
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
<p>Variables listed below are used by the LLVM Makefile System
|
|
|
|
|
and considered internal. You should not use these variables under any
|
|
|
|
|
circumstances.</p>
|
|
|
|
|
<dl>
|
|
|
|
|
<dt><a name="Archive"><tt>Archive</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="AR.Flags"><tt>AR.Flags</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="BaseNameSources"><tt>BaseNameSources</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="BCCompile.C"><tt>BCCompile.C</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="BCCompile.CXX"><tt>BCCompile.CXX</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="BCLinkLib"><tt>BCLinkLib</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Burg"><tt>Burg</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="C.Flags"><tt>C.Flags</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Compile.C"><tt>Compile.C</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="CompileCommonOpts"><tt>CompileCommonOpts</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Compile.CXX"><tt>Compile.CXX</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ConfigStatusScript"><tt>ConfigStatusScript</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ConfigureScript"><tt>ConfigureScript</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="CPP.Flags"><tt>CPP.Flags</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="CPP.Flags "><tt>CPP.Flags </tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="CXX.Flags"><tt>CXX.Flags</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DependFiles"><tt>DependFiles</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DestArchiveLib"><tt>DestArchiveLib</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DestBytecodeLib"><tt>DestBytecodeLib</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DestRelinkedLib"><tt>DestRelinkedLib</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DestSharedLib"><tt>DestSharedLib</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DestTool"><tt>DestTool</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistAlways"><tt>DistAlways</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistCheckDir"><tt>DistCheckDir</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistCheckTop"><tt>DistCheckTop</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistFiles"><tt>DistFiles</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistName"><tt>DistName</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistOther"><tt>DistOther</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistSources"><tt>DistSources</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistSubDirs"><tt>DistSubDirs</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistTarBZ2"><tt>DistTarBZ2</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistTarGZip"><tt>DistTarGZip</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="DistZip"><tt>DistZip</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ExtraLibs"><tt>ExtraLibs</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="INCFiles"><tt>INCFiles</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="InternalTargets"><tt>InternalTargets</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LD.Flags"><tt>LD.Flags</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LexOutput"><tt>LexOutput</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LibName.A"><tt>LibName.A</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LibName.BC"><tt>LibName.BC</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LibName.LA"><tt>LibName.LA</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LibName.O"><tt>LibName.O</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LibTool.Flags"><tt>LibTool.Flags</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Link"><tt>Link</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LLVMGCCLibDir"><tt>LLVMGCCLibDir</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LLVMLibDir"><tt>LLVMLibDir</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LLVMLibsOptions"><tt>LLVMLibsOptions</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LLVMLibsPaths"><tt>LLVMLibsPaths</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LLVMToolDir"><tt>LLVMToolDir</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LLVMUsedLibs"><tt>LLVMUsedLibs</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LocalTargets"><tt>LocalTargets</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LTCompile.C"><tt>LTCompile.C</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LTCompile.CXX"><tt>LTCompile.CXX</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="LTInstall"><tt>LTInstall</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ObjectsBC"><tt>ObjectsBC</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ObjectsLO"><tt>ObjectsLO</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ObjectsO"><tt>ObjectsO</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ObjMakefiles"><tt>ObjMakefiles</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Parallel_Targets"><tt>Parallel_Targets</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="PreConditions"><tt>PreConditions</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ProjLibsOptions"><tt>ProjLibsOptions</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ProjLibsPaths"><tt>ProjLibsPaths</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ProjUsedLibs"><tt>ProjUsedLibs</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Ranlib"><tt>Ranlib</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="RecursiveTargets"><tt>RecursiveTargets</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Relink"><tt>Relink</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="SrcMakefiles"><tt>SrcMakefiles</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="Strip"><tt>Strip</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="StripWarnMsg"><tt>StripWarnMsg</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="TableGen"><tt>TableGen</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="TDFiles"><tt>TDFiles</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="ToolBuildPath"><tt>ToolBuildPath</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="TopLevelTargets"><tt>TopLevelTargets</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="UserTargets"><tt>UserTargets</tt></a></dt><dd></dd>
|
|
|
|
|
<dt><a name="YaccOutput"><tt>YaccOutput</tt></a></dt><dd></dd>
|
|
|
|
|
</dl>
|
2004-10-23 07:57:22 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
<hr>
|
|
|
|
|
<address>
|
|
|
|
|
<a href="http://jigsaw.w3.org/css-validator/check/referer"><img
|
|
|
|
|
src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"></a>
|
|
|
|
|
<a href="http://validator.w3.org/check/referer"><img
|
|
|
|
|
src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!" /></a>
|
|
|
|
|
|
|
|
|
|
<a href="mailto:rspencer@x10sys.com">Reid Spencer</a><br>
|
|
|
|
|
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a><br>
|
|
|
|
|
Last modified: $Date$
|
|
|
|
|
</address>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
<!-- vim: sw=2 noai
|
|
|
|
|
-->
|
