The Flux Operating System Toolkit
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is the top level directory of the source distribution of the Flux
OS toolkit (or just "OS kit" for short).  The OS toolkit is a
framework and a set of modularized library code, together with
extensive documentation.  By providing in a modular way much of the
infrastructure "grunge" needed by an OS, the toolkit's goal is to make
the lives of OS developers easier when creating a new OS, porting an
existing OS to an architecture supported by the OS kit, or enhancing
an OS to support a wider range of devices, file system formats, or
executable formats.  The toolkit is also useful for constructing
OS-related programs, such as boot loaders or OS-level servers atop a
microkernel.

Detailed instructions on how to install and use the Flux OS toolkit
are contained in the `doc' subdirectory.  A text file version of the
document is available in doc/oskit.txt, a PostScript version is in
doc/oskit.ps, and the original LaTeX source is in doc/*.tex.
Since the document is currently over 300 pages, with a lot of white space,
we also provide a two-up PostScript version in doc/oskit.2up.ps and a
version with changebars in ch-oskit.ps (also ch-oskit.2up.ps.)

For a list of changes since the last release, see the ANNOUNCE file.

Send comments, suggestions, bugs, and fixes to oskit-users@cs.utah.edu.

To be added to appropriate mailing lists, send mail to:
  oskit-users-request@cs.utah.edu		(oskit users/hackers)
  oskit-announce-request@cs.utah.edu		(major announcements only)
You do not have to be on both lists at once, mail to the announce list
goes to the users list (but not vice versa, of course.)

Archives of the mailing lists are available in
  ftp://flux.cs.utah.edu/flux/oskit/mail/html/index.html	(HTML)
  ftp://flux.cs.utah.edu/flux/oskit/mail/index.html		(mbox)

The Flux Project
University of Utah
http://www.cs.utah.edu/projects/flux/
