Zandra Installation Guide

Prerequisites

GNU Binutils with target triplet
GCC with target triplet
mk (from 9base or plan9port)
pkgtools

Building the base packages

First, it is necessary to configure the build system. To do so, create a config.mk by copying config.def.mk and edit it. You can change the target architecture, compile flags, and more here.

After this, you can begin the build process:

[user@zandra ~]$ export mkbuild=$(pwd)/mkbuild # required for mkbuild
[user@zandra ~]$ export configmk=$(pwd)/config.mk # required for mkbuild
[user@zandra ~]$ export PATH="/opt/cross/bin:$PATH" # add cross compiler to $PATH
 
[user@zandra ~]$ mk init # initialize git submodules
[user@zandra ~]$ mk # build base packages

Installing the packages to a root directory

[user@zandra ~]$ export ROOT="rootdir" # replace with desired path (an existing directory)
[user@zandra ~]$ mk install

Making a bootable image

If you would like to create an image complete with a bootloader to use in a VM or put on a USB drive, make sure /dev/loop0 is not being used on your host system, and then run ROOT="rootdir" mk bootable, replacing "rootdir" with a path to the root directory used previously.