** ---------------------------------------------------------------

 ** RTL-POSIXTRACE 1.0 package

 ** INSTALL 

 ** (c) 2002 Andres Terrasa (DSIC-UPV)

 **

 ** ---------------------------------------------------------------



 This file explains how to install the package RTL-POSIXTRACE (RTL-PT)
1.0. For any other information about this packages, see the README
file.


 Please follow the steps below:


1) The first thing you need is a clean Open RT-Linux 3.1 distribution.

 If you don't have this RT-Linux distribution, you can freely download
it from the FSMLabs ftp site (ftp.fsmlabs.com). Then go to step (2).

 If you already have a *working* version of RT-Linux 3.1, go to the
distribution's main directory and type "make distclean". This will
erase all the installation and object files, effectively making the
RT-Linux distribution completely clean. Then, skip until step (3).
(If you computer has different working versions of RT-Linux, please
refer to the NOTE at the end of this file).



2) Unpack RT-Linux distribution into "/usr/src/rtlinux-3.1", for
example. Follow the RT-Linux installation instructions (in
"Installation.txt" file), but *only* from step 1 to 8 (inclusive).

 In short, these steps explain how to patch the appropriate Linux
kernel, recompile it, install it and boot with it.



3) Patch the clean Open RT-Linux 3.1 distribution with the RTL-PT 1.0
patch (rtl3.1-posixtrace.patch). To do so, go to the distribution main
directory and type:

    $ patch -p1 < ../rtl3.1-posixtrace.patch

(assuming that the patch file is in the distribution's parent
directory).



4) Configure the patched RT-Linux:

    $ make xconfig

 (*** IMPORTANT: Please make sure you select, inside the Support
                 Options, the "POSIX tracing support" option. ***)



5) Compile RT-Linux:
	
    $ make
    $ make devices
    $ make install



6) That's all. You can go to the "examples/posixtrace" subdirectories
and type "make test" in order to run the examples. If the examples
work, this should be enough to check that everything is going fine.






** ----------

 NOTE for systems containing multiple versions of RT-Linux:
 =========================================================

 I've experienced some problems in the installation of this package
when the computer had installed different versions of RT-Linux. In
particular, I installed versions 3.0 and 3.1 (with RTL-POSIXTRACE) and
then RT-Linux got mixed up with the kernel modules of both versions.

 If this is your case, I recommend you to uninstall any version
different than Open RT-Linux 3.1 before patching the distribution
(step 3).  Please note that, if you have version 3.0 (for example), it
may be necessary to manually delete the "/usr/rtlinux-3.0" directory
and the links to its modules in the "/lib/modules/(kernel)/misc"
directory.