RPM/debuginfo

Цель

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

Реализация

Доступна начиная с 4.0.4-alt100.14. Обучена автоматически проставлять зависимости между подпакетами *-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 могут попасть в обычный пакет, о чём можно судить по ошибке вида

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]

   Для ядер Linux (kernel-image-) отключите опцию CONFIG_DEBUG_INFO=y (например, сделать её =n). Это необходимо сделать даже в случае использования способов указанных ниже — для сокращения времени сборки ядра.

2. Можно отключить strip (note: используется eu-strip из elfutils, а не strip из bintutils). См. тж. обсуждение %brp_strip_debug и %brp_strip_none вместо ранее использовавшегося %set_strip_method. Пример:

   %brp_strip_none %_bindir/*

   NB: Buildroot policy пост-обработчик отладочной информации вызывает не только strip, но и debugedit (нормализация путей к исходным файлам, вычисление .build-id — операции могущие изменить исходный ELF объект), поэтому указания %brp_strip_none может быть недостаточно.

3. Макрос %add_debuginfo_skiplist отключает пост-обработчик отладочной информации (/usr/lib/rpm/brp.d/056-debuginfo.brp) для указанных файлов или директорий (в пути можно использовать звездочку). Пример:

   %add_debuginfo_skiplist %_bindir

4. Если пакеты *-debuginfo нежелательны вообще, отключение производится посредством глобальной переменной __find_debuginfo_files:

   %global __find_debuginfo_files %nil

Отладка

Список исходных файлов определяется по время BRP утилитой debugedit с опцией -l. Она берет его из ELF секции .debug_line. (Список секций можно посмотреть readelf -S /path/to/the/binary.) Содержимое этой секции можно посмотреть readelf -wl /path/to/the/binary где список исходных файлов определяется комбинацией таблиц The Directory Table + The File Name Table (которых может быть много в одной секции).

Кроме того, имена исходных файлов есть в DWARF атрибутах AT_decl_file — хотя debugedit берёт их не оттуда, а как описано выше, может быть полезно глянуть его там (примеры как это сделать):

• dwgrep /path/to/the/binary -e 'entry @AT_decl_file' | sort -u
• dwarfdump /path/to/the/binary | grep AT_decl_file
• llvm-dwarfdump-15 --show-sources /path/to/the/binary

• В Go пакетах могут пропадать исходники из debuginfo если при сборке в GO_FLAGS передавалась опция -trimpath. Для сохранения исходников рекомендуется её удалить.

• В Rust пакетах могут пропадать исходники из debuginfo если потерялась опция -Cdebuginfo=1 из rustflags. Это может произойти если debuginfo было включено через файл .cargo, но затем при сборке использована переменная окружения RUSTFLAGS, которая отменяет секцию build.rustflags из .cargo.

Ссылки

• debuginfo