Преобразование оригинального текста в DocBook: Юрий Зотов
Времена, когда тэг BuildRoot в spec-файле определял, какой каталогRPM будет использовать в качестве BuildRoot, прошли безвозвратно. Теперь этот тэг не несёт никакой информации и может (и должен) быть опущен. Вместо этого используется значение макроса %buildroot, который определён как %{_tmppath}/%{name}-buildroot в файле /usr/lib/rpm/macros и может быть переопределён в любом месте, где допускается определять макросы. В случае, если макрос %buildroot не определён либо его значение представляет собой недопустимое значение /, сборка пакета не будет выполнена.
домашний каталог пользователя, вызывающего этот макрос;
домашний каталог пользователя user;
manpages: %_man1dir, %_man2dir, %_man3dir, %_man4dir, %_man5dir, %_man6dir, %_man7dir, %_man8dir, %_man9dir;
X11R6: %_x11dir, %_x11bindir, %_x11libdir, %_x11includedir, %_x11mandir, %_x11datadir, %_x11fontsdir;
лицензии: %_licensedir;
меню: %_menudir, %_iconsdir, %_miconsdir, %_liconsdir;
service: %_initdir;
control: %_controldir;
emacs: %_emacslispdir;
pam: %_pam_modules_dir;
tcl: %_tcllibdir, %_tcldatadir;
kernel: %patches_dir, %kernel_srcdir;
ruby: %ruby_archdir, %ruby_libdir, %ruby_sitearchdir, %ruby_sitelibdir;
другие системные: %_cachedir, %_lockdir, %_logdir, %_spooldir.
добавить указанные параметры в стандартный набор %optflags;
убрать указанные параметры из стандартного набора %optflags;
базовые параметры;
уровень оптимизации;
параметры, отвечающие за оптимизацию, кроме архитектурно-зависимых;
warning options;
debugging options;
параметры, применяемые для создания relocatable файлов;
параметры, отключающие поддержку C++ exceptions и C++ RTTI;
-fomit-frame-pointer;
-ffast-math;
-fstrict-aliasing;
параметры, используемые при компиляции ядра и его модулей.
По умолчанию, стандартный набор %optflags состоит из %optflags_core %optflags_warnings %optflags_optimization.
выбор версии GCC из множества установленных в системе.
По умолчанию используется /usr/bin/i586-alt-linux-gcc.
выбор версии autoconf из множества установленных в системе;
выбор версии automake из множества установленных в системе;
выбор версии libtool из множества установленных в системе.
По умолчанию используется версия default.
число процессоров, доступных для сборки с помощью %make_build;
вызов make с параметром, обеспечивающим оптимальную параллельную сборку в данной среде;
вызов make c инициализацией переменной INSTALL, что в случае корректной реализации Makefile-ов пакета позволяет сохранить дату последней модификации файлов, что особенно важно для документации;
%make_install инициализация других переменных, используемых многими Makefile-ами install
регистрация новых/обновлённых библиотек;
регистрация новых/обновлённых системных библиотек (которые могут быть использованы в chroot'ах);
отмена регистрации удалённых библиотек.
регистрация новых/обновлённых info-страниц;
отмена регистрации удалённых info-страниц.
регистрация новых/обновлённых меню;
отмена регистрации удалённых меню.
регистрация новых/обновлённых описаний оконных менеджеров;
отмена регистрации удалённых описаний оконных менеджеров.
регистрация новых/обновлённых каталогов;
отмена регистрации удалённых каталогов.
путь к скрипту libtoolize;
путь к скрипту configure;
целевая платформа для configure;
--without-included-gettext.
регистрация нового сервиса при установке, перезапуск при обновлении;
отмена регистрации сервиса и его выключение при удалении.
значение BuildRoot;
атрибуты файлов и каталогов по умолчанию для каждой секции %files и для каждого файла, включаемого в таких секциях;
метод, используемый при удалении ненужных файлов в секции %install;
метод, используемый при сжатии документации в секции %install;
метод, используемый по умолчанию при поиске предоставляемых зависимостей;
метод, используемый по умолчанию при поиске требуемых зависимостей;
метод, используемый при исправлении файлов в секции %install;
метод, используемый при проверке ELF-файлов в секции %install;
метод, используемый при обработке ELF-файлов в секции %install;
метод, используемый при поиске зависимостей в perl-скриптах;
список каталогов, в которых производится поиск {\it ELF}-файлов на наличие предоставляемых зависимостей;
точка начала поиска файлов, обрабатываемых соответствующим методом;
список шаблонов файлов, которые будут пропущены при обработке соответствующим методом;
параметр, определяющий влияние неупакованных файлов на результат сборки;
изменить значение соответствующего макроса;
изменить значение соответствующего макроса;
добавить значение в соответствующий список;
добавить значение в список / изменить список каталогов, в которых производится поиск ELF-файлов на наличие предоставляемых зависимостей;
определяет, подлежат ли автоматическому удалению ненужные вспомогательные файлы libtool'а.
вызов /usr/lib/rpm/find-lang
вызов /usr/lib/rpm/brp-strip для обработки ELF executables;
вызов /usr/lib/rpm/brp-strip для обработки ELF relocatables;
вызов /usr/lib/rpm/brp-strip для обработки ELF shared objects;
вызов /usr/lib/rpm/brp-strip для обработки ELF ar archives;
вызов /usr/lib/rpm/brp-cleanup;
вызов /usr/lib/rpm/brp-compress;
вызов /usr/lib/rpm/brp-strip;
выполнение rm -rf %buildroot, если %buildroot не указывает на настоящий /.
управляет включённым по умолчанию для rpmbuild --rebuild и rpmbuild --recompile режимом удаления промежуточных файлов и каталогов.
управляет выключенным по умолчанию для rpmbuild --rebuild и rpmbuild --recompile режимом создания пакетов с исходным кодом.
альтернативная директива %build для случая, когда в секции %build происходит заполнение %buildroot. Вообще говоря, такой техники стоит избегать во всех случаях, когда это возможно;
управляет включённым по умолчанию режимом оптимизации зависимостей;
значение переменных LANG, LANGUAGE и LC_ALL;
значение переменной DISPLAY;
значение переменной XAUTHORITY;
значение переменной CCACHE_CC;
значение переменной CCACHE_DIR;
glibc: %__glibc_version, %__glibc_version_major, %__glibc_version_minor;
gcc: %__gcc_version, %__gcc_version_major, %__gcc_version_minor, %__gcc_version_base
python: %__python_version
версия указанного пакета;
релиз указанного пакета;
serial указанного пакета;
serial указанного пакета в виде, пригодном для включения в spec-файл;
тройка значений serial:version-release указанного пакета;
четвёрка значений name-serial:version-release указанного пакета;
строка вида name >= serial:version-release, построенная по указанному пакету;
Эти макросы, как правило, используются в пакетах, сборка которых возможна с различными версиями этих программ, если эти версии правильно учитывать.
установка значения макросов условия с указанием значения по умолчанию;
проверка макросов условия на непротиворечивость;
подстановка значения макросов условия;
проверка на существование макроса;
проверка значения макросов условия;
ветвление по факту существования макроса;
ветвление по значению макросов условия;
новый режим работы RPM, при котором происходит только подстановка макросов;
новый режим работы RPM, при котором происходит только вывод списка использованных макросов;
не блокировать процесс, если база данных RPM занята;
отображать дополнительную информацию о процентах проделанной работы при установке/обновлении пакетов;
не включать указанные патчи в исходный пакет;
не включать указанные исходники в исходный пакет;
вывести информацию о последнем изменении пакета;
вывести информацию обо всех изменениях пакета, начиная с указанной версии.
По окончании выполнения секции %install RPM выполняет ряд действий:
удаление ненужных файлов и каталогов;
исправление прав доступа к файлам и каталогам;
упаковка документации;
удаление отладочной информации;
коррекция символических ссылок на разделяемые библиотеки;
перекомпиляция python-модулей.
Все файлы и каталоги, подпадающие под правило определения ненужных файлов и каталогов, удаляются. В частности, по умолчанию подлежат удалению
файлы с именами DEADJOE, .SUMS, TAGS, core;
файлы, заканчивающиеся на ~, .orig, .rej, .bak;
каталоги с именем CVS.
Поддерживаются следующие методы определения файлов и каталогов, подлежащих удалению:
поиска и удаления не производится;
метод по умолчанию, определенный в файле /usr/lib/rpm/brp-cleanup;
специальный метод; переданное значение используется в качестве имени программы, которая будет вызвана для поиска и удаления ненужных файлов.
Какой метод будет использован в каждом конкретном случае, зависит от значения макроса %_cleanup_method; значение по умолчанию для этого макроса — auto.
Поддерживаются следующие типы файлов, подлежащих проверке и исправлению:
поиска и проверки не производится;
поиск и обработка shell-скриптов по шаблону /usr/bin/*-config;
поиск и обработка файлов по шаблону /usr/lib/pkgconfig/*.pc;
поиск и обработка .la-файлов;
Какой метод будет использован в каждом конкретном случае, зависит от значения макроса %_fixup_method; значение по умолчанию для этого макроса — binconfig pkgconfig libtool.
Права доступа ко всем файловым объектам, находящимся в $RPM_BUILD_ROOT, проверяются и корректируются согласно следующим правилам:
каталоги /usr/share, /usr/include, /usr/X11R6/share, /usr/X11R6/include, /usr/X11R6/man со всем содержимым должны быть доступны по чтению всем пользователям;
ничто из содержимого каталога /usr, за исключением /usr/src, не должно быть доступно по записи не-владельцу, за исключением владельца файлов.
никакие suid и/или sgid-файлы не должны быть доступны по чтению (и тем более по записи), за исключением владельца файлов.
Вся документация пакета, распознаваемая как man- или info-документация, по окончании работы секции %install, сжимается согласно выбранному методу. Поддерживаются следующие методы сжатия:
сжатие с помощью bzip2 -9;
сжатие с помощью gzip -9n;
сжатие с помощью gzip -9n либо bzip2 -9 в зависимости от того, какой вариант окажется эффективнее;
производится декомпрессия файлов вместо сжатия;
процедура сжатия пропускается полностью.
Какой метод будет использован в каждом конкретном случае, зависит от значения макроса %_compress_method; значение по умолчанию для этого макроса — auto. По окончании процедуры сжатия производится выравнивание ссылок, которые, возможно, требуют коррекции в связи с изменениями имён файлов в процессе их сжатия.
Иногда в результате сборки пакета получаются ELF-файлы, содержащие неверную и/или недопустимую информацию в некоторых секциях, таких как RPATH. Поэтому по окончании работы секции %install проверяются все собранные ELF-файлы. Выбор типов файлов определяется значением макроса %_verify_elf_method, которое есть набор из следующих возможных значений:
поиска и проверки не производится;
проверка RPATH только на наличие недопустимых элементов в RPATH;
relaxed + проверка на наличие более чем одного элемента в RPATH;
проверка на наличие непустого RPATH.
предупреждение о наличии записей типа TEXTREL;
проверка на наличие записей типа TEXTREL.
Значение по умолчанию для макроса %_verify_elf_method в данный момент равно normal, что эквивалентно rpath=normal,textrel=normal.
Зачастую возможно уменьшить размер получаемых в результате сборки пакета ELF-файлов без потери качества за счёт удаления из них отладочной информации. Поэтому по окончании работы секции %install все ELF-файлы выбранных типов обрабатываются программой strip. Выбор типов файлов определяется значением макроса %_strip_method, которое есть набор из следующих возможных значений:
ELF executable;
ELF relocatable;
ELF shared object;
ar archive.
Кроме того, есть возможность вызывать strip вручную, для этой цели предназначены макросы %strip_executable, %strip_relocatable, %strip_shared, %strip_static. Синтаксис этих макросов подробно изложен в /usr/lib/rpm/brp-strip --help.
Как известно, python-модули обычно компилируют в байтовую форму для увеличения быстродействия при последующей работе с ними. Каждый такой модуль, помимо всего прочего, хранит время своего создания и полное имя файла, в котором должен находиться. В связи с последним обстоятельством скомпилированные модули, созданные в результате работы секции %install, непригодны, ибо не могут быть использованы после установки пакета. По этой причине теперь по окончании работы секции %install производится перекомпиляция всех python-модулей таким образом, чтобы их можно было использовать после установки пакета. В качестве байт-компилятора будет использоваться программа, имя которой хранится в макросе %__python. Обычно это /usr/bin/python, однако в некоторых случаях может потребоваться изменить это значение на другое (например, в случае сборки пакета python или если по какой-то причине перекомпиляция не нужна).
В дополнение к стандартному поиску зависимостей от/для разделяемых библиотек, реализована поддержка поиска требуемых зависимостей для shell- и perl-скриптов, поиска зависимостей, определяемых наличием специальных файлов в пакете, а также поддержка поиска предоставляемых зависимостей для perl-скриптов.
Новые возможности RPM по автоматическому поиску зависимостей при сборке пакетов управляются, как и прежде, значениями тэгов AutoReq, AutoProv и AutoReqProv. К стандартным значениям yes/no (true/false), таким образом, добавлены новые возможные значения, являющиеся именами методов поиска зависимостей:
включение/выключение поиска зависимостей от/для разделяемых библиотек;
включение/выключение поиска зависимостей в shell-скриптах;
включение/выключение поиска зависимостей в perl-скриптах;
включение/выключение поиска зависимостей, определяемых наличием специальных файлов в пакете;
то же, что и yes;
то же, что и no;
включение всех возможных методов поиска зависимостей.
Значением тэга может являться как один метод, так и перечисление методов. По умолчанию, для каждого подпакета собираемого пакета AutoReq = AutoProv = yes, что на практике означает использование макросов %_findreq_default_method и %_findprov_default_method для определения методов поиска зависимостей.
Перед выполнением секции %install и по окончании выполнения секции %clean RPM автоматически очищает BuildRoot с помощью макроса %clean_buildroot. Это значит, что больше не нужно использовать эти ужасные rm -rf $RPM_BUILD_ROOT. Секция %clean вообще может (и должна) быть опущена, если в ней не содержится ничего, кроме этого «rm». В тех редких случаях, когда в spec-файле производится заполнение BuildRoot не в секции %install, как это должно быть, а в секции %build, что в принципе неправильно, можно перенести точку очистки BuildRoot из начала секции %install в начало секции %build, если заменить директиву %build на макрос %buildmulti.
Ранее в начале каждой секции %files было необходимо указывать атрибуты файлов и каталогов создаваемых пакетов с помощью довольно однообразно используемой директивы %defattr. Теперь это происходит автоматически в начале каждой секции %files, а также в начале каждого файла, включаемого в секцию %files с помощью опции -f. Точнее говоря, в качестве этой директивы используется значение макроса %_defattr. Таким образом, прежнее использование директивы %defattr в начале секций и файлов следует считать упразднённым.
То, что когда-то было необходимостью, со временем стало излишним, а порой и просто опасным. Теперь, когда все без исключения пакеты можно (и нужно) собирать непривилегированным пользователем во избежание риска разрушения системы и некорректной сборки, сборка пакетов привилегированным пользователем по умолчанию запрещена. Этот запрет можно снять путём изменения значения макроса %_allow_root_build.
[wwwrpm] Официальный web-сайт rpm: http://www.rpm.org/ .
[mailrpm] Список рассылки для разработчиков rpm: rpm-list{@}redhat.com .
[maxrpm] February 17, 1997. Maximum RPM, (доступна также online-версия по адресу http://www.rpm.org/max-rpm/ и в формате PostScript по адресу http://www.rpm.org/local/maximum-rpm.ps.gz).