Debugging Mode Kernel Langsung Menggunakan KD

Di jendela Prompt Perintah, Anda dapat memulai sesi debugging mode kernel langsung saat meluncurkan KD. Masukkan salah satu perintah berikut.

kd [-y SymbolPath] -k net:port=PortNumber,key=Key[,target=TargetIPAddress|TargetHostName]

kd [-y SymbolPath] -k usb:targetname=USBString

kd [-y SymbolPath] -k com:port=ComPort,baud=BaudRate

kd [-y SymbolPath] -k com:ipport=SerialTcpIpPort,port=SerialIPAddress

kd [-y SymbolPath] -k com:pipe,port=\VMHost\pipe\PipeName[,resets=0][,reconnect]

kd [-y SymbolPath] -k com:modem

kd [-y SymbolPath] -kl

kd [-y SymbolPath] -k

Untuk informasi selengkapnya, lihat Opsi Baris Perintah KD.

Variabel Lingkungan

Untuk penelusuran kesalahan melalui koneksi serial (port COM), Anda dapat menggunakan variabel lingkungan untuk menentukan pengaturan koneksi.

Gunakan variabel berikut untuk menentukan koneksi serial.

set _NT_DEBUG_PORT = ComPort

set _NT_DEBUG_BAUD_RATE = BaudRate

Untuk informasi selengkapnya, lihat Variabel Lingkungan Mode Kernel.

Parameter

SymbolPath
Daftar direktori tempat file simbol berada. Direktori dalam daftar dipisahkan oleh titik koma. Untuk informasi selengkapnya, lihat Jalur Simbol.

PortNumber
Nomor port yang digunakan untuk penelusuran kesalahan jaringan. Anda dapat memilih nomor apa pun dari 49152 hingga 65535. Untuk informasi selengkapnya, lihat Menyiapkan Koneksi Jaringan Secara Manual.

Kunci
Kunci enkripsi yang digunakan untuk penelusuran kesalahan jaringan. Kami menyarankan agar Anda menggunakan kunci yang dihasilkan secara otomatis, yang disediakan oleh bcdedit saat Anda mengonfigurasi komputer target. Untuk informasi selengkapnya, lihat Menyiapkan Koneksi Jaringan Secara Manual.

TargetIPAddress
Alamat IPv4 dari komputer target.

Ketika target= alamat IP ditentukan, ini menyebabkan debugger memulai koneksi ke komputer target yang ditentukan, dengan mengirim paket khusus ke target, yang akan menyebabkannya mencoba terhubung dengan debugger tersebut. Debugger akan mengirim paket ke target berulang kali sekitar setiap setengah detik, mencoba untuk terhubung. Jika koneksi berhasil, target akan menghilangkan koneksi yang ada, dan berkomunikasi hanya dengan instans debugger ini. Ini memungkinkan Anda mengontrol sesi penelusuran kesalahan dari koneksi penelusuran kesalahan yang ada.

Ketika target dikonfigurasi dengan alamat IP host, dan debugger sedang dijalankan pada komputer dengan alamat IP host yang dikonfigurasi, tidak perlu menentukan parameter target= alamat IP. Ketika target dikonfigurasi dengan alamat IP host, target akan mengirim paket OFFER ke host setiap tiga detik. Paket OFFER memungkinkan debugger untuk terhubung ke host ketika tidak ada target= alamat IP yang ditentukan.

Untuk informasi selengkapnya tentang mengonfigurasi alamat IP host pada target, lihat Menyiapkan Penelusuran Kesalahan Kernel Jaringan KDNET Secara Otomatis dan Menyiapkan Debugging Kernel Jaringan KDNET Secara Manual.

TargetMachineName
Nama komputer PC target. Untuk menggunakan nama komputer, sistem DNS pada jaringan harus memiliki nama mesin yang terkait dengan alamat IP PC target.

USBString
STRING KONEKSI USB. Ini harus cocok dengan string yang ditentukan dengan opsi boot /targetname. Untuk informasi selengkapnya, lihat Menyiapkan debugging mode kernel USB 3.0 xHCI-DBC (KDUSB).

ComPort
Nama port COM. Ini bisa dalam format "com2" atau dalam format "\\.\com2", tetapi seharusnya bukan sekadar angka. Untuk informasi selengkapnya, lihat Menyiapkan Koneksi Serial Secara Manual.

BaudRate
Laju baud. Ini bisa 9600, 19200, 38400, 57600, atau 115200.

VMHost
Saat men-debug komputer virtual, VMHost menentukan nama komputer fisik tempat komputer virtual berjalan. Jika komputer virtual berjalan pada komputer yang sama dengan debugger kernel itu sendiri, gunakan satu periode (.) untuk VMHost. Untuk informasi selengkapnya, lihat Menyiapkan Koneksi ke Komputer Virtual.

PipeName
Nama pipa yang dibuat oleh komputer virtual untuk koneksi penelusuran kesalahan.

resets=0
Menentukan bahwa jumlah paket reset yang tidak terbatas dapat dikirim ke target saat host dan target disinkronkan. Parameter ini hanya diperlukan saat men-debug jenis komputer virtual tertentu.

sambungkan kembali
Menyebabkan debugger secara otomatis memutuskan sambungan dan menyambungkan kembali pipa jika kegagalan baca/tulis terjadi. Selain itu, jika pipa bernama tidak ditemukan ketika debugger dimulai, parameter koneksi ulang akan menyebabkannya menunggu pipa nama ini muncul. Parameter ini hanya diperlukan saat men-debug jenis komputer virtual tertentu.

-Kl
Menyebabkan debugger melakukan penelusuran kesalahan mode kernel lokal. Untuk informasi selengkapnya, lihat Penelusuran Kesalahan Mode Kernel Lokal.

SerialTcpIpPort
Port IP TCP target dari port COM serial yang ditiru.

SerialIPAddress
Alamat IP TCP target dari port COM serial yang ditiru.

Contoh

File batch berikut dapat digunakan untuk menyiapkan dan memulai sesi penelusuran kesalahan melalui koneksi port COM.

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
kd

Baris perintah berikut dapat digunakan untuk memulai WinDbg tanpa variabel lingkungan apa pun.

kd -y d:\mysymbols -k com:port=com2,baud=57600

kd -y d:\mysymbols -k com:port=\\.\com2,baud=115200

kd -y d:\mysymbols -k net:port=50000,key=AutoGeneratedKey