Externe foutopsporing met behulp van KD

Externe foutopsporing omvat twee foutopsporingsprogramma's die op twee verschillende locaties worden uitgevoerd. Het foutopsporingsprogramma dat de foutopsporing uitvoert, wordt de foutopsporingsservergenoemd. Het tweede foutopsporingsprogramma, de zogenaamde foutopsporingsclient, beheert de foutopsporingssessie vanaf een externe locatie. Als u een externe sessie tot stand wilt brengen, moet u eerst de foutopsporingsserver instellen en vervolgens de foutopsporingsclient activeren.

Foutopsporing op afstand kan handig zijn wanneer u iemand anders wilt betrekken bij het onderzoeken van een probleem dat u op een pc aan het debuggen bent.

De code die wordt opgespoord, kan worden uitgevoerd op dezelfde computer waarop de foutopsporingsserver wordt uitgevoerd, of op een afzonderlijke computer. Als de foutopsporingsserver foutopsporing in de gebruikersmodus uitvoert, kan het proces dat wordt opgespoord, worden uitgevoerd op dezelfde computer als de foutopsporingsserver. Als de foutopsporingsserver kernelmodusfoutopsporing uitvoert, wordt de code die wordt opgespoord doorgaans uitgevoerd op een afzonderlijke doelcomputer.

In het volgende diagram ziet u een externe sessie waarin de foutopsporingsserver, die wordt uitgevoerd op een hostcomputer, kernelmodusfoutopsporing uitvoert van code die wordt uitgevoerd op een afzonderlijke doelcomputer.

Er zijn verschillende transportprotocollen die u kunt gebruiken voor een externe foutopsporingsverbinding: TCP, NPIPE, SPIPE, SSL en COM-poort. Stel dat u tcp als protocol wilt gebruiken en dat u ervoor hebt gekozen om KD te gebruiken als zowel de foutopsporingsclient als de foutopsporingsserver. U kunt de volgende procedure gebruiken om een foutopsporingssessie in de externe kernelmodus tot stand te brengen:

1. Open KD op de hostcomputer en stel een foutopsporingssessie in de kernelmodus met een doelcomputer in. (Zie Het uitvoeren van Kernel-Mode foutopsporing met behulp van KD.)

2. Inbreken door op CRTL-Break te drukken.

3. Voer de volgende opdracht in.

   .server tcp:port=5005

   Opmerking Het poortnummer 5005 is willekeurig. Het poortnummer is uw keuze.

4. KD reageert met uitvoer die vergelijkbaar is met de volgende.

   Server started.  Client can connect with any of these command lines
   0: <debugger> -remote tcp:Port=5005,Server=YourHostComputer
   

5. Open op de externe computer een opdrachtpromptvenster en voer de volgende opdracht in.

   kd -remote tcp:Port=5005,Server=YourHostComputer

   waarbij YourHostComputer de naam is van uw hostcomputer, waarop de foutopsporingsserver wordt uitgevoerd.

Aanvullende informatie

Zie KD Command-Line Options voor volledige informatie over het starten van KD (en het tot stand brengen van externe foutopsporing) op de opdrachtregel.