X-Git-Url: http://demsky.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FCMake.html;h=40a2cec8e91bd10a8f80b0fec4fd7d66ea8d2a56;hb=9e6d1d1f5034347d237941f1bf08fba5c1583cd3;hp=b329ca46d62e626d4665cb0fdaf868612497e350;hpb=81a875585c23ddc914e2f2955d87d1bf84696aa1;p=oota-llvm.git diff --git a/docs/CMake.html b/docs/CMake.html index b329ca46d62..40a2cec8e91 100644 --- a/docs/CMake.html +++ b/docs/CMake.html @@ -67,7 +67,7 @@
    -

  1. Download +

  2. Download and install CMake. Version 2.6.2 is the minimum required.

  3. Open a shell. Your development tools must be reachable from this @@ -180,7 +180,7 @@

    Variables are stored on the CMake cache. This is a file - named CMakeCache.txt on the root of the build + named CMakeCache.txt on the root of the build directory. Do not hand-edit it.

    Variables are listed here appending its type after a colon. It is @@ -209,7 +209,7 @@

    CMAKE_BUILD_TYPE:STRING
    Sets the build type for make based generators. Possible - values are Release, Debug, RelWithDebInfo and MiniSizeRel. On + values are Release, Debug, RelWithDebInfo and MinSizeRel. On systems like Visual Studio the user sets the build type with the IDE settings.
    @@ -217,6 +217,11 @@
    Path where LLVM will be installed if "make install" is invoked or the "INSTALL" target is built.
    +
    LLVM_LIBDIR_SUFFIX:STRING
    +
    Extra suffix to append to the directory where libraries are to + be installed. On a 64-bit architecture, one could use + -DLLVM_LIBDIR_SUFFIX=64 to install libraries to /usr/lib64.
    +
    CMAKE_C_FLAGS:STRING
    Extra flags to use when compiling C source files.
    @@ -245,26 +250,52 @@ to X86. On the other cases defaults to all. Example: -DLLVM_TARGETS_TO_BUILD="X86;PowerPC;Alpha". +
    LLVM_BUILD_TOOLS:BOOL
    +
    Build LLVM tools. Defaults to ON. Targets for building each tool + are generated in any case. You can build an tool separately by + invoking its target. For example, you can build llvm-as + with a makefile-based system executing make llvm-as on the + root of your build directory.
    + +
    LLVM_BUILD_EXAMPLES:BOOL
    +
    Build LLVM examples. Defaults to OFF. Targets for building each + example are generated in any case. See documentation + for LLVM_BUILD_TOOLS above for more details.
    +
    LLVM_ENABLE_THREADS:BOOL
    Build with threads support, if available. Defaults to ON.
    -
    LLVM_ENABLE_ASSERTS:BOOL
    -
    Enables code asserts. Defaults to ON if and only if +
    LLVM_ENABLE_ASSERTIONS:BOOL
    +
    Enables code assertions. Defaults to OFF if and only if CMAKE_BUILD_TYPE is Release.
    LLVM_ENABLE_PIC:BOOL
    -
    Add the -fPIC flag to the compiler command-line, if the - compiler supports this flag. Some systems, like Windows, does not - need this flag. Defaults to OFF.
    +
    Add the -fPIC flag for the compiler command-line, if the + compiler supports this flag. Some systems, like Windows, do not + need this flag. Defaults to ON.
    + +
    LLVM_ENABLE_WARNINGS:BOOL
    +
    Enable all compiler warnings. Defaults to ON.
    + +
    LLVM_ENABLE_PEDANTIC:BOOL
    +
    Enable pedantic mode. This disable compiler specific extensions, is + possible. Defaults to ON.
    + +
    LLVM_ENABLE_WERROR:BOOL
    +
    Stop and fail build, if a compiler warning is + triggered. Defaults to OFF.
    LLVM_BUILD_32_BITS:BOOL
    Build 32-bits executables and libraries on 64-bits systems. This - option is available only on some 64-bits unix systems. Defaults to - OFF.
    + option is available only on some 64-bits unix systems. Defaults to + OFF. -
    LLVM_PLO_FLAGS:STRING
    -
    Extra flags for creating partially linked objects. Visual C++ - does not use this.
    +
    LLVM_TARGET_ARCH:STRING
    +
    LLVM target to use for native code generation. This is required + for JIT generation. It defaults to "host", meaning that it shall + pick the architecture of the machine where LLVM is being built. If + you are cross-compiling, set it to the target architecture + name.
    LLVM_TABLEGEN:STRING
    Full path to a native TableGen executable (usually @@ -296,7 +327,16 @@
    -

    TODO

    +

    See this + wiki page for generic instructions on how to cross-compile + with CMake. It goes into detailed explanations and may seem + daunting, but it is not. On the wiki page there are several + examples including toolchain files. Go directly to + this + section for a quick solution.

    + +

    Also see the LLVM-specific variables + section for variables used when cross-compiling.

    @@ -326,26 +366,6 @@ - -
    - Microsoft Visual C++ -
    - -
    - -

    For linking the JIT into your executable, add

    - -
    -

    /INCLUDE:_X86TargetMachineModule

    -
    - -

    to your linker options. This is required for adding the relevant - LLVM object code to the executable. Not doing this will result on - some methods returning NULL (ExecutionEngine::create, for - instance).

    - -
    -