1.) Installation


Edit the file Makefile and configure the appropriate architecture and
the appropriate installation directory of the libraries and binaries.
For that purpose, you just have to choose one of the ARCH macros.
Change the value of the INSTALLDIR macro if necessary.  An
installation can either be done in one's home directory
(e.g. /home/lamberts/PFSLib_V2_0_SUN4) or in the system area
(e.g. /usr/local/PFSLib_V2_0_SUN4).

Depending on the compiler you want to use, you have to check the
compiler macro in the architecture makefiles, e.g. Makefile.SUN4.  
The current setting uses gcc on all architectures.  If you do not have
gcc you can use the vendor's compiler with the appropriate settings.

After all files have been edited and the macros have been set
correctly the final step of the installation is to compile and install
the libraries and binaries. This is done by a simple make.

# make

During that the installation directory gets populated with several
subdirectories and all necessary files to use PFSLib.


2.) Using PFSLib

A prerequisite to use PFSLib within an application for every user
is the following:

* Add the installations 'bin' directory to your path to have access to
  all PFSLib commands, e.g. PATH=$PATH:/home/lamberts/PFSLib_V1_0_SUN4/bin
  for sh or ksh.

* Make sure that the C preprocessor is able to find PFSLib's include
  files by adding the appropriate -I option to the preprocessor or
  compiler options (e.g. -I/usr/local/PFSLib_V1_0_SUN4/include).

* Make sure the linker is able to find the library libpfs.a by adding
  the appropriate -L option to the compiler or linker options
  (e.g. -L/usr/local/PFSLib_V1_0_SUN4/lib). 

* Link the library libpfs.a to the application by adding -lpfs to the
  compiler or linker options.

* Make sure a pfsd program is running on the machine specified in
  pfslib\_init().

See the Users' Guide for more.

##############################################################################
#                                                                            #
#  RCS Filename : INSTALL,v
#  RCS Date     : 1996/12/27 16:06:18
#  RCS Revision : 1.1
#  RCS Author   : lamberts
#  RCS State    : V2_0_B
#                                                                            #
#  Authors: Stefan Lamberts                                                  #
#                                                                            #
##############################################################################

