1994-06-24 14:02:31 +00:00
|
|
|
.\" $Id$
|
1987-03-02 13:06:23 +00:00
|
|
|
.tr ~
|
1991-10-01 12:18:39 +00:00
|
|
|
.TH EMINFORM 1 "$Revision$"
|
1987-03-02 13:06:23 +00:00
|
|
|
.ad
|
|
|
|
|
.SH NAME
|
|
|
|
|
eminform \- converts runtime information of interpreted em to
|
|
|
|
|
human readable form.
|
|
|
|
|
.SH SYNOPSIS
|
1991-10-01 12:18:39 +00:00
|
|
|
\fBeminform\fP
|
1987-03-02 13:06:23 +00:00
|
|
|
.SH DESCRIPTION
|
1991-10-01 12:18:39 +00:00
|
|
|
The EM interpreter, em(1), has several debugging features built in.
|
|
|
|
|
They can be activated by flag options to em(1).
|
1987-03-02 13:06:23 +00:00
|
|
|
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"
|
1991-10-01 12:18:39 +00:00
|
|
|
ack(1), em(1).
|
1987-03-02 13:06:23 +00:00
|
|
|
.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
|
