Proteus-format Event-Generation Library
Copyright 1992
Eric A. Brewer
Laboratory for Computer Science
Massachusetts Institute of Technology

This is the source code for the event-generation library associated with
the Proteus parallel-architecture simulator, designed and developed by
Eric A. Brewer and Chrysanthos N. Dellarocas.

The interface procedures are documented in event.c and event.h.
Example code (and the test code) is in libtest.c, which generates a
trace file named test.sim. The trace file should be displayed with
stats, Proteus' graph-generation program, using "stats -f test.sim".
If stats can read and display test.sim, then the library is fine.

To build the library, just type make.  The default compiler is gcc, but any
ANSI C compiler should work fine.  On the Suns, there are warnings about 
some of the stdio.h procedures, but no errors.

The file format.ps.Z is a compressed PostScript file that specifies the
trace-file format.  It provided primarily for people interested in either
generating files without this library or building additional tools that
take these files as input.  (There is an official way to extend the format
without forfeiting stats ability to read them.)

The files doc5*.ps.Z are compressed PostScript files that constitute the
fifth chapter of the Proteus user documentation.  This chapter covers
how to do data collection and display in Proteus;  it thus implicitly covers
how to use the procedures in this library.  It also discusses stats and
graph-specification files.

Eric Brewer
October 15, 1992


