diff --git a/man/m68k_int.1 b/man/m68k_int.1 new file mode 100644 index 000000000..0f7430cce --- /dev/null +++ b/man/m68k_int.1 @@ -0,0 +1,93 @@ +.\" $Header$ +.TH EM I +.ad +.SH NAME +em \- calling program for em interpreters +.SH SYNOPSIS +em [-t] [+fcp] [loadfile [args ... ...] ] +.SH DESCRIPTION +The loadfile ("e.out" if not specified) is opened to read the first 8 word header. +The format of this header is explained in e.out(V). +One of these 8 words is a flag word +specifying the interpreter options requested at compile time. +The usual setting of these options is +t +l -f -c -p. +One of these options may be overridden at run time +by the corresponding flag of em. +Based on these options the name of the appropriate interpreter +is constructed. +Two versions exist, one for two byte words and four byte pointers and +one for four byte words and pointers. +.PP +This interpreter is first searched for in /usr/em/mach/m68k[2,4]/int, then in the current +directory. +.PP +The flags control the following options that can be turned off +or on by prepending them with - or + respectively: +.IP t +run time tests for undefined variables, array bounds etc... +This option costs a small amount of memory and some time. +However, it is very useful for debugging. +.IP p +profiling of the entire program. The interpreter maintains tables containing +an estimate of the number of processor state cycles used per source line. +A processor state cycle is equal to two internal clock cycles. +This option is expensive in time as well as in memory space. +The result tables made at run time are dumped in a human readable +format onto a file named +em_profile. +.IP f +maintain a bit map of all source lines that have been executed. +This map is written onto a file em_flow . +This option is almost free in time and space. +The file is not easy to read . +Of each procedure only the lines between the first statement and the last +statement are represented in the bit map. +.IP c +count line usage in tables that +contains for every source line the number of times it +was entered. +These tables are written onto em_count. +This option is cheap in time ,but costs some in memory space. +.IP l +dump the line numbers of the last 64 lines entered onto a file named +em_last. +This file will be in a human readable format. +.PP +These flags +give rise to 5 different interpreters which are in the +directory /usr/em/mach/m68k2/int or in /usr/em/mach/m68k4/int +for the two byte word or the four byte word options , respectively. +.PP +.SH "FILES" +.IP /usr/em/mach/m68k[2,4]/int/em_???? 35 +interpreters proper +.PD 0 +.IP /usr/em/lib/m68k2_int/mloop? +source of interpreter +.IP /usr/em/mach/m68k[2,4]/int/?+ +positive option switch +.IP /usr/em/mach/m68k[2,4]/int/?- +negative option switch +.IP em_profile +profile data +.IP em_count +source line count data +.IP em_flow +source line flow data +.IP em_last +last lines executed +.PD +.SH "SEE ALSO" +ack(I), int(I) +.SH BUGS +Most error messages are self explanatory. +If runtime flags are turned on it is advisable to try again +with the default options. +Of the interpreter does not work most probably your particular +machine has an other format for the system calls then assumed +in the source . +In that case adapt source file mloopc to your machine. +Also the instruction that causes the machine to allocate stack +space might differ . +In that case adapt the macro 'claimstack' in deffile. +Bugs should be reported to Freek van Schagen.