Skip to content

Latest commit

 

History

History
93 lines (52 loc) · 2.4 KB

BuildInstructions.md

File metadata and controls

93 lines (52 loc) · 2.4 KB
Raw

Building an i686-pc-serenity toolchain

Here's a quick guide to building the i686-pc-serenity toolchain. I keep my toolchain in /opt/cross (so /opt/cross/bin needs to be in $PATH) and my Serenity sources are in /home/andreas/src/serenity

You need to adjust these so they fit your system.

Dependencies:

First off, GCC needs MPFR, MPC and GMP. On Ubuntu, this is as simple as:

sudo apt install libmpfr-dev libmpc-dev libgmp-dev

For Serenity, we will need nasm, e2fsprogs and QEMU:

sudo apt install nasm e2fsprogs qemu-system-i386

Binutils:

Download GNU binutils-2.32 and apply the patch serenity/Meta/binutils-2.32-serenity.patch

Make a build directory next to the binutils source directory.

In the build directory, run configure:

../binutils-2.32/configure \
    --prefix=/opt/cross \
    --target=i686-pc-serenity \
    --with-sysroot=/home/andreas/src/serenity/Root \
    --disable-nls

Then build and install:

make
sudo make install

Serenity LibC (part 1):

Before we can build GCC, we need to put the Serenity LibC headers where GCC can find them. So go into serenity/LibC/ and install them:

./install.sh

Don't worry about any error messages from the above command. We only care about copying the headers to the right place at this time.

GCC (part 1):

Okay, then let's build GCC.

Download GNU GCC-8.3.0 and apply the patch serenity/Meta/gcc-8.3.0-serenity.patch

Make a build directory next to the GCC source directory.

In the build directory, run configure:

../gcc-8.3.0/configure \
    --prefix=/opt/cross \
    --target=i686-pc-serenity \
    --with-sysroot=/home/andreas/src/serenity/Root \
    --enable-languages=c,c++

Then build and install:

make all-gcc all-target-libgcc
sudo make install-gcc install-target-libgcc

Serenity LibC (part 2):

Now let's go into serenity/LibC/ and build the C library. This is required in order to complete the GCC build.

make
./install.sh

The C library is now installed in serenity/Root/ and we can build GCC's libstdc++...

GCC (part 2):

Go back to the GCC build directory and finish building libstdc++:

make all-target-libstdc++-v3
sudo make install-target-libstdc++-v3

Serenity

If everything worked out, you now have the i686-pc-serenity toolchain ready and we can build Serenity.

Go into serenity/Kernel and build it:

./makeall.sh

Then take it for a spin:

./run