1 files changed, 79 insertions, 0 deletions
diff --git a/Mach/BuildingOskitMach.mdwn b/Mach/BuildingOskitMach.mdwn
new file mode 100644
index 00000000..a6893fc4
--- /dev/null
+++ b/Mach/BuildingOskitMach.mdwn
@@ -0,0 +1,79 @@
+%TOC%
+
+This is a brief Building OSKit Mach HowTO. It covers evrything from getting the latest sources of both the \[[http://www.cs.utah.edu/flux/oskit/]\[OSKit] and the OSKit branch of the GNUmach kernel. Down to building and debugging them.
+
+## <a name="Getting_your_hands_on_the_source"> Getting your hands on the source </a>
+
+First you need to checkout the relevant sources.
+
+### <a name="Accessing_the_FLUX_groups_CVS_or"> </a> Accessing the FLUX groups CVS, or FTP
+
+You can use either the bleeding edge OSKit from CVS, or the latest public release. The latter is preferrable!
+
+CVS:
+
+      CVSROOT=":pserver:anoncvs@leak.cs.utah.edu:/cvs"
+      CVS_RSH=ssh
+      cvs -z3 co oskit
+
+St. Patricks day 2002 release: <ftp://flux.cs.utah.edu/flux/oskit/oskit-20020317.tar.gz>
+
+Valentine's day 2001 release: <ftp://flux.cs.utah.edu/flux/oskit/oskit-20010214.tar.gz>
+
+### <a name="Accessing_GNU_CVS"> </a> Accessing GNU CVS
+
+Setup your environment with the CVSROOT variable and checkout the oskit-branch of the gnumach kernel.
+
+      CVSROOT=":pserver:anoncvs@anoncvs.gnu.org:/cvsroot/hurd"
+      cvs -z3 co -r oskit-branch -d oskit-mach gnumach
+
+## <a name="Building"> Building </a>
+
+### <a name="OSKit"> </a> OSKit
+
+The attached [[ATTACHURLmodulesx86pc]] file is my personal setup, it works for me. Now, how to configure and build the OSKit.
+
+Configuring:
+
+    # cd oskit-20020317/
+    # mkdir build
+    # cd build
+    # ../configure --prefix=/usr/local --enable-debug
+
+Building:
+
+    # make
+    # sudo make install
+
+### <a name="OSKit_Mach"> </a> OSKit Mach
+
+To build any Mach kernel you need an interface generator, a mig. If your host system is Debian based you can get the "Cheap cross-compuler for GNU/Hurd" with a simple:
+
+    $ apt-get gcc-i386-gnu
+
+This will install the i386-gnu-mig in /usr/bin for you.
+
+Configuring:
+
+    # cd oskit-mach
+    # mkdir build
+    # cd build
+    # CFLAGS="-g" MIG=i386-gnu-mig OSKIT_LIBDIR=/usr/local/lib/oskit ../configure --prefix=/gnu --enable-debug
+
+Building:
+
+    # make
+    # sudo make install
+    # sudo gzip /gnu/boot/oskit-mach
+
+## <a name="Debugging"> Debugging </a>
+
+For now, see the [[RemoteDebugOskitMach]] page.
+
+# <a name="Attachments"> Attachments </a>
+
+* [[ATTACHURLmodulesx86pc]]: Modules to build in OSKit
+
+----
+
+-- [[Main/JoachimNilsson]] - 14 May 2002