.dump (Create Dump File)

Der Dump-Befehl erstellt eine Absturzabbilddatei für den Benutzermodus oder den Kernelmodus.

.dump [options] FileName
.dump /?

Parameter

Optionen
Stellt eine oder mehrere der folgenden Optionen dar.

/a
Erstellen von Dumps für alle Prozesse (erfordert -u).

/b[a]
Paketabbild in einem CAB- und Löschabbild. Zusätzliche Informationen werden eingeschlossen, wenn die Option angegeben wird.

/c <kommentar>
Fügen Sie einen Kommentar hinzu (wird in allen Formaten nicht unterstützt).

/j <addr>
Geben Sie eine JIT_DEBUG_INFO Adresse an.

/o
Überschreibt eine vorhandene Dumpdatei mit demselben Namen. Wenn diese Option nicht verwendet wird und eine Datei mit demselben Dateinamen vorhanden ist, wird die Speicherabbilddatei nicht geschrieben.

/u
Fügen Sie einen eindeutigen Bezeichner an, um den Dumpnamen zu benennen.

/f[FullOptions]
(Kernelmodus:) Erstellt ein vollständiges Speicherabbild.

(Benutzermodus:) Nicht unterstützt. Bisher würde diese Option ein vollständiges Benutzermodusabbild erstellen, bei dem es sich um ein älteres Format mit weniger Informationen als dem neueren Minidumpformat handelt. Weitere Informationen finden Sie unter "Varianten von Benutzermodusabbilddateien".

Sie können die folgenden FullOptions hinzufügen, um den Inhalt der Dumpdatei zu ändern. Bei der Option wird die Groß-/Kleinschreibung beachtet.

FullOption	Effekt
y	Fügt der Speicherabbilddatei AVX-Registerinformationen hinzu.

/m[MiniOptions]
Erstellt ein kleines Speicherabbild (im Kernelmodus) oder einen Minidump (im Benutzermodus) Weitere Informationen finden Sie unter "Benutzermodusabbilddateien". Wenn weder /f noch /m angegeben ist, ist /m der Standardwert.

Im Benutzermodus kann /m mit zusätzlichen MiniOptions gefolgt werden, die zusätzliche Daten angeben, die im Dump enthalten sein sollen. Wenn keine MiniOptions enthalten sind, enthält das Dump Modul-, Thread- und Stapelinformationen, aber keine zusätzlichen Daten. Sie können eine der folgenden MiniOptions hinzufügen, um den Inhalt der Speicherabbilddatei zu ändern. Die Groß-/Kleinschreibung wird beachtet.

MiniOption	Effekt
a	Erstellt einen Minidump mit allen optionalen Ergänzungen. Die /ma-Option entspricht /mfFhut - sie fügt vollständige Speicherdaten hinzu, verarbeitet Daten, entladene Modulinformationen, grundlegende Speicherinformationen und Threadzeitinformationen zum Minidump. Ein Fehler beim Lesen des nicht erreichbaren Speichers führt zum Beenden der Minidumpgenerierung.
A	Die /mA-Option entspricht /ma, mit der Ausnahme, dass sie alle Fehler beim Lesen des nicht verfügbaren Speichers ignoriert und den Minidump weiterhin generiert.
f	Fügt dem Minidump vollständige Speicherdaten hinzu. Alle barrierefreien zugesicherten Seiten, die der Zielanwendung gehören, werden einbezogen.
Fr	Fügt dem Minidump alle grundlegenden Speicherinformationen hinzu. Dadurch wird dem Minidump ein Datenstrom hinzugefügt, der alle grundlegenden Speicherinformationen enthält, nicht nur Informationen zum gültigen Speicher. Dadurch kann der Debugger das vollständige layout des virtuellen Speichers des Prozesses rekonstruieren, wenn der Minidump gedebuggt wird.
h	Fügt dem Minidump Daten zu den Ziehpunkten hinzu, die der Zielanwendung zugeordnet sind.
n	Fügt dem Minidump ungeladene Modulinformationen hinzu.
t	Fügt dem Minidump zusätzliche Threadinformationen hinzu. Dazu gehören Threadzeiten, die beim Debuggen des Minidumps mithilfe der Erweiterung "!runaway" oder des Befehls ".ttime" (Anzeigethreadzeiten) angezeigt werden können.
i	Fügt dem Minidump sekundären Speicher hinzu. Sekundärer Speicher ist jeder Speicher, auf den ein Zeiger im Stapel oder Sicherungsspeicher verweist, sowie eine kleine Region, die diese Adresse umgibt.
p	Fügt dem Minidump Prozessumgebungsblock -Daten (Process Environment Block, PEB) und Threadumgebungsblock (Thread Environment Block, TEB) hinzu. Dies kann nützlich sein, wenn Sie Zugriff auf Windows-Systeminformationen zu den Prozessen und Threads der Anwendung benötigen.
a	Fügt alle zugesicherten privaten Seiten mit Lese-/Schreibzugriff zum Minidump hinzu.
d	Fügt alle Lese-/Schreibdatensegmente innerhalb des ausführbaren Images zum Minidump hinzu.
c	Fügt Codeabschnitte in Bildern hinzu.
r	Löscht aus dem Minidump diese Teile des Stapels und speichert Arbeitsspeicher, die für die Neuerstellen der Stapelablaufverfolgung nicht hilfreich sind. Lokale Variablen und andere Datentypwerte werden ebenfalls gelöscht. Diese Option macht den Minidump nicht kleiner (da diese Speicherabschnitte einfach null sind), aber es ist nützlich, wenn Sie die Privatsphäre anderer Anwendungen schützen möchten.
R	Löscht die vollständigen Modulpfade aus dem Minidump. Nur die Modulnamen werden einbezogen. Dies ist eine nützliche Option, wenn Sie die Privatsphäre der Verzeichnisstruktur des Benutzers schützen möchten.
j	Fügt der Speicherabbilddatei AVX-Registerinformationen hinzu.

Kernelmodusoptionen

Die folgenden Optionen sind im Kernelmodus verfügbar.

/k
Erstellen Sie ein Dump nur mit Kernelspeicher.

/Ka
Erstellen Sie ein Dump mit aktivem Kernel- und Benutzermodusspeicher.

Zusätzliche Informationen

Eine Beschreibung der Kernelmodus-Dumpdateien und eine Erläuterung ihrer Verwendung finden Sie unter Kernelmodus-Dumpdateien. Eine Beschreibung der Abbilddateien für den Benutzermodus und eine Erläuterung ihrer Verwendung finden Sie unter "Benutzermodusabbilddateien".

Hinweise

Dieser Befehl kann in einer Vielzahl von Situationen verwendet werden:

• Während des Debuggens im Live-Benutzermodus leitet dieser Befehl die Zielanwendung an, um eine Speicherabbilddatei zu generieren, die Zielanwendung wird jedoch nicht beendet.

• Während des Debuggens im Live-Kernelmodus leitet dieser Befehl den Zielcomputer an, um eine Speicherabbilddatei zu generieren, der Zielcomputer stürzt jedoch nicht ab.

• Während des Absturzabbilddebuggings erstellt dieser Befehl eine neue Absturzabbilddatei aus dem alten. Dies ist nützlich, wenn Sie über eine große Absturzabbilddatei verfügen und eine kleinere erstellen möchten.

Sie können steuern, welche Art von Dumpdatei erstellt wird:

• Verwenden Sie im Kernelmodus die Option "/f", um ein vollständiges Speicherabbild zu erzeugen. Um ein kleines Speicherabbild zu erzeugen, verwenden Sie die Option /m (oder keine Optionen). Der .dump-Befehl kann kein Kernelspeicherabbild erzeugen.

• Im Benutzermodus ist .dump /m[MiniOptions] die beste Wahl. Obwohl "m" für "minidump" steht, können die mit dieser MiniOption erstellten Dumpdateien von sehr klein bis sehr groß variieren. Durch Angeben der richtigen MiniOptions können Sie genau steuern, welche Informationen enthalten sind. Beispiel: ".dump /ma " erzeugt ein Dump mit einer großen Menge an Informationen. Der ältere Befehl .dump /f erzeugt eine mäßig große Standardabbilddatei und kann nicht angepasst werden.

Sie können nicht angeben, welcher Prozess gedumpt wird. Alle ausgeführten Prozesse werden gedumpt.

Die Optionen "/xc", "/xr", "/xp" und "/xt" werden verwendet, um Ausnahme- und Kontextinformationen in der Dumpdatei zu speichern. Dadurch kann der Ecxr-Befehl (Ausnahmekontextdatensatz anzeigen) in dieser Dumpdatei ausgeführt werden.

Im folgenden Beispiel wird ein Benutzermodus-Minidump erstellt, das vollständigen Arbeitsspeicher enthält und Informationen behandelt:

0:000> .dump /mfh myfile.dmp

Behandeln von Informationen können mithilfe des Erweiterungsbefehls "!handle " gelesen werden.

Weitere Informationen

Varianten von Kernelmodus-Speicherabbilddateien

ECXR