MTD 122-250 User Manual Page 1

Browse online or download User Manual for Lawnmowers MTD 122-250. the ee9 users` guide [en]

  • Download
  • Add to my manuals
  • Print
  • Page
    / 15
  • Table of contents
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews
Page view 0
For ee9 V1.9, © 2012 William Findlay
This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses/by-nc-sa/3.0/
1
USERS GUIDE FOR EE9: AN ENGLISH ELECTRIC KDF9 EMULATOR
by BILL FINDLAY
(kdf9@findlayw.plus.com)
0: INTRODUCTION
This note is a guide for users of ee9, a program emulating the EE KDF9 computer. Readers not yet familiar with the
KDF9 should consult the companion document, The English Electric KDF9.
ee9 is intended to be portable to any system that offers a basic POSIX API. It is written in Ada 2005 using the GNU
Ada compiler, GNAT GPL. To date, ee9 has been implemented on the Intel x86_64 and PowerPC G5 architectures
under MacOS X; on the Intel x86_32 and x86_64 architectures under Linux/FreeBSD; on the ARM11 architecture for the
Raspberry Pi under Raspbian (Debian Wheezy for ARM); and on the Intel x86_32 architecture under Microsoft Windows
(XP/SP3 or newer). For the particular characteristics of the current version of ee9, see §6.
1: ee9 COMMAND SUMMARY
The emulator is invoked from the command line, thus:
./ee9 [ -tp [ -df [ -v ] ] ] < TR0_input_file > TP0_output_file
where v is a short string that specifies the visibility of tracing outputs; f specifies a diagnostic execution mode; and p is
the mode of a test to be run.
The allowable test flag characters p are:
b: for boot mode, which is how Directors are loaded and run
p: for problem program mode, the default, which allows programs to be run without the complication of
operating a Director (see §2.2)
t: for test program mode, which allows programs to be run with OUTs serviced as in problem program mode, but
with the CPU in Director state. Though inauthentic, this is useful for running hardware’ test programs.
The allowable diagnostic flag characters f are:
f: for fast mode, the default
p: for pause mode
t: for trace mode
x (sic) for full-trace mode (see §2.1)
The allowable visibility string characters v are those of the visibility option settings; see under ‘V’ in §5.
Commands are available to simplify calls on ee9, in systems that support a bash-compatible shell. See Appendix 1.
EXAMPLES
./ee9 –tp < KMW0201UPU > TP0 # KMW0201UPU is the Walgol compiler
./ee9 –tb -df < KKT40E007UPU > TP0 # KKT40E007UPU is the Timesharing Director
2: EMULATION MODES
2.1: DIAGNOSTIC MODES
A KDF9 program is run, at option, in one of four diagnostic modes. These are:
fast mode; in which ee9 runs the program at maximum speed, with no execution tracing or interactive
diagnostic facilities available
pause mode, in which ee9 single-shots the program, pausing to interact with the user after each instruction
trace mode, in which ee9 runs the program at speed with retrospective tracing activated
full-trace mode, in which ee9 logs a summary of every traced instruction to a file named full_trace.txt
More precisely, things work as follows.
In fast mode ee9 interacts with the user only by providing informative messages, either because the KDF9 program
has terminated, or to log significant events during the run (such as the allocation of an I/O device). All tracing overhead is
avoided in fast mode.
In pause mode ee9 uses console-window text I/O to interact with the user. After each instruction is executed a short
summary of the machine state is displayed and a prompt asks the user how to continue. The user replies with a single
letter (which may be given in upper case or lower case) followed by RETURN, selecting one of the following options:
f: execution proceeds in fast mode
p: execution proceeds in pause mode
t: execution proceeds in trace mode
(nothing): execution proceeds in the current mode.
All tracing types described in §4 are available in pause mode, trace mode, and full-trace mode; but the manner of
execution depends on whether the current instruction execution lies within a set range of addresses, and within set
Page view 0
1 2 3 4 5 6 ... 14 15

Summary of Contents

Page 1 - 1: ee9 COMMAND SUMMARY

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 2 - 3: INPUTS AND OUTPUTS

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 3 - ®HOURS/MINS;1/23.

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 4 - RACING AND LOGGING

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 5

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 6

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 7 - 5: THE MODE SETTINGS FILES

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 8

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 9

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 10 - EFERENCES

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 11

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 12

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 13

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 14

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Page 15

For ee9 V1.9, © 2012 William Findlay This document is !licensed under a Creative Commons Attribution 3.0 License: http://creativecommons.org/licenses

Comments to this Manuals

No comments