$Id: README,v 1.2 1996/08/01 02:21:14 paul Exp $

This directory contains the sources for the initial version of the
software for analysis of interaction networks recorded by Solaris MINIX.

It contains various library files:

- logfiles.c, logfiles.h---functions for reading event records from
logfiles, and writing event records to logfiles.  Also functions for
returning an event's name and its type.

- IN.c, IN.h---main function is log_readIN, which reads an interaction
network into memory  from the specified file and returns a pointer
to the interaction network source vertex.  Also functions for use
in traversing the entire network, and freeing all of the memory
occupied by an interaction network.

- hsearch.c, hsearch.h---function library to support symbol tables based
on extensible hashing (keys are numeric).

- symlib.c, symlib.h---function library to support symbol tables based on
a fixed size hash table (keys are character strings).


Main programs:

logdump.c---provides a text dump of each event record in a specified
logfile.  Both "session" logfiles (those containing all events recorded
during a recording session) and "task" logfiles (each of which contains all
event records belonging to a single interaction network) can be dumped.

insplit.c---the name of a session logfile is given on the command line.
insplit extracts all interaction networks from the task logfile,
and places each in a file whose name is the sub-task number of
the source event.

totcl.c---the name of a task logfile is given on the command line.
totcl produces a file that can be read and displayed by browser.
if the -p option is given then "partial order" layout is used instead
of "time" layout.

browser---the name of a file produced by totcl is given on the command
line.  browser displays an interaction network, and allows the user to
browse around the file.

Disclaimer: the source files are all based on monitoring software
developed for Amoeba.  While the source code has been changed to 
allow for analysis of smx interaction networks, few (if any)
comments have been changed :-)


Performing logging:

To cause logging to be performed a "logfile" entry must appear in the
.minix file.  The name of the logfile is specified as the argument.
When smx is run, a session logfile with the specified name
is created.  Warning---these logfiles get big very quickly!
