From 61e26c372d35942e4738807e300c8e51b8342c38 Mon Sep 17 00:00:00 2001 From: Volker Ruppert Date: Wed, 1 Nov 2006 17:06:03 +0000 Subject: [PATCH] - moved iodebug documentation to the developer documentation - added sample to the iodebug section (posted in the ML) - added description for the 'magic_break' option - updated gdbstub section --- bochs/doc/docbook/development/development.dbk | 167 +++++++++++++++++- bochs/doc/docbook/user/user.dbk | 21 ++- bochs/docs-html/iodebug.html | 115 ------------ 3 files changed, 181 insertions(+), 122 deletions(-) delete mode 100644 bochs/docs-html/iodebug.html diff --git a/bochs/doc/docbook/development/development.dbk b/bochs/doc/docbook/development/development.dbk index d31ab5028..cbc013d05 100644 --- a/bochs/doc/docbook/development/development.dbk +++ b/bochs/doc/docbook/development/development.dbk @@ -1,7 +1,7 @@
@@ -6537,7 +6548,7 @@ Enable the gdbstub option in b
Running GDB -Bochs GDB stub waits for a connection on port 1234 on localhost (127.0.0.1). Just start GDB like this: +Bochs GDB stub waits for a connection on TCP port 1234. Just start GDB like this: $ gdb YOUR-KERNEL diff --git a/bochs/docs-html/iodebug.html b/bochs/docs-html/iodebug.html deleted file mode 100644 index 8f677e9d5..000000000 --- a/bochs/docs-html/iodebug.html +++ /dev/null @@ -1,115 +0,0 @@ - - - - I/O Interface to Bochs Debugger - - - - -

I/O Interface to Bochs Debugger

- -This device was added by Dave Poirier (eks@void-core.2y.net). - -

-Compiling bochs with support -

-
-./configure --enable-iodebug
-make
-
-Other optional fields may be added to the ./configure line, see -bochs documentations for all the informations. -
- - - -

-Using the I/O Interface to the debugger -

-
-port range:  0x8A00 - 0x8A02
-
-

-Port 0x8A00 servers as command register. You can use it to enable the -i/o interface, change which data register is active, etc. -

-Port 0x8A01 is used as data register for the memory monitoring. -

-Port 0x8A02 is used as data register for breakpoints/watchpoints. -

- - - -

-Commands supported by the 0x8A00 port -

-note: all accesses must be done using word
-note2: reading this register will return 0x8A00 if currently activated, otherwise 0 -
0x8A00
-

-Used to enable the device. Any I/O to the debug module before this command is -sent is sent will simply be ignored. -

-

0x8A01
-

-Selects register 0: Memory monitoring range start address (inclusive) -

-

0x8A02
-

-Selects register 1: Memory monitoring range end address (exclusive) -

-

0x8A80
-

-Enable address range memory monitoring as indicated by register 0 and 1 and clears both registers -

- -

0x8AE0 - Return to Debugger Prompt
-

-If the debugger is enabled (via --enable-debugger), sending 0x8AE0 to port 0x8A00 after the device has been enabled will return the bochs to the debugger prompt. Basically the same as doing CTRL+C -

- -

0x8AE2 - Instruction Trace Disable
-

-If the debugger is enabled (via --enable-debugger), sending 0x8AE2 to port 0x8A00 after the device has been enabled will disable instruction tracing -

- -

0x8AE3 - Instruction Trace Enable
-

-If the debugger is enabled (via --enable-debugger), sending 0x8AE3 to port 0x8A00 after the device has been enabled will enable instruction tracing -

- -

0x8AE4 - Register Trace Disable
-

-If the debugger is enabled (via --enable-debugger), sending 0x8AE4 to port 0x8A00 after the device has been enabled will disable register tracing. -

- -

0x8AE5 - Register Trace Enable
-

-If the debugger is enabled (via --enable-debugger), sending 0x8AE5 to port 0x8A00 after the device has been enabled will enable register tracing. This currently output the value of all the registers for each instruction traced. Note: instruction tracing must be enabled to view the register tracing -

- -

0x8AFF
-

-Disable the I/O interface to the debugger and the memory monitoring functions. -

- - - - -

-Access to port 0x8A01 -

-(write-only) -

-All accesses to this port must be done using words. Writing to this port will -shift to the left by 16 the current value of the register and add the provided -value to it. -

-i.e:    reg0 = 0x01234567
-        
-	out port: 0x8A01 data: 0xABCD
-
-	reg0 = 0x4567ABCD
-
- -