1bff4eceaaadbc52024287c34ec37aa07e4333b9
[hadrian.git] / doc / cross-compile.md
1 ## Build a cross-compiling GHC
2
3 In this example, our host machine is "Ubuntu 16.04.2 LTS, Linux ubuntu 4.4.0-79-generic 86_64".
4
5 We need to download necessary tools, including:
6
7 - [LLVM-4.0 source](http://releases.llvm.org/4.0.0/llvm-4.0.0.src.tar.xz), you need to build it yourself. Remember to choose release channel and use gold linker (`cmake -DCMAKE_BUILD_TYPE=Release -DLLVM_USE_LINKER=gold ..`)
8 - `sudo apt-get install gcc-arm-linux-gnueabihf` to install the GCC cross-compiler
9 - Download and install [Haskell Platform 8.0.2](https://haskell.org/platform/download/8.0.2/haskell-platform-8.0.2-unknown-posix--full-x86_64.tar.gz). Install it according to [instructions here](https://www.haskell.org/platform/linux.html#linux-generic)
10
11 After all the dependencies are in place:
12
13 - `git clone https://github.com/ghc/ghc`
14 - `cd ghc`
15 - `git clone https://github.com/snowleopard/hadrian`
16 - `git submodule update --init`
17 - `./configure --target=arm-linux-gnueabihf`
18 - `cd hadrian`
19 - Modify `src/Settings.hs`, set `stage1Only` and `crossCompiling` to `True`.
20 - Build the compiler by e.g. `./build.sh --flavour=quickest --integer-simple --skip-configure -V -j`
21
22 After that, you should have built `inplace/bin/ghc-stage1` cross compiler. We will go to the next section to validate this.
23
24 ## Test run
25
26 Write a simple hello world haskell program:
27
28 ```haskell
29 module Main where
30 main = putStrLn "Hello, world!"
31 ```
32 Compile it with cross-compiling GHC: `<ghc-folder>/inplace/bin/ghc-stage1 -static Main`. Note that we created a static version of it which packs together all depending libraries.
33
34 - Install QEMU: `sudo apt-get install qemu-system-arm`
35 - Download `vmlinuz` (kernel) and `initrd.gz` (initial ramdisk), e.g. from [this mirror](https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/dists/xenial/main/installer-armhf/current/images/generic-lpae/cdrom/).
36 - Add the ARM Linux executable `Main` to the initial ramdisk so we can load it directly into memory. No need for real installation
37   + `gunzip initrd.gz` to get `initrd`
38   + `mkdir tmp2; cd tmp2; sudo cpio -id < ../initrd` to get a file system
39   + `cp /PATH/TO/Main usr/bin`
40   + `find . | cpio --create --format='newc' > /tmp/newinitrd` to pack back the `initrd`
41   + `gzip /tmp/newinitrd`
42   + Move `newinitrd` to where `vmlinuz` is, rename it to `newinitrd.img`
43   + Run the following configured QEMU:
44
45 ```bash
46 #!/bin/sh
47 qemu-system-arm \
48     -kernel vmlinuz \
49     -initrd newinitrd.img \
50     -append "root=/dev/vda2 rootfstype=ext4" \
51     -no-reboot \
52     -nographic \
53     -m 1024 \
54     -M virt
55 ```
56
57 This will lead you to a installer interface. But we don't need to do that, so we can save ourself from the hassle of setting up networks etc. We just keep `Go Back`, until see a line `Execute a shell`, and select it. Now you get a shell, go find `/usr/bin/Main` and run it!