Debugging Compiler/ru

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

Пошаговое руководство

edit
  1. FPC установливается в D:\Fcpupdeluxe\fpc

  2. Репозиторий FPC извлекается (той же ревизии, что и установленный FPC) в другую папку D:\fpcsrc и используется для работы с компилятором; файл .lpi открывается из этой папки.

  3. В каталоге компилятора находится несколько файлов .lpi для разных архитектур, предназначенных для использования в Lazarus IDE. Откройте тот, который соответствует вашей архитектуре. В данном руководстве используется ppcx64.lpi в Windows 10 64-bit.

  4. После сборки компилятора в папке compiler\x86_64 исходных файлов FPC (папке, из которой был открыт файл .lpi) будет создан исполняемый файл pp. Этот исполняемый файл является вашим новым скомпилированным компилятором, который можно использовать для сборки любой другой программы, модуля или проекта в процессе отладки из данного проекта Lazarus.

  5. В строке меню перейдите в Run и нажмите Run parameters ..., чтобы задать Command line parameters.

    Пример параметров командной строки может выглядеть так:

    -FuD:\Fcpupdeluxe\fpc\units\x86_64-win64\* D:\Delphi\tests\test.pas

    Пояснение параметров командной строки:

    1. -FuD:\Fcpupdeluxe\fpc\units\x86_64-win64\* <- путь к модулям, поставляемым FPC; без этого будет показана ошибка Fatal: Can't find unit system used by test и в verbose.pas будет выброшено исключение ECompilerAbort
    2. D:\Delphi\tests\test.pas <- программа или модуль, который должен быть скомпилирован
  6. Теперь можно расставлять точки останова в Lazarus, например в функции parser.compile, и отслеживать процесс компиляции с помощью функций шага с обходом (F8) или шага с заходом (F7).

  7. После добавления, например, нового встроенного средства в компилятор необходимо перекомпилировать RTL:

    1. откройте командную строку Windows
    2. перейдите в папку с исходными текстами FPC: введите D: и cd D:\fpcsrc\
    3. скомпилируйте системные модули: введите make rtl PP=D:\fpcsrc\compiler\x86_64\pp
    4. измените Command line parameters в Lazarus, чтобы использовать новые системные модули из D:\fpcsrc\rtl\units\x86_64-win64

    -FuD:\fpcsrc\rtl\units\x86_64-win64

Советы по отладке FPC

edit
  1. найдите код ошибки в папке с исходными текстами (например, с помощью rgrep в Linux или grep -r из git bash в Windows)
  2. откройте соответствующий файл и установите точку останова на вызов внутренней ошибки
  3. изучите трассировку стека, чтобы увидеть историю вызовов, приведших к этой точке
  1. найдите код ошибки/предупреждения или короткий фрагмент текста сообщения в папке compiler/msg

  2. английское сообщение находится в файле errore.msg, например:

    % The constants are out of their allowed range.

    parser_e_double_caselabel=03037_E_Duplicate case label

  3. найдите имя константы сообщения (первая часть сообщения до «=»), например:

    parser_e_double_caselabel

  4. найдите эту константу в файлах исходного кода компилятора, пример результата:

    nset.pas: Message(parser_e_double_caselabel);

    nset.pas: Message(parser_e_double_caselabel);