Vzdálené ladění pomocí WinDbg

Vzdálené ladění umožňuje ladit kód spuštěný na jiném počítači. Tato příručka vám ukáže, jak nastavit ladicí server a vzdáleně připojit klienta ladění pro ovládání vaší ladicí relace na dálku. Dozvíte se přesné kroky konfigurace obou komponent.

Kód, který ladíte, může běžet na stejném počítači jako ladicí server nebo může běžet na samostatném počítači. Pokud ladicí server provádí ladění v uživatelském režimu, proces, který ladíte, může běžet na stejném počítači jako ladicí server. Pokud ladicí server provádí ladění v režimu jádra, kód, který ladíte, obvykle běží na samostatném cílovém počítači.

Tento diagram znázorňuje, jak tyto tři počítače spolupracují v typickém nastavení vzdáleného ladění:

Důležitý

Vzdálené ladění zpřístupňuje váš systém potenciálním rizikům zabezpečení. Než budete pokračovat:

• Kontrola zabezpečení během vzdáleného ladění a povolení zabezpečeného režimu
• Vysvětlení aspektů zabezpečení pro nástroje pro ladění Systému Windows

Pro vzdálené ladění připojení můžete použít několik přenosových protokolů: TCP, NPIPE, SPIPE, SSL a COM Port. Předpokládejme, že jako protokol zvolíte TCP a WinDbg použijete jak jako klienta ladění, tak jako server ladění. Pomocí následujícího postupu vytvořte ladicí relaci režimu jádra na dálku.

1. Na hostitelském počítači otevřete WinDbg a vytvořte ladicí relaci režimu jádra s cílovým počítačem. (Podívejte se na živé ladění pomocí Kernel-Mode WinDbg (Classic).)

2. Pro přerušení zvolte Break v nabídce Ladění nebo stiskněte kombinaci kláves CTRL-Break.

3. Ve okně příkazů ladicího programuzadejte následující příkaz.

   .server tcp:port=5005

   Poznámka:

   Číslo portu 5005 je libovolné. Zvolíte číslo portu.

4. WinDbg odpoví výstupem podobným následujícímu. Zkopírujte připojovací řetězec – budete ho potřebovat pro další krok.

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

5. Na vzdáleném počítači otevřete WinDbg a v nabídce Soubor zvolte Připojit ke vzdálené relaci.

6. V části Připojovací řetězeczadejte následující řetězec.

   tcp:Port=5005,Server=YourHostComputer

   kde YourHostComputer je název hostitelského počítače, který spouští ladicí server.

   Vyberte OK.

Použití příkazového řádku

Jako alternativu k postupu v předchozí části můžete nastavit relaci vzdáleného ladění na příkazovém řádku. Předpokládejme, že chcete vytvořit ladicí relaci v režimu jádra mezi hostitelským počítačem a cílovým počítačem přes kabel 1394 na kanálu 32. K vytvoření vzdálené relace ladění použijte následující postup:

1. V hostitelském počítači zadejte do okna příkazového řádku následující příkaz.

   windbg -server tcp:port=5005 -k 1394:channel=32

2. Počkejte, než se server spustí. Zobrazí se potvrzovací zpráva s podrobnostmi o připojení. Než budete pokračovat ke kroku 3, zkopírujte tento připojovací řetězec.

3. Na vzdáleném počítači zadejte do okna příkazového řádku následující příkaz.

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

   kde YourHostComputer je název hostitelského počítače, který spouští ladicí server.

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. Převeďte své projekty na jiné typy přenosů, například KDNET pomocí Ethernetu. Další informace o tomto přenosu naleznete v tématu Nastavení ladění jádra sítě KDNET automaticky.

Další kroky

Vzdálené ladění můžete vytvořit mnoha způsoby jiné než ty, které jsou uvedeny v tomto tématu.

• Úplné informace o nastavení ladicího serveru v příkazovém okně ladicího programu winDbgnaleznete v tématu .server (vytvoření ladicího serveru).
• Úplné informace o spuštění WinDbg (a navazování vzdáleného ladění) na příkazovém řádku naleznete v tématu WinDbg Command-Line Možnosti.