Bagikan melalui


WinDbg: Opsi startup baris perintah

logo WinDbg dengan kaca pembesar yang memeriksa bit.

Mulai WinDbg

Setelah WinDbg diinstal, WinDbgX.exe tersedia untuk dijalankan dari lokasi direktori mana pun.

Opsi startup baris perintah

WinDbgX [options]

Tabel berikut ini meringkas opsi baris perintah yang tersedia.

Opsi umum

Option Description
-c command Menjalankan baris perintah setelah debugger dilampirkan. Perintah ini harus diapit dalam tanda kutip. Beberapa perintah dapat dipisahkan dengan titik koma.
-v Mengaktifkan output verbose di debugger.
-T Title Mengatur judul jendela.
-logo LogFile Log Terbuka. Mulai mencatat informasi ke file log. Jika file tersebut ada, maka akan ditimpa.
-loga LogFile Tambahkan Log. Mulai mencatat informasi ke file log. Jika file ada, file akan ditambahkan.
-e EventHandle Memberi sinyal peristiwa dengan handle yang diberikan setelah pengecualian berikutnya di target.
-? Menampilkan ringkasan perintah yang tersedia.

Opsi kernel

Option Description
-d Setelah reboot, debugger akan masuk ke komputer target segera setelah modul kernel dimuat.
-k \[ConnectType\] Memulai sesi debugging kernel. Jika -k digunakan tanpa opsi ConnectType yang mengikutinya, itu harus menjadi entri akhir pada baris perintah.
-kqm Memulai KD dalam mode diam.
-kl Memulai sesi debugging kernel pada komputer yang sama dengan debugger.
-kx ExdiOptions Memulai sesi penelusuran kesalahan kernel menggunakan driver EXDI. Untuk informasi selengkapnya tentang EXDI, lihat Mengonfigurasi ExDI Debugger Transport.
-I Setelah reboot, debugger akan masuk ke komputer target segera setelah modul kernel dimuat.

Opsi mode pengguna

Option Description
-o Memecahkan masalah semua proses yang diluncurkan oleh aplikasi target (proses turunan).
-g Mengabaikan titik henti awal dalam aplikasi target.
-G Mengabaikan titik henti akhir dalam aplikasi target.
-pv Menentukan bahwa debugger harus melekat pada proses target secara noninvasif.
-hd Menentukan bahwa tumpukan debug tidak boleh digunakan.
-cimp Menentukan bahwa setiap proses yang dibuat akan menggunakan baris perintah implisit yang ditetapkan oleh server alih-alih string baris perintah yang diberikan pengguna dari klien.

Opsi target

Option Description
-remote ClientTransport 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.
-server ServerTransport Membuat server debugging yang dapat diakses oleh debugger lain. Untuk penjelasan tentang kemungkinan nilai ServerTransport , lihat Mengaktifkan Server Debugging.
-premote SmartClientTransport Membuat klien pintar, dan menyambungkan ke server proses yang sudah berjalan. Untuk penjelasan tentang kemungkinan nilai SmartClientTransport, lihat Mengaktifkan Klien Cerdas.
-p PID Menentukan ID proses desimal yang akan di-debug.
-tid TID Menentukan ID utas yang akan dilanjutkan saat sesi debugging dimulai.
-psn ServiceName Menentukan nama layanan yang terkandung dalam proses yang akan di-debug. Ini digunakan untuk men-debug proses yang sudah berjalan.
-pn ProcessName Menentukan nama proses yang akan di-debug.
-z DumpFile Menentukan nama file crash dump yang akan di-debug. Jika jalur dan nama file berisi spasi, ini harus dikelilingi oleh tanda kutip.
-debugArch x86 -or- amd64 Ambil alih perilaku autodetect dan atur bitness target untuk debugger.
-loadSession Muat file konfigurasi sesi yang disimpan.
-setupFirewallRules Mengonfigurasi aturan firewall yang diperlukan pada sistem lokal untuk memungkinkan penelusuran kesalahan kernel menggunakan KDNET.
-openPrivateDumpByHandle Handle Hanya penggunaan internal Microsoft. Menentukan handel file crash dump yang akan di-debug.
-benchmarkStartup Hanya penggunaan internal Microsoft. Menjalankan tolok ukur startup dan menambahkan hasilnya ke file.

Opsi simbol

Option Description
-y SymbolPath Menentukan jalur simbol yang akan digunakan. Pisahkan beberapa jalur dengan titik koma (;). Jika jalurnya berisi spasi, itu harus diapit dengan tanda kutip. Untuk detailnya, dan untuk cara lain mengubah jalur ini, lihat Jalur Simbol.
-n Beban simbol berisik. Mengaktifkan output verbose dari handler simbol.
-i *ImagePath Mengatur jalur pencarian gambar yang akan digunakan.
-sdce Menyebabkan debugger menampilkan pesan 'Kesalahan akses file' selama pemuatan simbol.
-ses Menyebabkan debugger melakukan evaluasi ketat dari semua file simbol dan mengabaikan simbol yang dipertanyakan.
-sicv Menyebabkan handler simbol mengabaikan rekaman CV.
-sins Menyebabkan debugger mengabaikan jalur simbol dan variabel lingkungan jalur gambar yang dapat dieksekusi.
-snc Menyebabkan debugger menonaktifkan terjemahan C++.
-snul Menonaktifkan pemuatan simbol otomatis untuk nama yang tidak memenuhi syarat.
-sup Menyebabkan handler simbol mencari tabel simbol publik selama setiap pencarian simbol.
-sflags Mengatur semua opsi handler simbol sekaligus.

Opsi jalur sumber

Option Description
-srcpath Menentukan jalur sumber yang akan digunakan pada server debug.
-lsrcpath Menentukan jalur sumber yang akan digunakan pada klien lokal.

Jika Anda berada dalam sesi debugger lokal, srcpath dan lsrcpath secara efektif sama ("server" Anda adalah sesi lokal Anda.) Untuk penelusuran kesalahan jarak jauh, ada situasi di mana Anda mungkin ingin mengaturnya ke nilai yang berbeda. Untuk informasi selengkapnya tentang penelusuran kesalahan jarak jauh, lihat Penelusuran Kesalahan Jarak Jauh.

Penanganan situasi pengecualian

Option Description
-x Aktifkan penanganan kesempatan kedua hanya untuk pengecualian pelanggaran akses.
-xe Exception Aktifkan penanganan pengecualian kesempatan pertama untuk pengecualian yang ditentukan.
-xd Exception Aktifkan penanganan pengecualian kesempatan kedua untuk pengecualian yang ditentukan.
-xn Exception Untuk pengecualian yang diberikan, nonaktifkan penanganan peluang pertama dan kedua, dan hanya menampilkan pesan di konsol.
-xi Exception Abaikan sepenuhnya pengecualian yang diberikan, menonaktifkan penanganan kesempatan pertama dan kedua, dan tidak menghasilkan apa pun ke konsol.

Untuk daftar pengecualian yang dapat ditentukan, lihat Definisi Kejadian dan Pengaturan Bawaan.

Postmortem

Option Description
-I Mengatur WinDbg sebagai debugger pasca-mortem default untuk sistem.
-IS Menetapkan WinDbg sebagai debugger pasca-mortem default untuk sistem tanpa pemberitahuan kepada pengguna, dengan hanya kesalahan yang terdeteksi dilaporkan.

Opsi yang tidak digunakan lagi

Option Description
-Q Opsi baris perintah yang tidak digunakan lagi.
-QY Opsi baris perintah yang tidak digunakan lagi.
-QS Opsi baris perintah yang tidak digunakan lagi.
-QSY Opsi baris perintah yang tidak digunakan lagi.
-WX Opsi baris perintah yang tidak digunakan lagi.

Untuk informasi umum tentang parameter startup, lihat Opsi winDbg Command-Line.

Anda dapat menggunakan -? untuk mencantumkan opsi baris perintah yang didukung.

Cuplikan layar output bantuan baris perintah WinDbgX yang menampilkan berbagai opsi.