From 989c100368b34c334c876aae1b5bf7674fff7407 Mon Sep 17 00:00:00 2001 From: Johannes Sixt Date: Wed, 8 Nov 2017 19:49:13 +0100 Subject: [PATCH] Update the German user manual. --- kdbg/doc/de/argspwdenv.html | 41 ++++++++++++++---------------- kdbg/doc/de/breakptlist.html | 35 +++++++++++++------------- kdbg/doc/de/globaloptions.html | 19 ++++++++------ kdbg/doc/de/howdoi.html | 45 ++++++++++++++++----------------- kdbg/doc/de/index.html | 57 +++++++++++++++++++++--------------------- kdbg/doc/de/localvars.html | 22 +++++++++------- kdbg/doc/de/memory.html | 17 +++++++------ kdbg/doc/de/pgmoutput.html | 21 ++++++++-------- kdbg/doc/de/pgmsettings.html | 19 +++++++------- kdbg/doc/de/registers.html | 17 ++++++------- kdbg/doc/de/sourcecode.html | 15 ++++++----- kdbg/doc/de/stack.html | 15 ++++++----- kdbg/doc/de/threads.html | 24 +++++++----------- kdbg/doc/de/tips.html | 10 ++------ kdbg/doc/de/watches.html | 25 ++++++++++-------- 15 files changed, 186 insertions(+), 196 deletions(-) diff --git a/kdbg/doc/de/argspwdenv.html b/kdbg/doc/de/argspwdenv.html index 027c8ee..68654fe 100644 --- a/kdbg/doc/de/argspwdenv.html +++ b/kdbg/doc/de/argspwdenv.html @@ -2,36 +2,38 @@ - KDbg - Benutzerhandbuch - Argumente, Arbeitsverzeichnis, Umgebungsvariablen - -Inhalt + +

-Programmargumente, Arbeitsverzeichnis, Umgebungsvariablen +Programmargumente, Arbeitsverzeichnis, Umgebungsvariablen setzen

-Mit Ausführen|Argumente öffnen Sie einen Dialog, in dem +

Mit Ausführen|Argumente öffnen Sie einen Dialog, in dem Sie Programmargumente, das Arbeitsverzeichnis sowie Umgebungsvariablen -setzen können. +setzen können.

-Programmargumente

-In der obersten Eingabezeile können Sie die Programmargumente eingeben, -die an das Programm übergeben werden sollen. Diese werden beim nächsten -Programmstart verwendet. +Register Argumente +

In dem Eingabefeld können Sie die Programmargumente eingeben, +die an das Programm übergeben werden sollen. +Mittels Dateinamen einfügen können Sie nach einer Datei suchen und an +der aktuellen Position einfügen. Analog können Sie mit +Verzeichnis einfügen nach einem Verzeichnis suchen.

Diese geänderten Argumente werden beim nächsten Programmstart verwendet.

-Arbeitsverzeichnis

-Im Eingabefeld darunter können Sie das Arbeitsverzeichnis angeben. +Register Arbeitsverzeichnis +

Im dem Eingabefeld können Sie das Arbeitsverzeichnis angeben. Dieses wird sofort an gdb übergeben, sobald Sie OK drücken. Das Programm verwendet das neue Arbeitsverzeichnis allerdings erst beim -nächsten Start. +nächsten Start.

Das Arbeitsverzeichnis gilt auch für gdb selbst! Das angegebene Arbeitsverzeichnis wird sofort an gdb weitergegeben, d.h. gdb wird die neue Einstellung verwenden, sobald Sie OK drücken. Das kann -einen Einfluss darauf haben, ob gdb Quellcodedateien findet. +einen Einfluss darauf haben, ob gdb Quellcodedateien findet.

-Umgebungsvariablen

-Im Bereich für Umgebungsvariablen können Sie einen Ausdruck in +Register Umgebungsvariablen +

Im Register Umgebungsvariablen können Sie einen Ausdruck in der Form VARIABLE=Wert eingeben und dann Ändern klicken, um der Umgebungsvariablen VARIABLE einen Wert zuzuweisen. @@ -40,11 +42,6 @@ darunter aus und klicken dan Löschen. Um einen Wert zu ändern, geben Sie einfach den neuen Wert ein und klicken Ändern. Wenn Sie den Namen der Variable ändern und Ändern clicken, erzeugen Sie eine neue Variable! Die neuen Umgebungsvariablen werden erst -beim nächsten Programmstart verwendet. -

Wenn Sie glibc2 unter Linux verwenden, ist es sehr wichtig, dass Sie -der Umgebungsvariablen LD_BIND_NOW den Wert 1 zuweisen. -Wenn diese Variable nicht gesetzt ist, können solche Funktionen nicht -betreten werden, die von der Bibliothek libc und anderen Shared -Libraries importiert werden. +beim nächsten Programmstart verwendet.

diff --git a/kdbg/doc/de/breakptlist.html b/kdbg/doc/de/breakptlist.html index 9c296c5..6e94390 100644 --- a/kdbg/doc/de/breakptlist.html +++ b/kdbg/doc/de/breakptlist.html @@ -2,17 +2,16 @@ - KDbg - Benutzerhandbuch - Haltepunkte - -Inhalt + +

Inhalt

Die Liste der Haltepunkte

-Die Liste der Haltepunkte zeigt alle gesetzten Haltepunkte und Watchpoints +

Die Liste der Haltepunkte zeigt alle gesetzten Haltepunkte und Watchpoints und ermöglicht, diese zu manipulieren. Die Liste der Haltepunkte können -Sie mit dem Menüpunkt Ansicht|Haltepunkte anzeigen. +Sie mit dem Menüpunkt Ansicht|Haltepunkte anzeigen.

Die Übersicht

Für jeden Haltepunkt wird folgendes angezeigt: @@ -29,14 +28,14 @@ die Anzahl der nächsten zu ignorierenden Stopps (falls gesetzt)

die Haltebedingung (falls gesetzt).

-Das Piktogramm links zeigt an, ob der Haltepunkt aktiviert (tiefroter Punkt) +

Das Piktogramm links zeigt an, ob der Haltepunkt aktiviert (tiefroter Punkt) oder deaktiviert (hellroter Punkt) ist, ob es sich um einen temporären Haltepunkt handelt (eine winzige Uhr ist sichtbar) und ob der Haltepunkt -bedingt ist (ein Fragezeichen ist sichtbar). -

Watchpoints werden durch ein Brillensymbol gekennzeichnet. +bedingt ist (ein Fragezeichen ist sichtbar).

Watchpoints werden durch ein Brillensymbol gekennzeichnet.

Haltepunkte manipulieren

-Beachten Sie bitte, dass Haltepunkte und Watchpoints +

Beachten Sie bitte, dass Haltepunkte und Watchpoints nicht manipuliert werden können solange das zu debuggende Programm läuft. Wenn das Programm bereits gestartet wurde, muss es zuerst angehalten werden - entweder indem es auf einen bereits gesetzten Haltepunkt trifft @@ -44,39 +43,39 @@ oder "gewaltsam" indem Sie Ausführung|Unterbrechen wählen. Dadurch wird das Programm nicht beendet, sondern nur unterbrochen. Sie können die Haltepunkte jetzt verändern. Wählen Sie danach Ausführung|Ausführen, -um das Programm fortzusetzen. +um das Programm fortzusetzen.

Am einfachsten kann ein Haltepunkt im Quellcode-Fenster gesetzt werden. Wenn Sie den genauen Dateinamen und die Zeilennummer einer Funktion nicht kennen, können Sie den Funktionsnamen im Feld über -der Liste eingeben und Haltepunkt wählen. +der Liste eingeben und Haltepunkt wählen.

Sie können eine Haltepunkt in der Liste auswählen seine Zustand mittels Deaktivieren oder Aktivieren ändern. Oder Sie klicken auf den Haltepunkt mit der mittleren Maustaste - genau so, wie -Sie im Quellcode-Fenster Haltepunkte aktivieren und deaktivieren. +Sie im Quellcode-Fenster Haltepunkte aktivieren und deaktivieren.

Sie können eine Bedingung setzen (sodass das Programm nur stehen bleibt, wenn die Bedingung erfüllt ist) oder die Anzahl der zu ignorierenden Stopps setzen (sodass das Programm die nächsten n Male nicht stehen bleibt, die es über diesen Haltepunkt läuft). Dazu wählen sie den Schalter Bedingt und geben die Anzahl der zu ignorierenden -Treffer und/oder die Bedingung ein. +Treffer und/oder die Bedingung ein.

Watchpoints manipulieren

-Watchpoints sind den Haltepunkten ähnlich, nur dass das Programm angehalten +

Watchpoints sind den Haltepunkten ähnlich, nur dass das Programm angehalten wird, sobald sich der Inhalt einer Speicherstelle ändert. Ebenso wie Haltepunkte können Watchpoints nicht manipuliert werden, solange das -Programm läuft. Weitere Hinweise dazu siehe oben. +Programm läuft. Weitere Hinweise dazu siehe oben.

Einen Watchpoint können Sie setzen, indem Sie einen Ausdruck im Feld über der Liste eingeben und Watchpoint klicken. Das Programm wird dann angehalten, sobald sich der Wert des Ausdrucks ändert. Beachten Sie, dass Sie Watchpoints, die eine lokale Variable benötigen, nur setzen können, wenn das Programm von einem Haltepunkt (oder mittels -Ausführung|Unterbrechen) angehalten wurde. +Ausführung|Unterbrechen) angehalten wurde.

Zum Entfernen eines Watchpoints wählen Sie diesen in der Liste aus und klicken Entfernen. Falls der Ausdruck eine lokale Variable enthält, wird der Watchpoint automatisch entfernt, sobald das Programm -die aktive Funktion verlässt. +die aktive Funktion verlässt.

Wie mit Haltepunkten können Sie eine Bedingung oder eine Anzahl zu ignorierender Stopps setzen, indem Sie den Watchpoint auswählen -und Bedingt klicken. +und Bedingt klicken.

diff --git a/kdbg/doc/de/globaloptions.html b/kdbg/doc/de/globaloptions.html index 86639a2..ceb94a8 100644 --- a/kdbg/doc/de/globaloptions.html +++ b/kdbg/doc/de/globaloptions.html @@ -2,16 +2,15 @@ - KDbg - Benutzerhandbuch - Globale Einstellungen - -Inhalt + +

Inhalt

Globale Einstellungen

-Mit dem Menüpunkt Datei|Globale Einstellungen können Sie -folgende Optionen einstellen: +

Mit dem Menüpunkt Datei|Globale Einstellungen können Sie +folgende Optionen einstellen:

den Befehl, mit dem gdb aufgerufen wird;

Sie können angeben, ob das KDbg-Fenster in den Vordergrund gebracht werden soll, sobald das kontrollierte Programm anhält (bei -einem Breakpoint oder wegen eines Signals). Das Fenster wird allerdings -nicht aktiviert (zumindest nicht unter KWM, dem Window Manger von KDE). +einem Breakpoint oder wegen eines Signals). Manche Benutzer werden dieses Verhalten als störend empfinden, weshalb diese Option standardmässig ausgeschaltet ist.

+Dateifilter

Sie können Dateifiltermuster für Quellcode-Datein und +Header-Dateien angeben. Diese werden beim Aufruf von Datei|Quellcode +öffnen verwendet.

KDbg - Benutzerhandbuch - Wie kann ich...?

Inhalt

Wie kann ich...?

... eine Haltepunkt setzen?

Dafür gibt's mehrere Möglichkeiten:

Sie können im Quellcode-Fenster in den @@ -27,57 +26,57 @@ im Menü Haltepunkt eine Auswahl treffen.

Liste der Haltepunkte

Wenn Sie keinen Haltepunkt setzen können, könnte es sein, dass das Programm gerade läuft. Sie können keine Haltepunkte setzen, solange das Programm läuft. Halten Sie es zuerst mit Ausführung|Unterbrechen an. Falls Sie dann noch immer keine Haltepunkte setzen können, versichern Sie sich, dass Sie das Programm mit Debug-Information übersetzt und -gebunden haben. +gebunden haben.

... den Wert einer globalen Variablen oder eines beliebigen Ausdrucks anzeigen?

Ausdrücke-Fenster

Benutzen Sie das Fenster Beobachtete Ausdrücke.

... Watchpoints setzen?

Liste -der Haltepunkte

Watchpoints können über die Liste +der Haltepunkte bearbeitet werden.

... einen Core-Dump benutzen?

Datei|Programm

Datei|Core dump

Laden Sie zuerst das Programm mittels Datei|Programm laden, dann geben +Sie den Core-Dump mittels Datei|Core-Dump an.

... ein Programm debuggen, das sich in eine Endlosschleife verlaufen hat?

Starten Sie das Programm und lassen Sie es laufen, bis es in die Endlosschleife gelangt. Dann schalten Sie um zu KDbg und wählen Ausführung|Unterbrechen. -Hiermit haben Sie das Programm in flagranti erwischt! +Hiermit haben Sie das Programm in flagranti erwischt!

... erreichen, dass das Programm einigemale über einen Haltepunkt drüberläuft, ohne anzuhalten?

Liste der Haltepunkte

In der Liste der Haltepunkte wählen Sie den Haltepunkt; dann klicken Sie Bedingt und geben die Anzahl -in Ignoriere nächste Treffer an. +in Ignoriere nächste Treffer an.

... eine Umgebungsvariable für das Programm setzen?

Ausführung|Argumente

Argumente-Dialog

Wählen Sie Ausführung|Argumente und geben die Umgebungsvariable +im Argumente-Dialog an.

... ein Arbeitsverzeichnis für das Programm wählen?

Ausführung|Argumente

Argumente-Dialog

Wählen Sie Ausführung|Argumente und geben das Arbeitsverzeichnis +im Argumente-Dialog an.

... das Terminal-Fenster los werden?

Datei|Einstellungen

Wählen Sie Einstellungen|Dieses Programm und schalten auf das Register Ausgabe um. Wählen Sie Nur Ausgabe, einfache Terminalemulation und klicken Sie OK. Nun müssen Sie das Programm neu laden (am einfachsten wählen Sie es aus der Liste unter Datei|Zuletzt geöffnete Programme). Die Programmausgaben werden nun in das eingebaute Ausgabefenster -geschrieben und stdin ist auf /dev/null umgeleitet. +geschrieben und stdin ist auf /dev/null umgeleitet.

Sie müssen diese Einstellungen für jedes neue Programm wiederholen, -das Sie debuggen. +das Sie debuggen.

Wichtig: Sie sollten dies nicht tun, falls Ihr Programm Eingaben vom Terminal (normalerweise stdin) erwartet oder falls mehr als nur einfache Terminalemultionen benötigt werden (mehr als nur Wagenrücklauf und Zeilenvorschub). Das eingebaute Ausgabefenster unterstützt keine -Eingaben oder Terminalemulationen. +Eingaben oder Terminalemulationen.

KDbg - Benutzerhandbuch

Typentabellen

Einleitung

gdb

KDbg ist eine grafische Benutzeroberfläche für gdb, +den GNU-Debugger.

Das bedeutet, dass KDbg selbst nicht der Debugger ist. Vielmehr kommuniziert KDbg mit gdb, indem Befehlszeilen and diesen geschickt werden und die Ausgabe, wie z.B. Variablenwerte, entgegengenommen werden. Die Menübefehle und Mausklicks werden in gdb-Befehle umgesetzt, und die Ausgabe von gdb wird in (mehr oder weniger) sichtbare -Information umgesetzt, wie zum Beispiel die Struktur von Variablen. +Information umgesetzt, wie zum Beispiel die Struktur von Variablen.

Eine Folge davon ist, dass KDbg vollständig von den Fähigkeiten des verwendeten Befehlszeilendebuggers, gdb, abhängig ist. KDbg kann nicht mehr als gdb leisten. Wenn Sie zum Beispiel einen gdb haben, der Programme mit Threads nicht unterstützt, dann kann auch -KDbg das nicht (obwohl ein Threads-Fenster vorhanden ist). +KDbg das nicht (obwohl ein Threads-Fenster vorhanden ist).

Mit KDbg arbeiten

globalen -Einstellungen

Datei|Globale Einstellungen

Bevor Sie mit der Arbeit beginnen, sollten Sie die globalen +Einstellungen prüfen, indem Sie Einstellungen|Globale Einstellungen +aufrufen.

Ein zu debuggendes Program angeben

Datei|Programm

Um ein Programm zu debuggen, wählen Sie Datei|Programm laden. Wenn Sie das Programm schon einmal debuggt haben, können Sie es auch aus der Liste unter Datei|Zuletzt göffnete Programme wählen. -Das Programm wird jetzt geladen. +Das Programm wird jetzt geladen.

Wenn Sie einen Core-Dump verwenden wollen, müssen Sie zuerst das Programm, das den Core-Dump erzeugt hat wie gerade erwähnt laden, -dann wählen Sie Datei|Core dump aus dem Menü. KDbg zeigt -die Stelle an, die den Core-Dump verursacht hat. +dann wählen Sie Datei|Core-Dump aus dem Menü. KDbg zeigt +die Stelle an, die den Core-Dump verursacht hat.

Sie können nun Haltepunkte setzen, indem Sie die Einträge im Menü Haltepunkt oder im Rechte-Maus-Menü oder in der Liste -der Haltepunkte verwenden. +der Haltepunkte verwenden.

Sie können auch programmspezifische -Einstellungen vornehmen, indem Sie Datei|Einstellungen wählen. +Einstellungen vornehmen, indem Sie Einstellungen|Dieses Programm wählen.

Das Programm ausführen

Ausführung|Ausführen

Nun führen Sie das Programm aus, indem Sie Ausführung|Ausführen wählen. Das Programm arbeitet nun wie gewöhnlich, bis es beendet -wird, auf einen Haltepunkt oder Watchpoint trifft, oder ein Signal empfängt. +wird, auf einen Haltepunkt oder Watchpoint trifft, oder ein Signal empfängt.

Sie können das Programm mit Argumenten ausführen, ein Arbeitsverzeichnis festlegen und auch Umgebungsvariablen definieren. Dazu wählen Sie Ausführung|Argumente -und machen Ihre Angaben im Programmargumente-Dialog. +und machen Ihre Angaben im Programmargumente-Dialog.

Weiters können Sie sich in ein Programm einhängen (attachen), das bereits ausgeführt wird. Dazu laden Sie das Programm zuerst wie oben beschrieben, dann wählen Sie Ausführung|Attachen. Geben Sie die Prozessnummer an und klicken Sie OK. Das Programm wird jetzt angehalten (aber nicht beendet), und der derzeitige Stand des -Programms wird im Quellcode-Fenster angezeigt. +Programms wird im Quellcode-Fenster angezeigt.

Das Programm wurde angehalten - was nun?

Wenn das Programm an einem Haltepunkt, Watchpoint oder wegen eines Signals angehalten wird, zeigt das Quellcode-Fenster die Zeile, in der das Programm gerade arbeitete. Es passiert häufig, dass das Programm wegen eine Signals (oftmals SIGSEGV, Speicherzugriffsfehler) @@ -100,32 +99,32 @@ befindet, den Sie geschrieben haben. In diesem Fall betrachten Sie das genauer: Suchen Sie nach einer Funktion, die Sie geschrieben haben (beginnen Sie am oberen Ende) und klicken Sie darauf. Das bringt Sie an eine Stelle, an der Sie mit der Suche nach dem tatsächlichen Programmfehler beginnen -können. +können.

Im Menü Ausführung finden Sie Befehle, die Sie zum Ausführen und schrittweisen Abarbeiten des Programms verwenden. Weiters können Sie das laufende Programm unterbrechen. Die wichtigen Befehle können auch mit Funktionstasten gegeben werden. Zum effizienten Arbeiten empfehle ich, dass Sie sich diese Tasten eingewöhnen. Sie können Einstellungen|Kurzbefehle festlegen verwenden, falls -Sie die Funktionen anderen Tasten zuweisen wollen. +Sie die Funktionen anderen Tasten zuweisen wollen.

Im Menü Haltepunkt finden Sie Befehle zum Setzen, Entfernen, Aktivieren und Inaktivieren von permanenten und temporären Haltepunkten. Natürlich können Sie auch eine Liste der Haltepunkte anzeigen. Sie können einen Haltepunkt auch setzen, indem Sie mit der Maus in den Freiraum links der entsprechenden Quellcode-Zeile klicken (mit der linken Maustaste); weiters können sie einen vorhandenen -Haltepunkt mit der mittleren Maustaste aktivieren und deaktivieren. +Haltepunkt mit der mittleren Maustaste aktivieren und deaktivieren.

Die Animation in der Werkzeugleiste zeigt an, ob das Programm gerade läuft. Sie bleibt stehen, sobald das Programm an einem Haltepunkt oder aus einem anderen Grund angehalten wird oder sobald es beendet wird. -Ein Klick auf die Animation hat die Funktion von Ausführung|Unterbrechen. +Ein Klick auf die Animation hat die Funktion von Ausführung|Unterbrechen.

Die Informationsfenster von KDbg

KDbg zeigt Information in einer Reihe verschiedener Fenster an. Im Menü Ansicht finden Sie die Befehle, die diese Fenster anzeigen und schließen. Es handelt sich dabei um dockende Fenster, sodass Sie deren Anordnung beliebig -verändern können. +verändern können.

Das Quellcode-Fenster

Der Programm-Stack

-Ausdrücke (Watches)

Beobachtete Ausdrücke

Die Liste der Haltepunkte

Autor

Johannes Sixt

KDbg wurde von Johannes Sixt mit vielen weiteren Helfern geschrieben. -
Die KDbg-Homepage befindet sich unter http://www.kdbg.org/. +
Die KDbg-Homepage befindet sich unter http://www.kdbg.org/.

KDbg - Benutzerhandbuch - Lokale Variablen

Inhalt

Lokale Variablen

Ansicht|Lokale Variablen

Mittels Ansicht|Lokale Variablen wird das Fenster für die lokalen Variablen angezeigt. Darin wird der Inhalt der lokalen Variablen des aktiven -Stack-Frames angezeigt. +Stack-Frames angezeigt.

Das im Stack-Fenster ausgewählte Frame -bestimmt die lokalen Variablen, die hier angezeigt werden. +bestimmt die lokalen Variablen, die hier angezeigt werden.

Sobald das Programm angehalten wird (z.B. durch einen Haltepunkt), wird die Anzeige aktualisiert. Variablenwerte, die sich seit dem letzten Anhalten -geändert haben, werden rot hervorgehoben. +geändert haben, werden rot hervorgehoben.

Die Werte der meisten Variable können modifiziert werden. Dazu setzen Sie +den Fokus auf das Fenster und drücken F2 oder wählen Sie Wert bearbeiten +im Kontextmenü. Nun können Sie den Wert bearbeiten. +Beachten Sie, dass eine Zeichenketten nicht bearbeitet werden kann, die bei +einer Zeigervariablen angezeigt wird, lediglich den Zeigerwert selbst.

Sie können die ausgewählte Variable oder Struktur-Member in -das Ausdrückefenster kopieren, indem Sie -mittels der rechten Maustaste das kleine Kontextmenü aufrufen. +Beobachtete Ausdrücke kopieren, indem Sie +mittels der rechten Maustaste das kleine Kontextmenü aufrufen.

KDbg - Benutzerhandbuch - Speicherinhalt

Inhalt

Der Speicherinhalt

Ansicht|Speicher

Das Fenster zur Anzeige des Speicherinhalts können Sie mittels Ansicht|Speicher aufrufen. Es zeigt den Inhalt des Speichers des Programms an beliebigen Adressen an. +Wenn Sie die Bildlaufleiste an das untere Ende verschieben, wird automatisch +zusätzlicher Speicherinhalt abgerufen.

Um Speicherinhalt anzuzeigen, geben Sie eine Adresse an. Die Adresse braucht nicht in Hexadezimalform eingegeben werden und es kann sich auch -um einen beliebigen Ausdruck handeln. +um einen beliebigen Ausdruck handeln.

Sie können ein Format wählen, wie der Speicherinhalt dargestellt werden soll, indem Sie die entsprechenden Optionen im Rechte-Maus-Menü -wählen. +wählen.

Die zuletzt verwendeten Adressen werden zwischengespeichert und können über die Popup-Liste ausgewählt werden. Bitte beachten Sie, dass -zusammen mit der Adresse auch das Darstellungsformat gespeichert wird. +zusammen mit der Adresse auch das Darstellungsformat gespeichert wird.

Wenn Sie keinen Speicherinhalt ansehen wollen, empfehlen wir, dass Sie die Adresse löschen, damit kein Speicherinhalt angezeigt wird - dadurch -arbeitet KDbg etwas schneller. +arbeitet KDbg etwas schneller.

KDbg - Benutzerhandbuch - Programmausgabe

Inhalt

Das Programmausgabefenster

Ansicht|Ausgabe

Das Programmausgabefenster wird mit Ansicht|Ausgabe geöffnet. Das Ausgabefenster zeichnet den Text auf, den das Programm auf stdout -und stderr ausgibt. +und stderr ausgibt.

Das Ausgabefenster lässt keine Eingabe zu und unterstützt nur eine äußerst minimale Terminalemulation: Lediglich \n (Zeilenvorschub, line-feed), \t (horizontaler Tabulator) und \r (Wagenrücklauf, carriage-return) werden behandelt. Das reicht im Allgemeinen für Programme mit grafischer Benutzeroberfläche -aus, die nur Debug-Ausgaben schreiben. +aus, die nur Debug-Ausgaben schreiben.

Wenn ein Programm zum ersten Mal in KDbg geladen wird, wird dieses Ausgabefenster nicht benutzt. Der Grund dafür ist, dass KDbg nicht wissen kann, ob das Programm eine ausgefeilte Terminalemulation benötigt oder ob es Eingaben über das Terminal erwartet. Deshalb wird standardmässig ein Terminalemulator verwendet. Um die Ausgaben in das Ausgabefenster umzuleiten, -gehen sie wie folgt vor: +gehen sie wie folgt vor:

-Rufen Sie mittels Datei|Einstellungen die programmspezifischen +Rufen Sie mittels Einstellungen|Dieses Programm die programmspezifischen Einstellungen auf.
@@ -41,12 +40,12 @@ Sie OK.

Datei|Zuletzt geöffnete Programme

Sie können den Inhalt des Fensters jederzeit löschen, indem Sie Löschen aus dem Popup-Menü wählen, das Sie mit der -rechten Maustaste aufrufen können. +rechten Maustaste aufrufen können.

Falls die letzte Zeile des Ausgabefensters sichtbar ist, verschiebt sich der Fensterinhalt automatisch, sodass die letzte Zeile immer sichtbar bleibt, wenn neuer Text ankommt. Wenn Sie hingegen den Fensterinhalt verschieben, -sodass die letzte Zeile nicht sichtbar ist, bleibt der sichtbare Teil unverändert. +sodass die letzte Zeile nicht sichtbar ist, bleibt der sichtbare Teil unverändert.

KDbg - Benutzerhandbuch - Programmspezifische Einstellungen

Inhalt

Programmspezifische Einstellungen

Datei|Einstellungen

In diesem Dialog können programmspezifischen Einstellungen getroffen +werden. Der Dialog wird mittels Einstellungen|Dieses Programm aufgerufen. Die Einstellungen werden nur auf das geladene Programm angewendet und bleiben -über Sitzungen hinweg erhalten. +über Sitzungen hinweg erhalten.

Wichtiger Hinweis: Die getroffenen Einstellungen werden erst wirksam, wenn das Programm das nächste Mal geladen wird. Das bedeutet, dass Sie nach dem Drücken von OK in diesem Dialog -das Programm erneut laden müssen (mittels Datei|Programm)!!

Datei|Programm laden

@@ -29,8 +28,8 @@ das Programm erneut laden müssen (mittels Datei|Programm)!!
Debugger
-Hier kann der Debugger gewählt werden, der für dieses Programm -verwendet werden soll. +
Hier kann der Debugger gewählt werden, der für dieses Programm +verwendet werden soll.

Aufruf von GDB
@@ -44,7 +43,7 @@ funktioniert KDbg nicht.
Ausgabe
-Hier geben Sie an, unter welcher Terminalemulation das Programm arbeitet. +
Hier geben Sie an, unter welcher Terminalemulation das Programm arbeitet.

Keine Ein- und Ausgabe
diff --git a/kdbg/doc/de/registers.html b/kdbg/doc/de/registers.html index 217096b..489512d 100644 --- a/kdbg/doc/de/registers.html +++ b/kdbg/doc/de/registers.html @@ -2,18 +2,17 @@ - KDbg - Benutzerhandbuch - Registerinhalt - -Inhalt + +
Inhalt

Der Registerinhalt
-Das Fenster zur Anzeige des Registerinhalts wird mittels Ansicht|Register -angezeigt. Jedesmal, wenn das Programm angehalten wird, zeigt Kdbg hier -den Inhalt der CPU-Register an. -
Das Fenster ist in 3 Spalten aufgeteilt: +
Das Fenster zur Anzeige des Registerinhalts wird mittels Ansicht|Register +angezeigt. Jedesmal, wenn das Programm angehalten wird, zeigt KDbg hier +den Inhalt der CPU-Register an.
+
Das Fenster ist in 3 Spalten aufgeteilt:
1. Die Spalte Register zeigt die Namen der Register.
-Durch Klicken mit der rechten Maustaste können Sie ein Kontextmenü +
Durch Klicken mit der rechten Maustaste können Sie ein Kontextmenü aufrufen, über das Sie die Darstellung der Werte in der zweiten Spalte -wählen können. +wählen können.
diff --git a/kdbg/doc/de/sourcecode.html b/kdbg/doc/de/sourcecode.html index 7f95921..8fb1799 100644 --- a/kdbg/doc/de/sourcecode.html +++ b/kdbg/doc/de/sourcecode.html @@ -2,29 +2,28 @@ - KDbg - Benutzerhandbuch - Quellcode - -Inhalt + +
Inhalt

Das Quellcode-Fenster
-Das Quellcode-Fenster ist das Hauptfenster und ist immer sichtbar. +
Das Quellcode-Fenster ist das Hauptfenster und ist immer sichtbar.

Das Quellcode-Fenster zeigt den Quellcode von Programmen an. Am linken Rand jeder Zeile befindet sich ein "aktiver Bereich". Dort wird ein mit einem Pfeil angezeigt, an welcher Stelle das Programm gerade ausgeführt wird. Weiters wird hier angezeigt, an welchen Stellen Haltepunkte gesetzt -sind. +sind.

Neue Haltepunkte können gesetzt werden, indem Sie mit der linken Maustaste in den aktiven Bereich klicken. Mit der mittleren Maustaste können -Sie vorhandene Haltepunkte aktivieren und deaktivieren. +Sie vorhandene Haltepunkte aktivieren und deaktivieren.

Das kleine Pluszeichen '+' zwischen dem "aktiven Bereich" und der Quellcodezeile zeigt den Assembler-Code der Quellcodezeile an, wenn Sie darauf klicken. Dabei wird das Zeichen zu einem Minus '-', das den Assemblercode wieder -verbirgt, wenn Sie darauf klicken. +verbirgt, wenn Sie darauf klicken.

Meistens werden Quellcode-Dateien automatisch geöffnet. Sie können Dateien manuell öffnen, indem Sie Datei|Quellcode öffnen -wählen oder Quellcode öffnen aus dem Rechte-Maus-Menü. +wählen oder Quellcode öffnen aus dem Rechte-Maus-Menü.
diff --git a/kdbg/doc/de/stack.html b/kdbg/doc/de/stack.html index 1d5c844..a506926 100644 --- a/kdbg/doc/de/stack.html +++ b/kdbg/doc/de/stack.html @@ -2,24 +2,23 @@ - KDbg - Benutzerhandbuch - Stack - -Inhalt + +
Inhalt

Das Stack-Fenster
-Das Stack-Fenster wird mittels Ansicht|Stack angezeigt. Hierin wird +
Das Stack-Fenster wird mittels Ansicht|Stack angezeigt. Hierin wird der Call-Stack (Backtrace, Stack-Frames) angezeigt, d.h. die Funktionen, -die das Programm im Augenblick betreten und noch nicht verlassen hat. +die das Programm im Augenblick betreten und noch nicht verlassen hat.

Das innerste Frame (in dem sich das Programm gerade befindet) befindet -sich an erster Stelle. +sich an erster Stelle.

Sie können in ein anderes Stack-Frame umschalten, indem Sie einfach auf die entsprechende Zeile klicken. Das Quellcode-Fenster zeigt die Stelle an, in der der Aufruf in das nächst-innere Frame stattfand; die Anzeige der lokalen Variablen -und die Ausdrücke werden umgeschaltet, -sodass die lokalen Variablen des gewählten Frames angezeigt werden. +und die Beobachteten Ausdrücke werden umgeschaltet, +sodass die lokalen Variablen des gewählten Frames angezeigt werden.
diff --git a/kdbg/doc/de/threads.html b/kdbg/doc/de/threads.html index 0f4d33d..abf1730 100644 --- a/kdbg/doc/de/threads.html +++ b/kdbg/doc/de/threads.html @@ -2,27 +2,21 @@ - KDbg - Benutzerhandbuch - Threads - -Inhalt + +
Inhalt

Die Programm-Threads
-Das Fenster mit der Liste der Programm-Threas wird mittels Ansicht|Threads -aufgerufen. Dieses Fenster listet die aktiven Threads des Programms auf. -
Wichtig: Das Debuggen von Programm-Threads muss von der -verwendeten gdb-Version unterstützt werden - es handelt sich -hierbei nicht um ein Feature von KDbg. Für Linux-Systeme (i386) funktioniert -gdb5 -am besten. +
Das Fenster mit der Liste der Programm-Threas wird mittels Ansicht|Threads +aufgerufen. Dieses Fenster listet die aktiven Threads des Programms auf.

Der Inhalt des Fensters wird jedesmal erneuert, wenn das Programm vom Debugger angehalten wird. (Das heisst, dass nicht der aktuelle Zustand -des Programms angezeigt wird, während es läuft.) +des Programms angezeigt wird, während es läuft.)

Die erste Spalte zeigt die Thread-ID an, die zweite Spalte zeigt die -Stelle, an der der Thread gerade abgearbeitet wird. -
Die Markierung am Zeilenanfang benennt den aktiven Thread: +Stelle, an der der Thread gerade abgearbeitet wird.
+
Die Markierung am Zeilenanfang benennt den aktiven Thread:
- Das Stack-Fenster zeigt den Call-Stack des @@ -36,9 +30,9 @@ die lokalen Variablen des aktiven Threads.
-Indem Sie auf einen Thread klicken, wechseln Sie den aktiven Thread und +
Indem Sie auf einen Thread klicken, wechseln Sie den aktiven Thread und die genannten Fenster werden entsprechend auf den aktuellen Stand gebracht. Ausserdem schaltet das Quellcode-Fenster -zu der Programmstelle um, an der der aktive Thread angehalten wurde. +zu der Programmstelle um, an der der aktive Thread angehalten wurde.
diff --git a/kdbg/doc/de/tips.html b/kdbg/doc/de/tips.html index c4400d4..e0f5e3d 100644 --- a/kdbg/doc/de/tips.html +++ b/kdbg/doc/de/tips.html @@ -2,22 +2,16 @@ - KDbg - Benutzerhandbuch - Tipps - -Inhalt + +
Inhalt

Tipps und Tricks
- -Setzen Sie immer die Umgebungsvariable LD_BIND_NOW=1 auf glibc2-Systems. -Wie Umgebungsvariablen gesetzt werden, wird hier -erklärt.
- Sie können Haltepunkte als Lesezeichen verwenden: Setzen Sie einfach einen Haltepunkt und deaktivieren Sie diesen. Später können Sie rasch an die entsprechende Stelle zurückkehren, indem Sie in der Liste diff --git a/kdbg/doc/de/watches.html b/kdbg/doc/de/watches.html index fc3fbd3..41dbec9 100644 --- a/kdbg/doc/de/watches.html +++ b/kdbg/doc/de/watches.html @@ -2,26 +2,29 @@ - KDbg - Benutzerhandbuch - Ausdrücke - -Inhalt + +
  Inhalt
  
  -Ausdrücke (Watches)
  -Das Watches-Fenster wird mittels Ansicht|Ausdrücke angezeigt. -Dieses zeigt beliebige Ausdrücke an (diese bezeichnet man auch als -Watches). +Beobachtete Ausdrücke +
  Das Watches-Fenster wird mittels Ansicht|Beobachtete Ausdrücke angezeigt. +Dieses zeigt beliebige Ausdrücke an.
  
  Ein neuer Ausdruck wird hinzugefügt, indem dieser im Eingabefeld eingegeben wird und dann auf Neu geklickt wird. Um einen Ausdruck zu entfernen, klicken Sie diesen an (an der Wurzel des entsprechenden Baums) -und klicken dann auf Entf. +und klicken dann auf Entf.
  
  Sie können auch eine Variable oder einen Struktur-Member aus dem Lokale-Variablen-Fenster herüberkopieren, -indem Sie das dortige Kontextmenü zuhilfe nehmen. -
  Die eingegeben Ausdrücke werden zwischen Sitzungen gespeichert. +indem Sie das dortige Kontextmenü zuhilfe nehmen.
  +
  Die Werte der meisten Variable können modifiziert werden. Dazu setzen Sie +den Fokus auf das Fenster und drücken F2 oder wählen Sie Wert bearbeiten +im Kontextmenü. Nun können Sie den Wert bearbeiten. +Beachten Sie, dass eine Zeichenketten nicht bearbeitet werden kann, die bei +einer Zeigervariablen angezeigt wird, lediglich den Zeigerwert selbst.
  +
  Die beobachteten Ausdrücke werden zwischen Sitzungen gespeichert. Wir empfehlen, Ausdrücke zu entfernen, die nicht mehr benötigt, -weil das die Arbeitsgeschwindigkeit von KDbg steigert. +weil das die Arbeitsgeschwindigkeit von KDbg steigert.
  -- 2.11.4.GIT

-Programmargumente, Arbeitsverzeichnis, Umgebungsvariablen +Programmargumente, Arbeitsverzeichnis, Umgebungsvariablen setzen

-Programmargumente

-Arbeitsverzeichnis

-Umgebungsvariablen

Die Liste der Haltepunkte

Die Übersicht

Haltepunkte manipulieren

Watchpoints manipulieren

Globale Einstellungen

+Dateifilter

Wie kann ich...?

... eine Haltepunkt setzen?

... den Wert einer globalen Variablen oder eines beliebigen Ausdrucks anzeigen?

... Watchpoints setzen?

... einen Core-Dump benutzen?

... ein Programm debuggen, das sich in eine Endlosschleife verlaufen hat?

... erreichen, dass das Programm einigemale über einen Haltepunkt drüberläuft, ohne anzuhalten?

... eine Umgebungsvariable für das Programm setzen?

... ein Arbeitsverzeichnis für das Programm wählen?

... das Terminal-Fenster los werden?

KDbg - Benutzerhandbuch

Einleitung

Mit KDbg arbeiten

Ein zu debuggendes Program angeben

Das Programm ausführen

Das Programm wurde angehalten - was nun?

Die Informationsfenster von KDbg

Autor

Lokale Variablen

Der Speicherinhalt

Das Programmausgabefenster

Programmspezifische Einstellungen

Debugger

Aufruf von GDB

Ausgabe

Keine Ein- und Ausgabe

Der Registerinhalt

Das Quellcode-Fenster

Das Stack-Fenster

Die Programm-Threads

Tipps und Tricks

-Ausdrücke (Watches)