SymChk-Befehlszeilenoptionen

SymChk verwendet die folgende Syntax:

symchk [/r] [/v | /q ] FileNames /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ie ExeFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /id DumpFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ih HotFixFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ip ProcessID /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /it TextFileList /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /om Manifest FileNames

symchk [/v | /q ] /im ManifestList /s[Opts] SymbolPath Options

symchk [/v | /q ] /om Manifest /ie ExeFile

symchk [/v | /q ] /om Manifest /id DumpFile

symchk [/v | /q ] /om Manifest /ih HotFixFile

symchk [/v | /q ] /om Manifest /ip ProcessFile

symchk [/v | /q ] /om Manifest /it TextFileList

Parameter

/r
Wenn Dateien ein Verzeichnis angeben, bewirkt die Option "/r ", dass SymChk alle Unterverzeichnisse unter diesem Verzeichnis rekursiv nach Programmdateien durchsucht.

/v
Zeigt ausführliche Informationen an. Dazu gehört der Dateiname jeder Programmdatei, deren Symbole untersucht wurden und ob sie bestanden, fehlgeschlagen oder ignoriert wurde.

/q
Aktiviert den ruhen Modus. Alle Ausgaben werden unterdrückt (es sei denn, die /ot-Option ist enthalten).

Filenamen
Gibt die Programmdateien an, deren Symbole überprüft werden sollen. Absolute Pfade, relative Pfade und UNC-Pfade sind zulässig. Ein Sternchen (*) ist zulässig. Wenn *FileNames in einem Schrägstrich endet, wird es als Verzeichnisname verwendet, und alle Dateien innerhalb dieses Verzeichnisses werden überprüft. Wenn FileNames Leerzeichen enthält, muss sie in Anführungszeichen eingeschlossen werden.

/ie ExeFile
Gibt den Namen eines Programms an, das zurzeit ausgeführt wird. Die Symbole für dieses Programm werden überprüft. ExeFile muss den Namen der Datei- und Dateierweiterung (in der Regel .exe), aber keine Pfadinformationen enthalten. Wenn zwei verschiedene ausführbare Dateien mit demselben Namen vorhanden sind, wird diese Option nicht empfohlen. ExeFile kann jedes Programm angeben, einschließlich eines Kernelmodustreibers. Wenn ExeFile ein einzelnes Sternchen (*) ist, überprüft SymChk die Symbole für alle ausgeführten Prozesse, einschließlich Treibern.

/id DumpFile
Gibt eine Speicherabbilddatei an. Die Symbole für diese Dumpdatei werden überprüft.

/ih HotFixFile
Gibt eine selbst extrahierende Hotfix CAB-Datei an.

/ip ProcessID
Gibt die Prozess-ID eines Programms an, das derzeit ausgeführt wird. Die Symbole für dieses Programm werden überprüft. ProcessID muss als Dezimalzahl angegeben werden. Es werden zwei spezielle Wildcards unterstützt:

• Wenn ProcessID null ( 0 ) ist, überprüft SymChk die Symbole für alle ausgeführten Treiber.

• Wenn ProcessID ein einzelnes Sternchen (*) ist, überprüft SymChk die Symbole für alle ausgeführten Prozesse, einschließlich Treibern.

/es TextFileList
Gibt eine Textdatei an, die eine Liste von Programmdateien enthält. Die Symbole für alle diese Programme werden überprüft. TextFileList muss genau eine Datei (durch relativen, absoluten oder UNC-Pfad, jedoch ohne Platzhalter) angeben. Wenn sie Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden. In dieser Datei gibt jede Zeile eine Programmdatei (durch relative, absolute oder UNC-Pfade) an, und ein Sternchen* () ist zulässig. Jede Zeile, die diesen Wildcard verwendet, muss jedoch einen relativen Pfad verwenden.

Wenn eine Zeile in dieser Datei Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden. Ein Semikolon in dieser Datei ist ein Kommentarzeichen – alles zwischen einem Semikolon und dem Ende der Zeile wird ignoriert.

/im ManifestList
Gibt an, dass die Eingabe an den Befehl eine Manifestdatei ist, die zuvor mithilfe des Parameters "/om " erstellt wurde. Die Manifestdatei enthält Informationen zu den Dateien, für die Symbole abgerufen werden. Weitere Informationen zur Verwendung einer Manifestdatei finden Sie unter Verwenden einer Manifestdatei mit SymChk.

/Om Manifest
Gibt an, dass eine Manifestdatei erstellt wird. Die Manifestdatei enthält Informationen zu einer Reihe von Dateien, für die Symbole mithilfe des Parameters "/im " zu einem späteren Zeitpunkt abgerufen werden.

/s[Opts] SymbolPath
Gibt die Verzeichnisse an, die Symbole enthalten. Absolute Pfade, relative Pfade und UNC-Pfade sind zulässig. Eine beliebige Anzahl von Verzeichnissen kann angegeben werden – mehrere Verzeichnisse sollten durch Semikolons getrennt werden. Wenn SymbolPath Leerzeichen enthält, muss es in Anführungszeichen eingeschlossen werden. Wenn Sie einen Symbolserver in diesem Pfad angeben möchten, sollten Sie eine der folgenden Syntaxen verwenden:

srv*DownstreamStore*\\Server\Share
srv*\\Server\Share

Es wird nicht empfohlen, den Parameter "/s[Opts] SymbolPath" wegzulassen, aber wenn er weggelassen wird, verweist SymChk mithilfe des folgenden Standardpfads auf den öffentlichen Symbolspeicher:

srv*%SystemRoot%\symbols*https://msdl.microsoft.com/download/symbols

Eine beliebige Anzahl der folgenden Optionen kann /s folgen. Zwischen " /s " und den folgenden Optionen kann kein Leerraum vorhanden sein:

e
SymChk überprüft jeden Pfad einzeln, anstatt alle Pfade gleichzeitig zu überprüfen.

n
Nachgeschaltete Speicher werden aktualisiert. Wenn der Symbolpfad einen nachgelagerten Speicher enthält, wird der Symbolspeicher nach den Symboldateien gesucht. Nur Symbolspeicher, die von SymChk überprüft werden, werden aktualisiert.

p
Erzwingen der Überprüfung auf private Symbole. Öffentliche Symbole werden als nicht übereinstimmend behandelt. Die p-Option impliziert e und u und kann nicht mit s verwendet werden.

s
Erzwingen der Überprüfung auf öffentliche (geteilte) Symbole. Private Symbole werden als nicht übereinstimmend behandelt. Die Option s impliziert e und u und kann nicht mit p verwendet werden.

r
Erweitern Sie alle Nichtsymbolserverelemente im angegebenen Pfad, um eine tiefe Suche des Pfads durchzuführen. HINWEIS: Diese Option kann Übereinstimmungen erzeugen, die nicht innerhalb des Debuggers auftreten, da der angegebene Symbolpfad geändert wird.

Optionen Die verfügbaren Optionen sind in mehrere Klassen unterteilt. Jede Optionsklasse steuert einen anderen Satz von Features.

Ausgabeoptionen. Eine beliebige Anzahl der folgenden Optionen kann angegeben werden. Diese Optionen können mit /o nur einmal abgekürzt werden - z . B. kann /oi /oe als /oie geschrieben werden.

Option	Effek
/Œ	Die Ausgabe enthält einzelne Fehler. Diese Option ist nur dann nützlich, wenn /q verwendet wird, da einzelne Fehler automatisch angezeigt werden, wenn der stille Modus nicht aktiviert wurde.
/op	Die Ausgabe listet jede datei auf, die übergeben wird. (Standardmäßig zeigt SymChk nur Dateien an, bei denen Tests fehlschlagen.)
/oi	Die Ausgabe listet jede Datei auf, die ignoriert wurde. (Standardmäßig zeigt SymChk nur Dateien an, bei denen Tests fehlschlagen.)
/Od	Die Ausgabe enthält vollständige Details. Identisch mit /oe /op /oi.
/Ot	Die Ausgabe enthält Ergebnissummen. Diese Option ist nur dann nützlich, wenn /q verwendet wird, da diese Summen automatisch angezeigt werden, wenn der stille Modus nicht aktiviert wurde.
/ob	Der vollständige Pfad für Binärdateien wird in alle Ausgabemeldungen eingeschlossen.
/Os	Der vollständige Pfad für Symbole wird in alle Ausgabemeldungen eingeschlossen.
/oc Dir	SymChk erstellt eine traditionelle Symbolstruktur im Verzeichnis Dir , die eine Liste aller aktivierten Symboldateien enthält.
/Ov	SymChk druckt auch Versionsinformationen für aktivierte Binärdateien.
/ol File	Schreiben Sie zusätzlich zu den an standard gesendeten Nachrichten eine Datei, die eine durch Trennzeichen getrennte Liste aller Binärdateien und deren Symbole enthält, die die Symbolüberprüfung bestehen.

DBG-Dateioptionen. Diese Optionen steuern, wie SymChk .dbg-Symboldateien überprüft. Es kann nur eine der folgenden Optionen angegeben werden.

Option	Effek
/Ds	SymChk überprüft, ob DIE DBG-Informationen aus der ausführbaren Datei entfernt wurden und nur in der DBG-Datei angezeigt werden und dass die ausführbare Datei auf die DBG-Datei verweist. Wenn das Programm ohne DBG-Symboldateien erstellt wurde, hat diese Option keine Auswirkung. Dies ist die Standardeinstellung.
/de	SymChk überprüft, ob die DBG-Informationen nicht aus der ausführbaren Datei entfernt wurden und dass die ausführbare Datei nicht auf eine DBG-Datei verweist. Wenn das Programm ohne DBG-Symboldateien erstellt wurde, hat diese Option keine Auswirkung.
/Dn	SymChk überprüft, ob die DBG-Informationen im Bild nicht vorhanden sind und dass das Bild nicht auf eine DBG-Datei verweist.

PDB-Dateioptionen. Diese Optionen steuern, wie SymChk .pdb-Symboldateien überprüft. Es kann nur eine der folgenden Optionen angegeben werden.

Option	Effek
/pf	SymChk führt keine Überprüfung des Inhalts der PDB-Datei durch – es überprüft lediglich, ob die Dateien vorhanden sind und mit der Binärdatei übereinstimmen. Dies ist die Standardeinstellung.
/PS	SymChk überprüft, ob die PDB-Dateien aus der Quellzeile, dem Datentyp und globalen Informationen entfernt wurden.
/Pt	SymChk überprüft, ob die PDB-Dateien Datentypinformationen enthalten.

Filteroptionen. Diese Optionen steuern, wie modulfiltert wird, wenn SymChk Prozesse überprüft oder Dumpdateien abbildt. Es kann nur eine der folgenden Optionen angegeben werden.

Option	Effek
/fm-Modul	SymChk überprüft nur Dumpdateien oder Prozesse, die dem angegebenen Modul zugeordnet sind. Das Modul muss den vollständigen Dateinamen enthalten, darf jedoch keinen Teil des Verzeichnispfads enthalten.

Symbolüberprüfungsoptionen. Eine beliebige Anzahl der folgenden Optionen kann angegeben werden.

Option	Effek
/Cs	SymChk überprüft nicht, ob CodeView-Daten vorhanden sind. (Standardmäßig wird das Vorhandensein von CodeView-Daten überprüft.)
/cc	Wenn SymChk eine Hotfix-CAB-Datei überprüft, sucht sie nicht nach Symbolen innerhalb der CAB-Datei. (Standardmäßig sucht SymChk nach Symbolen im Cab sowie im bereitgestellten Symbolpfad.)
/ea-Datei	SymChk überprüft keine Symbole für die programme, die in der angegebenen Datei aufgeführt sind. Auf diese Weise können Sie bestimmte Programme vetoieren, die andernfalls überprüft werden. Die Datei muss genau eine Datei (durch relativen, absoluten oder UNC-Pfad, aber ohne Platzhalter) angeben. Wenn sie Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden. Innerhalb der Datei gibt jede Zeile eine Programmdatei an (durch relative, absolute oder UNC-Pfade); es sind keine Wildcards zulässig. Wenn eine Zeile in dieser Datei Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden. Ein Semikolon in dieser Datei ist ein Kommentarzeichen – alles zwischen einem Semikolon und dem Ende der Zeile wird ignoriert. Wenn ein Symbolserver verwendet wird, werden Symbole für diese Programme nicht in den nachgelagerten Speicher kopiert.
/ee-Datei	Fehlermeldungen für die in der angegebenen Datei aufgeführten Programme werden unterdrückt. "Erfolgsmeldungen" und "Ignorieren" werden wie gewohnt angezeigt, und Symboldateien werden wie gewohnt in den nachgelagerten Speicher kopiert. Das Format der Datei und das Format des Inhalts sind identisch mit dem für /ea File.

Zusätzliche Informationen

Weitere Informationen zu SymChk finden Sie unter Verwenden von SymChk.