RPM/debuginfo: различия между версиями

Материал из ALT Linux Wiki
< RPM
Нет описания правки
Строка 45: Строка 45:
== Отключение ==
== Отключение ==


Отключать отладочную информацию настоятельно '''не рекомендуется''', но если необхоимо, чтобы отладочных данных было меньше или вообще не было можно добавлять в <tt>%optflags -g1</tt> (обычный -g включает -g2), а
Отключать отладочную информацию настоятельно '''не рекомендуется''', но если необходимо, то есть такие возможности (от менее рак более радикальным):
для отключения — -g0 (убирания -g из <tt>%optflags</tt> может быть недостаточно,
если в проекте принято добавлять свой -g). [https://lists.altlinux.org/pipermail/devel/2019-May/207855.html]


{{note|макрос <tt>%add_debuginfo_skiplist</tt> определяет (не)отделение отладочной информации от ELF-файлов (т.е. при его задействовании она ''останется'' в соответствующих файлах основного пакета)}}
# Чтобы отладочных данных было меньше или вообще не было можно добавлять в <tt>%optflags -g1</tt> (обычный -g включает -g2), а для отключения — -g0 (убирания -g из <tt>%optflags</tt> может быть недостаточно, если в проекте принято добавлять свой -g). [https://lists.altlinux.org/pipermail/devel/2019-May/207855.html]
 
#  Можно отключить ''strip'' (note: используется <tt>eu-strip</tt> из elfutils, а не <tt>strip</tt> из bintutils). См. тж. [http://lists.altlinux.org/pipermail/devel/2011-February/188023.html обсуждение] <tt>%brp_strip_debug</tt> и <tt>%brp_strip_none</tt> вместо ранее использовавшегося <tt>%set_strip_method</tt>. Пример:
Если {{pkg|*-debuginfo}} нежелательны вообще, отключение [https://lists.altlinux.org/pipermail/devel/2019-May/207852.html производится] посредством глобальной переменной <tt>__find_debuginfo_files</tt>:
#:<pre>%brp_strip_none %_bindir/*</pre>
 
#:'''NB''': Buildroot policy пост-обратотчик отладочной информации ELF объектов вызывает не только ''strip'', но и ''debugedit'' (нормализация путей к исходным файлам, вычисление .build-id — операции могущие изменить исходный ELF объект), поэтому указания <tt>%brp_strip_none</tt> может быть недостаточно.
%global __find_debuginfo_files %nil
#  Макрос <tt>%add_debuginfo_skiplist</tt> отключает пост-обратотчик отладочной информации (<tt>/usr/lib/rpm/brp.d/056-debuginfo.brp</tt>) для указанных файлов или директорий (в пути можно использовать звездочку).
 
#  Если пакеты {{pkg|*-debuginfo}} нежелательны вообще, отключение [https://lists.altlinux.org/pipermail/devel/2019-May/207852.html производится] посредством глобальной переменной <tt>__find_debuginfo_files</tt>:
См. тж. [http://lists.altlinux.org/pipermail/devel/2011-February/188023.html обсуждение] <tt>%brp_strip_debug</tt> и <tt>%brp_strip_none</tt> вместо ранее использовавшегося <tt>%set_strip_method</tt>.
#:<pre>%global __find_debuginfo_files %nil</pre>
 
%brp_strip_none %_bindir/*
<!--
Как вариант:
%define debug_package %nil
-->


== Примечания ==
== Примечания ==

Версия от 16:34, 25 ноября 2021


Цель

Поддержка автоматической генерации подпакетов с дополнительной отладочной информацией[1]. По использованию см. страницу Debuginfo.

Реализация

Доступна начиная с 4.0.4-alt100.14[2]. Обучена автоматически проставлять зависимости между подпакетами *-debuginfo.

Результаты для Sisyphus и стабильных веток, начиная с t6/p6, складываются в отдельный компонент debuginfo (RPMS.debuginfo).

Использование

При сборке пакета с помощью rpm-build >= 4.0.4-alt100.15 будут автоматически порождаться подпакеты *-debuginfo, содержащие файлы в /usr/{lib,src}/debug/. На x86_64 с ними работает gdb >= 7.2-alt1.

В секции %files следует избегать обобщений вида 

%files 
%_libdir/*

— так как на 32-битных архитектурах, где макрос %_libdir равен /usr/lib, файлы /usr/lib/debug/*.debug могут попасть в обычный пакет, о чём можно судить по ошибке вида[3] 

ldd: ERROR: /usr/src/tmp/paraview-buildroot/usr/lib/debug/usr/bin/pvserver.debug: trace failed

Диагностика

Обращайте внимание на сообщения от debuginfo.brp! Примеры: 

056-debuginfo.brp: WARNING: You have 3 stripped ELF objects. Please compile with debugging information!
056-debuginfo.brp: WARNING: An excerpt from the list of affected files follows:

— обнаружены ELF бинарники без отладочной информации (stripped), вероятно, где-то при компиляции добавилась опция -s (в CFLAGS, в install -s), выполнился strip, потерялась опция -g. 

056-debuginfo.brp: WARNING: 9 non-stripped binaries don't contain .debug sections making -debuginfo
056-debuginfo.brp: WARNING: package less relevant. An excerpt from the list of affected files follows:

— обнаружены not stripped бинарники (т.е. с секций .symtab), но без секций .debug_* (или .zdebug_*). Это не полная отладочная информация. Причины могут быть те же. 

056-debuginfo.brp: Please enable CONFIG_DEBUG_INFO=y in the kernel package!

— ядро собрано без CONFIG_DEBUG_INFO=y из-за этого модули тоже не будут содержать отладочной информации. 

056-debuginfo.brp: WARNING: debuginfo without debug sources.

— есть DWARF бинарники (*.debug файлы в дереве /usr/lib/debug), но нет соответствующих им исходников (в дереве /usr/src/debug).

Отключение

Отключать отладочную информацию настоятельно не рекомендуется, но если необходимо, то есть такие возможности (от менее рак более радикальным):

  1. Чтобы отладочных данных было меньше или вообще не было можно добавлять в %optflags -g1 (обычный -g включает -g2), а для отключения — -g0 (убирания -g из %optflags может быть недостаточно, если в проекте принято добавлять свой -g). [1]
  2. Можно отключить strip (note: используется eu-strip из elfutils, а не strip из bintutils). См. тж. обсуждение %brp_strip_debug и %brp_strip_none вместо ранее использовавшегося %set_strip_method. Пример: 
    %brp_strip_none %_bindir/*
    NB: Buildroot policy пост-обратотчик отладочной информации ELF объектов вызывает не только strip, но и debugedit (нормализация путей к исходным файлам, вычисление .build-id — операции могущие изменить исходный ELF объект), поэтому указания %brp_strip_none может быть недостаточно.
  3. Макрос %add_debuginfo_skiplist отключает пост-обратотчик отладочной информации (/usr/lib/rpm/brp.d/056-debuginfo.brp) для указанных файлов или директорий (в пути можно использовать звездочку).
  4. Если пакеты *-debuginfo нежелательны вообще, отключение производится посредством глобальной переменной __find_debuginfo_files: 
    %global __find_debuginfo_files %nil

Примечания

  1. ↑ #19707
  2. ↑ позднее доводилась, к использованию рекомендуется начиная с 4.0.4-alt100.21
  3. ↑ at@ в devel@