WinDbg: Možnosti spuštění příkazového řádku

logo WinDbg s lupou, která kontroluje bity.

Spuštění WinDbg

Po instalaci WinDbg je WinDbgX.exe k dispozici ke spuštění z libovolného umístění adresáře.

Možnosti spuštění příkazového řádku

WinDbgX [options]

Následující tabulky shrnují dostupné možnosti příkazového řádku.

Obecné možnosti

Option Description
-c command Spustí příkazový řádek po připojení ladicího programu. Tento příkaz musí být uzavřený do uvozovek. Více příkazů lze oddělit středníky.
-v Umožňuje podrobný výstup v debuggeru.
-T Title Nastaví název okna.
-Q Zakáže automatické ukládání nastavení. Změny nastavení se zachovají, jenom když explicitně vyberetepracovní prostor Uložitsoubor> nebo Uložit pracovní prostor jako.
-WF SettingsFile Načte nastavení ze zadaného souboru pracovního prostoru.
-logo LogFile Otevřete protokol. Začne zapisovat informace do protokolového souboru. Pokud soubor existuje, soubor bude přepsán.
-loga LogFile Připojení protokolu. Začne zapisovat informace do protokolového souboru. Pokud soubor existuje, připojí se k němu.
-e EventHandle Signalizuje událost s danou rukojetí po další výjimce ve sledovaném objektu.
-? Zobrazí souhrn dostupných příkazů.

Možnosti jádra

Option Description
-d Po restartování, jakmile je načten modul jádra, se ladicí program přerušením připojí k cílovému počítači.
-k \[ConnectType\] Spustí relaci ladění jádra. Pokud se parametr -k použije bez jakýchkoli možností ConnectType , musí se jednat o konečnou položku na příkazovém řádku.
-kqm Spustí KD v tichém režimu.
-kl Spustí relaci ladění jádra na stejném počítači jako debugger.
-kx ExdiOptions Spustí ladicí relaci jádra pomocí ovladače EXDI. Další informace o EXDI naleznete v tématu Konfigurace přenosu ladicího programu EXDI.
-I Po restartování, jakmile je načten modul jádra, se ladicí program přerušením připojí k cílovému počítači.

Možnosti uživatelského režimu

Option Description
-o Odlaďuje všechny procesy spuštěné cílovou aplikací (podřízené procesy).
-g Ignoruje počáteční bod zlomu v cílové aplikaci.
-G Ignoruje konečný bod přerušení v cílové aplikaci.
-pv Určuje, že ladicí program by se měl k cílovému procesu připojit neinvazivním způsobem.
-hd Určuje, že by se neměla používat halda ladění.
-cimp Určuje, že všechny vytvořené procesy budou používat implicitní příkazový řádek nastavený serverem místo řetězce příkazového řádku zadaného uživatelem z klienta.

Možnosti cíle

Option Description
-remote ClientTransport Připojí se k ladicímu serveru, který je již spuštěný. Vysvětlení možných hodnot ClientTransport naleznete v tématu Aktivace klienta ladění. Při použití tohoto parametru musí být prvními parametry na příkazovém řádku.
-server ServerTransport Vytvoří ladicí server, ke kterému mají přístup další ladicí programy. Vysvětlení možných hodnot ServerTransport naleznete v tématu Aktivace ladicí server.
-premote SmartClientTransport Vytvoří inteligentního klienta a připojí se k procesovém serveru, který je již spuštěný. Vysvětlení možných hodnot SmartClientTransport naleznete v tématu Aktivace inteligentního klienta.
-p PID Určuje desetinné ID procesu, které se má ladit.
-tid TID Určuje ID vlákna, které se má obnovit, když je zahájena ladicí relace.
-psn ServiceName Určuje název služby obsažené v procesu, který se má ladit. Používá se k odstraňování chyb u procesu, který již běží.
-pn ProcessName Určuje název procesu, který se má ladit.
-z DumpFile Určuje název souboru s výpisem stavu systému, který se má ladit. Pokud cesta a název souboru obsahují mezery, musí být ohraničené uvozovkami.
-debugArch x86 -or- amd64 Přepište automatické rozpoznávání a nastavte cílovou bitovou velikost pro ladicí program.
-loadSession Načtěte uložený konfigurační soubor relace.
-setupFirewallRules Nakonfiguruje požadovaná pravidla brány firewall v místním systému tak, aby povolovala ladění jádra pomocí KDNET.
-openPrivateDumpByHandle Handle Pouze interní použití Microsoftu. Určuje popisovač souboru s výpisem stavu systému, který se má ladit.
-benchmarkStartup Pouze interní použití Microsoftu. Spustí spouštěcí srovnávací test a připojí výsledek k souboru.

Možnosti symbolů

Option Description
-y SymbolPath Určuje cestu symbolu, která se má použít. Oddělte více cest středníkem (;). Pokud cesta obsahuje mezery, je vhodné ji uvést v uvozovkách. Podrobnosti a další způsoby, jak tuto cestu změnit, najdete v tématu Cesta symbolu.
-n Hlučné načítání symbolu Povolí podrobný výstup ze správy symbolů.
-i *ImagePath Nastaví cestu hledání obrázků, která se má použít.
-sdce Způsobí, že ladicí program během načítání symbolů zobrazí chybové zprávy o přístupu k souboru.
-ses Způsobí, že ladicí program provede striktní vyhodnocení všech souborů symbolů a ignoruje všechny pochybitelné symboly.
-sicv Způsobí, že obslužná rutina symbolu bude ignorovat záznam CV.
-sins Způsobí, že ladicí program ignoruje proměnné prostředí pro symbolovou cestu a cestu k spustitelnému obrazu.
-snc Způsobí, že ladicí program vypne překlad jazyka C++.
-snul Zakáže automatické načítání symbolů pro nekvalifikované názvy.
-sup Způsobí, že obslužná rutina symbolu prohledá veřejnou tabulku symbolů během každého hledání symbolů.
-sflags Nastaví všechny možnosti obslužné rutiny symbolů najednou.

Možnosti cesty ke zdroji

Option Description
-srcpath Určuje cestu ke zdroji, která bude použita na ladicím serveru.
-lsrcpath Určuje zdrojová cesta, která se má použít v místním klientovi.

Pokud jste v relaci místního ladicího programu, cesta srcpath a lsrcpath jsou v podstatě stejné (váš "server" je místní relace.) Pro vzdálené ladění existují situace, kdy je můžete chtít nastavit na různé hodnoty. Další informace o vzdáleném ladění naleznete v tématu Vzdálené ladění.

Zpracování výjimek

Option Description
-x Povolte zpracování druhé šance pouze pro výjimky týkající se porušení přístupu.
-xe Exception Povolte zpracování předběžných výjimek pro zadanou výjimku.
-xd Exception Povolte zpracování výjimek druhé šance pro zadanou výjimku.
-xn Exception Pro danou výjimku zakažte zpracování první a druhé šance a zobrazte v konzole pouze zprávu.
-xi Exception Zcela ignorujte danou výjimku, zakažte prvotní a druhotné zpracování a nevypisujte nic do konzoly.

Seznam výjimek, které lze zadat, naleznete v tématu Definice a výchozí hodnoty události.

Pitva

Option Description
-I Nastaví WinDbg jako výchozí ladicí program post-mortem pro systém.
-IS Nastaví WinDbg jako výchozí ladicí program post-mortem pro systém bezobslužně s pouze nahlášenými chybami.

Zastaralé možnosti

Option Description
-QY Zastaralá možnost příkazového řádku
-QS Zastaralá možnost příkazového řádku
-QSY Zastaralá možnost příkazového řádku
-WX Zastaralá možnost příkazového řádku

Obecné informace o spouštěcích parametrech naleznete v tématu WinDbg Command-Line Možnosti.

Můžete použít -? k zobrazení seznamu podporovaných možností příkazového řádku.

Snímek obrazovky s příkazovým řádkem WinDbgX zobrazující výstup s různými možnostmi