Penelusuran Kesalahan Jarak Jauh Menggunakan WinDbg

Debugging jarak jauh memungkinkan Anda melakukan debugging kode yang berjalan di komputer lain. Panduan ini menunjukkan kepada Anda cara menyiapkan server penelusuran kesalahan dan menyambungkan klien penelusuran kesalahan untuk mengontrol sesi penelusuran kesalahan Anda dari jarak jauh. Anda akan mempelajari langkah-langkah yang tepat untuk mengonfigurasi kedua komponen.

Kode yang Anda debug mungkin berjalan di komputer yang sama dengan server debugging, atau mungkin berjalan di komputer terpisah. Jika server debugging melakukan debugging dalam mode pengguna, proses yang Anda debugging dapat berjalan di komputer yang sama dengan server debugging. Jika server debugging melakukan debugging mode kernel, kode yang sedang Anda debugging biasanya berjalan pada komputer target terpisah.

Diagram ini menunjukkan cara ketiga komputer bekerja sama dalam pengaturan debugging jarak jauh yang khas.

Tangkapan layar diagram yang menggambarkan komputer remote, host, dan target yang terhubung untuk debugging mode kernel.

Penting

Debugging jarak jauh memaparkan sistem Anda terhadap risiko keamanan potensial. Sebelum melanjutkan:

Anda dapat menggunakan beberapa protokol transportasi untuk koneksi penelusuran kesalahan jarak jauh: TCP, NPIPE, SPIPE, SSL, dan COM Port. Misalkan Anda memilih TCP sebagai protokol dan WinDbg sebagai klien debugging dan server debugging. Gunakan prosedur berikut untuk membuat sesi debugging mode kernel jarak jauh.

  1. Pada komputer host, buka WinDbg dan buat sesi debugging mode kernel dengan komputer target. (Lihat Debugging Mode Kernel Langsung Menggunakan WinDbg (Klasik).)

  2. Ganti dengan memilih Putuskan dari menu Debug atau dengan menekan CTRL-Break.

  3. Di Jendela Perintah Debugger, masukkan perintah berikut.

    .server tcp:port=5005

    Nota

    Nomor port 5005 sembarang. Anda memilih nomor port.

  4. WinDbg merespons dengan output yang mirip dengan yang berikut ini. Salin string koneksi—Anda akan memerlukannya untuk langkah berikutnya.

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

  5. Pada komputer jarak jauh, buka WinDbg, dan pilih Sambungkan ke Sesi Jarak Jauh dari menu File .

  6. Di bawah String Koneksi, masukkan string berikut.

    tcp:Port=5005,Server=YourHostComputer

    di mana YourHostComputer adalah nama komputer host Anda, yang menjalankan server debugging.

    Pilih OK.

Menggunakan Baris Perintah

Sebagai alternatif untuk prosedur di bagian sebelumnya, Anda dapat menjalankan sesi debugging jarak jauh di baris perintah. Misalkan Anda ingin membuat sesi debugging mode kernel antara komputer host dan komputer target melalui kabel 1394 pada saluran 32. Gunakan prosedur berikut untuk membuat sesi penelusuran kesalahan jarak jauh:

  1. Pada komputer host, masukkan perintah berikut di jendela Prompt Perintah.

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

  2. Tunggu hingga server dimulai. Anda akan melihat pesan konfirmasi dengan detail koneksi. Salin string koneksi ini sebelum melanjutkan ke langkah 3.

  3. Di komputer jarak jauh, masukkan perintah berikut ini di jendela Prompt Perintah.

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

    di mana YourHostComputer adalah nama komputer host Anda, yang menjalankan server debugging.

Penting

Transportasi 1394 tersedia untuk digunakan di Windows 10, versi 1607 dan yang lebih lama. Ini tidak tersedia di Windows versi yang lebih baru. Alihkan proyek Anda ke protokol lain, seperti KDNET menggunakan Ethernet. Untuk informasi selengkapnya tentang transportasi tersebut, lihat Menyiapkan Penelusuran Kesalahan Kernel Jaringan KDNET Secara Otomatis.

Langkah selanjutnya

Anda dapat melakukan debugging jarak jauh dengan banyak cara selain yang dibahas dalam topik ini.

  • Untuk informasi lengkap tentang menyiapkan server penelusuran kesalahan di Jendela Perintah Debugger WinDbg, lihat .server (Buat Server Debugging).
  • Untuk informasi lengkap tentang meluncurkan WinDbg (dan membuat debugging jarak jauh) di baris perintah, lihat Opsi Baris Perintah WinDbg.
  • Last updated on