------------------------------------------------------------------------
This directory contains the Tape/Pvm event tracing tool developed and
             maintained at LMC-IMAG, Grenoble, France
------------------------------------------------------------------------

FILES
-----

ReadMe            : this file
manual-tape.ps.gz : gzip'ed PostScript of the Tape/Pvm User Manual
tape.tgz          : gzip'ed tar of the Tape/Pvm Source tree
                    contains instructions on setting up, building and
                    installing the distribution
tape0.9.plx.tgz   : patched versions of the initial distribution tape.tgz
patchXX.tgz       : patch number XX
SampleTraces      : directory containing a collection of sample traces
                    from various PVM applications (TAPE and PICL format)

PATCH HISTORY
-------------

tape0.9pl8.tgz	01/07/96

Tape/Pvm now measures the overhead inferred each time an event
is traced. Events now contain a new field (alpha) containing
the overhead (in mus). This information is used by the intrusion
compensation tool "tico". Caution: trace format has changed !

tape0.9pl7.tgz	11/15/95

Suppressed clock synchro tasks - clock synchro is now
done using successive calls to pvm_hostsync. User interface
to Tape/Pvm is not changed.

patch04.tgz	7/03/95

- tape2npicl checks version of the tracefiles it processes
- tape2npicl can read user supplied config files which control
  the way in which picl nodes are assigned to PVM tids (manual
  addendum)
- tapereader now supports Athapascan events

patch03.tgz     6/19/95 

- Support for pvm_precv,psend and group operations
  pvm_reduce,scatter and gather. These can now be
  visualized in PG (with t2np).
- Fixed bug in event buffer flushing which only
  occurred when more than one task is running on
  processors.
- Minor bug fixes in tapepp

patch02.tgz     5/25/95 

- Support for pvm_trecv

patch01.tgz	5/16/95	

- t2np now supports pvm_nrecv



ABOUT PATCHES
-------------

Patches are named patchXX.tgz where XX is the number of the patch.
To apply a patch to your TAPE/PVM distribution, unpack the patch
in the _root_ of your distribution's source tree:

  cd pvmtape
  gzip -dc patchXX.tgz | tar xf -

This will give you 3 files: noteXX.txt (what the patch is about),
patchXX (the actual patch file) and patchXX.sh (shell script
which applies the patch to the source tree).

Execute patchXX.sh to apply the patch to the source tree. Recompile
the distribution (make). Install the new distribution (make install).

IMPORTANT: patches have to be applied to your source tree in the correct
order. If you apply a patch out of order (e.g. you do patch02.sh before
patch01.sh) patchXX.sh will complain about this.

COMMENTS TO
-----------

Eric.Maillet@imag.fr