From 5bea822a0c21d46b2ee539a38474735b2617365d Mon Sep 17 00:00:00 2001 From: Jim Grosbach Date: Fri, 17 Apr 2009 17:25:16 +0000 Subject: [PATCH] Update information on canadian cross builds git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@69358 91177308-0d34-0410-b5e6-96231b3b80d8 --- docs/GettingStarted.html | 45 ++++++++-------------------------------- 1 file changed, 9 insertions(+), 36 deletions(-) diff --git a/docs/GettingStarted.html b/docs/GettingStarted.html index 5dd39c22305..87a143fd0ec 100644 --- a/docs/GettingStarted.html +++ b/docs/GettingStarted.html @@ -1036,43 +1036,16 @@ that directory that is out of date.

-

It is possible to cross-compile LLVM. That is, you can create LLVM - executables and libraries for a platform different than the one one which you - are compiling. To do this, a few additional steps are - required. 1 To cross-compile LLVM, use - these instructions:

-
    -
  1. Configure and build LLVM as a native compiler. You will need - just TableGen from that build. -
      -
    • If you have $LLVM_OBJ_ROOT=$LLVM_SRC_ROOT just execute - make -C utils/TableGen after configuring.
      • -
    • Otherwise you will need to monitor building process and terminate - it just after TableGen was built.
      • -
    -
    2. -
  2. Copy the TableGen binary to somewhere safe (out of your build tree). -
    3. -
  3. Configure LLVM to build with a cross-compiler. To do this, supply the - configure script with --build and --host options that - are different. The values of these options must be legal target triples - that your GCC compiler supports.
    4. -
  4. Put the saved TableGen executable into the - into $LLVM_OBJ_ROOT/{BUILD_TYPE}/bin directory (e.g. into - .../Release/bin for a Release build).
    5. -
  5. Build LLVM as usual.
    6. -
-

The result of such a build will produce executables that are not executable - on your build host (--build option) but can be executed on your compile host +

It is possible to cross-compile LLVM itself. That is, you can create LLVM + executables and libraries to be hosted on a platform different from the + platform where they are build (a Canadian Cross build). To configure a + cross-compile, supply the configure script with --build and + --host options that are different. The values of these options must + be legal target triples that your GCC compiler supports.

+ +

The result of such a build is executables that are not runnable on + on the build host (--build option) but can be executed on the compile host (--host option).

-

Notes:

-
-
    -
  1. Cross-compiling was tested only with Linux as - build platform and Windows as host using mingw32 cross-compiler. Other - combinations have not been tested.
    2. -
-