From a79e58c22eb4fa4277dffbdd7e0fe27a39abab5b Mon Sep 17 00:00:00 2001
From: Reid Spencer Written by Reid Spencer WARNING: This document is a work in progress!
+ install all
Copy built objects to installation directory.
printvars all
+ Prints variables defined by the makefile system (for debugging).
+
@@ -247,7 +249,6 @@
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.tags
Make C and C++ tags files for emacs and vi.
Not implemented yet!
This target does the same thing as check but only for the current (local) directory.
-Not implemented yet!
Not implemented yet!
Not implemented yet!
Not implemented yet!
Variables are used to tell the LLVM Makefile System what to do and to - obtain information from it. The sections below describe the three kinds of + 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 variables.
Variable Name | Variable Description |
---|---|
BUILD_ARCHIVE | -If set to any value, causes an archive (.a) library to be built. | -
BUILT_SOURCES | -Specifies a set of source files that are generated. These will be - built before any other target processing to ensure they are present. | -
BUILT_SOURCES | -If set to any value, causes a bytecode library (.bc) to be built. | -
BUILT_SOURCES | -Specifies a set of configuration files to be installed. | -
DIRS | -Specifies a set of directories that should also be made using the - same goal. These directories will be built serially. | -
DONT_BUILD_RELINKED | -If set to any value, causes a relinked library (.o) not to be built. | -
EXPORTED_SYMBOL_FILE | -Specifies the name of a single file that contains a list of the - symbols to be exported by the linker. One symbol per line. | -
LEVEL | -Specify the level of nesting from the top level. (Required) | -
LIBRARYNAME | -Specify the name of the library to be built. (Required For Libraries) | -
LLVMLIBS | -Specify the set of libraries from the LLVM $(OBJDIR) that will be - linked into the tool or library. | -
EXPERIMENTAL_DIRS | -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. | -
OPTIONAL_DIRS | -Specify a set of directories that may be built, if they exist, but its - not an error for them not to exist. | -
PARALLEL_DIRS | -Specify a set of directories to build recursively and in parallel if - the -j option was used with make. | -
SHARED_LIBRARY | -If set to any value, causes a shared library (.so) to be built. - (Optional) | -
SOURCES | -Specifies the list of source files in the current directory to be - acted upon. Source files of any type may be specified (programs, - documentation, config files, etc.) | -
TARGET | -Specifies the name of the LLVM code generation target that the - current directory builds. | -
TOOLNAME | -Specifies the name of the tool to build. (Required For Tools) | -
USEDLIBS | -Specifies the list of project libraries that will be linked into the - tool or library. | -
Variables listed in the table below can be used to override the default - values provided by the LLVM makefile system. These variables should be set - after the inclusion of $(LEVEL)/Makefile.common.
-Variable Name | Variable Description |
---|---|
C | -The name (and optional path) of the 'C' compiler (gcc normally). | -
CFLAGS | -The set of options to be passed to the 'C' compiler on every - compile. | -
CPP | -The name (and optional path) of the 'C' pre-processor (cpp normally). - | -
CXX | -The name (and optional path) of the C++ compiler (g++ normally). | -
LD | -The name (and optional path) of the system linker (gcc normally). | -
LIBTOOL | -The name (and optional path) of the libtool tool (libtool normally). | -
Overridable variables can be used to override the default + values provided by the LLVM makefile system. These variables can be set in + several ways:
+The overridable variables are given below:
+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.
-Variable Name | Variable Description |
---|---|
BUILD_SRC_DIR | -The project directory containing the directories source files. | -
BUILD_OBJ_DIR | -The project directory that will receive the object files. | -
CONFIGURATION | -The name of the configuration being built. | -
DESTDIR | -The top level directory into which files are installed. | -
LLVM_SRC_ROOT | -The top level directory of the LLVM source. | -
LLVM_OBJ_ROOT | -The top level directory of the LLVM objects. | -
OBJDIR | -The directory in which the project's object files should be placed. | -
LIBDIR | -The directory in which the project's library files should be placed. | -
TOOLDIR | -The directory in which the project's executable tools should be - placed. | -
Variables listed below are used by the LLVM Makefile System + and considered internal. You should not use these variables under any + circumstances.
+