Синтаксис Pseudo-Register

Отладчик поддерживает несколько псевдорегистров, которые содержат определенные значения.

Отладчик устанавливает для автоматических псевдорегистров определенные полезные значения. Определяемые пользователем псевдорегистры — это целочисленные переменные, которые можно записывать или считывать.

Все псевдорегистры начинаются со знака доллара ($). Если вы используете синтаксис MASM, вы можете добавить знак @ () перед знаком доллара. Этот знак at сообщает отладчику, что следующий маркер является регистром или псевдорегистрателем, а не символом. Если опустить знак at, отладчик отвечает медленнее, так как ему приходится искать всю таблицу символов.

Например, следующие две команды создают одинаковые выходные данные, но вторая команда выполняется быстрее.

0:000> ? $exp
Evaluate expression: 143 = 0000008f
0:000> ? @$exp
Evaluate expression: 143 = 0000008f

Если существует символ с тем же именем, что и псевдорегистра, необходимо добавить знак at.

При использовании синтаксиса выражений C++ всегда требуется знак at ( @ ).

Команда r (Registers) является исключением из этого правила. Отладчик всегда интерпретирует свой первый аргумент как регистр или псевдорегистрал. (Знак при не требуется или не разрешен.) Если для команды r есть второй аргумент, он интерпретируется в соответствии с синтаксисом выражения по умолчанию. Если синтаксис выражений по умолчанию — C++, необходимо скопировать псевдорегистрал $t 2 в псевдорегистратив $t 1 .

0:000> r $t1 = @$t2

Автоматическое Pseudo-Registers

Отладчик автоматически задает следующие псевдорегистры.

Некоторые из этих псевдорегистров могут быть недоступны в некоторых сценариях отладки. Например, нельзя использовать $peb, $tid и $tpid при отладке минидампов в пользовательском режиме или определенных файлов дампа в режиме ядра. В некоторых ситуациях сведения о потоке можно получить из ~ (состояние потока), но не из $tid. Вы не можете использовать $previp псевдорегистрару в первом событии отладчика. Вы не можете использовать $relip псевдорегистративную регистрацию, если не выполняется трассировка ветви. Если вы используете недоступный псевдорегистр, возникает синтаксическая ошибка.

Псевдорегистратор, содержащий адрес структуры, такой как $thread, $proc, $teb, $peb и $lastclrex , будет вычисляться в соответствии с соответствующим типом данных в средстве оценки выражений C++, но не в вычислителе выражений MASM. Например, команда ? $teb отображает адрес TEB, а команда ?? @$teb — всю структуру TEB. Дополнительные сведения см. в разделе Вычисление выражений.

На процессоре на основе Itanium регистр IIPвыравнивается по пакету, что означает, что он указывает на слот 0 в пакете, содержающем текущую инструкцию, даже если выполняется другой слот. Таким образом , iIP не является полным указателем инструкции. Псевдорегистративная $ip — это фактический указатель инструкции, включая пакет и слот. Другие псевдорегистры, в которых содержатся указатели адресов ($ra, $retreg, $eventip, $previp, $relip и $exentry), имеют ту же структуру, что и $ip на всех процессорах.

Для изменения значения $ip можно использовать команду r. Это изменение также автоматически изменяет соответствующий регистр. При возобновлении выполнения оно возобновляется по новому адресу указателя инструкции. Это единственный автоматический псевдорегистрат, который можно изменить вручную.

Примечание В синтаксисе MASM можно указать $ip псевдорегистрару с точкой ( . ). Вы не добавляете знак at (@) до этого периода и не используете точку в качестве первого параметра команды r . Этот синтаксис не допускается в выражении C++.

Автоматические псевдорегистры похожи на автоматические псевдонимы. Но вы можете использовать автоматические псевдонимы вместе с маркерами, связанными с псевдонимами (например , ${ }), и с такими маркерами нельзя использовать псевдорегистры.

Определяемые пользователем Pseudo-Registers

Существует 20 определяемых пользователем псевдорегистров ($t 0, $t 1, ..., $t 19). Эти псевдорегистрали являются переменными, которые можно считывать и записывать с помощью отладчика. В этих псевдорегистрах можно хранить любое целочисленное значение. Они могут быть особенно полезны в качестве переменных цикла.

Чтобы записать данные в один из этих псевдорегистров, используйте команду r (Registers), как показано в следующем примере.

0:000> r $t0 = 7
0:000> r $t1 = 128*poi(MyVar)

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

0:000> bp $t3 
0:000> bp @$t4 
0:000> ?? @$t1 + 4*@$t2 

Псевдорегистрал всегда вводится как целое число, если только вы не используете параметр ? вместе с командой r . Если вы используете этот параметр, псевдорегистрал получает тип того, что ему назначено. Например, следующая команда назначает тип UNICODE_STRING** и значение 0x0012FFBC $t 15.

0:000> r? $t15 = * (UNICODE_STRING*) 0x12ffbc

Определяемые пользователем псевдорегистраторы используют ноль в качестве значения по умолчанию при запуске отладчика.

Примечание Псевдонимы $u 0, $u 1, ..., $u 9 не являются псевдорегистралами, несмотря на их похожий внешний вид. Дополнительные сведения об этих псевдонимах см. в разделе Использование псевдонимов.

Пример

В следующем примере задается точка останова, которая достигается каждый раз, когда текущий поток вызывает NtOpenFile. Но эта точка останова не достигается, когда другие потоки вызывают NtOpenFile.

kd> bp /t @$thread nt!ntopenfile

Пример

В следующем примере команда выполняется до тех пор, пока регистр не содержит указанное значение. Сначала поместите следующий код для условного пошагового выполнения в файл скрипта с именем eaxstep.

.if (@eax == 1234) { .echo 1234 } .else { t "$<eaxstep" }

Затем выполните следующую команду.

t "$<eaxstep"

Отладчик выполняет шаг, а затем выполняет команду . В этом случае отладчик запускает скрипт, который либо отображает 1234 , либо повторяет процесс.