XtratuM Installation Documentation
----------------------------------

In order to install XtratuM follow next steps:

INSTALLING LINUX PATCHED WITH THE XTRATUM PATCH

1) Download an  adequate version of  the Vanilla Linux  Kernel from:
   http://www.kernel.org. An  suitable version means that  you can only
   use the kernel version for which XtratuM provides a patch.

2) Untar the  kernel, depending if you  have download the  tbz2 or tgz
   package you  have to  use "tar -xjvf"  or "tar -xzvf"  command. Any
   place where you have read/write permissions is ok

3) Patch the kernel with the suitable patch (all XtratuM patches are
   located in  the XtratuM's  patch directory). It  is done  using the
   "patch -p0 < <XtratuM_patch>" command, where <XtratuM_patch> is the 
   patch which you are going to use.

4) Compile the kernel (remind not to enable smp support) following the
   kernel installation instructions.

5) Restart the machine with this new kernel.

INSTALLING XTRATUM

6) Edit the file Rules.mk changing the LINUX_DIR and CDIR variable with
   the suitable value.  In fact CDIR must contain  the directory where
   XtratuM has been uncompressed and LINUX_DIR must contain the directory
   where the Linux source code is.

7) Compile XtratuM, it is simple, just type "make" in the XtratuM directory.

8) To execute XtratuM you have to insert it as Linux Kernel module, that is,
   "insmod XtratuM.o"

Recall that to carry out step 8 you need root permissions

TESTING AN EXAMPLE

Now you can test the correct working of XtratuM inserting any example.

1) Go to the example directory and choose an example

2) Compile the selected example (with "make")

3) Insert the example (insmod example.o)

4) Check the output (dmesg)

5) Remove the example (rmmod example)