summaryrefslogtreecommitdiff
path: root/docs/HowToBuildOnARM.rst
diff options
context:
space:
mode:
authorMicah Villmow <villmow@gmail.com>2012-09-27 15:05:49 +0000
committerMicah Villmow <villmow@gmail.com>2012-09-27 15:05:49 +0000
commit7149ef0176240ee5a09b0f6ad6300d1a966a31d1 (patch)
treea4e096f7f388ffa52708a621c0e581d78d2a1ff3 /docs/HowToBuildOnARM.rst
parent94c22716d60ff5edf6a98a3c67e0faa001be1142 (diff)
downloadllvm-7149ef0176240ee5a09b0f6ad6300d1a966a31d1.tar.gz
llvm-7149ef0176240ee5a09b0f6ad6300d1a966a31d1.tar.bz2
llvm-7149ef0176240ee5a09b0f6ad6300d1a966a31d1.tar.xz
Patch for HowToBuildOnARM documentation from Wei-Ren Chen.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@164776 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/HowToBuildOnARM.rst')
-rw-r--r--docs/HowToBuildOnARM.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/HowToBuildOnARM.rst b/docs/HowToBuildOnARM.rst
new file mode 100644
index 0000000000..793015a4ed
--- /dev/null
+++ b/docs/HowToBuildOnARM.rst
@@ -0,0 +1,34 @@
+.. _how_to_build_on_arm:
+
+===================================================================
+How To Build On ARM
+===================================================================
+
+.. sectionauthor:: Wei-Ren Chen (陳韋任) <chenwj@iis.sinica.edu.tw>
+
+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