path: root/Distrib/BuildingTheHurd.mdwn

<table align="center" width="75%">
  <tr>
    <td align="center" colspan="2"><nop><h2><a name="HowTo_setup_a_Hurd_cross_compile"> <nop>HowTo setup a Hurd cross-compiler in Linux </nop></a></h2></nop></td>
  </tr>
  <tr>
    <td><nop><h2><a name="Table_of_Contents"> Table of Contents </a></h2> %TOC% </nop></td>
    <td valign="top">
      <p> Created from the original by <a href="http://cvs.gentoo.org/~avenj/" target="_top">Jon Portnoy</a>, <a href="http://cvs.gentoo.org/~avenj/doc/xcompile-en.html" target="_top">http://cvs.gentoo.org/~avenj/doc/xcompile-en.html</a></p>
      <p><nop></nop></p>
      <h2><a name="Introduction"> Introduction </a></h2>
      <p> For a Linux to Hurd cross-compiler you need these versions (I tried newer versions of gcc but they won't compile) </p>
      <p>
      </p>
      <ul>
        <li><a href="http://ftp.gnu.org/gnu/binutils/" target="_top">binutils-2.13.90.0.16</a></li>
      </ul>
      <p>
      </p>
      <ul>
        <li> egcs-core-1.2.2 &amp;lt;- a very old version of gcc, but it is very stable, you will need it for compiling the gnumach headers and the mig kernel </li>
      </ul>
      <p>
      </p>
      <ul>
        <li><a href="http://ftp.gnu.org/gnu/gcc/" target="_top">gcc-core-2.95.2</a> &amp;lt;- for compiling hurd </li>
      </ul>
      <p>
      </p>
      <ul>
        <li><a href="http://ftp.gnu.org/gnu/glibc/" target="_top">glibc-2.2.5</a></li>
      </ul>
      <p>
      </p>
      <ul>
        <li><a href="http://ftp.gnu.org/gnu/gnumach/gnumach-1.3.tar.gz" target="_top">gnumach-1.3</a></li>
      </ul>
      <p>
      </p>
      <ul>
        <li><a href="http://ftp.gnu.org/gnu/mig/mig-1.3.tar.gz" target="_top">mig-1.3</a></li>
      </ul>
      <p>
      </p>
      <ul>
        <li><a href="http://www.gnu.org/software/hurd/download.html" target="_top">hurd</a></li>
      </ul>
      <p>
      </p>
    </td>
  </tr>
</table>

## <a name="Building"> Building </a>

### <a name="The_directory_structure"> The directory structure </a>

It is easier to compile the whole sources in an extra directory:

* build/binutils &lt;- the unpacked binutils sources

* build/binutils.build

* build/egcs &lt;- the unpacked egcs sources

* build/egcs.build

* build/gcc &lt;- the unpacked gcc sources

* build/gcc.build

* build/glibc &lt;- the unpacked glibc sources

* build/glibc.build

* build/gnumach &lt;- the unpacked gnumach kernel sources

* build/gnumach.build

* build/mig &lt;- the unpacked mig kernel sources

* build/mig.build

* build/hurd &lt;- the unpacked hurd kernel sources

* build/hurd.build

### <a name="Exporting_the_CFLAG_and_PATH"> </a> Exporting the CFLAG and PATH

`/usr/local` is where the sources we compile will be installed. If you want to choose another directory you have to change the path to the bin directory and too you have to change the --prefix path to the directory you want.

    export CFLAGS="-march=i686 -O2 -fomit-frame-pointer"

    export PATH=/usr/local/bin:$PATH

### <a name="Cross_binutils"> Cross binutils </a>

cd binutils.build ../binutils/configure --prefix=/usr/local --target=i686-pc-gnu make make check

make install (as root, and don't forget to export the CFLAGS and the PATH)

cd ..

### <a name="Cross_egcs"> Cross egcs </a>

When the `/usr/local/bin` directory do not exist before you will now have to export the `PATH` again because after installing binutils you will have it.

    cd egcs.build
    ../egcs/configure --prefix=/usr/local --target=i686-pc-gnu \
                      --with-gnu-as --with-gnu-ld
    make -k
    make -k install (as root, don't forget to export CFLAGS and PATH)
    ln -s /usr/local/i686-pc-gnu /usr/local/lib/gcc-lib/i686-pc-gnu/egcs-2.91.66/i686-pc-gnu
    cd ..

### <a name="GNUmach_Headers"> </a> GNUmach Headers

    cd gnumach.build
    ../gnumach/configure --build=i686-pc-linux-gnu --host=i686-pc-gnu
    make -k install-headers prefix=/usr/local/i686-pc-gnu (as root ...)
    cd ..

### <a name="Mig"> Mig </a>

Mig is the Mach Interface Generator - needed by Mach and the Hurd to create C code from their IDL files. Mig is what helps us do RPC without ever knowing much about it.

    cd mig.build
    ../mig/configure --target=i686-pc-gnu --host=i686-pc-linux-gnu \
                     --prefix=/usr/local
    make
    make install (as root ...)
    cd ..

### <a name="Gnumach_Headers_inclusive_Mig"> Gnumach Headers inclusive Mig </a>

When you first compile the GNUmach headers Mig won't be mentioned (it wasn't installed actually) and this causes some errors when compiling the GNUmach headers but you need them to compile mig. (I do nt know if you have to do this but i think it is the better way)

    cd gnumach.build
    rm -r * (deletes every file and directory in this directory)

    ../gnumach/configure --build=i686-pc-linux-gnu --host=i686-pc-gnu
    make -k install-headers prefix=/usr/local/i686-pc-gnu (as root ...)
    cd ..

### <a name="Cross_GCC"> </a> Cross GCC

For the coexistence of EGCS and GCC you have to move the `/usr/local/bin/i686-pc-gnu-gcc` to the `/usr/local/bin` directory in `i686-pc-gnu-egcs`. So you can choose wich compiler you want use: with the `CC` environment variable set to `i686-pc-gnu-egcs` you can use EGCS without this command you use GCC.

    mv /usr/local/bin/i686-pc-gnu-gcc /usr/local/bin/i686-pc-gnu-egcs

    cd gcc.build
    ../gcc/configure --prefix=/usr/local --target=i686-pc-gnu --with-gnu-as --with-gnu-ld
    make -k compile the glibc-headers)
    sudo make -k install
    cd ..
    ln -s /usr/local/i686-pc-gnu/ /usr/local/lib/gcc-lib/i686-pc-gnu/2.95.2/i686-pc-gnu

You need `make -k` because otherwise it will fail but with -k you will have everything you need.

### <a name="Hurd_Headers"> Hurd Headers </a>

    cd hurd.build

    ../hurd/configure --build=i686-pc-linux-gnu -�host=i686-pc-gnu \
                      -�prefix=/usr/local/i686-pc- gnu --disable-profile
    make install-headers no_deps=t (as root ...)
    cd ..

### <a name="Cross_GLibC"> Cross GLibC </a>

For having glibc compiled with the cross-gcc and not with your original gcc you have to export another PATH. The normal user who configures and compiles and also root has to export this PATH.

    export PATH=/usr/local/bin:/usr/local/i686-pc-gnu/bin:$PATH

    cd glibc.build
    ../glibc/configure --without-cvs --enable-add-ons=crypt --disable-profile \
                       --build=i686-pc-linux-gnu --host=i686-pc-gnu           \
                       --prefix=/usr/local/i686-pc-gnu

AS ROOT WITH EXPORTED CFLAGS:

    export PATH=/usr/local/bin:/usr/local/i686-pc-gnu/bin:$PATH

    make -k install-headers install_root=/usr/local/i686-pc-gnu

    cp ../glibc/include/features.h /usr/local/i686-pc-gnu/include/features.h
    touch /usr/local/i686-pc-gnu/include/gnu/stubs.h
    cd ..

### <a name="Building_Cross_egcs"> Building Cross egcs </a>

    mv /usr/local/bin/i686-pc-gnu-gcc /usr/local/bin/i686-pc-gnu-foo (for protecting gcc)

    mv /usr/local/bin/i686-pc-gnu-egcs /usr/local/bin/i686-pc-gnu-gcc

    cd egcs.build
    make
    make install (as root, export CFLAGS and the NEW PATH)

    cd ..

    mv /usr/local/bin/i686-pc-gnu-gcc /usr/local/bin/i686-pc-gnu-egcs

    mv /usr/local/bin/i686-pc-gnu-foo /usr/local/bin/i686-pc-gnu-gcc

### <a name="Building_Cross_GCC"> </a> Building Cross GCC

    cd gcc.build

    make

    sudo make install

    cd ..

Remember to export CFLAGS and the new PATH

### <a name="Building_Cross_GLibC"> Building Cross GLibC </a>

    cd glibc.build

    make

    sudo make install root_install=/usr/local/i686-pc-gnu

Remember to export CFLAGS and the new PATH

For solving a glibc bug you have to link the `/usr/local/i686-pc-gnu/include/libc.so.0.2` with the `/usr/local/i686-pc-gnu/lib/libc.so` ever when you (re)install glibc.

    ln -sf /usr/local/i686-pc-gnu/lib/libc.so.0.2 /usr/local/i686-pc-gnu/lib/libc.so

### <a name="Install_the_GNUmach_kernel_somew"> </a> Install the GNUmach kernel somewhere

    rm -r gnumach.build

    mkdir gnumach.build

    cd gnumach.build

You will need more than the -�target and -�host variables to build the GNUmach kernel. You have to enable some kernel features with the --enable command to have your kernel working properly. To have a quick view of what you need you can edit the gnumach/i386/README-Drivers (I do not know how old it is, so maybe there are more options available but i haven't searched for more).

My configure command:

    ../gnumach/configure --build=i686-pc-linux-gnu --host=i686-pc-gnu �-enable-lpr \
                         --enable-floppy --enable-ide --enable-aic7xxx \
                         �-enable-rtl8139

    ln -s /usr/local/i686-pc-gnu/include /where/you/want/to/install/the/kernel/include

    ln -s /usr/locali686-pc-gnu/lib /where/you/want/to/install/the/kernel/lib

    make

    make install-kernel prefix=/where/you/want/to/install/the/kernel (as root ...)

### <a name="Hurd_Servers"> Hurd Servers </a>

rm -r hurd.build

mkdir hurd.build

cd hurd.build

nano -w/vi (or what editor you ever use) ../hurd/Makeconf

You have to comment out the CFLAGS in this file or delete the -std=gnu99 and the -03.

    ../hurd/configure �build=i686-pc-linux-gnu --host=i686-pc-gnu -�prefix=/where/you/want/to/install/the/kernel --disable-profile

    make -k

    make -k install prefix=/where/you/want/to/install/the/kernel

You have to use -k because when you don't use it the compilation will brake with an error. I tried different installations of gcc and glibc and too i used different versions of hurd but i cannot solve this prob so maybe it is hurd related.

So there is no warranty that the hurd kernel you compiled will work. I will try it and then update this guide.

----

## <a name="Document_History"> Document History </a>

Created from the original, <http://cvs.gentoo.org/~avenj/doc/xcompile-en.html>, by [Jon Portnoy](http://cvs.gentoo.org/~avenj/)

I would recommend not using EGCS, but instead using the GCC cross compiler. See [[Hurd/BuildingHurd]] and [[Mach/BuildingOskitMach]] for more information on building the GNU OS components. <br />-- [[Main/JoachimNilsson]] - 13 Apr 2003