These documents were copied  from /afs/ri.osf.org/project/mach3/doc
on Feb 25, 1992

The Open Software Foundation Mach 3 series of books provides the
necessary information so that system programmers can develop servers
for the Mach 3 microkernel environment. Assuming an understanding of
operating systems programming in general, and an understanding of the
client-server model of system construction as well as the microkernel
system concept, the Mach 3 series provides the information necessary
to understand the Mach 3 microkernel, to be able to program to its
interfaces, and to be able to develop server programs and specify
their interfaces to be used in a client-server environment.

The volumes of the Mach 3 series are:
	Mach 3 Kernel Principles
	Mach 3 Kernel Interfaces
	Mach 3 Server Writer's Guide
	Mach 3 Server Writer's Interfaces
These documents describe release MK67 of the microkernel, and release
11 of the user libraries.
 
The Mach 3 Kernel Principles volume provides an informal description
of the Mach 3 microkernel: its concepts, features and an overview of
the various kernel interfaces. The volume explains the various objects
and abstractions implemented by the kernel, as well as their
interrelationships, both in text and through a series of detailed
figures. When appropriate, state diagrams are used to explain kernel
operation. (60 pages)

The Mach 3 Kernel Interfaces volume documents every interface to the
Mach 3 microkernel in man-page style, describing the purpose of the
interface, the function it performs, the various parameters and return
values and other information necessary to be able to use the
interface. The volume also describes all kernel-initiated interactions
with user code, such as external memory management requests. (328
pages, with index)

The Mach 3 Server Writer's Guide provides information of interest to
anyone who wishes to write, or to understand, a Mach 3-based server.
The way in which a server processes requests, how it interfaces to
Mach's inter-process communication (IPC) service, and how a
multi-threaded (parallel) server uses Mach facilities to maintain
consistency are discussed through text and example code. The volume
includes a description of the way in which the interface to a server
is described to the interface generation tool (MIG) and how the
C-threads multi-threaded support library is used. The development of
external memory managers, one of Mach's most novel features, is
described, also through text and example code. (136 pages)

The Mach 3 Server Writer's Interfaces volume provides the
documentation for the various user-space library routines supplied
with the Mach 3 microkernel, in man-page style, for use in building
server programs. The volume describes the C-threads package used to
support multi-threaded programs, the interfaces to the system name
service, as well as other support services. (94 pages, with index)

These documents are available in PostScript form, each contained in
its own file. These files are:

	kernel_principles.ps
	kernel_interface.ps
	server_writer.ps
	server_interface.ps