Building Kiwi
Building Kiwi is not a hard job, but does require some initial setup before you can get started. The build requirements are below:
| To build Kiwi itself: | Kiwi cross compiler, scons 1.2.0 or later, python, mkisofs, sharutils, boost, ncurses (+headers) | ||||
|---|---|---|---|---|---|
| To build the cross compiler: | wget, gcc, binutils, make, patch, mpfr (+headers), gmp (+headers), mpc (+headers), texinfo, bison, flex | ||||
| Supported build platforms: | Linux, Mac OS X, Windows (via Cygwin) | ||||
Windows users: Please see the Cygwin building page for details on setting up Cygwin to build Kiwi.
Mac OS X users: Please see the Mac OS X building page for details on setting up Mac OS X to build Kiwi.
Step 1: Configuration
To configure Kiwi, you must be using a terminal that supports ncurses. Run 'scons config' to open the configuration utility and follow the instructions. The only field you must correct is the toolchain directory, though you may also want to change the target architecture, which defaults to AMD64.
Step 2: Toolchain
If you have not yet built a Kiwi toolchain, then you will need to build one now. If you want to check if you need one, run scons and it will tell if you need to build one.
To build one simply run 'scons toolchain' from the root of the source tree and do something else for a bit. When its done you will be ready to build Kiwi.
Step 3: Build
To build Kiwi, run 'scons' and the OS will be built. In addition a CD image will be created for you to use. This will reside in build/(arch)-(platform)/cdrom.iso. You now have built Kiwi. Enjoy!
To clean up built files, run 'scons -c'. To test in qemu (specify QEMU binary and options in the build configuration), run scons qtest.