Élő Kernel-Mode hibakeresés WinDbg (Klasszikus) használatával

A WinDbg használatával kétféleképpen kezdeményezhet élő kernelmódú hibakeresési munkamenetet.

WinDbg menü

Ha a WinDbg alvó módban van, elkezdheti a kernel hibakeresési munkamenetét a Fájl menü Kernel hibakeresés parancsával vagy a CTRL+K billentyűkombináció lenyomásával. Amikor megjelenik a Kernel hibakeresése párbeszédpanel, kattintson a megfelelő fülre: NET, COM, USB vagy Local. Mindegyik lap egy másik kapcsolati módszert határoz meg.

Parancssor

A Parancssor ablakban kernel módú hibakeresési munkamenetet kezdeményezhet a WinDbg indításakor. Adja meg az alábbi parancsok egyikét:

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

További információ: WinDbg Command-Line Beállítások.

Környezeti változók

A soros (COM-porton) történő hibakereséshez környezeti változók használatával adhatja meg a kapcsolati beállításokat.

A soros kapcsolat megadásához használja az alábbi változókat.

Állítsa be az _NT_DEBUG_PORT = ComPort értéket

set _NT_DEBUG_BAUD_RATE = BaudRate

További információ: Kernel-Mode környezeti változók.

Paraméterek

SymbolPath
Azon könyvtárak listája, amelyekben szimbólumfájlok találhatók. A listában szereplő könyvtárakat pontosvesszők választják el egymástól. További információ: Szimbólum elérési útja.

PortNumber
Hálózati hibakereséshez használandó portszám. A 49152 és 65535 közötti számokat választhatja. További információ: Hálózati kapcsolat manuális beállítása.

Kulcs
A hálózati hibakereséshez használandó titkosítási kulcs. Javasoljuk, hogy automatikusan generált kulcsot használjon, amelyet a bcdedit biztosít a célszámítógép konfigurálásakor. További információ: Hálózati kapcsolat manuális beállítása.

TargetIPAddress
A célgép IPv4-címe.

Ha a cél = IP-cím meg van adva, a hibakereső egy speciális csomag küldésével kapcsolatot kezdeményez a megadott célgéppel, ami azt eredményezi, hogy megpróbál csatlakozni a hibakeresőhöz. A hibakereső körülbelül fél másodpercenként küld csomagokat a célnak, és megpróbál csatlakozni. Ha a kapcsolat sikeres, a célkészülék leállítja a meglévő kapcsolatokat, és kizárólag a hibakereső ezen példányával kommunikál. Ez lehetővé teszi a hibakeresési munkamenet irányítását egy meglévő hibakeresési kapcsolattól távol.

Ha a cél IP-címmel van konfigurálva, és a hibakereső a számítógépen fut, amelyen a konfigurált IP-cím van, nincs szükség a cél IP-cím paraméter megadására. Ha a cél állomás IP-címmel van konfigurálva, három másodpercenként elküldi az OFFER-csomagokat a gazdagépnek. Az OFFER-csomagok lehetővé teszik, hogy a hibakereső csatlakozzon a gazdagéphez, ha nincs megadva cél IP-cím.

A gazdagép IP-címének a célon való konfigurálásáról további információt a KDNET-hálózati kernel automatikus hibakeresésének beállítása és a KDNET hálózati kernel hibakeresésének manuális beállítása című témakörben talál.

TargetMachineName
A célszámítógép gépneve. A gépnév használatához a hálózat DNS-rendszerének a célszámítógép IP-címéhez társított gépnévvel kell rendelkeznie.

USBString
USB-kapcsolati sztring. Meg kell egyeznie a sztringnek, amelyet a /targetname rendszerindítási beállítással adtak meg. További információ: Az USB 3.0 xHCI-DBC kernelmódú hibakeresésének (KDUSB) beállítása.

ComPort
A COM port neve. Ez lehet "com2" vagy "\\.\com2" formátumban, de nem lehet egyszerűen szám. További információ: Soros kapcsolat manuális beállítása.

BaudRate
A baud sebesség. Ez lehet 9600, 19200, 38400, 57600 vagy 115200.

SerialTcpIpPort
Az emulált soros COM-port TCP/IP-célportja.

SerialIPAddress
Az emulált soros COM-port TCP/IP-címének célja.

VMHost
Virtuális gép hibakeresésekor a VMHost megadja annak a fizikai számítógépnek a nevét, amelyen a virtuális gép fut. Ha a virtuális gép ugyanazon a számítógépen fut, mint maga a kernel hibakeresője, a VMHost esetében egyetlen időszakot (.) használjon. További információ: Kapcsolat beállítása virtuális géphez.

PipeName
A virtuális gép által a hibakeresési kapcsolathoz létrehozott cső neve.

resets=0
Meghatározza, hogy korlátlan számú visszaállítási csomag küldhető a cél eszközének, amikor a gazdagép és a cél eszköz szinkronizálnak. Ez a paraméter csak bizonyos típusú virtuális gépek hibakereséséhez szükséges.

Újrakapcsolódás
Olvasási/írási hiba érzékelése esetén a hibakereső automatikusan leválasztja és újracsatlakoztatja a csövet. Ezenkívül, ha a hibakereső indításakor nem található a megadott nevű cső, az újracsatlakozási paraméter arra készteti, hogy várjon, amíg meg nem jelenik egy ilyen nevű cső. Ez a paraméter csak bizonyos típusú virtuális gépek hibakereséséhez szükséges.

-kl
Lehetővé teszi a hibakeresőt, hogy helyi kernelmódban fusson. További információ: Helyi Kernel-Mode hibakeresés.

Korábbi verzióparaméterek

Fontos

Az 1394-es átvitel a Windows 10 1607-es és korábbi verzióiban érhető el. A Windows későbbi verzióiban nem érhető el. A projekteket át kell váltania más átvitelekre, például az Ethernetet használó KDNET-re. További információ az átvitelről: A KDNET hálózati kernel hibakeresésének automatikus beállítása.

1394Channel
Az 1394-es csatorna száma. Az érvényes csatornaszámok a 0 és 62 közötti egész számokat tartalmazzák. Az 1394Channelnek meg kell egyeznie a célszámítógép által használt számmal, de nem függ az adapteren kiválasztott fizikai 1394-es porttól.

1394Protocol
Az 1394-ben kernelkapcsolathoz használandó kapcsolati protokoll. Ez szinte mindig kihagyható, mert a hibakereső automatikusan a megfelelő protokollt választja ki. Ha manuálisan szeretné beállítani ezt a beállítást, és a célszámítógépEn Windows XP fut, a 1394Protocol értéknek "channel" értékűnek kell lennie. Ha a célszámítógép Windows Server 2003-at vagy újabb verziót futtat, a 1394Protocol értéknek "instance" értékűnek kell lennie. Ha nincs megadva, a hibakereső alapértelmezés szerint az aktuális célszámítógépnek megfelelő protokollt használja. Ez csak a parancssoron vagy a környezeti változókon keresztül adható meg, a WinDbg grafikus felületén keresztül nem.

Példák

A következő kötegfájl használható hibakeresési munkamenet beállításához és elindításához COM-portkapcsolaton keresztül.

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

Az alábbi parancssorokkal környezeti változók nélkül indítható el a WinDbg.

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

Lásd még

WinDbg Command-Line Beállítások

Kernel-Mode környezeti változók