RTLGNAT version 0.1

Copyright (c) OCERA Consortium. Dec, 2002.

Please, read the license terms and conditions in the accompanying
file: COPYRIGHT

Requirements (please, see the README if you need more details):
   1. Linux with the BigphysArea patch
   2. RTLinux and sources
   3. GNAT 3.14

Before starting the RTLGNAT installation, please ensure that the GNAT
compiler is correctly installed. Most Linux distributions include the
GNAT compiler as an optional package located in the development
section.

If you have RTLinux 3.1 already installed then skip steps 1-8.

1.- Unpack the linux (2.4.18 or later) source tarball

2.- Apply the BigphysArea patch to the Linux sources.  The patch is
available at http://www.polyware.nl/~middelink/En/hob-v4l.html

3.- Apply the RTLinux patch to the Linux source code.  Available at
http://www.rtlinux-gpl.org or http://www.rtlinux.org

4.- Configure the linux kernel (remember to select the Bigphysarea
functionality). 

5.- Compile the Linux kernel (make dep; make clean; make ....)

6.- Configure and compile the RTLinux code.

7.- Add the following line to the /etc/lilo.conf file, and run lilo.
    append="bigphysarea=1024"

8.- Reboot your computer with the new kernel.

9.- Unpack the RTLGNAT tarball in the directory of your choice. For
example at /usr/src. This will create the directory
/usr/src/RTLGNAT-3.14.

10.- Compile RTLGNAT by running "make" from the /usr/src/RTLGNAT-3.14
directory.

11.- Now you may compile the examples: make examples



How to compile and run your own Ada applications
================================================

The compilation process will create the "rtgnatmake" script in the
utils/ directory. This script is the equivalent to "gnatmake" in GNAT.

To be able to run rtgnatmake you need to add to the utils/ directory
to the PATH environment variable. Supposing RTLGNAT was unpacked in
/usr/src/, you should add /usr/src/RTLGNAT-3.14/utils to the PATH
variable.

RTLGNAT is still in alpha phase, some parts of the runtime has not
ported to RTLinux. Also, some files of the runtime has been ported but
not compiled, in this case when you try to compile your program you
can get a error like this:

gnatbind: Cannot find: s-stalib.ali
gnatmake: *** bind failed.

In this case, you can force gnatmake to recompile any required
standard package by calling rtgnatmake with the "-a" flag.

Once you have created your application object module (e.g. my_app.o)
RTLinux needs to be loaded in order to run your application: 
# rtlinux start

Now you should start up your application by doing:
# insmod my_app.o

To remove or stop your running application then just rmmod the module.

Enjoy.