← Back to branch summary

~pmdj/ubuntu/trusty/qemu/2.9+applesmc+fadtv3

« back to all changes in this revision

Viewing changes to roms/openbios/Documentation/README.debugger

  • Committer: Phil Dennis-Jordan
  • Date: 2017-07-21 08:03:43 UTC
  • mfrom: (1.1.1)
  • Revision ID: phil@philjordan.eu-20170721080343-2yr2vdj7713czahv
New upstream release 2.9.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
roms/openbios/Documentation/README.debugger
 
1
The following Forth words can be used for debugging:
 
2
 
 
3
   debug <xt> - Mark word for debugging
 
4
   debug-off  - Unmark all words for debugging
 
5
   resume     - Return from subordinate Forth interpreter
 
6
 
 
7
The source debugger also implements the following commands when it has been activated:
 
8
 
 
9
   Up - Unmark current word for debugging, mark parent and continue
 
10
   Down - Mark next word for debugging
 
11
   Trace - Continue execution until end of word displaying
 
12
           debug information
 
13
   Rstack - Display contents of the Rstack
 
14
   Forth - Launch subordinate Forth interpreter
 
15
 
 
16
An example session:
 
17
0 > see boot 
 
18
: boot
 
19
  linefeed parse cr " platform-boot" $find if
 
20
  execute then
 
21
  2drop cr " Booting " type type cr "   ... not supported on this system." type cr
 
22
  ;
 
23
 ok
 
24
0 > debug boot 
 
25
Stepper keys: <space>/<enter> Up Down Trace Rstack Forth
 
26
 ok
 
27
0 > boot 
 
28
: boot  ( Empty ) 
 
29
00000000ffe26b08: linefeed  ( a ) 
 
30
00000000ffe26b10: parse  ( ffec6e24 0 ) 
 
31
00000000ffe26b18: cr 
 
32
 ( ffec6e24 0 ) 
 
33
00000000ffe26b20: (")  ( ffec6e24 0 ffe26b30 d ) 
 
34
00000000ffe26b40: $find  ( ffec6e24 0 ffe31710 ffffffffffffffff ) 
 
35
00000000ffe26b48: do?branch  ( ffec6e24 0 ffe31710 ) 
 
36
00000000ffe26b58: execute [sparc64] Booting file 'cdrom' with parameters ''
 
37
Not a bootable ELF image
 
38
Not a Linux kernel image
 
39
Not a bootable a.out image
 
40
Loading FCode image...
 
41
Loaded 5936 bytes
 
42
entry point is 0x4000
 
43
Evaluating FCode...
 
44
open isn't unique.
 
45
Boot load failed.
 
46
 ( Empty ) 
 
47
00000000ffe26b60: dobranch  ( Empty ) 
 
48
00000000ffe26bf8: (semis) 
 
49
[ Finished boot ]  ok
 
50
0 >