Эта страница посвящена отладке компилятора FPC и содержит руководство и советы, которые могут оказаться полезными.
Пошаговое руководство
edit-
FPC установливается в
D:\Fcpupdeluxe\fpc -
Репозиторий FPC извлекается (той же ревизии, что и установленный FPC) в другую папку
D:\fpcsrcи используется для работы с компилятором; файл .lpi открывается из этой папки. -
В каталоге компилятора находится несколько файлов .lpi для разных архитектур, предназначенных для использования в Lazarus IDE. Откройте тот, который соответствует вашей архитектуре. В данном руководстве используется
ppcx64.lpiв Windows 10 64-bit. -
После сборки компилятора в папке
compiler\x86_64исходных файлов FPC (папке, из которой был открыт файл .lpi) будет создан исполняемый файл pp. Этот исполняемый файл является вашим новым скомпилированным компилятором, который можно использовать для сборки любой другой программы, модуля или проекта в процессе отладки из данного проекта Lazarus. -
В строке меню перейдите в Run и нажмите Run parameters ..., чтобы задать Command line parameters.
Пример параметров командной строки может выглядеть так:
-FuD:\Fcpupdeluxe\fpc\units\x86_64-win64\* D:\Delphi\tests\test.pasПояснение параметров командной строки:
-FuD:\Fcpupdeluxe\fpc\units\x86_64-win64\*<- путь к модулям, поставляемым FPC; без этого будет показана ошибка Fatal: Can't find unit system used by test и в verbose.pas будет выброшено исключение ECompilerAbortD:\Delphi\tests\test.pas<- программа или модуль, который должен быть скомпилирован
-
Теперь можно расставлять точки останова в Lazarus, например в функции
parser.compile, и отслеживать процесс компиляции с помощью функций шага с обходом (F8) или шага с заходом (F7). -
После добавления, например, нового встроенного средства в компилятор необходимо перекомпилировать RTL:
- откройте командную строку Windows
- перейдите в папку с исходными текстами FPC: введите
D:иcd D:\fpcsrc\ - скомпилируйте системные модули: введите
make rtl PP=D:\fpcsrc\compiler\x86_64\pp - измените Command line parameters в Lazarus, чтобы использовать новые системные модули из D:\fpcsrc\rtl\units\x86_64-win64
-FuD:\fpcsrc\rtl\units\x86_64-win64
- Примечания:
- Установка FPC в
D:\Fcpupdeluxe\fpcнеобходима для начальной загрузки исполняемого файла компилятора - Системные модули из
D:\Fcpupdeluxe\fpcможно использовать до тех пор, пока в компиляторе не вносятся изменения, затрагивающие эти модули; в противном случае системные модули тоже необходимо перекомпилировать (см. шаги выше) - При изменении любого из файлов исходного кода компилятора исполняемый файл pp будет перезаписан с учётом внесённых изменений
- Скомпилированный исполняемый файл pp при необходимости также можно использовать для перекомпиляции RTL (или пакетов), например:
make rtl PP=compiler\x86_64\pp
- Установка FPC в
Советы по отладке FPC
edit- Для отображения внутренних представлений в командной строке можно задать параметры подробности вывода (как в gcc), например:
- -vp: записывать tree.log с деревом разбора
- -vv: записывать fpcdebug.txt с подробной отладочной информацией
- Установите точку останова на функцию
parser.compileв Lazarus, так как она является точкой входа для разбора.
- Ещё одна полезная процедура для установки точки останова —
GenerateErrorв verbose.pas. Она вызывается при любой ошибке компиляции (синтаксической ошибке, ошибке типа, ошибке чтения ассемблера, внутренней ошибке и т.д.).
- Шаги для исследования кодов внутренних ошибок:
- найдите код ошибки в папке с исходными текстами (например, с помощью rgrep в Linux или grep -r из git bash в Windows)
- откройте соответствующий файл и установите точку останова на вызов внутренней ошибки
- изучите трассировку стека, чтобы увидеть историю вызовов, приведших к этой точке
- Анализ кода, приводящего к ошибке или предупреждению:
-
найдите код ошибки/предупреждения или короткий фрагмент текста сообщения в папке compiler/msg
-
английское сообщение находится в файле errore.msg, например:
% The constants are out of their allowed range.parser_e_double_caselabel=03037_E_Duplicate case label -
найдите имя константы сообщения (первая часть сообщения до «=»), например:
parser_e_double_caselabel -
найдите эту константу в файлах исходного кода компилятора, пример результата:
nset.pas: Message(parser_e_double_caselabel);nset.pas: Message(parser_e_double_caselabel);
- Подпрограмма
printnode(<node>)позволяет вывести узел и всех его потомков; это часто бывает полезным при изучении деревьев узлов в определённых местах.
- Если генерируемый код совершенно не соответствует ожидаемому, хорошей отправной точкой является компиляция с -al -sr: это генерирует файл ассемблера до распределения регистров. Если он выглядит корректно, значит проблема находится в коде распределителя регистров или коде вытеснения.
- Функцию вывода узлов в формате XML можно включить с помощью
-dDEBUG_NODE_XMLпри компиляции компилятора; при этом для каждого компилируемого модуля, программы или библиотеки создаётся файл <NAME>-node-dump.xml, содержащий XML-описание узлов, обрабатываемых в процессе компиляции.