<!doctype html public "-//w3c//dtd html 3.2//en">
<HTML>
<HEAD>
	<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
	<META NAME="generator"   CONTENT="hand crafted">
	<META NAME="Author"      CONTENT="kio@little-bat.de">
	<META NAME="KeyWords"    CONTENT="dispatcher MacOS realtime thread task semaphor interrupt irpt twsp tid kio">
	<META NAME="Description" CONTENT="A priority-driven, fast thread library for MacOS.">
	<TITLE>Kio's Thread Dispatcher - Documentation</TITLE>

	<link rel=stylesheet type="text/css" href="def.css">

	<script language="JavaScript">
	<!--
	if(top.frames.length==0) top.location.href="index.html";
	// -->
	</script>
</HEAD>


<BODY background="hdgr.jpg" bgcolor="#CCCCCC" text="#000000" link="#660000" vlink="#660000" alink="#FF0000">



<a name="title"></a>

<h1 align=center><font color="#660000"><u>KIO's Thread Dispatcher - Documentation</u></font></h1>

<h3 align=center><font color="#660000">Version 1.0.0; C++ for MacOS</font></h3>

<p align=center><I class=big>27.Dec.2000 KIO !</I>



<p>&nbsp;
<table border=1 align=center>
	<tr><td width=300>
	<p class=small align=center>
	This documentation complies with <b>ISO&nbsp;8879</b> HTML&nbsp;4.0&nbsp;Standard and is
	best viewed with any non-broken browser.
	<p class=small align=center>
	If you feel that it does not look good on your browser, write to your browser's manufacturer 
	and complain about it.
	</td></tr>
</table>



<p>&nbsp;
<a name="copyright"></a>
<h3 align=center><U>Copyright</U></h3>

<p class=big align=center>
Copyright &copy; 1990-2000 G&uuml;nter Woigk (kio !)
<br>
email: <a class=big href="mailto:kio@little-bat.de">kio@little-bat.de</a>
<br>
homepage: <a class=big href="http://little-bat.de/prog.html">little-bat.de</a>


<p>&nbsp;
<a name="disclaimer"></a>
<h3 align=center><U>Disclaimer of Warranties</U></h3>

<p class=big>
 	This program is distributed in the hope that it will be useful,
 	but WITHOUT ANY WARRANTY; without even the implied warranty of
 	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  

<p class=big>
 	THE COPYRIGHT HOLDER DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
 	INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
 	EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY SPECIAL, INDIRECT OR
 	CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
 	DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 	TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 	PERFORMANCE OF THIS SOFTWARE.



<p>&nbsp;
<a name="permissions"></a>
<h3 align=center><U>Permissions</U></h3>

<p class=big>
 	Permission to use, copy, modify, distribute, and sell this software and
 	its documentation for any purpose is hereby granted without fee, provided
 	that the above copyright notice appear in all copies and that both that
 	copyright notice and this permission notice appear in supporting
 	documentation, and that the name of the copyright holder not be used
 	in advertising or publicity pertaining to distribution of the software
 	without specific, written prior permission.  The copyright holder makes no
 	representations about the suitability of this software for any purpose.
 	It is provided "as is" without express or implied warranty.








<a name="files"></a>
<h3>Files</h3>

<table border=0 cellspacing=0 cellpadding=0>
	<tr valign=top><td>disp.h			 <td>central definitions; this file must be included in your project files
	<tr valign=top><td>sema.h			 <td>class Sema; 		included in disp.h	
	<tr valign=top><td>irpt.h			 <td>class Irpt; 		included in disp.h
	<tr valign=top><td>twsp.h			 <td>class Twsp; 		included in disp.h
	<tr valign=top><td>disp.cp			 <td>central implementations; this file must be included in your project
	<tr valign=top><td>sema.cp			 <td>class Sema; 		included in disp.cp
	<tr valign=top><td>irpt.cp			 <td>class Irpt; 		included in disp.cp
	<tr valign=top><td>twsp.cp			 <td>class Twsp; 		included in disp.cp
	<tr valign=top><td>disp.ticker.cp	 <td>timer interrupt;	included in disp.cp
	<tr valign=top><td>disp.registers.cp <td>context switching;	included in disp.cp 
</table>





<a name="thanks"></a>
<h3>Thanks</h3>

<p>
I'd like to thank Ari Halberstadt for publishing the source of his threads library and for fiddling out the system globals which required special care in the 68k environment. Without this knowledge i'd probably never succeeded in implementing my version of a threads lib.



<a name="base"></a>
<h3>Based work</h3>

<table><tr><td>
	The FORCE Project for Atart ST		
	<ul>
		<li>	(c) copyright 1991-1992	kio
		<li>	68000 assember coded realtime multitasking environment
	</ul>
	</td></tr>
	
	<tr><td>
	The FORCE Project for MacOS		
	<ul>
		<li>	(c) copyright 1994-1997	kio
		<li>	C coded VIP engine (virtual instruction processor)
		<li>	dispatcher based on the Atari version
	</ul>
	</td></tr>
	
	<tr><td>
	ThreadLibrary 1.3 on MacOS
	<ul>
		<li>	(c) Copyright 1994  Ari Halberstadt
		<li>	as an example of implementation
	</ul>
	</td></tr>
</table>



<a name="history"></a>
<h3>Version history</h3>

<table border=0 cellspacing=0 cellpadding=0>
	<tr valign=top><td>20.jul.1998	<td>started work on this version 
	<tr valign=top><td>06.oct.1999	<td>'classified' Twsp, Sema, Irpt
	<tr valign=top><td>16.mai.1999	<td>first major effort to work around osEvt problem purged by WaitNextEvent() 
					  					using EventAvail(): did not work.
	<tr valign=top><td>03.dec.2000	<td>second major effort to work around osEvt problem using idleIrpt and idleFlag
	<tr valign=top><td>18.dec.2000	<td>fixed buggy timeout handling in semaphors, reworked asynchronous interrupts, 
					  					added boost blocking owner of semaphors
	<tr valign=top><td>22.dec.2000	<td>wrote documentation. HTML sucks.
	<tr valign=top><td>24.dec.2000	<td>released version 1.0.0 to the public...
</table>





<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;
<p>&nbsp;











