blob: d41f85b3edad116bf9d48f3dd19e845624c9d076 [file] [log] [blame]
Bin Meng75574052016-02-05 19:30:11 -08001The biggest problem when trying to compile U-Boot with clang is that
Jeroen Hofstee2e571e92014-09-10 20:08:52 +02002almost all archs rely on storing gd in a global register and clang user
3manual states: "clang does not support global register variables; this
4is unlikely to be implemented soon because it requires additional LLVM
5backend support."
6
7Since version 3.4 the ARM backend can be instructed to leave r9 alone.
8Global registers themselves are not supported so some inline assembly is
9used to get its value. This does lead to larger code then strictly
10necessary, but at least works.
11
12NOTE: target compilation only work for _some_ ARM boards at the moment.
13Also Aarch64 is not supported: Most notably boards which aren't using
14the generic board will fail to compile, but since those are expected
15to be converted this will solve itself. Boards which reassign gd in c
16will also fail to compile, but there is in no strict reason to do so
17in the ARM world, since crt0.S takes care of this. These assignments
18can be avoided by changing the init calls but this is not in mainline yet.
19
Bin Meng75574052016-02-05 19:30:11 -080020NOTE: without the -mllvm -arm-use-movt=0 flags U-Boot will compile
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020021fine, but llvm might hardcode addresses in movw / movt pairs, which
Bin Meng75574052016-02-05 19:30:11 -080022cannot be relocated and U-Boot will fail at runtime.
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020023
24Debian (based)
25--------------
26Binary packages can be installed as usual, e.g.:
27sudo apt-get install clang
28
29To compile U-Boot with clang on linux without IAS use e.g.:
30export TRIPLET=arm-linux-gnueabi && export CROSS_COMPILE="$TRIPLET-"
Stephen Warren682b6b52014-11-19 20:41:03 -070031make HOSTCC=clang CC="clang -target $TRIPLET -mllvm -arm-use-movt=0 -no-integrated-as" rpi_defconfig
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020032make HOSTCC=clang CC="clang -target $TRIPLET -mllvm -arm-use-movt=0 -no-integrated-as" all V=1 -j8
33
Tom Rini689de5f2016-03-16 20:40:20 -040034It can also be used to compile sandbox:
35make HOSTCC=clang sandbox_defconfig
36make HOSTCC=clang CC=clang -j8
37
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020038FreeBSD 11 (Current):
39--------------------
40Since llvm 3.4 is currently in the base system, the integrated as is
Jeroen Hofstee432710c2014-09-21 10:20:22 +020041incapable of building U-Boot. Therefore gas from devel/arm-gnueabi-binutils
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020042is used instead. It needs a symlinks to be picked up correctly though:
43
Jeroen Hofstee432710c2014-09-21 10:20:22 +020044ln -s /usr/local/bin/arm-gnueabi-freebsd-as /usr/bin/arm-freebsd-eabi-as
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020045
46# The following commands compile U-Boot using the clang xdev toolchain.
47# NOTE: CROSS_COMPILE and target differ on purpose!
Jeroen Hofstee432710c2014-09-21 10:20:22 +020048export CROSS_COMPILE=arm-gnueabi-freebsd-
Stephen Warren682b6b52014-11-19 20:41:03 -070049gmake CC="clang -target arm-freebsd-eabi --sysroot /usr/arm-freebsd -no-integrated-as -mllvm -arm-use-movt=0" rpi_defconfig
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020050gmake CC="clang -target arm-freebsd-eabi --sysroot /usr/arm-freebsd -no-integrated-as -mllvm -arm-use-movt=0" -j8
51
Bin Meng75574052016-02-05 19:30:11 -080052Given that U-Boot will default to gcc, above commands can be
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020053simplified with a simple wrapper script, listed below.
54
Jeroen Hofstee432710c2014-09-21 10:20:22 +020055/usr/local/bin/arm-gnueabi-freebsd-gcc
Jeroen Hofstee2e571e92014-09-10 20:08:52 +020056---
57#!/bin/sh
58
59exec clang -target arm-freebsd-eabi --sysroot /usr/arm-freebsd -no-integrated-as -mllvm -arm-use-movt=0 "$@"
60