1984-07-12 14:55:49 +00:00
|
|
|
\" $Header$
|
1984-07-12 14:14:54 +00:00
|
|
|
.tr ~
|
|
|
|
|
.TH EMINFORM I
|
|
|
|
|
.ad
|
|
|
|
|
.SH NAME
|
|
|
|
|
eminform \- converts runtime information of interpreted em to
|
|
|
|
|
human readable form.
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
eminform
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The EM interpreter, em(I), has several debugging features built in.
|
|
|
|
|
They can be activated by flag options to em(I).
|
|
|
|
|
The EM interpreter collects the information while it runs the program.
|
|
|
|
|
When the program is terminated, the interpreter dumps this information onto
|
|
|
|
|
a file called em_runinf.
|
|
|
|
|
Eminform converts this information in human readable form onto
|
|
|
|
|
a set of files with fixed names, the file em_runinf itself is unlinked.
|
|
|
|
|
.PP
|
|
|
|
|
.in +15
|
|
|
|
|
.ti -13
|
|
|
|
|
~~em_last~~~~A circular buffer is used to keep track of
|
|
|
|
|
the last collection of executed source lines.
|
|
|
|
|
.ti -13
|
|
|
|
|
~~em_flow~~~~A bit map for all source lines tells which lines
|
|
|
|
|
are executed.
|
|
|
|
|
.ti -13
|
|
|
|
|
~~em_count~~~Count the number of times each source line was entered.
|
|
|
|
|
.ti -13
|
|
|
|
|
~~em_profile~Estimate the number of memory cycles
|
|
|
|
|
spent on each source line.
|
|
|
|
|
.in -15
|
|
|
|
|
.LP
|
|
|
|
|
The most common use of eminform is to print the numbers of the last executed
|
|
|
|
|
source lines if an execution error occurred.
|
|
|
|
|
No arguments are needed in this case.
|
|
|
|
|
.LP
|
|
|
|
|
Eminform will create only those files for which there were
|
|
|
|
|
interpreter flags turned on. If no runtime error occurred and
|
|
|
|
|
no flag was turned on the file em_runinf is not created. In
|
|
|
|
|
this case eminform will give the error message "read header
|
|
|
|
|
failed".
|
|
|
|
|
.SH FILES
|
|
|
|
|
em_runinf, em_last, em_flow, em_count, em_profile
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
ack(I), int(I), em(I).
|
|
|
|
|
.SH BUGS
|
|
|
|
|
If an entire procedure is not touched, the the file name in
|
|
|
|
|
which this procedure occured is unknown.
|
|
|
|
|
If no em_runinf is available the error message is "read header
|
|
|
|
|
failed" and a core dump is created.
|
|
|
|
|
Bugs should be reported to Evert Wattel
|
