Bootstrapping With Magma In 7 Steps

Bootstrapping with magma in 7 steps: a quick showcase for the impatient.

1. patch and build a vanilla Linux kernel tree with the RTAI support as
   usual. Patches for x86 are available from
   rtai-m1/rtai-core/arch/i386/patches/. Apply only one of them
   that matches the Linux kernel version (either rthal or adeos).
2. $ mkdir <your_build_dir> && cd <your_build_dir>
3. $ make -f ../rtai-m1/makefile srctree=../rtai-m1 menuconfig
4. a GUI should pop up, allowing you to configure RTAI:
        o default settings should be ok for most platforms
        o in the "General" section, set your site values for the RTAI
        installation directory (defaults to /usr/realtime) and
        Linux kernel tree (defaults to /usr/src/linux).
        o save and exit.
--
At this point, you should see the typical output of a GNU configure
script. Your RTAI settings are being used to setup the
autoconf/automake-based build system.
--
5. $ make install
--
RTAI will be compiled then installed under the directory you specified
at configuration time (ensure that your shell can write to the
destination directory).
Note #1 -- Automake's output is utterly verbose.
Note #2 -- This is expected to be fixed in the next Automake release.
Note #3 -- Automake's output is somewhat brain-damage.
Note #4 -- Yeah, we know. See #2.
--
6. $ cd <your_RTAI_install_dir>/testsuite/kern/latency
7. $ ../../../bin/rtai_load
--
If "sudo" is installed on your box, the application loader script
(rtai_load) will attempt to use it for running privileged commands
(e.g. insmod, rmmod et al.) If sudo is not available, just "su"
manually before running the script. You should then see the typical
output of the latency calibration program running in kernel space.
Hit ^C to stop it.