Руководство по Soft-ICE (DOS) (стр. 4 )

XG аналогична команде G при нормальной отладке.

Обратите внимание:

Для использования XG вы должны быть в режиме эмуляции трассировки. См. главу 9

и команду TRACE из этого раздела для подробной информации о диапазонах

обратной трассировки.

Пример:

XG 273:1030

Эта команда перемещает указатель команд на

следующее упоминание команды по адресу 273:1030.

XRSET

XRSET -- Сброс буфера истории обратной трассировки

Синтаксис:

XRSET

Комментарии:

Команда XRSET сбрасывает буфер истории обратной трассировки. Эта команда

должна выполняться перед установкой диапазона обратной трассировки, если

в буфере обратной трассировки имеется нежелательная информация о командах.

Пример:

XRSET

Эта команда сбрасывает буфер обратной трассировки.

VECS

VECS -- Сохранение/восстановление/сравнение векторов прерываний

Синтаксис:

VECS [C|S|R]

C -- Сравнить текущую таблицу с сохраненной таблицей

S -- Сохранить текущую таблицу прерываний в буфере

R -- Восстановить таблицу прерываний из буфера

Комментарии:

Команда VECS позволяет вам сохранять и восстанавливать таблицу прерываний из

внутреннего буфера Soft-ICE. Также фактическая таблица может сравниваться с

сохраненной таблица с отображением различий.

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

с сохраненной копией, вывод производится в следующем формате:

адрес старый-вектор новый-вектор

Отображаются все измененные векторы.

Таблица векторов прерываний первоначально сохраняется, при загрузке Soft-ICE.

Это

Она также автоматически сохраняется при загрузке программы LDR'ом. Хранится

только одна копия таблицы векторов прерываний, т. о. при каждом выполнении

VECS S, предыдущая копия таблицы прерываний перезаписывается.

Если параметры не указаны, на экран выводится вся таблица векторов

прерываний.

Пример:

VECS C

Эта команда сравнивает фактическую таблицу векторов

прерываний с предварительно сохраненной во

внутреннем буфере векторов Soft-ICE.

SNAP

SNAP -- Запоминает содержимое блока памяти (snap shot)

Синтаксис:

SNAP [C|S|R] адрес1 адрес2

C -- Сравнить буфер с адресным интервалом

S -- Сохранить адресный интервал в буфере

R -- Восстановить адресный интервал из буфера

Комментарии:

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

Опция S копирует блок памяти в буфер в дополнительной памяти (XMS).

Опция C отображает различия между буфером в дополнительной памяти и

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

буфер в дополнительной памяти в адресный интервал в стандартной памяти.

Когда используется опция C, для сравнения буфера с адресным интервалом,

вывод производится в следующем формате:

адрес старые-данные новые-данные

Отображаются все измененные байты.

Обычно для опций C и R адрес необязателен. Если адрес не указан,

используется адрес, который был указан в последний раз при использовании

команды SNAP.

Примечания:

Для использования команды SNAP вы должны указать переключатель /TRA XXXX в

строке S-ICE. EXE в CONFIG. SYS.

Команда SNAP сохраняет данные в буфере истории обратной трассировки. Если вы

используете обратную трассировку, у вас будет конфликт со SNAP. В силу своей

специфики, SNAP перезапишет информацию обратной трассировки, если вы выполните

SNAP S, когда история команд находится в буфере обратной трассировки. Наоборот,

если вы сохранили область при помощи SNAP, активация диапазона обратной

трассировки перезапишет буфер SNAP.

Пример:

SNAP S 2000:0 4000:0

Эта команда сохраняет блок данных с 2000:0 по

4000:0 в буфере обратной трассировки Soft-ICE.

EMMMAP

EMMMAP -- Отображают карту распределения EMM

Синтаксис:

EMMMAP

Комментарии:

Команда EMMMAP отображает все физические страницы, которые доступны для EMM

памяти и страницы, которые в настоящее время отображены.

Обратите внимание:

Для использования этой функции должна быть активирована возможность Soft-ICE

EMM. См. главу 8 для подробной информации о предоставлении возможности EMM.

Пример:

EMMMAP

Этот пример отображает текущее распределение EMM

и следующей форме.

Физ. страница | Сег. адрес | Дескриптор/Страница(логическая)

00 ¦ D000 ¦ FFFF

01 ¦ D400 ¦ 0001/0000

02 ¦ D800 ¦ 0001/0001

03 ¦ DC00 ¦ 0001/0002

В этом примере, физическая страница 0 размещена в D000 и

не отображается. Физическая страница 1 размещена в D400 и

имеет дескриптор 1, в нее отображается страница 0. Физическая страница 2

размещена в D800 и имеет дескриптор 1, в нее отображается страница I.

Физическая страница 3 размещена в DC00 и имеет дескриптор 1,

в нее отображается страница 2.

5.7 Команды Работы с окнами

Команды:

WR -- Переключает окно регистров

WC -- Переключает/устанавливает размер окна кода

WD -- Переключает/устанавливает размер окна данных

EC -- Войти/выйти из окна кода

. -- Найти местоположение текущей команды

Soft-ICE может выводить окна трех типов:

регистров, данных и кода. Любое из этих окон может быть

активизировано или деактивировано в любое время. Окна данных

и кода могут иметь переменный размер; окно регистров

фиксировано в размере. Окна всегда остаются в фиксированном

порядке. Начиная с верхней части экрана порядок следующий :

окно регистров, окно данных, затем окно кода.

WR

WR -- Переключает окно регистров

Синтаксис:

WR

Комментарии:

Команда визуализирует окно регистров, если оно в текущий момент невидимо. Если

окно регистров в текущий момент видимо, WR удаляет окно регистров.

Окно регистров отображает набор регистров 8086 и флаги процессора.

Функция, заданная по умолчанию: F2

WC

WC -- Переключает/устанавливает размер окна кода

Синтаксис:

WC [размер-окна]

размер-окна -- десятичное число между единицей и 21.

Комментарии:

Если размер-окна не указан, эта команда переключает окно кода. Если

оно не было видимо, оно станет видимым, и если оно было видимо, оно

будет удалено.

Если указан размер-окна, окно кода будет изменено или, если оно

не было видимо, оно станет видимым с определенным размером.

Обратите внимание:

Если вы хотите переместить курсор в окно кода, используйте команду EC. См.

описание команды EC для более подробной информации.

Пример:

WC 12

Если окно кода не присутствует, то создается окно кода

высотой 12 строк. Если окно кода в текущий момент - на

экране, его высота изменяется на 12 строк.

WD

WD -- Переключает/устанавливает размер окна данных

Синтаксис:

WD [размер-окна]

размер-окна -- десятичное число между единицей и 21.

Комментарии:

Если размер-окна не указан, эта команда переключает окно данных. Если

оно не было видимо, оно станет видимым и если оно было видимо, оно

будет удалено.

Если указан размер-окна, окно кода будет изменено или, если оно

не было видимо, оно станет видимым с определенным размером.

Пример:

WD 1

Если окно данных не присутствует, то создается окно

данных высотой в одну строку. Если окно данных в текущий момент - на

экране, его высота изменяется на одну строку.

EC

EC -- Войти/выйти из окна кода

Синтаксис:

EC

Комментарии:

Команда EC переключает расположение курсора между окном кода и

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

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

окно команд.

Когда курсор находится в окне кода, становятся доступными несколько опций,

которые намного упрощают отладку. Опции:

* Точки останова типа point-and-shoot

Точки останова типа point-and-shoot устанавливаются

командой BP. Если в команде BPX параметры не указаны,

в ячейку памяти, на которую указывает курсор в окне

кода, будет установлена точка останова на выполнение.

Курсор должен быть в строке, которая

содержит код (переключите окно кода в смешанный

режим, если вы не уверены). Заданная по умолчанию

функциональная клавиша для BPX - F9.

* Исполнение до строки курсора

Вы можете устанавливать временную точку останова в месте

положения курсора выполнять команду HERE. Курсор должен

находиться в строке, которая содержит код (переключите

окно кода в смешанный режим, если вы не уверены). Заданная

по умолчанию функциональная клавиша для HERE - F7.

* Прокрутка окна кода

Окно кода может быть пролистано только когда

курсор находится в окне кода. Клавиши прокрутки

(стрелка "ВВЕРХ", стрелка "ВНИЗ", PageUp и

PageDown) переопределяются, когда курсор - в

окне кода. Когда курсор находится в окне

кода, клавиши прокрутки делают следующее:

ВВЕРХ -- Прокрутка окна кода вверх на одну строку

ВНИЗ -- Прокрутка окна кода вниз на одну строку

PageUp -- Прокрутка окна кода на один экран

PageDn -- Прокрутка окна кода один экран

Обратите внимание:

Для того чтобы команда EC работала, Окно кода должно быть видимо.

Заданная по умолчанию функциональная клавиша: F6

.

. -- Найти местоположение текущей команды

Синтаксис:

.

Комментарии:

Когда окно кода видимо, команда. делает видимой текущую строку

исходного текста или текущую команду.

5.8 Команды Настройки Отладчика

Команды:

PAUSE -- Пауза после каждого экрана

ALTKEY -- Устанавливает альтернативную комбинацию клавиш для

вызова Soft-ICE

FKEY -- Отображает и редактирует назначение функциональных клавиш

BASE -- Устанавливает/отображает текущее основание системы счисления

CTRL-P -- Выводит сеанс на принтер

Print-Screen -- Печать содержимого экрана

PRN -- Устанавливает порт для вывода на принтер

PAUSE

PAUSE -- Пауза после каждого экрана

Синтаксис:

PAUSE [ON | OFF]

Комментарии:

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

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

Подсказка отображается в строке состояния в нижней части окна.

Если параметры не указаны, отображается текущее состояние PAUSE.

Значение по умолчанию - PAUSE ON.

Пример:

PAUSE ON

Эта команда указывает, что последующие команды,

отображающие информацию в окне, будут ожидать, пока вы

не нажмете клавишу, до прокрутки в окне новой информации.

ALTKEY

ALTKEY -- Устанавливает альтернативную комбинацию клавиш для вызова Soft-ICE

Синтаксис:

ALTKEY [ALTсимвол] | [CTRLсимвол] | [SYSREQ]

символ -- любой символ (A - Z)

Комментарии:

Команда ALTKEY позволяет изменять комбинацию клавиш для вызова Soft-ICE.

Комбинация клавиш изменяется на CTRL + символ, ALT + символ или клавишу SysRq.

Иногда вы можете использовать программу, которая конфликтует с комбинацией

клавиш CTRL D, вызывающей окно Soft-ICE. Один из способов обойти эту возможную

проблему - использование команды ALTKEY для изменения комбинации клавиш.

Другой способ - добавить клавишу SHIFT к текущей комбинации. Soft-ICE

не отвечает на эту комбинацию клавиш и позволяет ей вызвать вашу программу.

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

комбинацией клавиш CTRL D, попробуйте использовать комбинацию CTRL SHIFT D для

вызова вашей резидентной программы. На некоторых клавиатурах, для генерации

системного запроса вы должны одновременно нажать клавиши ALT и prtsc. Надо

действовать с осторожностью, чтобы случайно не был распечатан экран.

Если параметры не указаны, отображается текущее состояние комбинации клавиш.

Заданная по умолчанию комбинация клавиш - CTRL D.

Пример:

ALTKEY ALT Z

Эта команда указывает, что комбинация клавиш

ALT Z будет теперь использоваться для вызова

окна Soft-ICE.

FKEY

FKEY -- Отображает и редактирует назначение функциональных клавиш

Синтаксис:

FKEY [название-функциональной-клавиши строка]

название-функциональной-клавиши -- F1, F2 ... F12

строка -- Строка состоит из любых допустимых для Soft-ICE

команд и специальных символов

^ (каретка) и ; (точка с запятой). Знак ^,

помещается в строку, чтобы сделать

команду невидимой. Знак ; помещается в

строку, чтобы обозначить возврат каретки.

Комментарии:

Команда FKEY используется в командной строке для назначения функциональной

клавише строки команд. Функциональной клавише может быть назначена любая

строка команд, которая может быть напечатана в Soft-ICE.

Если параметры не указаны, отображаются текущие назначения функциональных

клавиш.

Для отмены назначения определенной функциональной клавиши, используйте команду

FKEY с параметрами: название-функциональной-клавиши с пустой строкой.

Функциональные клавиши могут также быть объявлены заранее в файле определений

S-ICE. DAT. Для подробной информации об объявления функциональных клавиш в

файле определений, обратитесь к разделу 6.4.

Использование символов возврата каретки в строке назначения функциональной

клавиши позволяет назначить функциональной клавише ряд команд. Возврат каретки

обозначается символом ; (точка с запятой).

Если Вы помещаете знак ^ (shift 6) перед определением функциональной клавиши,

последующая команда будет невидима. Команда будет функционировать как обычно,

но вся информация, отображаемая в окне команд (включая сообщения об ошибках)

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

в окне (кода, регистров или данных) но вы не хотите помех в окне команд.

Когда функциональная клавиша сделана невидимой при помощи знака ^, она может

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

Например, если вы используете заданное по умолчанию назначение для F2, вы

можете переключать окно регистров клавишей F2, даже если вы частично ввели

вашу следующую команду.

Обратите внимание:

У Soft-ICE теперь есть файл определений - S-ICE. DAT. Вы можете поместить

назначения функциональных клавиш в этот файл и функциональные клавиши будут

автоматически назначены, при загрузке Soft-ICE. Вот синтаксис для назначения

функциональных клавиш в файле конфигурации:

название-функциональной-клавиши = "строка"

При назначении функциональной клавише строки команд в S-ICE. DAT, строка

должна быть заключена в двойные кавычки.

Примеры командной строки:

FKEY F2 ^WR;

Этот пример назначит команду переключения окна

регистров клавише F2. Знак ^ делает функцию

невидимой и знак ; завершает функцию возвратом

каретки. Клавиша F2 активизирует или деактивирует

окно регистров и даже может быть вызвана при вводе

другой команды.

FKEY F1 "G CS:120; R; G CS:"

Этот пример показывает, что одной функциональной клавише может

быть назначено несколько команд и что могут быть назначены

частичные команды для их завершения пользователем.

После того, как эта команда введена, нажатие клавиши F1

вызовет выполнение программы до достижения

ячейки CS:120, вывод на экран регистров, затем начало

выполнения команды G для ее завершения пользователем.

FKEY F1 WD 3;D DS:100;

Этот пример назначит ряд команд

клавише F1. Функция видима и заканчивается

возвратом каретки. Клавиша F1 изменит высоту окна

данных на три строки и установит начало дампа в

DS:100.

Пример S-ICE. DAT:

F1 = "WR;WD 2;WC 10;"

Если эта строка помещена в S-ICE. DAT, при загрузке

Soft-ICE эта будет строка назначена клавише F1. Нажатие

F1 при работе в Soft-ICE переключит окно регистров,

создаст окно данных высотой 2 строки и окно кода

высотой 10. Для подробной информации относительно назначения

определений функциональным клавишам в S-ICE. DAT, обратитесь

к главе 6.

BASE

BASE -- Устанавливает/отображает текущее основание системы счисления

Синтаксис:

BASE [10 | 16]

Комментарии:

Команда BASE устанавливает основание системы счисления в 10 или 16. Основание

10 ограничено в использовании в узком окне из-за ограничений ширины окна.

Также ограничивается количество информации, отображаемой в некоторых командах

в режиме полной ширины экрана.

Когда текущее основание системы счисления - 10, все числа и адреса, вводимые

и отображаемые Soft-ICE десятичными. Когда основание системы -

16, все числа и адреса, вводимых в Soft-ICE являются шестнадцатеричными,

за исключением:

* Номеров строк исходного текста

* Координаты экрана и размеры в команде WIN

Эти исключения всегда вводятся и отображаются как десятичные числа.

Заданное по умолчанию основание системы счисления - 16.

Пример:

BASE 16

Этот пример устанавливает текущее основание системы счисления в 16.

CTRL-P

CTRL-P --- Выводит сеанс на принтер

Синтаксис:

CTRL-P

Комментарии:

Когда нажаты клавиши CTRL и P, вся последующая информация, отображаемая в

окне команд, также посылается на принтер. Для отмены вывода сеанса на

принтер, повторно нажмите клавиши CTRL и P.

Когда вы посылаете много информации на принтер, используя CTRL-P, вы

может пожелать отменить команду PAUSE и позволить информации пролистываться

в окне без нажатия клавиши.

Print-Screen

Print-Screen - Печать содержимого экрана

Синтаксис:

Print-Screen

Комментарии:

Нажатие клавиши print-screen производит дамп экрана на принтер. Вся

информация с экрана посылается на принтер.

Если вы хотите распечатать карту памяти или информацию помощи, обычно намного

быстрее использовать CTRL-P, чем Print-Screen. Это потому что Print-Screen

печатает все символы на экране, включая рамки.

PRN

PRN --- Устанавливает порт для вывода на принтер

Синтаксис:

PRN [LPTx | COMx]

x -- десятичное число между 1 и 4.

Комментарии:

Команда PRN позволяет вам переслать вывод от команд CTRL-P и

Print-Screen в другой порт принтера.

Если параметры не указаны, PRN отображает текущий порт, назначенный

для принтера.

Пример:

PRN COM 1

Эта команда вызывает перевод вывода от команд

CTRL-P и Print-Screen в порт COM 1.

5.9 Команды Управления Экраном

Команды:

FLASH -- Восстанавливает экран при выполнении команд P и T

FLICK -- Снижение нежелательного мерцания экрана ("снега")

WATCHV -- Включает отслеживание видеорежимов

RS -- Восстанавливает экран программы

CLS -- Очищает окно

ALTSCR -- Изменяет экран на альтернативный

WIN -- Изменяет размер окна Soft-ICE

FLASH

FLASH -- Восстанавливает экран при выполнении команд P и T

Синтаксис:

FLASH [ON | OFF]

Комментарии:

Команда FLASH позволяет вам указывать, будет ли экран восстанавливаться

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

экран должен восстанавливаться, он восстанавливается за краткий период времени

пока выполняется команда P или T. Эта возможность необходима для отладки

участков кода, осуществляющих доступ к видеопамяти.

Если команда P выполняется для обращения или прерывания, экран всегда

будет восстанавливаться, потому что вызываемая подпрограмма может записывать

на экран.

Если параметры не указаны, отображается текущее состояние FLASH.

Значение по умолчанию - FLASH OFF.

Пример:

FLASH ON

Эта команда включает режим FLASH. Экран будет

восстанавливаться в течение любых последующих команд P или T.

FLICK

FLICK -- Снижение нежелательного мерцания экрана ("снега")

Синтаксис:

FLICK [ON | OFF]

Комментарии:

Некоторые типы видеоплат требуют ожидания горизонтального или вертикального

обратного хода перед выводом символов. Если запись в видеопамять сделана

произвольно, при отображении символов появится мерцание. Если

при использовании окна Soft-ICE на вашем экране происходит мерцание, вы

должны включить FLICK.

На некоторых платах EGA при выходе из Soft-ICE цвета будут восстановлены

некорректно. Это - проблема виртуализации видео EGA. Порт 3DA является

видеопортом для двух целей. Первая - опрос старыми программами CGA 3DA для

hsync и vsync. Это позволяет им избежать "снега" при выводе на некоторых

старых платах с контроллером CGA. Вторая - сброс регистра-защелки палитры на

платах EGA. В Soft-ICE есть алгоритм, позволяющий избежать необходимости

постоянно опрашивать этот порт, которая замедлила бы старые программы,

которые предназначены для CGA. Однако возможно случайное возникновение

обстоятельств, когда этот алгоритм не сработает. Если вы используете Soft-

ICE на экране EGA и вы заметили, что цвета восстанавливаются

некорректно, включите FLICK и Soft-ICE будет опрашивать порт 3DA, разрешая

проблему.

Когда включен режим FLICK, обновление экрана будет замедлено.

Если параметр не указаны, отображается текущее состояние FLICK.

Значение по умолчанию - FLICK OFF.

Пример:

FLICK ON

Эта команда включает режим FLICK. Это заставляет

Soft-ICE ожидать горизонтального или вертикального обратного хода

перед выводом символов.

WATCHV

WATCHV -- Включает отслеживание видеорежимов

Синтаксис:

WATCHV [ON | OFF]

Комментарии:

Команда WATCHV позволяет вам указать, как Soft-ICE должен отслеживать

видеопорты. Обычно, Soft-ICE отслеживает видео порты только после выполнения

команды INT 10, которая переключает адаптер в графический видеорежим.

Некоторые программы не используют INT 10 для переключения режимов. В этих

случаях, если WATCHV выключен, у Soft-ICE могут быть проблемы с корректным

сохранением и восстановлением экрана. Включение WATCHV заставит Soft-ICE

постоянно отслеживать видео порты.

Включите WATCHV, если вы заметите, что Soft-ICE некорректно обрабатывает ваш

экран, или если некорректно восстанавливается курсор. Активизация WATCHV

может воздействовать на эффективность в некоторых видеорежимах.

Если параметры не указаны, отображается текущее состояние WATCHV.

Значение по умолчанию - WATCHV OFF.

Пример:

WATCHV ON

Эта команда включает режим WATCHV. Это заставит

Soft-ICE отслеживать дополнительные видео порты в

целях виртуализации.

RS

RS -- Восстанавливает экран программы

Синтаксис:

RS

Комментарии:

Команда RS позволяет вам временно восстанавливать экран программы.

Окно Soft-ICE исчезает, пока не будет нажата любая клавиша.

Эта возможность полезна при отладке графических программ, часто модифицирующих

экран. При вызове Soft-ICE, он возвращается в текстовый режим.

Использование команды RS временно восстанавливает графический экран.

Пример:

RS

CLS

CLS -- Очищает окно

Синтаксис:

CLS

Комментарии:

Команда CLS очищает окно Soft-ICE и перемещает подсказку и

курсор в левый верхний угол окна.

Пример:

CLS

ALTSCR

ALTSCR -- Изменяет экран на альтернативный

Синтаксис:

ALTSCR [ON | OFF]

Комментарии:

Команда ALTSCR позволяет вам переназначить вывод Soft-ICE из вашего экрана,

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

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

переключения между окном Soft-ICE и графическим экраном.

ALTSCR требует от системы двух подсоединенных мониторов. Альтернативный

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

для мониторов.

Значение по умолчанию - ALTSCR OFF.

Пример:

ALTSCR ON

Эта команда переназначает экранный вывод на альтернативный монитор.

WIN

WIN -- Изменяет размер окна Soft-ICE

Синтаксис:

WIN [N | W] [строка-начала длина [столбец-начала]]

N -- Когда задан N, окно будет

установлено в узкий режим: 46

символов.

W -- Когда задан W, окно будет

установлено в полноэкранный режим.

строка-начала -- Число от 0 до 17 указывающий строку

где начинается отображение окна.

длина -- Число от 8 до 25 указывающее, желаемую

высоту окна в строках.

столбец-начала -- Позиция столбца левой стороны

узкого окна. Строка-начала и столбец-начала

определяют левый верхний угол узкого окна.

Столбец-начала игнорируется, если применяется

к широкому окну (во весь экран).

Комментарии:

Команда WIN позволяет вам изменять ширину и высоту окна

Soft-ICE на экране.

Если параметры не указаны, эта команда переключает окно между

широким и узким режимом вывода на экран.

Если в команде WIN указан только параметр N или W,

размер окна будет изменен на запрошенную ширину при текущей высоте.

Если число строк плюс начальный номер строки больше чем 25,

окно растягивается до нижней части экрана.

Значение по умолчанию - узкий режим WIN.

Примеры:

WIN N 4 9 30

Эта команда заставляет окно выводиться со

строки 4 и столбца 30 и быть 9 строк высоты и 46

символов ширины.

WIN

Эта команда переключает ширину окна из

текущего состояния (широкое или узкое) в противоположное

состояние.

WIN W 10 8

Эта команда заставляет окно начинаться в

строке 10, быть 8 строк высоты и иметь ширину

экрана.

5.10 Команды Работы с Символами и Строками Исходного Текста

Команды:

SYM -- Вывести/установить символ

SYMLOC -- Переместить базу символа

SRC -- Переключает между исходным текстом, смешанным режимом и кодом

FILE -- Изменить/вывести текущий исходный текст

SS -- Найти строку в текущем файле с исходным текстом

SYM

SYM -- Вывести/установить символ

Синтаксис:

SYM [имя-символа [значение]]

имя-символа -- Допустимое имя символа. Имя символа

может заканчиваться знаком * (звездочкой).

Это позволяет искать, если известна только

первая часть имени символа.

Знак, (запятая) может использоваться

как знак-маска вместо

знака в имени символа.

значение -- Это - значение типа СЛОВО, которое используется если вы

хотите присвоить символу определенное значение.

Комментарии:

Команда SYM позволяет отображать и устанавливать символы. Если SYM

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

символа отображается рядом с именем символа.

Если имя символа указано без значения, то отображаются имя символа

и его значение. Если имя символа не было найдено, ничего не выводится.

Команда SYM часто полезна для нахождения имени символа, когда помните

только часть имени. Для поиска символов доступны два метода поиска по

маске. Если имя символа заканчивается знаком *, то выводятся все символы,

которые совпадают с фактическими буквами, указанными до знака *,

независимо от завершающих букв. Если знак, используется вместо

определенной буквы в имени символа, то этот знак является символом-

маской.

Если указано значение, всем символам, соответствующим имени-символа,

присваивается указанное значение. Все символы имеют значения типа СЛОВО.

Примеры:

SYM FOO*

Отображаются все символы, которые начинаются с FOO.

SYM FOO* 6000

Всем символам, которые начинаются с FOO, присваивается значение

6000.

SYMLOC

SYMLOC -- Переместить базу символа

Синтаксис:

SYMLOC адрес-сегмента

Комментарии:

Команда SYMLOC перемещает сегментные компоненты всех символов

относительно указанного адреса-сегмента. Эта функция необходима при

отладке загружаемых драйверов устройств или других программ, которые не могут

быть непосредственно загружены LDR. EXE.

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

адреса драйвера, найденного в команде MAP. При настройке для

.EXE-программы, значение должно быть на 10H больше чем найденная база в

команде MAP. При настройке для. COM-программы, используйте адрес базового

сегмента, найденного в команде MAP.

Команда MAP отобразит, по крайней мере, два входа для каждой программы.

Первый - обычно среда, а второй - обычно

сама программа. Базовый адрес программы - значение перемещения.

Пример:

SYMLOC 1244 + 10

Это переместит все сегменты в таблице идентификаторов

относительно 1244. + 10 используется, чтобы переместить TSR

бывший первоначально. EXE-файлом. Если это - .COM-файл

+ 10 не обязательно.

SRC

SRC -- Переключает между исходным текстом, смешанным режимом и кодом

Синтаксис:

SRC [?]

Комментарии:

Команда SRC переключает между режимом исходного текста, смешанным режимом и

режимом кода в окне кода.

Если введено SRC?, отображается текущее состояние.

Пример:

SRC

Эта команда изменяет текущий режим окна кода.

Если режим был режимом исходного текста, он становится смешанным.

Если режим был смешанным, он становится режимом кода. Если режим

был режимом кода, он становится режимом исходного текста.

Функциональная клавиша по умолчанию: F3

FILE

FILE -- Изменить/вывести текущий исходный текст

Синтаксис:

FILE [имя файла]

Комментарии:

Если имя файла указано, этот файл становится текущим файлом и

начало файла выводится в окне кода. Если имя не указано, выводится

имя текущего файла (если он есть) с исходным текстом.

Команда FILE часто полезна при установке точки останова в строке, которая

не ассоциирована ни с одним публичным символом. Используйте FILE, для вызова

желаемого файла в окно кода, используйте команду SS для поиска определенной

строки, переместите в нее курсор и введите BPX для установки точки останова.

Обратите внимание:

Для команды FILE доступны только файлы с исходным текстом, загруженные в

дополнительную память (XMS) программой LDR. EXE.

Пример:

FILE MAIN. C

Если MAIN. C был загружен LDR. EXE, эта

команда выводит его в окно кода, начиная со

строки 1.

SS

SS -- Найти строку в текущем файле с исходным текстом

Синтаксис:

SS [номер-строки] ['строка']

номер-строки -- десятичное число

строка -- символьная строка, заключенная в кавычки.

Кавычки могут быть как одиночными так

и двойными.

Комментарии:

Команда SS ищет в текущем файле с исходным текстом указанную

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

найдена подстрока будет выведена как верхняя строка в окне кода.

Поиск начинается с указанного номера строки. Если номер строки не

указан, поиск начинается с верхней строки, отображаемой в окне кода.

Если параметры не указаны, продолжается поиск предыдущей

указанной строки.

Обратите внимание:

Окно кода должно быть видимо и быть в режиме исходного текста до использования

команды SS.

Пример:

SS 1 'if (i = = 3)'

В текущем файле с исходным текстом ищется, начиная со строки 1,

подстрока 'if (i = = 3)'. Строка, содержащая следующее

совпадение с подстрокой, становится верхней отображаемой строкой

в окне кода.

РАЗДЕЛ III -- Поддерживаемые Возможности

ГЛАВА 6

6.1 Введение

Программный файл Soft-ICE (S-ICE. EXE) может быть загружен как загружаемый

драйвер устройства в CONFIG. SYS или как программа из командной строки DOS. Для

получения всей силы Soft-ICE, он должен быть загружен как драйвер устройства в

CONFIG. SYS. Однако, могут иметься обстоятельства, когда вы можете захотеть

запустить Soft-ICE из командной строки DOS или пакетного файла, типа:

* У вас нет расширенной памяти в вашей системе.

Soft-ICE можно загрузить как загружаемый драйвер устройства,

только если у вас есть расширенная память.

* Вы хотите занять НОЛЬ байт обычной

памяти. При загрузке как драйвер устройства,

Soft-ICE занимает приблизительно 2КБ

обычной памяти.

* Вам только иногда необходимо использовать Soft-ICE и

нет никаких других программ, использующих расширенную

память.

В некоторых случаях вам могут быть нужны некоторые возможности, требующие

загрузки Soft-ICE из CONFIG. SYS, но не нужно, чтобы Soft-ICE был постоянно

резидентным. В этом случае Soft-ICE может быть загружен из CONFIG. SYS, чтобы

зарезервировать расширенную память, и потом отключен переключателем /UN, пока

не потребуется Soft-ICE. См. часть 6.3.1 для большей информации относительно

переключателя /UN.

6.2 Загрузка из командной строки DOS

Вы НЕ можете активизировать все возможности Soft-ICE при загрузке из командной

строки DOS. Если вы будете использовать Soft-ICE как автономный отладчик,

рекомендуется загружать Soft-ICE из файла CONFIG. SYS.

Чтобы загрузить Soft-ICE из командной строки DOS, введите

S-ICE

В системах без расширенной памяти, Soft-ICE загружается в

самые высокие возможные адреса памяти. Тогда память, используемая Soft-ICE

"отрезается", становясь невидимой для программ DOS. Так как общая память,

видимая для DOS и ее программ, уменьшается после загрузки Soft-ICE,

рекомендуется загружать Soft-ICE до загрузки любых TSR-программ.

В системах с расширенной памятью вы можете загружать Soft-ICE из командной

строки DOS, только если вы не используете расширенную память для чего-либо еще

(напр. VDISK, CACHE, HIMEM...). Когда вы загружаете Soft-ICE из командной

строки или из пакетного файла, Soft-ICE предупредит вас, выдав специальное

сообщение. Это предупреждение только напоминает вам, что Soft-ICE перезапишет

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

подавить это предупреждающее сообщение при помощи опции EXTENDED в файле

конфигурации Soft-ICE. Для большей информации относительно опции EXTENDED,

см. часть 6.4.1.

6.3 Загрузка Soft-ICE как Загружаемого Драйвера Устройства

Чтобы использовать все возможности Soft-ICE, вы должны загрузить Soft-ICE как

загружаемый драйвер устройства в вашем файле CONFIG. SYS. При этом становятся

доступными следующие возможности:

* Сосуществование с другим программным обеспечением, использующим

расширенную память.

Загрузка как драйвера устройства позволяет Soft-ICE

управлять расширенной памятью, так что вы можете запускать Soft-ICE

с программами, использующими расширенную память, такими как

VDISK, CACHE и HIMEM.

* Отладка на уровне символов и исходного текста.

Загрузка как драйвера устройства позволяет Soft-ICE

разместить в расширенный памяти буфер для информации

о символах и исходном тексте.

* Диапазоны обратной трассировки и команда SNAP.

Загрузка как драйвера устройства позволяет Soft-ICE

разместить в расширенный памяти буфер для информации

обратной трассировки. Этот буфер также используется для

команды Soft-ICE, SNAP.

* Активизация возможностей Soft-ICE по EMM 4.0

* Запуск Soft-ICE с MagicCV или MagicCVW

Заметьте:

Загруженный, как драйвер устройства в CONFIG. SYS, Soft-ICE резервирует старшую

область расширенной памяти для себя и связанных с ним компонент, следовательно

не может возникнуть конфликтов памяти. S-ICE. EXE должен быть загружен в

CONFIG. SYS до любого другого драйвера, резервирующего расширенную память при

загрузке (напр. VDISK. SYS, RAMDRIVE. SYS). Вообще Soft-ICE работает наилучшим

образом, если он - первый загружаемый драйвер устройства в CONFIG. SYS.

6.3.1 Переключатели Загрузки Soft-ICE

После S-ICE. EXE в CONFIG. SYS может быть указан один или более переключателей

загрузки. Эти переключатели позволяют вам указывать, как Soft-ICE будет

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

символом / . Есть следующие переключатели загрузки:

* /EXT XXXX -- Сообщает S-ICE. EXE зарезервировать

XXXX килобайт расширенной памяти для других

программ DOS, использующих расширенную память (напр.

VDISK, CACHE, HIMEM,...). Если переключатель

/EXT не указан, то расширенная память, не используемая Soft-ICE и связанными

с ним компонентами будет оставлена, как стандартная расширенная память, но ее

количество нельзя гарантировать. Переключатель /EXT полезен, потому что

иногда трудно точно определить, сколько памяти используется Soft-ICE и

связанными с ним компонентами. Использование переключателя /EXT будет

гарантировать, что указанное количество будет доступно для других программ,

использующих расширенную память.

* /SYM XXXX -- Сообщает S-ICE. EXE зарезервировать

XXXX килобайт расширенной памяти для символов

и исходного текста. Если XXXX не указано, то

вся остающаяся расширенная память используется для

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

вашего файла. SYM и всех исходных текстов. Для большей

информации об использовании символов и исходного текста, см.

главу 7.

* /TRA XXXX -- Сообщает S-ICE. EXE зарезервировать

XXXX килобайт расширенной памяти для буфера истории

обратной трассировки. Этот буфер используется для диапазонов