Symbol Options

Для управления загрузкой и использованием символов можно использовать ряд вариантов. Эти параметры можно задать различными способами.

В следующей таблице перечислены следующие параметры символов:

Изменение параметров параметра символа

Команда Symopt (Задать параметры символов) может использоваться для изменения или отображения параметров параметра символа. 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. Рекомендуется использовать шестнадцатеричное значение, так как флаги символов выравниваются должным образом. Будьте осторожны при использовании этого метода, так как он задает весь битовый поле и переопределит все значения обработчика символов по умолчанию. 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!

Значение по умолчанию для битов общего флага — 0x30237 в WinDbg, 0xB0227 в CDB и KD и 0x10C13 в средстве DBH, когда эти программы запускаются без каких-либо параметров командной строки, связанных с символами.

SYMOPT_CASE_INSENSITIVE

Этот параметр символа приводит к тому, что все поиски имен символов не учитывает регистр.

Этот параметр включен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x1 or .symopt-0x1, respectively.

Этот параметр включен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +1 или symopt -1 соответственно.

SYMOPT_UNDNAME

Этот параметр символа приводит к тому, что имена открытых символов не будут отображаться при отображении и вызывают поиск имен символов, чтобы игнорировать украшения символов. Имена частных символов никогда не декорируются независимо от того, активен ли этот параметр. Сведения о украшении имен символов см. в разделе " Общедоступные и частные символы".

Этот параметр включен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x2 or .symopt-0x2, respectively.

Этот параметр включен по умолчанию в DBH. Оно отключено, если используется параметр командной строки -d. После запуска DBH его можно включить или отключить с помощью symopt +2 или symopt -2 соответственно.

SYMOPT_DEFERRED_LOADS

Этот параметр символа называется отложенной загрузкой символов или отложенной загрузкой символов. Если он активен, символы на самом деле не загружаются при загрузке целевых модулей. Вместо этого символы загружаются отладчиком по мере их необходимости. Дополнительные сведения см. в разделе "Отложенная загрузка символов ".

Этот параметр включен по умолчанию во всех отладчиках. В CDB и KD параметр командной строки -s отключит этот параметр. 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.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +4 или symopt -4 соответственно.

SYMOPT_NO_CPP

Этот параметр символа отключает перевод C++. When this symbol option is set, :: is replaced by __ in all symbols.

Этот параметр отключен по умолчанию во всех отладчиках. Его можно активировать с помощью параметра командной строки -snc. Once the debugger is running, it can be turned on or off by using .symopt+0x8 or .symopt-0x8, respectively.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +8 или symopt -8 соответственно.

SYMOPT_LOAD_LINES

Этот параметр символа позволяет считывать сведения о номере строки из исходных файлов. Этот параметр должен быть включен для правильной работы исходной отладки.

В KD и CDB этот параметр отключен по умолчанию; В WinDbg этот параметр включен по умолчанию. В CDB и KD параметр командной строки -lines включает этот параметр. Once the debugger is running, it can be turned on or off by using .symopt+0x10 or .symopt-0x10, respectively. Кроме того, его можно включить и отключить с помощью команды .line (переключатель поддержки исходной строки).

Этот параметр включен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +10 или symopt -10 соответственно.

SYMOPT_OMAP_FIND_NEAREST

При оптимизации кода и отсутствии символа в ожидаемом расположении этот параметр приводит к использованию ближайшего символа.

Этот параметр включен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x20 or .symopt-0x20, respectively.

Этот параметр включен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +20 или symopt -20 соответственно.

SYMOPT_LOAD_ANYTHING

Этот параметр символа уменьшает готовность обработчика символов при попытке сопоставить символы.

Этот параметр отключен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x40 or .symopt-0x40, respectively.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +40 или symopt -40 соответственно.

SYMOPT_IGNORE_CVREC

Этот параметр символа заставляет обработчик символов игнорировать запись CV в загруженном заголовке изображения при поиске символов.

Этот параметр отключен по умолчанию во всех отладчиках. Его можно активировать с помощью параметра командной строки -sicv. Once the debugger is running, it can be turned on or off by using .symopt+0x80 or .symopt-0x80, respectively.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +80 или symopt -80 соответственно.

SYMOPT_NO_UNQUALIFIED_LOADS

Этот параметр символа отключает автоматическую загрузку модулей обработчика символов. Если этот параметр задан и отладчик пытается сопоставить символ, он будет выполнять поиск только модулей, которые уже загружены.

Этот параметр можно использовать в качестве защиты от несоответствия имени символа. Как правило, неправильный символ приведет к приостановке отладчика при поиске всех выгрузочных файлов символов. Если этот параметр активен, в загруженных модулях не будет найден неправильный символ, а затем поиск завершится.

Этот параметр отключен по умолчанию во всех отладчиках. Его можно активировать с помощью параметра командной строки -snul. Once the debugger is running, it can be turned on or off by using .symopt+0x100 or .symopt-0x100, respectively.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +100 или symopt -100 соответственно.

SYMOPT_FAIL_CRITICAL_ERRORS

Этот параметр символа приводит к отключению диалоговых окон доступа к файлам.

Если этот параметр отключен, ошибки доступа к файлам, такие как "диск не готов", возникшие во время загрузки символов, будут отображаться диалоговые окна. Если этот параметр включен, эти поля подавляются, а все ошибки доступа получают ответ "сбой".

Этот параметр включен по умолчанию во всех отладчиках. Его можно отключить с помощью параметра командной строки -sdce. Once the debugger is running, it can be turned on or off by using .symopt+0x200 or .symopt-0x200, respectively.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +200 или symopt -200 соответственно.

SYMOPT_EXACT_SYMBOLS

Этот параметр символа приводит к тому, что отладчик выполняет строгую оценку всех файлов символов.

Если этот параметр включен, даже наименьшее несоответствие между файлами символов и ожиданиями обработчика символов приведет к тому, что символы будут игнорироваться.

Этот параметр отключен по умолчанию во всех отладчиках. Его можно активировать с помощью параметра командной строки -ses. Once the debugger is running, it can be turned on or off by using .symopt+0x400 or .symopt-0x400, respectively.

Параметр командной строки -failinc также включает SYMOPT_EXACT_SYMBOLS. Кроме того, если выполняется отладка мини-dump в пользовательском режиме или мини-ddump в режиме ядра, -failinc не позволит отладчику загружать модули, образы которых невозможно сопоставить.

Этот параметр включен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +400 или symopt -400 соответственно.

SYMOPT_ALLOW_ABSOLUTE_SYMBOLS

Этот параметр символа позволяет DbgHelp считывать символы, хранящиеся в абсолютном адресе в памяти. Этот вариант не нужен в подавляющем большинстве случаев.

Этот параметр отключен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x800 or .symopt-0x800, respectively.

Этот параметр включен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +800 или symopt -800 соответственно.

SYMOPT_IGNORE_NT_SYMPATH

Этот параметр символа приводит к тому, что отладчик игнорирует параметры переменной среды для пути символа и пути к исполняемому изображению.

Этот параметр отключен по умолчанию во всех отладчиках. Его можно активировать с помощью параметра командной строки -sins. However, it cannot be controlled by .symopt once the debugger is running, because the environment variables are only read at startup.

Этот параметр отключен по умолчанию в DBH и игнорируется DBH во всех случаях.

SYMOPT_PUBLICS_ONLY

Этот параметр символа приводит к тому, что DbgHelp игнорирует данные закрытых символов и выполняет поиск только в общедоступной таблице символов для получения сведений о символах. Это эмулирует поведение DbgHelp до добавления поддержки этих типов. см. общие и закрытые символы.

Этот параметр отключен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x4000 or .symopt-0x4000, respectively.

Этот параметр отключен по умолчанию в DBH. Он включен, если используется параметр командной строки -d. После запуска DBH его можно включить или отключить с помощью symopt +4000 или symopt -4000 соответственно.

SYMOPT_NO_PUBLICS

Этот параметр символа запрещает DbgHelp выполнять поиск в общедоступной таблице символов. Это позволяет ускорить поиск символов и символов. Если вы обеспокоены исключительно скоростью поиска, SYMOPT_AUTO_PUBLICS вариант, как правило, предпочтительнее для этого. Сведения о таблице открытых символов см. в разделе " Открытые и частные символы".

Этот параметр отключен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x8000 or .symopt-0x8000, respectively.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +8000 или symopt -8000 соответственно.

SYMOPT_AUTO_PUBLICS

Этот параметр символа приводит к тому, что DbgHelp будет выполнять поиск в таблице открытых символов в PDB-файле только в качестве последнего способа. Если при поиске данных закрытого символа обнаружены какие-либо совпадения, открытые символы не будут искать. Это повышает скорость поиска символов.

Этот параметр включен по умолчанию во всех отладчиках. Его можно отключить с помощью параметра командной строки -sup. Once the debugger is running, it can be turned on or off by using .symopt+0x10000 or .symopt-0x10000, respectively.

Этот параметр включен по умолчанию в DBH. Оно отключено, если используется параметр командной строки -d. После запуска DBH его можно включить или отключить с помощью symopt +10000 или symopt -10000 соответственно.

SYMOPT_NO_IMAGE_SEARCH

Этот параметр символа запрещает dbgHelp выполнять поиск на диске для копии изображения при загрузке символов.

Этот параметр включен по умолчанию во всех отладчиках. Once the debugger is running, it can be turned on or off by using .symopt+0x20000 or .symopt-0x20000, respectively.

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +20000 или symopt -20000 соответственно.

SYMOPT_SECURE

(Kernel mode only) This symbol option indicates whether Secure Mode is active.

Безопасный режим отключен по умолчанию во всех отладчиках. Его можно активировать с помощью параметра командной строки -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).

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +40000 или symopt -40000 соответственно.

Безопасный режим никогда не может быть отключен после активации.

SYMOPT_NO_PROMPTS

Этот параметр символа запрещает диалоговые окна проверки подлинности с прокси-сервера. Это может привести к тому, что SymSrv не может получить доступ к хранилищу символов в Интернете.

Дополнительные сведения см. в разделе "Брандмауэры" и "Прокси-серверы".

В KD и CDB этот параметр включен по умолчанию; В WinDbg этот параметр отключен по умолчанию. 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. Кроме того, его можно включить и отключить с помощью команд расширения !sym, а затем команды расширения .reload (Перезагрузить модуль).

Этот параметр отключен по умолчанию в DBH. После запуска DBH его можно включить или отключить с помощью symopt +80000 или symopt -80000 соответственно.

-SYMOPT_DEBUG

Этот параметр символа включает загрузку шумных символов. Это указывает отладчику отображать сведения о поиске символов.

Имя каждого файла символа будет отображаться при загрузке. Если отладчик не может загрузить файл символов, отобразится сообщение об ошибке. Сообщения об ошибках для PDB-файлов будут отображаться в тексте. Сообщения об ошибках для dbg-файлов будут находиться в виде кода ошибки; Эти коды описаны в файле winerror.h.

Если файл изображения загружается исключительно для восстановления сведений о символьном заголовке, это также будет отображаться.

Этот параметр отключен по умолчанию во всех отладчиках. Его можно активировать с помощью параметра командной строки -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.

Этот параметр отключен по умолчанию в DBH. Его можно активировать с помощью параметра командной строки -n. После запуска DBH его можно включить или отключить с помощью symopt +8000000000 или symopt -800000000 соответственно. Кроме того, его можно включить и отключить с помощью подробных команд.