	Real-Time Linux upgrading notes
	(C) 1999 Michael Barabanov (baraban@fsmlabs.com)


This information is for people upgrading from previous versions
(1.3 and earlier) of Real-Time Linux.

Real-Time Linux versions 2.x provide a new API that is aiming
to POSIX compliance. This has many nice implications, so
you are encouraged to update your programs to use the new interface.

To get started, please read the GettingStarted.txt file.
There are manual pages for all API functions in the man/ directory.

Here's a very rough description of how the old RT-task API maps to the new 
pthread-based one.

Old API				New API

rt_get_time			gethrtime(3), clock_gettime(3)
rt_task_init			pthread_create(3)
rt_task_delete			pthread_delete_np (3)
rt_task_make_periodic		pthread_make_periodic_np (3)
rt_task_wait			pthread_wait_np(3)
request_RTirq			rtl_request_irq(3), rtl_hard_enable_irq(3)
free_RTirq			rtl_free_irq(3)

NOTES
1. Unlike rt_task_init, pthread_create starts the task immediately
2. With rtl_request_irq(3), hardware interrupts must be explicitely
enabled with rtl_hard_enable_irq(3).

The old API is also supported in RTL v2.x. It is implemented
on top of the current API (include/rtl_compat.h, schedulers/rtl_compat.c).

To use RTL v1.x API, you need to uncomment the CONFIG_RTL_USE_V1_API option in
the include/rtl.h file and recompile the RTL system.

Please direct comments and suggestions about this file to
Michael Barabanov <baraban@fsmlabs.com>

