Листер перекрестных ссылок

Листер перекрестных ссылок - средство отладки. Эта утилита принимает в качестве входа скомпонованные объектные файлы и производит листинг перекрестных ссылок на выходе. Эта распечатка показывает символы, их определения и ссылки на них в скомпонованных объектных файлах.

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

Чтобы использовать утилиту перекрестной ссылки, файл должен быть собран с правильными параметрами и затем скомпонован в исполняемый файл. Транслируйте файлы ассемблера с -x опцией. Эта опция создает распечатку перекрестной ссылки и прибавляет информацию перекрестной ссылки к объектному файлу. По умолчанию ассемблер делает перекрестные ссылки только для глобальных символов, но если используется -s опция при вызове ассемблера, то также добавляются локальные символы. Скомпонуйте объектные файлы, чтобы получить выполняемый объектный файл.

· Листинг перекрестных ссылок

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

Чтобы вызвать листер перекрестных ссылок, введите следующее:

xref2000 [опции] [имя входного файла [имя файла вывода]]

x ref2000 - команда, которая вызывает листер перекрестных ссылок.

Опции идентифицируют параметры листера перекрестных ссылок, которые Вы хотите использовать. Параметры не чувствительны к регистру и могут появляться где-либо в командной строке после команды. Предшествуйте каждую опцию дефисом (-). Эти опции следующие:

· -l (нижний регистр L) определяет число строк в странице выходного файла. Формат -l опции: -l число, где число - десятичная константа. Например, -l30 устанавливает число строк в странице выходного файла = 30. Пробел между опцией и константой - необязательный. Значение по умолчанию 60 строк.

· -q подавляет заголовок и всю информацию по работе (тихий запуск).

Имя входного файла – скомпонованный объектный файл. Если Вы опускаете входное имя файла, утилита его запрашивает.

Имя файла вывода – имя файла листинга перекрестных ссылок. Если Вы опускаете имя файла вывода, заданное по умолчанию имя файла - имя входного файла с расширением.xrf.

Пример. Листинг перекрестных ссылок ассемблера. Листер для каждого объявленного символа формирует описание ссылок. Листинг содержит:

· Symbol – имя символа.

· Filename - имя файла, где встречается символ.

· RTYP – тип символа
STAT – определен в файле, не объявлен глобальным;
EDEF – определен в файле, объявлен глобальным;
EREF – не определен в файле, но ссылка глобальная;
UNDF – не определен в файле, не объявлен глобальным;

· AsmVal – шестнадцатиричное значение символа в ассемблировании.

· LnkVal - шестнадцатиричное значение символа после установления ссылки.

· DefLn – Номер оператора, где обнаружен символ.