mach/pdp/int/eminform.1

   1 .\" $Id: eminform.1,v 1.4 1994/06/24 13:18:08 ceriel Exp $
   2 .tr ~
   3 .TH EMINFORM 1 "$Revision: 1.4 $"
   4 .ad
   5 .SH NAME
   6 eminform \- converts runtime information of interpreted em to
   7 human readable form.
   8 .SH SYNOPSIS
   9 \fBeminform\fP
  10 .SH DESCRIPTION
  11 The EM interpreter, em(1), has several debugging features built in.
  12 They can be activated by flag options to em(1).
  13 The EM interpreter collects the information while it runs the program.
  14 When the program is terminated, the interpreter dumps this information onto
  15 a file called em_runinf.
  16 Eminform converts this information in human readable form onto
  17 a set of files with fixed names, the file em_runinf itself is unlinked.
  18 .PP
  19 .in +15
  20 .ti -13
  21 ~~em_last~~~~A circular buffer is used to keep track of
  22 the last collection of executed source lines.
  23 .ti -13
  24 ~~em_flow~~~~A bit map for all source lines tells which lines
  25 are executed.
  26 .ti -13
  27 ~~em_count~~~Count the number of times each source line was entered.
  28 .ti -13
  29 ~~em_profile~Estimate the number of memory cycles
  30 spent on each source line.
  31 .in -15
  32 .LP
  33 The most common use of eminform is to print the numbers of the last executed
  34 source lines if an execution error occurred.
  35 No arguments are needed in this case.
  36 .LP
  37 Eminform will create only those files for which there were
  38 interpreter flags turned on. If no runtime error occurred and
  39 no flag was turned on the file em_runinf is not created. In
  40 this case eminform will give the error message "read header
  41 failed".
  42 .SH FILES
  43 em_runinf, em_last, em_flow, em_count, em_profile
  44 .SH "SEE ALSO"
  45 ack(1), em(1).
  46 .SH BUGS
  47 If an entire procedure is not touched, the the file name in
  48 which this procedure occured is unknown.
  49 If no em_runinf is available the error message is "read header
  50 failed" and a core dump is created.
  51 Bugs should be reported to Evert Wattel