Additional to the following text, a further [[example]] has be posted.


# Building [[GNUMach]] from Source

If you want to build the [[GNUMach]] kernel yourself instead of just using a
pre-built binary, follow these instructions.

The unpacked source tree is around 20 MiB, and the build tree (with all drivers
enabled) is around 50 MiB.

## Getting the Source Code

### Developers's RCS

See [here](http://www.gnu.org/software/hurd/gnumach-download.html#cvs).

    $ cvs -z3 -d:pserver:anonymous@cvs.savannah.gnu.org:/sources/hurd co -r gnumach-1-branch gnumach

(Most probably you want to get hold of the *GNU Mach 1 branch* and not the
trunk, which is also what we've done above.)

You then have to create the automatically generatable files:

    $ ( cd gnumach && autoreconf --install )

### What Debian is currently using

See [here](http://packages.debian.net/source/unstable/gnumach).

    $ apt-get source gnumach

Please see the Debian [[running/debian/FAQ]] before using `apt-get source`.

## Preparing for the Build

### ... on Debian systems

Building GNU Mach requires the *build-essential* and *fakeroot* packages, their
dependencies and additional packages that are specified by the source gnumach
package:

    # apt-get install build-essential fakeroot
    # apt-get build-dep gnumach

### ... on non-Debian systems

Apart from the case that you only want to install GNU Mach's header files (see
below), building GNU Mach requires you to have the Mach Interface Generator
installed.  See [[building_MIG|mig/building]] about how to do that, then come
back here.

Additionally, building GNU Mach requires a C compiler, a standard C library and
your favourite flavor of awk (gawk) and GNU make.

## Building and Installing

### ... Debian `.deb` files

Change into the directory with the downloaded / unpacked GNU Mach sources, e.g.

    $ cd gnumach-20050801

Start the build process with

    $ dpkg-buildpackage -us -uc -b -rfakeroot

[[GNUMach]] is now building.  To use the new kernel, you must install the
resulting `.deb` package which is located one directory above the build
directory and has a similar name as the build directory, e.g.

    # dpkg -i ../gnumach_20050801-4_hurd-i386.deb

You can now reboot your computer and enjoy the new kernel.

### [TODO]

GNU Mach should be built in a separate directory:

    $ mkdir gnumach-build
    $ cd gnumach-build

Find the path to your GNU Mach sources (`[...]/gnumach-1-branch`) and configure
it:

    $ [...]/gnumach-1-branch/configure [TODO]

Build the kernel image:

    $ make gnumach.gz

Optionally run the (tiny) test suite:

    $ make check

You can then install and use `gnumach.gz`.

[TODO.]

### Installing only the Header Files

GNU Mach should be built in a separate directory:

    $ mkdir gnumach-build
    $ cd gnumach-build

Find the path to your GNU Mach sources (`[...]/gnumach-1-branch`) and configure
it:

    $ [...]/gnumach-1-branch/configure --prefix=

Install the header files into e.g. `~/gnu/include/`:

    $ make DESTDIR=~/gnu install-data