CodeGuard-Konfiguration

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Menü Tools


Tools > CodeGuard-Konfiguration

Mit dem Dialogfeld CodeGuard-Konfiguration legen Sie das Verhalten des CodeGuard-Laufzeit-Debuggers fest. Sie können dieses Dialogfeld durch Ausführen des Hilfsprogramms cgconfig.exe aufrufen, das im Produktinstallationsverzeichnis verfügbar ist. Wenn Sie Einstellungen im Dialogfeld CodeGuard-Konfiguration ändern, wird eine .cgi-Konfigurationsdatei mit dem Namen des Projekts erstellt und im Projektverzeichnis gespeichert.

Hinweis: CodeGuard steht nur für C++-Projekte zur Verfügung.
Element Beschreibung

Aktivieren (CodeGuard)

Aktiviert oder deaktiviert CodeGuard.

Stack-Füllfrequenz

Gibt an, wie häufig CodeGuard den nicht initialisierten Teil des Laufzeit-Stack mit einem eindeutigen Byte-Muster füllt. Werte:

  • -1 = Nie
  • 0 = Nach jedem Aufruf einer Laufzeitfunktion, die von CodeGuard abgedeckt wird.
  • n [0...15] = Nach allen 2^n Aufrufen einer Laufzeitfunktion, die von CodeGuard abgedeckt wird. Zum Beispiel, wenn n 1 ist, dann wird der Stack jedes zweite Mal gefüllt, wenn eine Laufzeitfunktion aufgerufen wird.

Statistik

Gibt eine Funktions- und Ressourcenverwendungsstatistik aus.

Ressourcen-Lecks

Gibt Ressourcen-Lecks an, die nach dem Ende der Anwendung entdeckt wurden.

An OutputDebugString senden

Verwendet die Funktion OutputDebugString, um CodeGuard-Meldungen an den externen Debugger zu senden.

An Protokoll anhängen

Hängt das Fehlerprotokoll an das vorhandene Protokoll an. Wenn diese Option deaktiviert ist, überschreibt CodeGuard das vorhandene Fehlerprotokoll.

Wiederkehrende Fehler

Meldet Fehler, die wiederholt in einer Funktion auftreten.

Anzahl von Fehlermeldungen begrenzen

Beschränkt die Anzahl der berichteten Fehler. Sie können einen Maximalwert von 65535 eingeben.

Aktivieren (Fehlermeldung)

Aktiviert das Fehlermeldungsfenster. Wenn Sie eine CodeGuard-aktivierte Anwendung außerhalb von RAD Studio ausführen, wird das Fehlermeldungsfenster angezeigt, wenn Laufzeitfehler auftreten.

Titel

Legt den Text fest, der in der Titelleiste des Fensters angezeigt wird.

Meldung

Legt die angezeigte Fehlermeldung fest.

Debug-Info lesen

Ermöglicht, dass CodeGuard anhand der Debug-Informationen in Ihrem Projekt auf eine Quelltextzeile verweisen kann, wenn ein Laufzeitfehler aufgetreten ist.

Quellpfad

Wenn sich der Quellcode an einem anderen Speicherort befindet als die ausführbare Datei, dann geben Sie hier den Pfad (oder die Pfade, getrennt durch Semikolon) an. CodeGuard überprüft zunächst den eigenen Debug-Quellpfad und dann den IDE-Debug-Quellpfad (sofern CodeGuard in der IDE ausgeführt wird).

Ressourcenoptionen

Verwenden Sie die Seite Ressourcenoptionen, um anzugeben, wie CodeGuard die verschiedenen Ressourcentypen behandeln soll.

Element Beschreibung

Ressourcen

Listet die Ressourcentypen auf, die CodeGuard behandeln kann:
Speicherblock – Speicher, der von den Funktionen malloc und free verwaltet wird.
Objekt – Speicher, der von den Operatoren new und delete verwaltet wird.
Objektarray – Speicher, der von den Operatoren new[] und delete[] verwaltet wird.
Datei-Handle – Datei, die von den Funktionen open und close verwaltet wird.
Datei-Stream – Datei, die von den Funktionen fopen und fclose verwaltet wird.
Pipe-Stream – Befehls-Prozessor-Pipe, die von den Funktionen _popen und _pclose verwaltet wird.
Verzeichnis-Stream – Verzeichnis, das von den Funktionen opendir und closedir verwaltet wird.

Verfolgung aktivieren

Aktiviert die Verfolgung der ausgewählten Ressource. Eine deaktivierte Verfolgung führt zu geringerer Speicherbeanspruchung und schnellerer Ausführung.

Ressourcen-Lecks verfolgen

Gibt Ressourcen-Zuweisungen an, die keine entsprechende Freigabe haben. Zum Beispiel kann ein Leck durch fehlende Freigabe eines Datei-Handles vor dem Programmabbruch entstehen.

Meldung bei ungültigen Handle- oder Ressourcen-Parametern

Gibt eine nicht korrekte Verwendung der Ressourcen in Funktionsargumenten an.

Freigabe verzögern

Verfolgt die ausgewählte Ressource nach der Freigabe. Ist die Option Freigabe verzögern aktiv, kennzeichnet CodeGuard jede Ressource einmal, sobald sie freigegeben ist. Gleichzeitig werden Windows und die Laufzeit-Bibliotheken daran gehindert, die Ressource wiederzuverwenden.
Einige Ressourcen, z.B. Stack-Speicherzuweisungen, können nicht in die Warteschlange für die verzögerte Freigabe gestellt werden.

Länge der Verzögerungswarteschlange

Gibt die Anzahl der Objekte an, die für die verzögerte Freigabe in die Warteschlange gestellt werden können. Sie können einen Maximalwert von 65535 Objekten eingeben.

Max. Größe für Speicherblöcke

Gibt die maximale Anzahl der Speicherblöcke an, die CodeGuard in der Warteschlange speichern kann. Sie können einen Maximalwert von 65535 Byte festlegen.

Funktionsoptionen

Verwenden Sie die Seite Funktionsoptionen, um anzugeben, wie CodeGuard die verschiedenen Funktionstypen behandeln soll.

Element Beschreibung

Funktionen

Listet die Funktionen auf, die CodeGuard verfolgen kann.

Funktionsverfolgung deaktivieren

Deaktiviert die Funktionsverfolgung für die ausgewählten Funktionen.

Speicherzugriffsfehler

Meldet einen Laufzeitfehler, wenn eine Funktion einen Zeiger auf ungültigen Speicher verwendet.

Jeden Aufruf protokollieren

Meldet jeden Aufruf der ausgewählten Funktionen.

Warnungen

Meldet Situationen, in denen die Anwendung auf einen Speicherplatz jenseits der Maximalgröße des Puffers zugreift.
Warnungen werden nur für die folgenden Laufzeit-Bibliotheksfunktionen ausgegeben:
strncmp, strnicmp, strncmpi, _fstrncmp, _fstrnicmp, memcmp, memicmp, _fmemcmp, _fmemicmp, fnmerge, fnsplit, getcurdir.

Fehler bei Funktionsergebnissen

Meldet, wenn die ausgewählte Funktion einen Wert zurückgibt, der einen Fehler anzeigt.

Ungültige Handle- und Ressourcenparameter

Wenn es sich bei einem der ausgewählten Funktionsparameter um einen Handle- oder Ressourcenbezeichner handelt, sollte überprüft werden, ob dieser korrekt zugewiesen und aktuell gültig ist.

Standardoptionen setzen

Zeigt das Dialogfeld Standard-Funktionsoptionen festlegen an, in dem Sie die Standard-Funktionsoptionen anzeigen und setzen können.

Standard-Funktionsoptionen

Weist den ausgewählten Funktionen die Standard-Funktionsoptionen zu.

Ignorierte Module

Auf der Seite Ignorierte Module geben Sie die Module an, die CodeGuard beim Fehlerbericht überspringen soll.

Siehe auch