Payload Delivery Vehicle - INSTALL
----------------------------------

Thanks to the powerful GNU configuration and build utilities
you should be able to use PDV on just about any UNIXish
platform.  If you have platform specific problems please write
me (gwiley@ieee.org) and I will do what I can to address them.
If you successfully overcome porting problems I would like to
know what you did so that I can incorporate the changes in
the distribution.

Contents
--------
Requirements
Building and Installing from Sources
Execution Tests
Installing Binaries
Uninstalling from Sources
Uninstalling Binary Packages


Requirements
------------
If you will be building the sources then you must have:

	gmake (GNU make)
	gcc

If you want the X11/Motif interface, then you will also need:

	X11 headers and libraries
	Motif/Lesstif 1.2 or better headers and libraries (libXm.so etc.)

In order to build the regression tests you will also need the Korn
shell (or pdksh, available in the path as ksh).

If you picked up a binary release, then you have everything you need
for the command line, for xmpdvmkpkg you will also need Motif shared
libraries (v. 1.2 or better).  I expect it will work fine with lesstif
as well.

	
Building and Installing from Sources
------------------------------------
To build and install PDV, you should be able to follow these steps:

	./configure
	make
	make install

Refer to the man page (pdv.1) and on-line help (pdvmkpkg -h) for
a detailed description of options and usage.

If you would prefer to not build the X utilities, then tell
configure:

	./configure --without-x
	make
	make install

If you want the X utilities, but configure can not seem to find
your libraries and headers, then you might try:

	./configure --x-libraries=DIR --x-includes=DIR

replacing DIR with the directory in which configure will find what
it needs (libXt, libXm etc.)

You may also need to add your X library directory to your library
search path, under most UNIXes the following works:

	LD_LIBRARY_PATH=$LD_LIBRARY_PATH:xdir

Replace 'xdir' with the directory that contains libXt*, libXm* etc.


Execution Tests
---------------
If you picked up the source distribution then you may want
to do a sanity check after building it.

A few test scripts (using ksh '88 or pdksh) are included in the 
test/ subdirectory.  If you want peace of mind that the program 
is likely to perform as described in the docs then you may want 
to run these tests.

Follow these steps after building pdv:

	cd test
	make

If you get messages indicating that a series of tests passed then
as far as I can tell things should work.  However, if you see any
message indicating failed tests then you should look at the
results file for the test (e.g. basic.results).  This file contains
the diffs between what should have been the output and what the
output actually was.  This can tell you whether the problem is
merely superficial (such as different message formatting).


Installing Binaries
-------------------
Binaries for some platforms are available for PDV, to install
the precompiled binaries follow these steps (the name of the
PDV package file may have changed depending on the version):

Linux i386 RPM:
	rpm -ivh pdv-1.2-1.i386.rpm

Solaris package:
	pkgadd -d ./pdv-1.2-SunOS_5.7_sparc-local

If you can't get the binaries to install then follow these steps
to manually install them:

1.copy pdv and pdvmkpkg to a directory in your path (/usr/local/bin)
2.copy pdv.1 to a likely place for man pages (/usr/local/man/man1)


Uninstalling from Sources
-------------------------
If you kept the source tree you can uninstall pdv by issuing
the following command in the build directory:

	make uninstall

If you did not keep the source tree you need to unarchive it
and issue the following commands:

	./configure
	make uninstall

This will also uninstall the X11/Motif utilities if you built
those to begin with.


Uninstalling Binary Packages
----------------------------
If you installed from a binary distribution then you will need to 
follow these steps depending on which one you are using:

Linux RPM:
	rpm -e pdv-1.2

Solaris package:
	pkgrm GSWpdv

---
$Id: INSTALL,v 1.7 2001/02/04 15:58:44 gwiley Exp $
