Welcome to KallistiOS! If this documentation looks familiar to users of libdream, that's because it is - this is basically a ``port'' of the documentation, with new sections added as neccessary, and other sections modified. You'll find some entire sections marked ``UNPORTED FROM LIBDREAM'' and these haven't been updated to KOS yet. Some other sections are simply unfinished as yet. Bear with us here, this is a lot of documentation to write.
The following is copied from the README file:
KallistiOS is a pseudo-real-time operating system for gaming consoles, licensed under the terms of the new BSD license (the one without the advertising clause). It has currently been ported to the Dreamcast (tm) and Gameboy Advance (tm) platforms.
Depending on whether you wish to see the fnords, you can pronounce it ``kallisti-o's'' (like a cereal) or ``kallisti o s'' (like an operating system). We like the former since it's silly to be so serious most of the time =). ``Kallisti'' means ``to the fairest'' in Greek. This was the word (so the story goes) that was inscribed on the golden apple that Eris threw into the banquet of the gods to start the Trojan war. This somehow landed her the title of matriarch of a silly religion called Discordianism, which is what the name pays homage to. If you want a short abbreviation, you can also refer to it as ``KOS'', which can be pronounced ``k-os'' (chaos =) or just plain old ``k-o-s''.
Note that this name is not to be confused or associated with either the professional development company Kalisto Software(tm) or the cracking group ``Kalisto''.
Now that that is cleared up... =)
Like most embedded kernels, KallistiOS is designed to be linked directly into a program. Unlike some simple libraries, however, KallistiOS (abbreviated elsewhere as KOS) also includes a full thread scheduler, virtual file system, etc. The only real difference is that your program is linked directly into the kernel instead of being run in a ``userland'' state.
Note that the only active port of KOS is for the Dreamcast(tm), so the rest of this document will refer to that port unless otherwise stated.