EMINFORM(1ACK)

NAME
eminform - converts runtime information of interpreted em to human readable form.

SYNOPSIS
eminform

DESCRIPTION
The EM interpreter, em(1ACK), has several debugging features built in. They can be activated by flag options to em(1ACK). 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.

~~em_last~~~~A circular buffer is used to keep track of the last collection of executed source lines.
~~em_flow~~~~A bit map for all source lines tells which lines are executed.
~~em_count~~~Count the number of times each source line was entered.
~~em_profile~Estimate the number of memory cycles spent on each source line.

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.

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".

FILES
em_runinf, em_last, em_flow, em_count, em_profile

SEE ALSO
ack(1ACK), em(1ACK).

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