-*-text-*-
This is Prospero release Beta.5.1

INTRODUCTION

This is a special release intended for use by an anonymous FTP archive
site.  It contains only the parts of Prospero needed by an archive
site that just wants to make information about its anonymous FTP area
available through Prospero.  If you want the full current Prospero
release, retrieve pub/prospero/propero.tar.Z from PROSPERO.ISI.EDU.

This file, README, contains some simplified release notes and the
directions for compiling the server.

You must compile this release using ANSI C, since it makes use of the
ANSI C variable-length argument list facilities and of the ANSI
prototypes.  A future release may be compilable under both ANSI and
traditional C, using a conversion program.  If you feel like modifying
the ansi2knr conversion program to perform such a conversion, we would
be delighted to hear from you.

SUPPORTED: This release has been tested on:

 Sun3s and Sun4s running SunOS version 4.1.1 -- No known problems

 HP 9000 series 700 workstations running HPUX version 8.0.5
        -- No known problems (for this release)

 MIPS little-endian processor running Ultrix Version 4.2A -- No known problems


INSTALLATION INSTRUCTIONS:

Instructions for installing the Prospero server at an anonymous FTP
archive site.

This distribution includes the source code for the Prospero server.
It also includes the clients 'pkl', which let you restart or kill the
server, and 'pstatus', which lets you check the status of the server.

You must edit the definition of P_DIRSRV_BINARY in include/pserver.h.  

The server is by default configured to start up as the user 'ftp' and
to publish information for the home directory of that user (which
should be the same as the root of your anonymous FTP area).  If you
wish the server to run under a different user ID, or if your Anonymous
FTP area has a different root, you'll need to look at the definitions
of PSRV_USER_ID, AFTPUSER, and AFTPDIRECTORY in include/pserver.h.

If the gethostbyname() system call on your computer does not return
the host's name as a fully qualified domain name, you must define
PSRV_HOSTNAME in include/pserver.h.

By default, this server is configured to log no information.  If you
wish to log information about requests made to the server, define
PSRV_LOGFILE in include/pserver.h.

IMPORTANT: IF YOU ENABLE LOGGING, PROSPERO WILL LOG LOTS OF
INFORMATION, INCLUDING THE NAMES OF CLIENTS AND THE SPECIFIC COMMANDS
ISSUED.  THIS INFORMATION SHOULD BE CONSIDERED SENSITIVE AND YOU MUST
PROTECT THE LOGFILE.

You should not need to set any other definitions in the pserver.h
file.

Next, edit include/pmachine.h.  This file defines some of the machine
and OS specific parameters needed by Prospero.  

Then edit the top level Makefile.  First set any machine-specific
parameters.  If you're installing the binaries under HP-UX or another
system which lacks a BSD-like INSTALL, redefine the INSTALL macro as
discussed in the Makefile.  If you're on an AIX system redefine the
MACHDEF macro as discussed in the Makefile.  If you're on a MIPS or
VAX ULTRIX system, you may also need to define the MACHDEF macro as
discussed in the Makefile.

Now set the following installation parameters in the top level
Makefile.  Set P_BINARIES to the directory in which the binaries are
to be installed.  OWNER and GROUP should be set to the intended owner
and group for the Pospero binaries.

This release must be compiled with an ANSI compiler; therefore, the
default is 'gcc'.  If you're using another compiler, you may want to
change the definitions of CC and CFLAGS.  We set CFLAGS to enable
debugging by default in order to facilitate bug reporting.  If you are
low on diskspace, you may want to redefine CFLAGS to turn off the
inclusion of debugging information in the executables, and you may
want to strip the resulting executables.

Next, move back to the top level directory for the distribution and
type 'make'.  Once the distribution has been successfully built, type
'make install'.  If you are running a previous release of Prospero,
rename P_BINARIES to P_BINARIES.old before you 'make install', and
keep P_BINARIES.old around for a while in case you need to revert to
the previous version of Prospero.

The program pstart figures out the appropriate arguments for the
server, sets its UID to that under which the server is to run, and
starts dirsrv.  By making pstart setuid and setgid to the ID under
which the server will run, any user will be able to start/restart the
server.  You should start the server whenever your system is booted.
pstart may be called from the system startup.  It will immediately set
its user and group IDs to that for the server.

Bug reports should be sent to:

  bug-prospero@isi.edu

Requests or queries about the release should be sent to:

  info-prospero@isi.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@isi.edu

Requests for addition or deletions should be sent to:

  prospero-request@isi.edu

If you are interested in the full Prospero release (with more
configuration options for the server and a full set of clients and
documentation), it can be retrieved by anonymous FTP from
PROSPERO.ISI.EDU as pub/prospero/prospero.tar.Z.

