Live Kernel-Mode Felsökning med WinDbg (Klassisk)

Det finns två sätt att använda WinDbg för att starta en felsökningssession i kernelläge.

WinDbg-meny

När WinDbg är i vilande läge kan du starta en kernel-felsökningssession genom att välja Kernel Debug på Arkiv-menyn eller genom att trycka på CTRL+K. När dialogrutan Kernel-felsökning visas klickar du på lämplig flik: NET, COM, USB eller Local. Varje flik anger en annan anslutningsmetod.

Kommandotolkfönster

I ett kommandotolkfönster kan du starta en felsökningssession i kernelläge när du startar WinDbg. Ange något av följande kommandon:

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

Mer information finns i WinDbg Command-Line Alternativ.

Miljövariabler

För felsökning via en seriell (COM-port) kan du använda miljövariabler för att ange anslutningsinställningarna.

Använd följande variabler för att ange en seriell anslutning.

set _NT_DEBUG_PORT = ComPort

set _NT_DEBUG_BAUD_RATE = BaudRate

Mer information finns iKernel-Mode Miljövariabler.

Parameterar

SymbolPath
En lista över kataloger där symbolfiler finns. Kataloger i listan avgränsas med semikolon. Mer information finns i Symbolsökväg.

PortNumber
Ett portnummer som ska användas för nätverksfelsökning. Du kan välja valfritt tal mellan 49152 och 65535. Mer information finns i Konfigurera en nätverksanslutning manuellt.

Nyckel
Krypteringsnyckeln som ska användas för nätverksfelsökning. Vi rekommenderar att du använder en automatiskt genererad nyckel som tillhandahålls av bcdedit när du konfigurerar måldatorn. Mer information finns i Konfigurera en nätverksanslutning manuellt.

TargetIPAddress
Måldatorns IPv4-adress.

När målet= IP-adressen har angetts gör detta att felsökaren initierar en anslutning till den angivna måldatorn genom att skicka ett särskilt paket till målet, vilket gör att det försöker ansluta till felsökningsprogrammet. Felsökningsprogrammet skickar paket till målet upprepade gånger ungefär varje halv sekund och försöker ansluta. Om anslutningen lyckas släpper målet alla befintliga anslutningar och kommunicerar endast med den här instansen av felsökningsprogrammet. På så sätt kan du ta kontroll över felsökningssessionen från en befintlig felsökningsanslutning.

När målet har konfigurerats med en värd-IP-adress och felsökningsprogrammet körs på datorn med den konfigurerade värd-IP-adressen behöver du inte ange parametern target= IP-adress. När målenheten har konfigurerats med en värd-IP-adress skickar den OFFER-paket till värden var tredje sekund. OFFER-paketen tillåter felsökningsprogrammet att ansluta till värden när ingen måladress= IP har angetts.

Mer information om hur du konfigurerar värd-IP-adressen på målet finns i Konfigurera KDNET-nätverkskärnfelsökning automatiskt och konfigurera KDNET-nätverkskärnfelsökning manuellt.

TargetMachineName
Datornamnet på måldatorn. Om du vill använda datornamnet måste DNS-systemet i nätverket ha datornamnet associerat med måldatorns IP-adress.

USBString
En USB-anslutningssträng. Detta måste matcha strängen som angetts med startalternativet /targetname. Mer information finns i Konfigurera USB 3.0 xHCI-DBC kernel-mode debugging (KDUSB).

ComPort
Namnet på COM-porten. Detta kan vara i formatet "com2" eller i formatet "\\.\com2", men bör inte bara vara ett tal. Mer information finns i Konfigurera en seriell anslutning manuellt.

BaudRate
Överföringshastigheten. Detta kan vara 9600, 19200, 38400, 57600 eller 115200.

SerialTcpIpPort
Mål-TCP IP-porten för den emulerade seriella COM-porten.

SerialIPAddress
Mål-TCP IP-adressen för den emulerade seriell COM-porten.

VMHost
När du felsöker en virtuell dator anger VMHost namnet på den fysiska dator där den virtuella datorn körs. Om den virtuella datorn körs på samma dator som själva kernelfelsökaren använder du en enskild punkt (.) för VMHost. Mer information finns i Konfigurera en anslutning till en virtuell dator.

PipeName
Namnet på det rör som skapats av den virtuella maskinen för felsökningsanslutningen.

återställningar=0
Anger att ett obegränsat antal återställningspaket kan skickas till mål när värddatorn och målet synkroniseras. Den här parametern behövs bara vid felsökning av vissa typer av virtuella datorer.

återkoppla
Gör att felsökaren automatiskt kopplar från och återansluter röret om ett läs-/skrivfel inträffar. Om det inte går att hitta det namngivna röret när felsökningsprogrammet startas gör parametern återanslutning att den väntar tills ett rör med det här namnet visas. Den här parametern behövs bara vid felsökning av vissa typer av virtuella datorer.

-kl
Gör att debuggern utför felsökning i lokalt kärnläge. Mer information finns i Lokal Kernel-Mode felsökning.

Parametrar för tidigare version

1394Channel
Kanalnumret 1394. Giltiga kanalnummer är alla heltal mellan 0 och 62, inklusive. 1394Channel måste matcha det nummer som används av måldatorn, men är inte beroende av den fysiska 1394-port som valts på adaptern.

1394Protocol
Anslutningsprotokollet som ska användas för 1394-kernelanslutningen. Detta kan nästan alltid utelämnas eftersom felsökaren automatiskt väljer rätt protokoll. Om du vill ange detta manuellt, och måldatorn kör Windows XP, bör 1394Protocol anges som "kanal". Om måldatorn kör Windows Server 2003 eller senare ska 1394Protocol anges som "instans". Om det utelämnas kommer felsökaren som standard att använda det protokoll som är lämpligt för den aktuella måldatorn. Detta kan bara anges via kommandoraden eller miljövariablerna, inte via det grafiska WinDbg-gränssnittet.

Exempel

Följande batchfil kan användas för att konfigurera och starta en felsökningssession via en COM-portanslutning.

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

Följande kommandorader kan användas för att starta WinDbg utan några miljövariabler.

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

Se även

WinDbg Command-Line alternativ

Kernel-Mode miljövariabler