Instructions for installing the Prospero applications

This distribution includes the source code for the Prospero applications.

Select a directory in which the Prospero binaries will be installed.
The path of this directory will be compiled into some of the programs.

To tailor the applications to your systems's configuration, edit the
file include/psite.h (this has changed slightly since the last
release).  The only definitions that will be applicable to you are
those that precede section 1, and those in section 2.  In fact, if you
will be using the default site for the storage of virtual systems
(which is likely to be the case if you retrieved the client only
distribution), there should be no changes in section 2 either.  

Next, edit pmachine.h.  This file defines some of the machine and OS
specific parameters needed by Prospero.  Make sure that you have
replaced the top level Maklefile by Makefile_u.  Finally, edit the top
level makefile.  Set INSTDIR to the directory in which the binaries
are to be installed.  ONWNER and GROUP should be set to the intended
owner and group for the Pospero binaries. 

If you will be building the PFS compatibility library (which redefines
open and several other library functions), some systems will require a
change to the SC_REDEF variable definition in app/Makefile.  If you do
not want to build the compatibility library, replace lib/pcompat/Makefile
with Makefile.nopcompat, replace app/Makefile with Makefile.nopcompat,
and make sure the P_NO_PCOMPAT is defined in include/psite.h.

Next, move back to the top level directory for the distribution and
type 'make', and once the distribution has been successfully built
type 'make install'. 

The directory app contains the code for versions of cat and ls which
may be linked with the compatability library.  Other programs may also
be linked with the compatability library, but filenames hardcoded into
those programs (or the libraries they call) might be resolved using
Prospero, causing unexpected behavior if those names do not identify
the same files in the active virtual system.

The directory "doc" contains the source to a manual on using the
Prospero file system.  The file "getting-started.txt" in that directory
contains enough information to get started.  The file ".virt-sys" contains
a reference to a guest virtual system at the University of Washington.
This may be copied to your home directory.  If you would like your own
virtual system contact pfs-administrator@cs.washington.edu.

Bug reports should be sent to:

  bug-prospero@cs.washington.edu

Requests or queries about the release should be sent to:

  info-prospero@cs.washington.edu

Requests for creation of virtual system stored at the University of
Washington site, or requests to establish one's own Prospero site
should be sent to:

  pfs-administrator@cs.washington.edu

A public mailing list has been set up for discussion of Prospero.
Among other things, this list can be used to announce directories of
information that users have created and wish to share.  The name of
the list is:

  prospero@cs.washington.edu

Requests for addition or deletions should be sent to:

  prospero-request@cs.washington.edu

