Debugging Kode Sumber di WinDbg (Klasik)

Jalur Sumber

Jalur sumber menentukan direktori tempat file sumber C dan C++ berada. Untuk informasi selengkapnya tentang menampilkan kode sumber di debugger, lihat Jalur sumber.

Nota Jika Anda terhubung ke jaringan perusahaan, cara paling efisien untuk mengakses file sumber adalah dengan menggunakan server sumber. Anda dapat menggunakan server sumber dengan menggunakan string srv* dalam jalur sumber Anda. Untuk informasi selengkapnya tentang server sumber, lihat Menggunakan Server Sumber.

Untuk mengontrol jalur sumber di WinDbg, lakukan salah satu hal berikut:

• Pilih Jalur File Sumber dari menu File atau tekan CTRL+P.

• Gunakan perintah .srcpath (Atur Jalur Sumber). Jika Anda menggunakan server sumber, .srcfix (Gunakan Server Sumber) sedikit lebih mudah.

• Gunakan perintah .lsrcpath (Atur Jalur Sumber Lokal). Jika Anda menggunakan server sumber, .lsrcfix (Gunakan Server Sumber Lokal) sedikit lebih mudah.

• Saat Anda memulai debugger, gunakan opsi baris perintah -srcpath atau -lsrcpath . Lihat opsi WinDbg Command-Line.

• Sebelum Anda memulai debugger, atur variabel lingkungan _NT_SOURCE_PATH.

Membuka dan Menutup File Sumber

Untuk membuka atau menutup file sumber secara langsung, lakukan salah satu hal berikut ini:

• Pilih Buka Berkas Sumber dari menu File, atau tekan CTRL+O. Anda juga dapat menggunakan tombol Buka file sumber (

  Nota Saat Anda menggunakan menu atau tombol toolbar untuk membuka file sumber, jalur file tersebut secara otomatis ditambahkan ke jalur sumber.

• Pilih Tutup Jendela Saat Ini dari menu File .

• Pilih tombol Tutup di sudut jendela Sumber.

• Pilih File Terbaru dari menu File untuk membuka salah satu dari empat file sumber yang baru-baru ini Anda buka di WinDbg.

• Masukkan perintah .open (File Sumber Terbuka).

• Masukkan perintah lsf (Muat atau Bongkar File Sumber).

Di WinDbg, jendela Sumber menampilkan file sumber yang telah dimuat ke dalam debugger.

Membuka Jendela Sumber

Debugger membuka jendela sumber saat memuat file sumber baru. Untuk memulihkan atau beralih ke jendela Sumber yang terbuka, buka menu Jendela dan pilih dari daftar jendela di bagian bawah menu.

Cuplikan layar berikut menunjukkan contoh jendela Sumber.

Setiap file sumber berada di jendela Sumbernya sendiri. Judul setiap jendela Sumber adalah jalur lengkap file sumber.

Menggunakan Jendela Sumber

Setiap jendela Sumber menampilkan teks dari satu file sumber. Anda tidak dapat mengedit file sumber di debugger. Untuk informasi selengkapnya tentang mengubah pengaturan font dan tab, lihat Mengubah Properti Teks.

Setiap jendela Sumber memiliki menu pintasan dengan perintah tambahan. Untuk mengakses menu, pilih dan tahan (atau klik kanan) bilah judul atau pilih ikon yang muncul di dekat sudut kanan atas jendela. Daftar berikut ini menjelaskan beberapa perintah menu:

• Atur penunjuk instruksi ke baris saat ini mengubah nilai penunjuk instruksi ke instruksi yang sesuai dengan baris saat ini. Perintah ini setara dengan menggunakan Edit | Atur perintah Instruksi Saat Ini atau tekan CTRL+SHIFT+I.

• Edit file ini membuka file sumber di editor teks. Editor ditentukan oleh informasi registri editor WinDiff atau dengan nilai variabel lingkungan WINDBG_INVOKE_EDITOR. Misalnya, pertimbangkan kasus ketika nilai WINDBG_INVOKE_EDITOR adalah sebagai berikut.

  c:\my\path\myeditor.exe -file %f -line %l
  

  Dalam hal ini, Myeditor.exe akan terbuka ke nomor baris berbasis satu dari file sumber saat ini. Opsi %l menunjukkan bahwa nomor baris harus dibaca sebagai berbasis satu, sementara %f menunjukkan bahwa file sumber saat ini harus digunakan. Kemungkinan penggantian lainnya termasuk %L, yang menunjukkan bahwa nomor baris berbasis nol, dan %p, yang juga dapat menunjukkan bahwa file sumber saat ini harus digunakan.

• Mengevaluasi pilihan mengevaluasi teks yang saat ini dipilih dengan menggunakan evaluator ekspresi C++. Hasilnya muncul di jendela Perintah Debugger. Jika teks yang dipilih menyertakan lebih dari satu baris, hasil kesalahan sintaks. Perintah ini setara dengan menggunakan Edit | Evaluasi perintah Pemilihan , menekan CTRL+SHIFT+V, atau menggunakan ?? (Evaluasi Ekspresi C++) perintah dengan teks terpilih sebagai argumennya.

• Tampilkan tipe terpilih menampilkan tipe data dari objek terpilih. Tampilan ini muncul di jendela Perintah Debugger. Jika teks yang dipilih menyertakan lebih dari satu objek, kesalahan sintaksis atau hasil tidak teratur lainnya mungkin ditampilkan. Perintah ini setara dengan menggunakan Edit | Tampilkan perintah Tipe Terpilih atau tekan CTRL+SHIFT+Y.

• Buka jendela memori untuk pilihan membuka jendela Memori tertampan baru yang menampilkan memori yang dimulai pada alamat ekspresi yang dipilih.

• Tambahkan pilihan ke jendela Watch menambahkan token sumber yang dipilih ke jendela Watch.

• Membongkar pada baris saat ini menyebabkan instruksi yang sesuai dengan baris saat ini muncul di jendela Pembongkaran. Baris yang dipilih disorot di jendela Sumber dan di jendela Pembongkaran, tetapi perintah ini hanya memengaruhi tampilan—penunjuk instruksi tidak diubah. Jika jendela Pembongkaran ditutup saat perintah ini dipilih, maka akan dibuka.

• Pilih bahasa sumber menampilkan daftar bahasa pemrograman. Pilih bahasa pemrograman yang Anda gunakan untuk menghasilkan file sumber, lalu pilih OK untuk mengaktifkan penyorotan sintaks dasar untuk jendela Sumber saat ini. Pilih <Tidak Ada> untuk menonaktifkan penyorotan sintaks untuk jendela Sumber saat ini.

Warna Jendela Sumber dan Evaluasi Hover

Jika debugger mengenali ekstensi nama file sumber, jendela Sumber menampilkan elemen sintaksis tertentu dalam warna. Untuk menonaktifkan atau mengubah warna, lakukan hal berikut:

• Untuk menonaktifkan warna sintaks dalam satu jendela, buka menu pintasan Jendela sumber, pilih Pilih bahasa sumber, lalu pilih <Tidak Ada>.

• Untuk menonaktifkan warna sintaks untuk semua jendela Sumber, pilih Opsi dari menu Tampilan . Lalu kosongkan kotak centang Uraikan Bahasa Sumber .

• Untuk mengubah warna sintaks, pilih Opsi dari menu Tampilan . Kemudian, di area Warna , pilih elemen sintaksis dan pilih tombol Ubah untuk mengubah warna.

• Metode penguraian yang digunakan untuk penyorotan ditentukan oleh bahasa pemrograman yang terkait dengan ekstensi file untuk file sumber. Untuk mengubah bahasa pemrograman yang terkait dengan ekstensi file tertentu, gunakan kotak dialog Ekstensi File untuk Bahasa Sumber. Untuk membuka kotak dialog ini, pilih Ekstensi file bahasa sumber dari menu Tampilan .

Garis yang mewakili penghitung program saat ini disorot. Garis di mana titik henti ditetapkan juga disorot.

Jika Anda memilih jendela Sumber lalu menggunakan mouse untuk mengarahkan kursor ke simbol di jendela tersebut, simbol akan dievaluasi. Evaluasi sama dengan yang dihasilkan oleh perintah dt (Jenis Tampilan). Untuk menonaktifkan evaluasi ini, pilih Opsi dari menu Tampilan . Lalu hapus centang kotak Evaluasi saat melayang.

Lihat juga

Untuk informasi selengkapnya tentang penelusuran kesalahan sumber dan perintah terkait, lihat Penelusuran kesalahan dalam Mode Sumber.