FpDebug/ru: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | # О пакете | |
| 2 | 2 | ||
| 3 | 3 | FpDebug - это [[Debugger|отладчик]], написанный языке [[Pascal|Паскаль]] для использования в Pascal. | |
| 4 | 4 | ||
| 5 | 5 | Подробнее: | |
| 6 | 6 | ||
| 7 | 7 | - FpDebug написан на Паскале | |
| 8 | 8 | - FpDebug использует формат отладочной информации [[DWARF]] | |
| 9 | 9 | - Текущая реализация является подмножеством DWARF с поддержкой DWARF версий 2 и 3. Однако «подмножество» - это просто состояние реализации. Цель состоит в том, чтобы расширить его, дабы реализовать как можно больше стандартных возможностей. | |
| 10 | 10 | - Текущая реализация охватывает подмножество, которое используется FPC | |
| 11 | 11 | - FpDebug имеет специальные реализации для работы с конкретным использованием DWARF для FPC (ошибки, отсутствующая информация, подробности реализации) | |
| 12 | 12 | ||
| 13 | 13 | ## Что подразумевается под «FpDebug» | |
| 14 | 14 | ||
| 15 | 15 | FpDebug может ссылаться на | |
| 16 | 16 | ||
| 17 | 17 | ### Пакет "FpDebug" | |
| 18 | 18 | ||
| 19 | 19 | Это движок отладчика. Это не относится к [[IDE]]. Пакет используется несколькими бэкэндами IDE: | |
| 20 | 20 | ||
| 21 | 21 | - Отладчик LLDB (с fpdebug): этот отладчик использует LLDB в качестве бэкэнда. Чтобы отображать результаты в стиле Паскаля, он использует движок «fpdebug» для отображения locals/watches. | |
| 22 | 22 | - [[GDB|Отладчик GNU]] (с fpdebug): для пошаговой отладки(stepping)/точек останова(breakpoints)/... используется GDB, а FpDebug - для списка слежения (watches). | |
| 23 | 23 | - Внутренний отладчик Dwarf FpDebug: "чистый" FpDebug. Пошаговая отладка(Stepping), Запуск(Running), Точки останова(Breakpoint), Список слежения (Watches), Локальные переменные (Locals), Стэк (Stack).... | |
| 24 | 24 | ||
| 25 | 25 | ### FpDebug как ссылка на серверную часть IDE [[LazDebuggerFp]] | |
| 26 | 26 | ||
| 27 | 27 | Фактическое имя серверной части IDE - [[LazDebuggerFp]]. Это имя пакета, который необходимо установить для использования отладчика. Однако, как видно выше, ни в каком техническом контексте (например, в заголовках в среде IDE) это не упоминается как «FpDebug ...» | |
| 28 | 28 | ||
| 29 | 29 | ### Другие проекты FpDebug | |
| 30 | 30 | ||
| 31 | 31 | Имя используется для другого проекта с той же целью. | |
| 32 | 32 | ||
| 33 | 33 | - <https://github.com/graemeg/fpdebug> | |
| 34 | 34 | - <http://sourceforge.net/projects/duby/> | |
| 35 | 35 | ||
| 36 | 36 | ## Установка в IDE | |
| 37 | 37 | ||
| 38 | 38 | Установите пакет LazDebuggerFp | |
| 39 | 39 | ||
| 40 | 40 | # Общие проблемы отладки | |
| 41 | 41 | ||
| 42 | 42 | Эти проблемы не могут быть исправлены одним отладчиком. Им тоже нужны изменения в FPC. На некоторых может также повлиять отсутствие поддержки в DWARF. | |
| 43 | 43 | ||
| 44 | 44 | Эти проблемы относятся ко всем серверным модулям отладчика. | |
| 45 | 45 | ||
| 46 | 46 | ## Свойства | |
| 47 | 47 | ||
| 48 | 48 | Свойства - одна из наиболее востребованных функций (любого) отладчика(ов). Вот почему они еще не могут быть проверены, и почему до этого пройдет еще немало времени. | |
| 49 | 49 | ||
| 50 | - | ||
| 50 | + | Прежде, чем вдаваться в подробности: для «Свойства без getter-функции» (т.е. «с прямым доступом к полю») FPC (как средство решения проблемы) в настоящее время добавляет запись для переменной с именем свойства. Это означает, что такие свойства могут отображаться. Они также могут быть записаны отладчиком (если отладчик поддерживает изменение данных), и если они записаны, это делается в обход любой процедуры Setter, поскольку отладчик не знает, есть ли даже сеттер. | |
| 51 | 51 | ||
| 52 | 52 | Есть несколько недостающих частей, позволяющих отладчику показывать (и, возможно, изменять) свойства. | |
| 53 | 53 | ||
| 54 | 54 | - Отладчику нужна поддержка для вызова функций. | |
| 55 | 55 | - FPC нужен способ добавить информацию о «свойствах» к отладочной информации. | |
| 56 | 56 | ||
| 57 | 57 | Что касается вызова функции. Это просто может отсутствовать реализация в отладчике. Это еще не было исследовано более глубоко. Может потребоваться или не потребоваться дополнительная информация в DWARF, созданном FPC. | |
| 58 | 58 | ||
| 59 | 59 | Что касается добавления «свойств» к отладочной информации: DWARF (по крайней мере версии 2 и 3 / не проверено 4 или 5) фактически не имеет возможности кодировать эту информацию. Следовательно, FPC в настоящее время также не добавляет его. | |
| 60 | 60 | ||
| 61 | 61 | В случае, если DWARF не добавит это вовремя, DWARF позволит использовать данные от производителя (afaik). До сих пор ни один отладчик не знал бы о каких-либо «частных данных fpc», поэтому в этом не было никакого смысла. В будущем такие данные могут быть согласованы между FPC и FpDebug. Но до этого еще далеко. FpDebug еще даже не выполняет вызов функций. | |
| 62 | 62 | ||
| 63 | 63 | ## Strings (vs PChar и Array of Char) | |
| 64 | 64 | ||
| 65 | 65 | Первоначально в DWARF не было концепции кодирования строк. Это было добавлено в DWARF 4 (требуется проверка), но еще не исследовано на предмет удобства использования с FPC. Также в FPC в настоящее время реализованы только DWARF 2 и 3 (с первыми шагами к версии 4). | |
| 66 | 66 | ||
| 67 | 67 | Остается только 2 способа кодирования строки в DWARF. | |
| 68 | 68 | ||
| 69 | 69 | - Как указатель на char | |
| 70 | 70 | - Как массив char | |
| 71 | 71 | ||
| 72 | 72 | Какой из них используется, зависит от версии FPC и от того, используется ли DWARF 2 или 3. | |
| 73 | 73 | ||
| 74 | 74 | Если это «указатель на char», то это делает его неотличимым от реального PChar. По этой причине все отладчики в Lazarus иногда для таких отслеживаемых выражений, как `SomeString[4]`, показывают результат «PChar: 'a'; String: 'b'». Поскольку PChar начинается с нуля, а строка - с единицы, индекс «4» может означать 4-й или 5-й символ. | |
| 75 | 75 | ||
| 76 | 76 | Недавние FPC используют «массив символов», когда они генерируются DWARF 3. В том, что у них (в настоящее время) есть различия в деталях реализации между тем, как они кодируют строки и реальный массив символов. (Например, пропуск необязательного/избыточного бита информации. В данном случае: DW_AT_byte_stride). Эти детали не имеют смысла с точки зрения любого другого отладчика, но FpDebug может их обнаружить, поскольку знает об этих деталях реализации. Конечно, это очень ненадежно, следующая версия FPC всегда может это изменить. | |
| 77 | 77 | ||
| 78 | 78 | Аналогичным образом FPC обрабатывает ShortStrings внутри как запись и кодирует их как есть. Опять же, различие заключается в деталях реализации. | |
| 79 | 79 | ||
| 80 | 80 | ## Изменение управляемых типов | |
| 81 | 81 | ||
| 82 | 82 | Это применимо к любому отладчику, который может устанавливать новые значения для списка слежения (изменяет переменную в отлаживаемом exe). | |
| 83 | 83 | ||
| 84 | 84 | Управляемые типы не могут быть изменены корректно. | |
| 85 | 85 | ||
| 86 | 86 | Для изменения управляемых типов отладчику необходимо знать: | |
| 87 | 87 | ||
| 88 | 88 | - счетчик ссылок | |
| 89 | 89 | - копирование при записи | |
| 90 | 90 | - как выделить/освободить память / или лучше как вызвать методы inc/dec_ref для каждого типа, чтобы они выполняли работу правильно | |
| 91 | 91 | ||
| 92 | 92 | Ничего из этого не доступно. | |
| 93 | 93 | ||
| 94 | 94 | Если вы присваиваете новое значение строке или динамическому массиву, то необходимо скорректировать счетчик ссылок старого и нового значения. При необходимости память должна быть выделена или освобождена. Если это сделать неправильно, это, по крайней мере, вызовет утечку памяти. Но это также может вызвать сбои или другие случайные ошибки, когда отлаженный exe продолжает работу. | |
| 95 | 95 | ||
| 96 | 96 | В массиве можно изменить один элемент. "SomeArray\[5\] := 7;". Если на массив ссылаются несколько переменных, это повлияет на их всех. То же самое произойдет, если вы выполните этот оператор в своем приложении. | |
| 97 | 97 | ||
| 98 | 98 | У строки (AnsiString) использует механизм копирование при записи (copy-on-write). Если вы сделаете "SomeString\[4\] := 'a'", тогда переменная, из которой вы получили доступ к строке, получит новую копию, и другие переменные (которые совместно используют память) не должны быть затронуты. У отладчика этой информации нет. Также у него нет доступа к счетчику ссылок и распределению/освобождению памяти (или внутренним строковым процессам). | |
| 99 | 99 | ||
| 100 | 100 | ## Вызов функции с управляемыми типами в качестве параметра или результата | |
| 101 | 101 | ||
| 102 | 102 | Предполагая, что вызов функции был реализован в целом .... | |
| 103 | 103 | ||
| 104 | 104 | По той же причине, что и в «Модификации управляемых типов», отладчик не может создавать строки или массивы для вызова функций, которые ожидают их как параметр. | |
| 105 | 105 | ||
| 106 | 106 | Значения результатов можно принять, но это вызовет утечку памяти. | |
| 107 | 107 | ||
| 108 | 108 | ## Область действия / порядок поиска переменных | |
| 109 | 109 | ||
| 110 | 110 | Существуют различные проблемы, при которых FPC не помещает достаточно информации в информацию DWARF, чтобы отладчик мог вычислить правильную область для всех переменных. В тех же случаях это может быть связано с тем, что DWARF не предлагает этого или не предлагает его в то время, когда он был реализован или последний раз обновлялся в FPC. Некоторые из них можно исправить, если FPC изменит способ кодирования информации. | |
| 111 | 111 | ||
| 112 | 112 | ### Вложенные процедуры | |
| 113 | 113 | ||
| 114 | 114 | ``` pascal | |
| 115 | 115 | var SomeVar: Integer; // глобальная переменная | |
| 116 | 116 | ||
| 117 | 117 | procedure Outer(NumText: string); | |
| 118 | 118 | var | |
| 119 | 119 | SomeVar: Integer; // локальная переменная, объявленная выше "Nested" | |
| 120 | 120 | ||
| 121 | 121 | procedure Nested; | |
| 122 | 122 | var | |
| 123 | 123 | I: Integer; | |
| 124 | 124 | begin | |
| 125 | 125 | WriteLn(OuterVarInScope); | |
| 126 | 126 | end; | |
| 127 | 127 | ||
| 128 | 128 | //var | |
| 129 | 129 | // SomeVar: Integer; // локальная переменная, объявленная ниже "Nested" | |
| 130 | 130 | begin | |
| 131 | 131 | Nested; | |
| 132 | 132 | end; | |
| 133 | 133 | ``` | |
| 134 | 134 | ||
| 135 | 135 | Локальная переменная `SomeVar` скрывает глобальную переменную с таким же именем, если вы находитесь в процедуре «Outer». Локальная переменная также видна (и скрывает глобальную), если вы находитесь в процедуре «Nested». | |
| 136 | 136 | ||
| 137 | 137 | Но если вы закомментируете локальную переменную, "объявленную выше Nested", и раскомментируете локальную переменную, "объявленную ниже Nested", то локальная переменная больше не будет в области видимости "Nested". «Nested» теперь будет видеть глобальную переменную. («Outer» по-прежнему видит локальные переменные). | |
| 138 | 138 | ||
| 139 | 139 | Информация DWARF в настоящее время только сообщает отладчику, что `SomeVar` объявлена как локальная переменная в параметре "Outer". И это «Nested» находится внутри «Outer». Но информация DWARF не включается, если `SomeVar` объявлен выше или ниже "Nested". Так что отладчик не заметит разницы. В обоих случаях отладчик будет отображать локальную переменную `SomeVar`, если она приостановлена в "Nested". | |
| 140 | 140 | ||
| 141 | 141 | ### Глобальные перменные из других модулей | |
| 142 | 142 | ||
| 143 | 143 | Информация DWARF содержит раздел для каждого модуля. Все символы модуля перечислены в правильном разделе. Однако нет информации о том, какой модуль входит в секцию "uses" какого другого модуля. И, очевидно, даже меньше, в каком порядке они используются. | |
| 144 | 144 | ||
| 145 | 145 | Если существует несколько глобальных переменных с одинаковым именем, по одной в каждом из нескольких модулей, то FPC использует порядок разделов uses (справа налево), чтобы найти переменную, которая будет видна из кода в текущем модуле. | |
| 146 | 146 | ||
| 147 | 147 | Если в модуле `FooBar` есть код, который обращается к переменной с именем `NotInFooBar` (которая не объявлена в модуле `FooBar`), то эта переменная должна быть из одного из других модулей. Если есть несколько переменных с именем `NotInFooBar` в разных модулях, то отладчик не имеет информации, какой из них именно использовал FPC. В настоящее время отладчик показывает первое найденное. (Что вроде случайно) | |
| 148 | 148 | ||
| 149 | 149 | # Проблемы FPC | |
| 150 | 150 | ||
| 151 | 151 | Это влияет на все отладчики | |
| 152 | 152 | ||
| 153 | 153 | - resourcestring | |
| 154 | 154 | ||
| 155 | 155 | В настоящее время не реализовано <https://bugs.freepascal.org/view.php?id=35571> | |
| 156 | 156 | ||
| 157 | 157 | - const Foo = unicodestring('abc') | |
| 158 | 158 | ||
| 159 | 159 | Информация об отладке не реализована <https://bugs.freepascal.org/view.php?id=35569> | |
| 160 | 160 | ||
| 161 | 161 | - type Foo = object (Dwarf 3) - Исправлено в 3.3.3 | |
| 162 | 162 | ||
| 163 | 163 | Неправильно закодирован как экземпляр класса <https://bugs.freepascal.org/view.php?id=36017>\ | |
| 164 | 164 | Отладчик не может отобразить данные. | |
| 165 | 165 | ||
| 166 | 166 | - Динамический массив при кросс-компиляции | |
| 167 | 167 | ||
| 168 | 168 | <https://bugs.freepascal.org/view.php?id=35567>\ | |
| 169 | 169 | Отладчик может неправильно вычислить длину. | |
| 170 | 170 | ||
| 171 | 171 | - Неправильный шаг для битового массива - исправлено в 3.3.3 | |
| 172 | 172 | ||
| 173 | 173 | <https://bugs.freepascal.org/view.php?id=36144>\ | |
| 174 | 174 | В настоящее время у FpDebug есть обходной путь | |
| 175 | 175 | ||
| 176 | 176 | # Положение дел | |
| 177 | 177 | ||
| 178 | 178 | FpDebug поддерживает Linux, Windows и MacO. | |
| 179 | 179 | ||
| 180 | 180 | Любые функции, касающиеся управления выполнением (пошаговое выполнение/приостановка ...), тестируются только для Linux и Windows. Поддержка этого на Mac неполная/ненадежная. | |
| 181 | 181 | ||
| 182 | 182 | > **Note:** Для Windows/Linux см. **[[Debugger Status]]** | |
| 183 | 183 | ||
| 184 | 184 | Поддержка Mac в настоящее время считается «альфа-версией» Оценка данных может использоваться на Mac через серверную часть LLDB + FpDebug | |
| 185 | 185 | ||
| 186 | 186 | Информация носит ориентировочный характер и может обновляться / подлежит дальнейшему тестированию. | |
| 187 | 187 | ||
| 188 | 188 | ## Примечания | |
| 189 | 189 | ||
| 190 | 190 | ### Пошаговый вывод | |
| 191 | 191 | ||
| 192 | 192 | «Пошаговый вывод» основан на поиске адреса вызова. Расположение которого зависит от того, есть ли у функции «стековый фрейм» (использует регистр BasePointer и (прим. перев.: представляет из себя структуры в стеке процессора)) и имеет ли уже/все еще настроенный фрейм. Обнаружение этого ограничено несколькими стандартными ситуациями. (Особенно это невозможно обнаружить в коде FPC или в оптимизированном коде). | |
| 193 | 193 | ||
| 194 | 194 | Эта функция работает в неоптимизированном коде FPC. | |
| 195 | 195 | ||
| 196 | 196 | ### Аппаратные точки наблюдения (также известные как точки останова по данным) | |
| 197 | 197 | ||
| 198 | 198 | Частично реализовано для большинства типов данных (подмножество типов, поддерживаемых оборудованием), включая условия и другие свойства. | |
| 199 | 199 | ||
| 200 | 200 | Все точки наблюдения будут иметь глобальную область действия. Наблюдение за локальной переменной будет предупреждать вас в следующий раз, когда память переменной будет перезаписана (например, если другая переменная займет память). | |
| 201 | 201 | ||
| 202 | 202 | Точки наблюдения "только запись" действуют как "чтение/запись" | |
| 203 | 203 | ||
| 204 | 204 | Точки наблюдения также срабатывают, если они перезаписываются имеющимся у них значением. | |
| 205 | 205 | ||
| 206 | 206 | Точки наблюдения не показывают диалоговое окно до/после. | |
| 207 | 207 | ||
| 208 | 208 | Точки наблюдения, которые не выровнены по адресу, кратному их размеру, могут запускаться соседними значениями. Например, Word, начинающееся с нечетного адреса, может запускаться байтом до или после него. 64-битный указатель должен быть выровнен по 8-байтовой границе или может запускаться соседями. | |
| 209 | 209 | ||
| 210 | 210 | ### Поток и стэк | |
| 211 | 211 | ||
| 212 | 212 | См. «Пошаговый вывод». Полагается на то же обнаружение кадров. | |
| 213 | 213 | ||
| 214 | 214 | ### Окно наблюдений / Локальные переменные / Осмотр | |
| 215 | 215 | ||
| 216 | 216 | Реализовано | |
| 217 | 217 | ||
| 218 | 218 | - Любые отсутствующие типы должны быть обнаружены (т.е. неизвестны какие-либо типы, которые не отображаются, если они не указаны в разделе «Проблемы fpc» | |
| 219 | 219 | - типы валют могут не отображать десятичную точку (они будут отображать значение * 1000) | |
| 220 | 220 | - Реализованы не все настройки из свойств окна наблюдений (большинство из них) | |
| 221 | 221 | - Выражения: | |
| 222 | 222 | - Отладчик принимает выражения, которые он будет вычислять. Не все операторы Паскаля реализованы. | |
| 223 | 223 | - Выражения рассчитываются без проверки диапазона | |
| 224 | 224 | - простые выражения (просто идентификатор) | |
| 225 | 225 | - Включает идентификатор значения 'self' (если в методе) и константы nil, true, false. | |
| 226 | 226 | - приведение типов | |
| 227 | 227 | - @ и ^ (address of и deref) | |
| 228 | 228 | - "^TFoo(x)"' приведение типа x как указатель на TFoo | |
| 229 | 229 | - () выражение в квадратных скобках "a*(b+c)" | |
| 230 | 230 | - \[\] индекс для массивов, указателей и pchar | |
| 231 | 231 | - Доступ участников к Foo.Bar | |
| 232 | 232 | - постоянные числа в десятичном, шестнадцатеричном формате (\$), oct (u0026), bin (%) | |
| 233 | 233 | - постоянная строка (ansistring) | |
| 234 | 234 | - \+ - * / для int и float | |
| 235 | 235 | - мод для int | |
| 236 | 236 | - \+ для строки | |
| 237 | 237 | - +- для указателя + int | |
| 238 | 238 | - div для int | |
| 239 | 239 | - = \<\> \< \> \<= \>= для int, float, string | |
| 240 | 240 | - not and or xor: для int и boolean | |
| 241 | 241 | ||
| 242 | 242 | ### Изменение переменных (не реализовано) | |
| 243 | 243 | ||
| 244 | 244 | Не сделано | |
| 245 | 245 | ||
| 246 | 246 | ### Консольный вывод | |
| 247 | 247 | ||
| 248 | 248 | В Windows консоль открывается ОС. В Linux вывод поступает в окно отладчика «Консольный вывод». | |
| 249 | 249 | ||
| 250 | 250 | ### Кросс-битовая отладка (32/64 бит) | |
| 251 | 251 | ||
| 252 | 252 | FpDebug не имеет кросс отладки между разными платформами. | |
| 253 | 253 | ||
| 254 | 254 | Однако, если ваша IDE имеет другую разрядность, ваш проект FpDebug может ее отладить. | |
| 255 | 255 | ||
| 256 | 256 | #### Windows | |
| 257 | 257 | ||
| 258 | 258 | A 64-битная IDE | |
| 259 | 259 | может отлаживать как 64-битные, так и 32-битные приложения | |
| 260 | 260 | ||
| 261 | 261 | A 32-битная IDE | |
| 262 | 262 | может отлаживать только 32-битные приложения | |
| 263 | 263 | ||
| 264 | 264 | #### Linux | |
| 265 | 265 | ||
| 266 | 266 | Перекрестная отладка еще не тестировалась, но, вероятно, возможна. | |
| 267 | 267 | ||
| 268 | 268 | # Еще не реализовано | |
| 269 | 269 | ||
| 270 | 270 | - Изменение окна отладки | |
| 271 | 271 | - Изменение места выполнения (во время паузы) / возобновление выполнения с другой строки | |
| 272 | 272 | - Свойства | |
| 273 | 273 | - Вызов функций | |
| 274 | 274 | - ... | |
| 275 | 275 | ||
| 276 | 276 | --- | |
| 277 | 277 | *From the Free Pascal wiki, page "FpDebug/ru", as it stood on 2021-08-17 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |