1 $Id: README,v 1.2 1996/08/01 02:21:14 paul Exp $
2
3 This directory contains the sources for the initial version of the
4 software for analysis of interaction networks recorded by Solaris MINIX.
5
6 It contains various library files:
7
8 - logfiles.c, logfiles.h---functions for reading event records from
9 logfiles, and writing event records to logfiles. Also functions for
10 returning an event's name and its type.
11
12 - IN.c, IN.h---main function is log_readIN, which reads an interaction
13 network into memory from the specified file and returns a pointer
14 to the interaction network source vertex. Also functions for use
15 in traversing the entire network, and freeing all of the memory
16 occupied by an interaction network.
17
18 - hsearch.c, hsearch.h---function library to support symbol tables based
19 on extensible hashing (keys are numeric).
20
21 - symlib.c, symlib.h---function library to support symbol tables based on
22 a fixed size hash table (keys are character strings).
23
24
25 Main programs:
26
27 logdump.c---provides a text dump of each event record in a specified
28 logfile. Both "session" logfiles (those containing all events recorded
29 during a recording session) and "task" logfiles (each of which contains all
30 event records belonging to a single interaction network) can be dumped.
31
32 insplit.c---the name of a session logfile is given on the command line.
33 insplit extracts all interaction networks from the task logfile,
34 and places each in a file whose name is the sub-task number of
35 the source event.
36
37 totcl.c---the name of a task logfile is given on the command line.
38 totcl produces a file that can be read and displayed by browser.
39 if the -p option is given then "partial order" layout is used instead
40 of "time" layout.
41
42 browser---the name of a file produced by totcl is given on the command
43 line. browser displays an interaction network, and allows the user to
44 browse around the file.
45
46 Disclaimer: the source files are all based on monitoring software
47 developed for Amoeba. While the source code has been changed to
48 allow for analysis of smx interaction networks, few (if any)
49 comments have been changed :-)
50
51
52 Performing logging:
53
54 To cause logging to be performed a "logfile" entry must appear in the
55 .minix file. The name of the logfile is specified as the argument.
56 When smx is run, a session logfile with the specified name
57 is created. Warning---these logfiles get big very quickly!
This page was automatically generated by the
LXR engine.
Visit the LXR main site for more
information.
