X-Git-Url: http://demsky.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FHowToBuildOnARM.rst;h=13de7d1b44709bab6506aaf3b7dcf6460919eb6b;hb=9e6a5a37460ff82ad4e3a7aea1c45e2c934ab25b;hp=793015a4ed40f7d97e161dfe0da8300878b1b235;hpb=7149ef0176240ee5a09b0f6ad6300d1a966a31d1;p=oota-llvm.git diff --git a/docs/HowToBuildOnARM.rst b/docs/HowToBuildOnARM.rst index 793015a4ed4..13de7d1b447 100644 --- a/docs/HowToBuildOnARM.rst +++ b/docs/HowToBuildOnARM.rst @@ -1,34 +1,43 @@ -.. _how_to_build_on_arm: - -=================================================================== -How To Build On ARM -=================================================================== - -.. sectionauthor:: Wei-Ren Chen (陳韋任) - -Introduction -============ - -This document contains information about building/testing LLVM and -Clang on ARM. - -Notes On Building LLVM/Clang on ARM -===================================== -Here are some notes on building/testing LLVM/Clang on ARM. Note that -ARM encompasses a wide variety of CPUs; this advice is primarily based -on the ARMv6 and ARMv7 architectures and may be inapplicable to older chips. - -#. If you are building LLVM/Clang on an ARM board with 1G of memory or less, - please use ``gold`` rather then GNU ``ld``. - Building LLVM/Clang with ``--enable-optimized`` - is prefered since it consumes less memory. Otherwise, the building - process will very likely fail due to insufficient memory. In any - case it is probably a good idea to set up a swap partition. - -#. If you want to run ``make - check-all`` after building LLVM/Clang, to avoid false alarms (eg, ARCMT - failure) please use the following configuration: - - .. code-block:: bash - - $ ../$LLVM_SRC_DIR/configure --with-abi=aapcs +=================================================================== +How To Build On ARM +=================================================================== + +Introduction +============ + +This document contains information about building/testing LLVM and +Clang on ARM. + +Notes On Building LLVM/Clang on ARM +===================================== +Here are some notes on building/testing LLVM/Clang on ARM. Note that +ARM encompasses a wide variety of CPUs; this advice is primarily based +on the ARMv6 and ARMv7 architectures and may be inapplicable to older chips. + +#. If you are building LLVM/Clang on an ARM board with 1G of memory or less, + please use ``gold`` rather then GNU ``ld``. + Building LLVM/Clang with ``--enable-optimized`` + is prefered since it consumes less memory. Otherwise, the building + process will very likely fail due to insufficient memory. In any + case it is probably a good idea to set up a swap partition. + +#. If you want to run ``make + check-all`` after building LLVM/Clang, to avoid false alarms (eg, ARCMT + failure) please use at least the following configuration: + + .. code-block:: bash + + $ ../$LLVM_SRC_DIR/configure --with-abi=aapcs-vfp + +#. The most popular linaro/ubuntu OS's for ARM boards, eg, the + Pandaboard, have become hard-float platforms. The following set + of configuration options appears to be a good choice for this + platform: + + .. code-block:: bash + + ./configure --build=armv7l-unknown-linux-gnueabihf + --host=armv7l-unknown-linux-gnueabihf + --target=armv7l-unknown-linux-gnueabihf --with-cpu=cortex-a9 + --with-float=hard --with-abi=aapcs-vfp --with-fpu=neon + --enable-targets=arm --disable-optimized --enable-assertions