PPCR README
Copyright (c) 1994 Xerox Corporation.  All rights reserved.

Alan Demers, Hans Boehm and Carl Hauser
Xerox Palo Alto Research Center
3333 Coyote Hill Road
Palo Alto, CA 94304 USA

email: pcrcoordinator@parc.xerox.com

September 13, 1994

Abstract: The Posix Portable Common Runtime (PPCR) provides integrated
user-level support for pre-emptive lightweight threads, garbage
collected storage, and dynamic programming loading.  It should run on
any POSIX.1-conforming implementation that also supports BSD select()
or System V poll().  PPCR can take advantage of kernel thread
extensions of the underlying system, such as the LWP facility of
Solaris 2.3 and the sproc facility of Irix 5, to achieve true
concurrent execution by its threads on multiprocessors.  It also uses
memory protection features available in some systems (e.g. mprotect())
to support incremental garbage collection.  

PPCR has been successfully built for SunOS 4.1.3 (aka Solaris 1.1),
SunOS 5.3 (aka Solaris 2.3), Irix 5, Linux 1.0 and BSDI.  We would be
interested in hearing of others' experience in porting it to
additional platforms.

Acquiring PPCR

  PPCR is available in ftp://parcftp.xerox.com/pub/ppcr/v1.20/ppcr.v1.20.tar.Z, a
  compressed tarfile.  cd to the directory where you will expand it and
  type
  
    zcat ppcr.v1.20.tar.Z | tar xf -
    
  This will create a v1.20/ subtree rooted in the current working
  directory, with subdirectories source/ and template/.

  v1.20/source/README contains the remainder of the instructions for
  installing PPCR on your system.

  v1.20/source/PCRDoc.txt describes the interfaces and naming
  conventions used in PPCR (notice our tendency to sometimes leave out
  the first "P" in "PPCR".