Bagikan melalui

Menggunakan SrcSrv

  • Artikel

Untuk menggunakan SrcSrv dengan WinDbg, KD, NTSD, atau CDB, verifikasi bahwa Anda telah menginstal versi terbaru dari paket Alat Debugging untuk Windows (versi 6.3 atau yang lebih baru). Kemudian, sertakan teks srv* di jalur sumber, dipisahkan oleh titik koma dari direktori apa pun yang juga berada di jalur sumber.

Contohnya:

.srcpath srv*;c:\someSourceCode

Jika jalur sumber diatur seperti yang ditunjukkan dalam contoh sebelumnya, debugger terlebih dahulu menggunakan SrcSrv untuk mengambil file sumber dari lokasi yang ditentukan dalam file simbol modul target. Jika SrcSrv tidak dapat mengambil file sumber, debugger mencoba mengambilnya dari c:\someSourceCode. Terlepas dari apakah srv* adalah elemen pertama di jalur atau muncul nanti, debugger selalu menggunakan SymSrv sebelum mencari direktori lain yang tercantum di jalur.

Jika file sumber diambil oleh SrcSrv, file tersebut tetap berada di hard drive Anda setelah sesi penelusuran kesalahan selesai. File sumber disimpan secara lokal di subdirektori src direktori beranda (tidak seperti server simbol, server sumber tidak menentukan cache lokal dalam sintaks itu srv* sendiri). Direktori beranda default ke direktori Alat Debugging untuk penginstalan Windows; ini dapat diubah dengan menggunakan ekstensi !homedir atau dengan mengatur variabel lingkungan DBGHELP_HOMEDIR. Jika subdirektori src dari direktori beranda belum ada, subdirektori tersebut dibuat.

Penelusuran kesalahan SrcSrv

Jika Anda mengalami masalah saat mengekstrak file sumber dari debugger, mulai debugger dengan parameter baris perintah -n untuk melihat perintah ekstraksi sumber aktual bersama dengan output perintah tersebut. Perintah !sym noisy melakukan hal yang sama, tetapi Anda mungkin telah melewatkan informasi penting dari upaya ekstraksi sebelumnya. Ini karena debugger menyerah mencoba mengakses sumber dari repositori kontrol versi yang tampaknya tidak dapat dijangkau.

Mengambil File Sumber

Jika Anda menggunakan perintah .open (Open Source File) untuk membuka file sumber baru melalui SrcSrv, Anda harus menyertakan parameter Alamat -m.

Untuk memfasilitasi penggunaan SrcSrv dari alat selain debugger yang tercantum sebelumnya, API DbgHelp menyediakan akses ke fungsionalitas SrcSrv melalui fungsi SymGetSourceFile . Untuk mengambil nama file sumber yang akan diambil, panggil fungsi SymEnumSourceFiles atau SymGetLineFromAddr64 . Untuk detail selengkapnya tentang DbgHelp API, lihat dokumentasi dbghelp.chm, yang dapat ditemukan di subdirektori sdk/bantuan dari alat debugging untuk direktori penginstalan Windows, atau lihat Pustaka Bantuan Debug.

Menggunakan AgeStore untuk Mengurangi Ukuran Cache

File sumber apa pun yang diunduh oleh SrcSrv tetap berada di hard drive Anda setelah sesi penelusuran kesalahan selesai. Untuk mengontrol ukuran cache sumber, alat AgeStore dapat digunakan untuk menghapus file cache yang lebih lama dari tanggal yang ditentukan atau untuk mengurangi konten cache di bawah ukuran yang ditentukan. Untuk detailnya, lihat AgeStore.