Opsi Baris Perintah KD

Pengguna pertama kali KD harus dimulai dengan bagian Debugging Menggunakan KD dan NTKD .

Baris perintah KD menggunakan sintaks berikut.

kd [ -server ServerTransport | -remote ClientTransport ] 
   [-b | -x] [-d] [-bonc] [-m] [-myob] [-lines] [-n] [-r] [-s] 
   [-v] [-clines lines] [-failinc] [-noio] [-noshell] 
   [-secure] [-sdce] [-ses] [-sicv] [-sins] [-snc] [-snul]
   [-sup] [-sflags 0xNumber] [-log{a|au|o|ou} LogFile] 
   [-aExtension] [-zp PageFile] 
   [-i ImagePath] [-y SymbolPath]  [-srcpath SourcePath] 
   [-k ConnectType | -kl | -kqm | -kx ExdiOptions] [-ee {masm|c++}] 
   [-z DumpFile] [-cf "filename"] [-cfr "filename"] [-c "command"] 
   [-t PrintErrorLevel] [-version] 

kd -iu KeyString

kd -QR Server 

kd -wake PID 

kd -?

Deskripsi opsi baris perintah KD mengikuti. Hanya opsi -remote dan -server yang peka huruf besar/kecil. Tanda hubung awal dapat diganti dengan garis miring (/). Opsi yang tidak mengambil parameter tambahan apa pun dapat digabungkan -- sehingga kd -r -n -v dapat ditulis sebagai kd -rnv.

Jika opsi -remote atau -server digunakan, opsi tersebut harus muncul sebelum opsi lain pada baris perintah.

Parameter

-peladen ServerTransport
Membuat server penelusuran kesalahan yang dapat diakses oleh debugger lain. Untuk penjelasan tentang kemungkinan ServerTransport, lihat Mengaktifkan Server Debugging. Ketika parameter ini digunakan, parameter harus menjadi parameter pertama pada baris perintah.

-terpencil ClientTransport
Membuat klien penelusuran kesalahan, dan menyambungkan ke server debugging yang sudah berjalan. Untuk penjelasan tentang kemungkinan nilai ClientTransport, lihat Mengaktifkan Klien Debugging. Ketika parameter ini digunakan, parameter harus menjadi parameter pertama pada baris perintah.

-sebuah Ekstensi
Menyetel DLL ekstensi default. Defaultnya adalah kdextx86.dll atau kdexts.dll. Tidak boleh ada spasi setelah "a", dan ekstensi nama file .dll tidak boleh disertakan. Untuk detailnya, dan metode pengaturan default lainnya, lihat Memuat DLL Ekstensi Debugger.

-b
Opsi ini tidak lagi didukung.

-bonc
Jika opsi ini ditentukan, debugger akan masuk ke target segera setelah sesi dimulai. Ini sangat berguna saat menyambungkan ke server debugging yang mungkin saat ini tidak dipecah ke target.

-c "perintah"
Menentukan perintah debugger awal untuk dijalankan saat start-up. Perintah ini harus dikelilingi dengan tanda kutip. Beberapa perintah dapat dipisahkan dengan titik koma. (Jika Anda memiliki daftar perintah yang panjang, mungkin lebih mudah untuk memasukkannya ke dalam skrip dan kemudian menggunakan opsi -c dengan perintah $<, $><, $><, $$>< (Jalankan File Skrip).)

Jika Anda memulai klien penelusuran kesalahan, perintah ini harus ditujukan untuk server penelusuran kesalahan. Perintah khusus klien, seperti .lsrcpath, tidak diizinkan.

-cf "nama file"
Menentukan jalur dan nama file skrip. File skrip ini dijalankan segera setelah debugger dimulai. Jika nama file berisi spasi, itu harus diapit dalam tanda kutip. Jika jalur dihilangkan, direktori saat ini diasumsikan. Jika opsi -cf tidak digunakan, file ntsd.ini di direktori saat ini digunakan sebagai file skrip. Jika file tidak ada, tidak ada kesalahan yang terjadi. Untuk detailnya, lihat Menggunakan File Skrip.

-cfr "nama file"
Menentukan jalur dan nama file skrip. File skrip ini dijalankan segera setelah debugger dimulai, dan kapan saja target dimulai ulang. Jika nama file berisi spasi, itu harus diapit dalam tanda kutip. Jika jalur dihilangkan, direktori saat ini diasumsikan. Jika file tidak ada, tidak ada kesalahan yang terjadi. Untuk detailnya, lihat Menggunakan File Skrip.

-clines Baris
Mengatur perkiraan jumlah perintah dalam riwayat perintah yang dapat diakses selama penelusuran kesalahan jarak jauh. Untuk detailnya, dan untuk cara lain mengubah nomor ini, lihat Menggunakan Perintah Debugger.

-d
Setelah reboot, debugger akan masuk ke komputer target segera setelah modul kernel dimuat. (Jeda ini lebih awal dari jeda dari opsi -b .) Lihat Crash dan Reboot Komputer Target untuk detail dan untuk metode lain mengubah status ini.

-ee {masm|c++}
Mengatur evaluator ekspresi default. Jika masm ditentukan, sintaks ekspresi MASM akan digunakan. Jika c++ ditentukan, sintaks ekspresi C++ akan digunakan. Jika opsi -ee dihilangkan, sintaks ekspresi MASM digunakan sebagai default. Lihat Mengevaluasi Ekspresi untuk detailnya.

-failinc
Menyebabkan debugger mengabaikan simbol yang dipertanyakan. Saat menelusuri kesalahan mode pengguna atau file minidump mode kernel, opsi ini juga akan mencegah debugger memuat modul apa pun yang gambarnya tidak dapat dipetakan. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_EXACT_SYMBOLS.

-saya ImagePath
Menentukan lokasi executable yang menghasilkan kesalahan. Jika jalur berisi spasi, jalur harus diapit dalam tanda kutip.

-Iu KeyString
Mendaftarkan debugger jarak jauh sebagai jenis URL sehingga pengguna dapat meluncurkan klien jarak jauh debugger secara otomatis dengan URL. KeyString memiliki format remdbgeng://RemotingOption. RemotingOption adalah string yang mendefinisikan protokol transportasi seperti yang didefinisikan dalam topik Mengaktifkan Klien Debugging. Jika tindakan ini berhasil, tidak ada pesan yang ditampilkan; jika gagal, pesan kesalahan ditampilkan.

Parameter -iu tidak boleh digunakan dengan parameter lain. Perintah ini tidak akan benar-benar memulai KD.

-k ConnectType
Memberi tahu debugger cara menyambungkan ke target. Untuk detailnya, lihat Debugging Menggunakan KD dan NTKD.

-Kl
Memulai sesi debugging kernel pada komputer yang sama dengan debugger.

-kqm
Memulai KD dalam mode diam.

-kx ExdiOptions
Memulai sesi penelusuran kesalahan kernel menggunakan driver EXDI. Driver EXDI tidak dijelaskan dalam dokumentasi ini. Jika Anda memiliki antarmuka EXDI ke pemeriksaan perangkat keras atau simulator perangkat keras, silakan hubungi Microsoft untuk informasi penelusuran kesalahan.

-Baris
Mengaktifkan penelusuran kesalahan baris sumber. Jika opsi ini dihilangkan, perintah .lines (Toggle Source Line Support) harus digunakan sebelum penelusuran kesalahan sumber akan diizinkan. Untuk metode lain untuk mengontrol ini, lihat SYMOPT_LOAD_LINES.

-log{a|au|o|ou} LogFile
Mulai mencatat informasi ke file log. Jika LogFile sudah ada, logFile akan ditimpa jika -logo digunakan, atau output akan ditambahkan ke file jika -loga digunakan. Opsi -logau dan -logou beroperasi mirip dengan -loga dan -logo masing-masing, kecuali bahwa file log adalah file Unicode. Untuk detail selengkapnya, lihat Menyimpan File Log di KD.

-m
Menunjukkan bahwa port serial tersambung ke modem. Menginstruksikan debugger untuk mengawasi sinyal carrier-detect.

-myob
Jika ada ketidakcocokan versi dengan dbghelp.dll, debugger akan terus berjalan. (Tanpa sakelar -myob , ini dianggap sebagai kesalahan fatal.)

Efek sekunder dari opsi ini adalah bahwa peringatan yang biasanya muncul saat membobol komputer target ditekan.

-n
Beban simbol berisik: Mengaktifkan output verbose dari handler simbol. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_DEBUG.

-noio
Mencegah server penelusuran kesalahan digunakan untuk input atau output. Input hanya akan diterima dari klien penelusuran kesalahan (ditambah perintah awal atau skrip perintah yang ditentukan oleh opsi baris perintah -c ).

Semua output akan diarahkan ke klien debugging. Untuk detail selengkapnya, lihat Mengaktifkan Server Penelusuran Kesalahan.

-noshell
Melarang semua perintah .shell . Larangan ini akan berlangsung selama debugger berjalan, bahkan jika sesi penelusuran kesalahan baru dimulai. Untuk detailnya, dan untuk cara lain menonaktifkan perintah shell, lihat Menggunakan Perintah Shell.

-QR Peladen
Mencantumkan semua server penelusuran kesalahan yang berjalan pada server jaringan yang ditentukan. Server sebelumnya garis miring terbalik ganda (\\) bersifat opsional. Lihat Mencari Server Debugging untuk detailnya.

Parameter -QR tidak boleh digunakan dengan parameter lain. Perintah ini tidak akan benar-benar memulai KD.

-r
Menampilkan register.

-s
Menonaktifkan pemuatan simbol malas. Ini akan memperlambat proses startup. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_DEFERRED_LOADS.

-sdce
Menyebabkan debugger menampilkan kotak dialog Kesalahan akses file selama pemuatan simbol. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_FAIL_CRITICAL_ERRORS.

-aman
Mengaktifkan Mode Aman.

-Ses
Menyebabkan debugger melakukan evaluasi ketat dari semua file simbol dan mengabaikan simbol yang dipertanyakan. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_EXACT_SYMBOLS.

-sflags 0xAngka
Mengatur semua opsi handler simbol sekaligus. Angka harus berupa angka heksadesimal yang diawali dengan 0x -- desimal tanpa 0x diizinkan, tetapi opsi simbol adalah bendera biner dan oleh karena itu heksadesimal direkomendasikan. Opsi ini harus digunakan dengan hati-hati, karena akan mengambil alih semua default handler simbol. Untuk detailnya, lihat Mengatur Opsi Simbol.

-sicv
Menyebabkan handler simbol mengabaikan rekaman CV. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_IGNORE_CVREC.

-dosa
Menyebabkan debugger mengabaikan jalur simbol dan variabel lingkungan jalur gambar yang dapat dieksekusi. Untuk detailnya, lihat SYMOPT_IGNORE_NT_SYMPATH.

-snc
Menyebabkan debugger menonaktifkan terjemahan C++. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_NO_CPP.

-snul
Menonaktifkan pemuatan simbol otomatis untuk nama yang tidak memenuhi syarat. Untuk detail dan untuk metode lain untuk mengontrol ini, lihat SYMOPT_NO_UNQUALIFIED_LOADS.

-srcpath SourcePath
Menentukan jalur pencarian file sumber. Pisahkan beberapa jalur dengan titik koma (;). Jika jalur berisi spasi, jalur harus diapit dalam tanda kutip. Untuk detailnya, dan untuk cara lain mengubah jalur ini, lihat Jalur Sumber.

-sup
Menyebabkan handler simbol mencari tabel simbol publik selama setiap pencarian simbol. Untuk detail dan untuk metode lain dalam mengontrol ini, lihat SYMOPT_AUTO_PUBLICS.

-t PrintErrorLevel
Menentukan tingkat kesalahan yang akan menyebabkan debugger menampilkan pesan kesalahan. Ini adalah angka desimal yang sama dengan 0, 1, 2, atau 3. Nilai dijelaskan sebagai berikut:

Nilai	Terus-menerus	Makna
0	NONE	Jangan tampilkan kesalahan apa pun.
1	KESALAHAN	Tampilkan peristiwa penelusuran kesalahan tingkat KESALAHAN.
2	MINORERROR	Tampilkan peristiwa penelusuran kesalahan tingkat MINORERROR dan ERROR.
3	PERINGATAN	Tampilkan peristiwa PENELUSURAN KESALAHAN TINGKAT PERINGATAN, MINORERROR, dan KESALAHAN.

Tingkat kesalahan ini hanya memiliki arti dalam build Microsoft Windows yang diperiksa. Nilai default adalah 1. Build yang diperiksa tersedia pada versi Windows yang lebih lama, sebelum Windows 10 versi 1803.

-v
Menghasilkan pesan verbose untuk beban, beban yang ditangguhkan, dan pembongkaran.

-versi
Mencetak string versi debugger.

-bangun PID
Menyebabkan mode tidur berakhir untuk debugger mode pengguna yang ID prosesnya ditentukan oleh PID. Perintah ini harus dikeluarkan pada komputer target selama mode tidur. Lihat Mengontrol Debugger Mode Pengguna dari Debugger Kernel untuk detailnya.

Parameter -wake tidak boleh digunakan dengan parameter lain. Perintah ini tidak akan benar-benar memulai KD.

-x
Menyebabkan debugger pecah ketika pengecualian pertama kali terjadi, daripada membiarkan aplikasi atau modul yang menyebabkan pengecualian menanganinya. (Sama seperti -b, kecuali dengan eb nt awal ! NtGlobalFlag 9; g perintah.)

-y SymbolPath
Menentukan jalur pencarian simbol. Pisahkan beberapa jalur dengan titik koma (;). Jika jalur berisi spasi, jalur harus diapit dalam tanda kutip. Untuk detailnya, dan untuk cara lain mengubah jalur ini, lihat Jalur Simbol.

-z DumpFile
Menentukan nama file crash dump yang akan di-debug. Jika jalur dan nama file berisi spasi, ini harus dikelilingi oleh tanda kutip. Dimungkinkan untuk membuka beberapa file cadangan sekaligus dengan menyertakan beberapa opsi -z, masing-masing diikuti oleh nilai DumpFile yang berbeda. Untuk detailnya, lihat Menganalisis File Cadangan Mode Kernel dengan KD.

-zp PageFile
Menentukan nama file halaman yang dimodifikasi. Ini berguna jika Anda men-debug file cadangan dan ingin menggunakan perintah .pagein (Page In Memory). Anda tidak dapat menggunakan -zp dengan file halaman Windows standar—hanya file halaman yang dimodifikasi khusus yang dapat digunakan.

-?
Menampilkan teks bantuan baris perintah.

KD akan secara otomatis mendeteksi platform tempat target berjalan. Anda tidak perlu menentukan target pada baris perintah KD. Sintaks yang lebih lama (menggunakan nama I386KD atau IA64KD) sudah usang.