d0p1/ack
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Adapted to new tree structure.

Browse source
This commit is contained in:
keie 1984-12-21 14:23:10 +00:00
parent 18dbfc024e
commit 6860747f3e
1 changed files with 23 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
man/m68k_int.1
View file

@ -10,16 +10,18 @@ The loadfile ("e.out" if not specified) is opened to read the first 8 word heade
The format of this header is explained in e.out(V). The format of this header is explained in e.out(V).
One of these 8 words is a flag word One of these 8 words is a flag word
specifying the interpreter options requested at compile time. specifying the interpreter options requested at compile time.
The usual setting of these options is +t +l -f -c -p. The usual setting of these options is +t -f -c -p.
One of these options may be overridden at run time These options may be overridden at runtime as follows:
by the corresponding flag of em. em -t turns the test option of; em +c turns count on ; em +p turns profile
on ; em +c +p turns both count and profile on.
Based on these options the name of the appropriate interpreter Based on these options the name of the appropriate interpreter
is constructed. is constructed.
Two versions exist, one for two byte words and four byte pointers and Two versions exist, one for two byte words and four byte pointers and
one for four byte words and pointers. one for four byte words and pointers.
The information in the header of the e.out file is used by em to select the
right interpreter for the word size of used in the e.out file.
.PP .PP
This interpreter is first searched for in /usr/em/mach/m68k[2,4]/int, then in the current This interpreter is searched for in /usr/em/lib/int[24]4.
directory.
.PP .PP
The flags control the following options that can be turned off The flags control the following options that can be turned off
or on by prepending them with - or + respectively: or on by prepending them with - or + respectively:
@ -39,35 +41,33 @@ em_profile.
maintain a bit map of all source lines that have been executed. maintain a bit map of all source lines that have been executed.
This map is written onto a file em_flow . This map is written onto a file em_flow .
This option is almost free in time and space. This option is almost free in time and space.
The file is not easy to read . The file is not easy to read.
Of each procedure only the lines between the first statement and the last Of each procedure only the lines between the first statement and the last
statement are represented in the bit map. statement are represented in the bit map.
Currently this option is not installed in the em tree.
.IP c .IP c
count line usage in tables that count line usage in tables that
contains for every source line the number of times it contains for every source line the number of times it
was entered. was entered.
These tables are written onto em_count. These tables are written onto em_count, a human readable file .
This option is cheap in time ,but costs some in memory space. This option is cheap in time, but costs some in memory space.
.IP l .IP l
dump the line numbers of the last 64 lines entered onto a file named dump the line numbers of the last 64 lines entered onto a file named
em_last. em_last.
This file will be in a human readable format. This file will be in a human readable format.
This option is used simultaneously with the test option.
.PP .PP
These flags These flags
give rise to 5 different interpreters which are in the give rise to 5 different interpreters which are in the
directory /usr/em/mach/m68k2/int or in /usr/em/mach/m68k4/int directory /usr/em/lib/int24 or in /usr/em/lib/int44
for the two byte word or the four byte word options , respectively. for the two byte word or the four byte word options, respectively.
.PP .PP
.SH "FILES" .SH "FILES"
.IP /usr/em/mach/m68k[2,4]/int/em_???? 35 .IP /usr/em/lib/int[24]4/em_???? 35
interpreters proper interpreters proper
.PD 0 .PD 0
.IP /usr/em/lib/m68k2_int/mloop? .IP /usr/em/mach/m68k2/int/mloop?
source of interpreter 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 .IP em_profile
profile data profile data
.IP em_count .IP em_count
@ -78,16 +78,19 @@ source line flow data
last lines executed last lines executed
.PD .PD
.SH "SEE ALSO" .SH "SEE ALSO"
ack(I), int(I) \fIack\fP(I),
\fIint24\fP(I),
\fIint44\fP(I)
.SH BUGS .SH BUGS
Most error messages are self explanatory. Most error messages are self explanatory.
If runtime flags are turned on it is advisable to try again If runtime flags are turned on it is advisable to try again
with the default options. with the default options.
Of the interpreter does not work most probably your particular If the interpreter does not work most probably your particular
machine has an other format for the system calls then assumed machine has an other format for the system calls then assumed
in the source . in the source.
In that case adapt source file mloopc to your machine. In that case adapt source file mloopc to your machine.
Also the instruction that causes the machine to allocate stack Also the instruction that causes the machine to allocate stack
space might differ . space might differ .
In that case adapt the macro 'claimstack' in deffile. In that case adapt the macro 'claimstack' in deffile.
Bugs should be reported to Freek van Schagen. .SH AUTHOR
Freek van Schagen