Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Sejumlah opsi tersedia untuk mengontrol bagaimana simbol dimuat dan digunakan. Opsi ini dapat diatur dalam berbagai cara.
Tabel berikut mencantumkan opsi simbol ini:
| Flag | Option Name | Default dalam debugger | Default dalam DBH |
|---|---|---|---|
0x1 |
On |
On |
|
0x2 |
On |
On |
|
0x4 |
On |
Off |
|
0x8 |
Off |
Off |
|
0x10 |
Nonaktif di KD dan CDB Aktif di WinDbg |
On |
|
0x20 |
On |
Off |
|
0x40 |
Off |
Off |
|
0x80 |
Off |
Off |
|
0x100 |
Off |
Off |
|
0x200 |
On |
Off |
|
0x400 |
Off |
On |
|
0x800 |
Off |
On |
|
0x1000 |
Off |
Off |
|
0x2000 |
SYMOPT_INCLUDE_32BIT_MODULES |
Off |
Off |
0x4000 |
Off |
Off |
|
0x8000 |
Off |
Off |
|
0x10000 |
On |
On |
|
0x20000 |
On |
Off |
|
0x40000 |
Off |
Off |
|
0x80000 |
Aktif di KD dan CDB Nonaktif di WinDbg |
Off |
|
0x80000000 |
Off |
Off |
Mengubah Pengaturan Opsi Simbol
Perintah .symopt (Atur Opsi Simbol) dapat digunakan untuk mengubah atau menampilkan pengaturan opsi simbol. In addition, a number of command-line parameters and commands are available to change these settings; these are listed in the individual SYMOPT_XXX sections.
You can also control all the settings at once with the -sflagscommand-line option. This option can be followed with a decimal number, or with a hexadecimal number prefixed by 0x. Disarankan agar Anda menggunakan heksadesimal, karena bendera simbol diselaraskan dengan benar seperti itu. Berhati-hatilah dalam menggunakan metode ini, karena mengatur seluruh bitfield dan akan mengambil alih semua default handler simbol. For example, -sflags 0x401 will not only turn on SYMOPT_EXACT_SYMBOLS and SYMOPT_CASE_INSENSITIVE, but will also turn off all the other options that normally are on by default!
Nilai default untuk total bit bendera 0x30237 di WinDbg, 0xB0227 di CDB dan KD, dan 0x10C13 di alat DBH, ketika program ini diluncurkan tanpa opsi baris perintah terkait simbol apa pun.
SYMOPT_CASE_INSENSITIVE
Opsi simbol ini menyebabkan semua pencarian nama simbol tidak peka huruf besar/kecil.
Opsi ini aktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x1 or .symopt-0x1, respectively.
Opsi ini aktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +1 atau symopt -1, masing-masing.
SYMOPT_UNDNAME
Opsi simbol ini menyebabkan nama simbol publik tidak terdekorasi saat ditampilkan, dan menyebabkan pencarian nama simbol mengabaikan dekorasi simbol. Nama simbol privat tidak pernah dihiasi, terlepas dari apakah opsi ini aktif. Untuk informasi tentang dekorasi nama simbol, lihat Simbol Publik dan Privat.
Opsi ini aktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x2 or .symopt-0x2, respectively.
Opsi ini aktif secara default di DBH. Ini dimatikan jika opsi baris perintah -d digunakan. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +2 atau symopt -2, masing-masing.
SYMOPT_DEFERRED_LOADS
Opsi simbol ini disebut pemuatan simbol yang ditangguhkan atau pemuatan simbol malas. Ketika aktif, simbol tidak benar-benar dimuat ketika modul target dimuat. Sebagai gantinya, simbol dimuat oleh debugger karena diperlukan. Lihat Pemuatan Simbol Yang Ditangguhkan untuk detailnya.
Opsi ini aktif secara default di semua debugger. Di CDB dan KD, opsi baris perintah -s akan menonaktifkan opsi ini. It can also be turned off in CDB by using the LazyLoad variable in the tools.ini file. Once the debugger is running, this option can be turned on or off by using .symopt+0x4 or .symopt-0x4, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +4 atau symopt -4, masing-masing.
SYMOPT_NO_CPP
Opsi simbol ini menonaktifkan terjemahan C++. When this symbol option is set, :: is replaced by __ in all symbols.
Opsi ini nonaktif secara default di semua debugger. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -snc. Once the debugger is running, it can be turned on or off by using .symopt+0x8 or .symopt-0x8, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +8 atau symopt -8, masing-masing.
SYMOPT_LOAD_LINES
Opsi simbol ini memungkinkan informasi nomor baris dibaca dari file sumber. Opsi ini harus aktif agar penelusuran kesalahan sumber berfungsi dengan benar.
Di KD dan CDB, opsi ini nonaktif secara default; di WinDbg, opsi ini aktif secara default. Di CDB dan KD, opsi baris perintah -lines akan mengaktifkan opsi ini. Once the debugger is running, it can be turned on or off by using .symopt+0x10 or .symopt-0x10, respectively. Ini juga dapat diaktifkan dan dinonaktifkan dengan menggunakan perintah .lines (Toggle Source Line Support).
Opsi ini aktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +10 atau symopt -10, masing-masing.
SYMOPT_OMAP_FIND_NEAREST
Ketika kode telah dioptimalkan dan tidak ada simbol di lokasi yang diharapkan, opsi ini menyebabkan simbol terdekat digunakan sebagai gantinya.
Opsi ini aktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x20 or .symopt-0x20, respectively.
Opsi ini aktif secara default di DBH. Setelah DBH berjalan, DBH dapat dihidupkan atau dimatikan dengan menggunakan symopt +20 atau symopt -20, masing-masing.
SYMOPT_LOAD_ANYTHING
Opsi simbol ini mengurangi kepetikan penangan simbol saat mencoba mencocokkan simbol.
Opsi ini nonaktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x40 or .symopt-0x40, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +40 atau symopt -40, masing-masing.
SYMOPT_IGNORE_CVREC
Opsi simbol ini menyebabkan handler simbol mengabaikan rekaman CV di header gambar yang dimuat saat mencari simbol.
Opsi ini nonaktif secara default di semua debugger. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -sicv. Once the debugger is running, it can be turned on or off by using .symopt+0x80 or .symopt-0x80, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +80 atau symopt -80, masing-masing.
SYMOPT_NO_UNQUALIFIED_LOADS
Opsi simbol ini menonaktifkan pemuatan modul otomatis handler simbol. Ketika opsi ini diatur dan debugger mencoba mencocokkan simbol, opsi ini hanya akan mencari modul yang telah dimuat.
Opsi ini dapat digunakan sebagai pertahanan terhadap salah ketik nama simbol. Biasanya, simbol yang salah ketik akan menyebabkan debugger dijeda saat mencari semua file simbol yang dibongkar. Ketika opsi ini aktif, simbol yang salah ketik tidak akan ditemukan dalam modul yang dimuat, dan kemudian pencarian akan dihentikan.
Opsi ini nonaktif secara default di semua debugger. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -snul. Once the debugger is running, it can be turned on or off by using .symopt+0x100 or .symopt-0x100, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +100 atau symopt -100, masing-masing.
SYMOPT_FAIL_CRITICAL_ERRORS
Opsi simbol ini menyebabkan kotak dialog kesalahan akses file ditekan.
Jika opsi ini nonaktif, kesalahan akses file, seperti "drive tidak siap", yang ditemui selama pemuatan simbol, akan mengakibatkan kotak dialog muncul. Jika opsi ini aktif, kotak-kotak ini ditekan dan semua kesalahan akses menerima respons "gagal".
Opsi ini aktif secara default di semua debugger. Ini dapat dinonaktifkan dengan menggunakan opsi baris perintah -sdce. Once the debugger is running, it can be turned on or off by using .symopt+0x200 or .symopt-0x200, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +200 atau symopt -200, masing-masing.
SYMOPT_EXACT_SYMBOLS
Opsi simbol ini menyebabkan debugger melakukan evaluasi ketat dari semua file simbol.
Ketika opsi ini aktif, bahkan perbedaan sekecil apa pun antara file simbol dan harapan penangan simbol akan menyebabkan simbol diabaikan.
Opsi ini nonaktif secara default di semua debugger. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -ses. Once the debugger is running, it can be turned on or off by using .symopt+0x400 or .symopt-0x400, respectively.
Opsi baris perintah -failinc juga mengaktifkan SYMOPT_EXACT_SYMBOLS. Selain itu, jika Anda men-debug minidump mode pengguna atau minidump mode kernel, -failinc akan mencegah debugger memuat modul apa pun yang gambarnya tidak dapat dipetakan.
Opsi ini aktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +400 atau symopt -400, masing-masing.
SYMOPT_ALLOW_ABSOLUTE_SYMBOLS
Opsi simbol ini memungkinkan DbgHelp membaca simbol yang disimpan pada alamat absolut dalam memori. Opsi ini tidak diperlukan dalam sebagian besar kasus.
Opsi ini nonaktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x800 or .symopt-0x800, respectively.
Opsi ini aktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +800 atau symopt -800, masing-masing.
SYMOPT_IGNORE_NT_SYMPATH
Opsi simbol ini menyebabkan debugger mengabaikan pengaturan variabel lingkungan untuk jalur simbol dan jalur gambar yang dapat dieksekusi.
Opsi ini nonaktif secara default di semua debugger. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -sins. However, it cannot be controlled by .symopt once the debugger is running, because the environment variables are only read at startup.
Opsi ini nonaktif secara default di DBH, dan diabaikan oleh DBH dalam semua kasus.
SYMOPT_PUBLICS_ONLY
Opsi simbol ini menyebabkan DbgHelp mengabaikan data simbol privat, dan hanya mencari tabel simbol publik untuk informasi simbol. Ini meniru perilaku DbgHelp sebelum dukungan untuk jenis ini ditambahkan. lihat Simbol Publik dan Privat.
Opsi ini nonaktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x4000 or .symopt-0x4000, respectively.
Opsi ini nonaktif secara default di DBH. Ini diaktifkan jika opsi baris perintah -d digunakan. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +4000 atau symopt -4000, masing-masing.
SYMOPT_NO_PUBLICS
Opsi simbol ini mencegah DbgHelp mencari tabel simbol publik. Ini dapat membuat enumerasi simbol dan pencarian simbol jauh lebih cepat. Jika Anda hanya khawatir dengan kecepatan pencarian, opsi SYMOPT_AUTO_PUBLICS umumnya lebih disukai daripada yang satu ini. Untuk informasi tentang tabel simbol publik, lihat Simbol Publik dan Privat.
Opsi ini nonaktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x8000 or .symopt-0x8000, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +8000 atau symopt -8000, masing-masing.
SYMOPT_AUTO_PUBLICS
Opsi simbol ini menyebabkan DbgHelp mencari tabel simbol publik dalam file .pdb hanya sebagai upaya terakhir. Jika ada kecocokan yang ditemukan saat mencari data simbol privat, simbol publik tidak akan dicari. Ini meningkatkan kecepatan pencarian simbol.
Opsi ini aktif secara default di semua debugger. Ini dapat dinonaktifkan dengan menggunakan opsi baris perintah -sup. Once the debugger is running, it can be turned on or off by using .symopt+0x10000 or .symopt-0x10000, respectively.
Opsi ini aktif secara default di DBH. Ini dimatikan jika opsi baris perintah -d digunakan. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +10000 atau symopt -10000, masing-masing.
SYMOPT_NO_IMAGE_SEARCH
Opsi simbol ini mencegah DbgHelp mencari disk untuk salinan gambar saat simbol dimuat.
Opsi ini aktif secara default di semua debugger. Once the debugger is running, it can be turned on or off by using .symopt+0x20000 or .symopt-0x20000, respectively.
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +20000 atau symopt -20000, masing-masing.
SYMOPT_SECURE
(Kernel mode only) This symbol option indicates whether Secure Mode is active.
Mode Aman nonaktif secara default di semua debugger. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -secure. If the debugger is running, is in dormant mode, and has not established any Debugging Servers, Secure Mode can be turned on by using .symopt+0x40000 or .secure (Activate Secure Mode).
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dimatikan dengan menggunakan symopt +40000 atau symopt -40000, masing-masing.
Mode aman tidak pernah dapat dimatikan setelah diaktifkan.
SYMOPT_NO_PROMPTS
Opsi simbol ini menekan kotak dialog autentikasi dari server proksi. Hal ini dapat mengakibatkan SymSrv tidak dapat mengakses penyimpanan simbol di internet.
Untuk detailnya, lihat Firewall dan Server Proksi.
Di KD dan CDB, opsi ini aktif secara default; di WinDbg, opsi ini nonaktif secara default. Once the debugger is running, it can be turned on or off by using .symopt+0x80000 or .symopt-0x80000, respectively, followed by the .reload (Reload Module) command. Ini juga dapat diaktifkan dan dinonaktifkan dengan menggunakan perintah !sym prompts off dan !sym prompts extension, diikuti oleh perintah .reload (Reload Module).
Opsi ini nonaktif secara default di DBH. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +80000 atau symopt -80000, masing-masing.
-SYMOPT_DEBUG
Opsi simbol ini menyalakan pemuatan simbol berisik. Ini menginstruksikan debugger untuk menampilkan informasi tentang pencarian simbolnya.
Nama setiap file simbol akan ditampilkan saat dimuat. Jika debugger tidak dapat memuat file simbol, debugger akan menampilkan pesan kesalahan. Pesan kesalahan untuk file .pdb akan ditampilkan dalam teks. Pesan kesalahan untuk file .dbg akan dalam bentuk kode kesalahan; kode ini dijelaskan dalam file winerror.h.
Jika file gambar dimuat hanya untuk memulihkan informasi header simbolis, ini juga akan ditampilkan.
Opsi ini nonaktif secara default di semua debugger. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -n. Once the debugger is running, it can be turned on or off by using .symopt+0x80000000 or .symopt-0x80000000, respectively. It can also be turned on and off by using the !sym noisy and !sym quiet extension commands.
Note This option should not be confused with noisy source loading -- that is controlled by the .srcnoisy (Noisy Source Loading) command.
Opsi ini nonaktif secara default di DBH. Ini dapat diaktifkan dengan menggunakan opsi baris perintah -n. Setelah DBH berjalan, DBH dapat diaktifkan atau dinonaktifkan dengan menggunakan symopt +80000000 atau symopt -80000000, masing-masing. Ini juga dapat dihidupkan dan dimatikan dengan menggunakan perintah verbose aktif dan verbose off.