123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051 |
- .\" $Header$
- .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
|