Živé ladění Kernel-Mode pomocí nástroje WinDbg (Classic)

WinDbg můžete použít dvěma způsoby, jak můžete zahájit živou ladicí relaci v režimu jádra.

Nabídka WinDbg

Pokud je WinDbg v neaktivním režimu, můžete zahájit ladicí relaci jádra tak, že v nabídce Soubor zvolíte Ladění jádra nebo stisknete kombinaci kláves CTRL+K. Po zobrazení dialogového okna Ladění jádra klikněte na příslušnou kartu: NET, COM, USB nebo Místní. Každá záložka určuje jinou metodu připojení.

Příkazový řádek

V okně příkazového řádku můžete zahájit ladicí relaci režimu jádra, když spustíte WinDbg. Zadejte jeden z následujících příkazů:

windbg [-y SymbolPath] -k net:port=PortNumber,key=Key[,target=TargetIPAddress|TargetMachineName]

windbg [-y SymbolPath] -k usb:targetname=USBString

windbg [-y SymbolPath] -k com:port=ComPort,baud=BaudRate

windbg [-y SymbolPath] -k com:ipport=SerialTcpIpPort,port=SerialIPAddress

windbg [-y SymbolPath] -k com:pipe,port=\\\\VMHost\\pipe\\PipeName[,resets=0][,reconnect]

windbg [-y SymbolPath] -k com:modem

windbg [-y SymbolPath] -kl

windbg [-y SymbolPath] -k

Další informace naleznete v tématu WinDbg Command-Line Možnosti.

Proměnné prostředí

Pro ladění přes sériový port (port COM) můžete použít proměnné prostředí k určení nastavení připojení.

K určení sériového připojení použijte následující proměnné.

set _NT_DEBUG_PORT = ComPort

set _NT_DEBUG_BAUD_RATE = BaudRate

Další informace najdete v tématu Kernel-Mode proměnné prostředí.

Parametry

SymbolPath
Seznam adresářů, kde jsou umístěné soubory symbolů. Adresáře v seznamu jsou oddělené středníky. Další informace naleznete v tématu Cesta k symbolům.

Číslo portu
Číslo portu, které se má použít pro ladění sítě. Můžete zvolit libovolné číslo od 49152 do 65535. Další informace naleznete v tématu Ruční nastavení síťového připojení.

Klíč
Šifrovací klíč, který se má použít pro ladění sítě. Doporučujeme použít automaticky vygenerovaný klíč, který poskytuje bcdedit při konfiguraci cílového počítače. Další informace naleznete v tématu Ruční nastavení síťového připojení.

TargetIPAddress
Adresa IPv4 cílového počítače.

Když je specifikována adresa IP cíle, způsobí to, že ladicí program zahájí připojení k cílovému počítači odesláním speciálního paketu k cíli, což způsobí pokus o připojení k tomuto ladicímu programu. Ladicí program bude opakovaně posílat datagramy do cíle přibližně každou půl sekundu, aby se pokusil připojit. Pokud je připojení úspěšné, cílové zařízení ukončí veškerá existující připojení a bude komunikovat pouze s touto instancí ladicího programu. To vám umožní převzít kontrolu nad ladicí relací od existujícího ladicího připojení.

Pokud je cíl nakonfigurovaný s IP adresou hostitele a ladicí program se spouští na počítači s nakonfigurovanou IP adresou hostitele, není nutné zadávat parametr target= IP adresa. Pokud je cíl nakonfigurovaný s IP adresou hostitele, odešle pakety OFFER hostiteli každé tři sekundy. Pakety OFFER umožňují ladicímu programu připojit se k hostiteli, pokud není zadána žádná cílová IP adresa.

Další informace o konfiguraci IP adresy hostitele v cíli naleznete v tématu Nastavení ladění jádra sítě KDNET automaticky a ruční nastavení ladění jádra sítě KDNET.

TargetMachineName
Název cílového počítače. Pokud chcete použít název počítače, musí mít systém DNS v síti název počítače přidružený k IP adrese cílového počítače.

USBString
Připojovací řetězec USB. Musí se shodovat s řetězcem zadaným s možností spuštění /targetname. Další informace naleznete v tématu Nastavení ladění režimu jádra USB 3.0 xHCI-DBC (KDUSB).

ComPort
Název portu COM. Může to být ve formátu "com2" nebo ve formátu \\.\com2", ale nemělo by to být jenom číslo. Další informace naleznete v tématu Ruční nastavení sériového připojení.

BaudRate
Přenosová rychlost. Může to být 9600, 19200, 38400, 57600 nebo 115200.

SerialTcpIpPort
Cílový port TCP IP emulovaného sériového portu COM.

SerialIPAddress
Cílová IP adresa PROTOKOLU TCP emulovaného sériového portu COM.

VMHost
Při ladění virtuálního počítače určuje VMHost název fyzického počítače, na kterém je virtuální počítač spuštěný. Pokud virtuální počítač běží na stejném počítači jako samotný ladicí program jádra, použijte pro VMHost tečku (.). Další informace najdete v tématu Nastavení připojení k virtuálnímu počítači.

PipeName
Název potrubí vytvořeného virtuálním počítačem pro ladicí připojení.

resets=0
Určuje, že při synchronizaci hostitele a cíle se do cíle může odeslat neomezený počet resetovaných paketů. Tento parametr je potřeba pouze při ladění určitých typů virtuálních počítačů.

znovu zapojit
Způsobí, že se ladicí program automaticky odpojí a znovu připojí potrubí, pokud dojde k selhání čtení a zápisu. Pokud se při spuštění ladicího programu nenajde pojmenovaný kanál, parametr opětovného připojení způsobí, že počká na zobrazení kanálu s tímto názvem. Tento parametr je potřeba pouze při ladění určitých typů virtuálních počítačů.

-kl
Způsobí, že ladicí program provede ladění v místním režimu jádra. Další informace naleznete v tématu Místní Kernel-Mode Ladění.

Parametry předchozí verze

Důležité

Přenos 1394 je k dispozici pro použití ve Windows 10 verze 1607 a starších verzích. Není k dispozici v novějších verzích Windows. Projekty byste měli převést na jiné přenosy, například KDNET pomocí ethernetu. Další informace o tomto přenosu naleznete v tématu Nastavení ladění jádra sítě KDNET automaticky.

1394Channel
Číslo kanálu 1394. Platná čísla kanálů jsou celé číslo od 0 do 62 včetně. 1394Channel musí odpovídat číslu používanému cílovým počítačem, ale nezávisí na fyzickém portu 1394 zvoleném na adaptéru.

1394Protocol
Připojovací protokol, který se má použít pro připojení jádra 1394. To lze téměř vždy vynechat, protože ladicí program automaticky zvolí správný protokol. Pokud chcete tuto možnost nastavit ručně a cílový počítač používá systém Windows XP, měla by být nastavena hodnota 1394Protocol na hodnotu "channel". Pokud cílový počítač používá systém Windows Server 2003 nebo novější, musí být nastavena hodnota 1394Protocol na hodnotu instance. Pokud je vynechán, ladicí program se ve výchozím nastavení nastaví na protokol vhodný pro aktuální cílový počítač. To lze zadat pouze prostřednictvím příkazového řádku nebo proměnných prostředí, ne prostřednictvím grafického rozhraní WinDbg.

Příklady

Následující dávkový soubor lze použít k nastavení a spuštění ladicí relace přes připojení pomocí portu COM.

set _NT_SYMBOL_PATH=d:\mysymbols
set _NT_DEBUG_PORT=com1
set _NT_DEBUG_BAUD_RATE=115200
set _NT_DEBUG_LOG_FILE_OPEN=d:\debuggers\logfile1.log
windbg -k

Následující příkazové řádky je možné použít ke spuštění WinDbg bez jakýchkoli proměnných prostředí.

windbg -y d:\mysymbols -k com:port=com2,baud=57600

windbg -y d:\mysymbols -k com:port=\\.\com2,baud=115200

windbg -y d:\mysymbols -k net:port=50000,key=AutoGeneratedKey

windbg -y d:\mysymbols -k net:port=50000,key=AutoGeneratedKey,target=TargetIPAddress

Viz také

WinDbg Command-Line Možnosti

proměnné prostředíKernel-Mode