Blame view
doc/README.clang
2.47 KB
a187559e3 Use correct spell... |
1 |
The biggest problem when trying to compile U-Boot with clang is that |
5bfdcebf7 README.clang: bui... |
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
almost all archs rely on storing gd in a global register and clang user manual states: "clang does not support global register variables; this is unlikely to be implemented soon because it requires additional LLVM backend support." Since version 3.4 the ARM backend can be instructed to leave r9 alone. Global registers themselves are not supported so some inline assembly is used to get its value. This does lead to larger code then strictly necessary, but at least works. NOTE: target compilation only work for _some_ ARM boards at the moment. Also Aarch64 is not supported: Most notably boards which aren't using the generic board will fail to compile, but since those are expected to be converted this will solve itself. Boards which reassign gd in c will also fail to compile, but there is in no strict reason to do so in the ARM world, since crt0.S takes care of this. These assignments can be avoided by changing the init calls but this is not in mainline yet. |
a187559e3 Use correct spell... |
19 |
NOTE: without the -mllvm -arm-use-movt=0 flags U-Boot will compile |
5bfdcebf7 README.clang: bui... |
20 |
fine, but llvm might hardcode addresses in movw / movt pairs, which |
a187559e3 Use correct spell... |
21 |
cannot be relocated and U-Boot will fail at runtime. |
5bfdcebf7 README.clang: bui... |
22 23 24 25 26 |
Debian (based) -------------- Binary packages can be installed as usual, e.g.: sudo apt-get install clang |
b745e8283 arm: clang: Updat... |
27 28 29 30 |
Note that we still use binutils for some tools so we must continue to set CROSS_COMPILE. To compile U-Boot with clang on linux without IAS use e.g.: make HOSTCC=clang rpi_2_defconfig make HOSTCC=clang CROSS_COMPILE=arm-linux-gnueabi- CC=clang -j8 |
7ad260a99 doc/README.clang:... |
31 32 33 34 |
It can also be used to compile sandbox: make HOSTCC=clang sandbox_defconfig make HOSTCC=clang CC=clang -j8 |
5bfdcebf7 README.clang: bui... |
35 36 37 38 |
FreeBSD 11 (Current): -------------------- Since llvm 3.4 is currently in the base system, the integrated as is |
92c2dc0f6 README.clang: upd... |
39 |
incapable of building U-Boot. Therefore gas from devel/arm-gnueabi-binutils |
5bfdcebf7 README.clang: bui... |
40 |
is used instead. It needs a symlinks to be picked up correctly though: |
92c2dc0f6 README.clang: upd... |
41 |
ln -s /usr/local/bin/arm-gnueabi-freebsd-as /usr/bin/arm-freebsd-eabi-as |
5bfdcebf7 README.clang: bui... |
42 43 44 |
# The following commands compile U-Boot using the clang xdev toolchain. # NOTE: CROSS_COMPILE and target differ on purpose! |
92c2dc0f6 README.clang: upd... |
45 |
export CROSS_COMPILE=arm-gnueabi-freebsd- |
b745e8283 arm: clang: Updat... |
46 47 |
gmake rpi_2_defconfig gmake CC="clang -target arm-freebsd-eabi --sysroot /usr/arm-freebsd" -j8 |
5bfdcebf7 README.clang: bui... |
48 |
|
a187559e3 Use correct spell... |
49 |
Given that U-Boot will default to gcc, above commands can be |
5bfdcebf7 README.clang: bui... |
50 |
simplified with a simple wrapper script, listed below. |
92c2dc0f6 README.clang: upd... |
51 |
/usr/local/bin/arm-gnueabi-freebsd-gcc |
5bfdcebf7 README.clang: bui... |
52 53 |
--- #!/bin/sh |
b745e8283 arm: clang: Updat... |
54 |
exec clang -target arm-freebsd-eabi --sysroot /usr/arm-freebsd "$@" |