Der [[Bochs|bochsinterne]] Debugger stellt eine nützliche Hilfe beim [[Debugging|Debuggen]] eines Betriebssystems dar, weil er unter anderem Registerinhalte, Speicherinhalte oder auch disassemblierte Codestellen ausgeben kann.

== Speicherinhalte ausgeben und manipulieren ==

Um sich den Speicherinhalt an einer bestimmten Adresse ausgeben zu lassen, verwendet man einen der folgenden Befehle:

<pre>x /nuf virtuelle_Adresse
xp /nuf physikalische_Adresse</pre>

n, u und f bestimmen dabei die Ausgabe genauer:
* n steht für die Anzahl der auszugebenen Einheiten
* u für die Größe einer Einheit (b=1, h=2, w=4 und g=8 Bytes)
* f legt das Ausgabeformat fest (d=dezimal, x=hexadezimal und t=binär)

Wenn [[Paging]] deaktiviert ist, dann bewirken beide Befehle dasselbe.

Möchte man geziehlt bestimmte Werte im Arbeitsspeicher verändern, nutzt man:

<pre>setpmem  physikalische_Adresse  Länge  Wert</pre>

Dadurch wird der Arbeitsspeicher von der physikalischen Adressen an soweit mit dem Wert gefüllt, wie die Länge angibt.

Zudem kann auch der Inhalt des [[Stack|Stacks]] ausgegeben werden mit:

<pre>print-stack [Anzahl_Elemente]</pre>

Im [[Real Mode]] werden dabei Words, im [[Protected Mode]] Dwords ausgegeben.



== Register ausgeben und manipulieren ==
{| {{prettytable}}
!Befehl||auszugebene Register
|-
|reg
|Alle [[Register]]
|-
|sreg
|Segment-Register
|-
|dreg
|[[Debug Register|Debug-Register]]
|-
|creg
|[[Control Register|Control-Register]]
|-
|info eflags
|[[EFLAGS]]
|-
|fpu
|[[FPU]]-Register
|}

Außerdem gibt es die Möglichkeit die allgemeinen Register zu verändern mit dem Befehl:

<pre>set Register = Wert</pre>

== Code ausführen und ausgeben ==

Die Codeausführung kann man jederzeit mit Strg+C anhalten oder auch gezielt Breakpoints setzen:

<pre>vbreak segment:offset
lbreak lineare_adresse</pre>

Auch gibt es die Möglichkeit Watchpoints an bestimmte Arbeitsspeicherstellen zu setzen. Wenn an diesen Stellen dann auf die Daten zugegriffen wird, wird die Codeausführung  unterbrochen:

<pre>watch r/w physikalische_Adresse</pre>

Mit r (lesen) und w (schreiben) wird bestimmt, bei welcher Art von Zugriff unterbrochen wird.


Wird die Ausführung angehalten, dann gibt Bochs die aktuelle Codestelle automatisch disassembliert aus.
Möchte man den Code dann weiterlaufen lassen, kann man entweder
mit

<pre>cont</pre>

normal fortfahren oder mit

<pre>step [Anzahl_Schritte]</pre>

Einzelschritte ausführen lassen.

== Sonstiges ==

* Mit "quit" wird der Debugger beendet.
* Mit "help" kann man sich die Liste der verfügbaren Befehle ausgeben.
* Mit "show int" werden Interruptaufrufe ausgegeben.

== Weblinks ==
*http://bochs.sourceforge.net/doc/docbook/user/internal-debugger.html Liste aller verfügbaren Befehle (Englisch)