.TH "EBUILD" "1" "Dec 2012" "Portage VERSION" "Portage"
.SH "НАЗВАНИЕ"
ebuild \- низкоуровневый интерфейс системы портежей
.SH "СИНТАКСИС"
.B ebuild
.I файл команда [команда]\fR...
.SH "ОПИСАНИЕ"
Программа ebuild представляет собой прямой интерфейс системы Portage.
Она обеспечивает возможность непосредственного взаимодействия со
сценарием ebuild при помощи специальных подкоманд или групп команд,
выполняемых в контексте данного файла, и функций. Утилита ebuild
принимает в качестве аргументов ebuild-сценарий и одну или более
команд, подвергает сценарий синтаксическому анализу и выполняет
указанные команды. Имеются отдельные команды для загрузки исходных
файлов, их распаковки, компиляции, установки объектных файлов
во временный каталог image, установки образа в локальную файловую
систему, создания архива пакета из образа и т.д.
.SH "ФАЙЛ"
Должен быть рабочим ebuild-сценарием. Подробнее смотри в руководстве
по \fBebuild\fR(5).
.SH "КОМАНДЫ"
По умолчанию portage выполняет все функции по порядку вплоть до
указанной. Наприме, если вы дадите команду \fBcompile\fR, то
вызовете тем самым и предшествующие ей функции (такие как
\fBsetup\fR и \fBunpack\fR). Если вы хотите, чтобы запускалась
только одна команда, вам следует добавить опцию \fInoauto\fR в
значение переменной окружения \fBFEATURES\fR. Подробнее смотри
в справке по \fBmake.conf\fR(5).

.TP
.BR help
Выводит справочную информацию о программе в сжатом изложении,
а также целый ряд сведений о пакете.
.TP
.BR setup
Запускает все действия по настройке данного пакета, в том числе
специфические системные тесты.
.TP
.BR clean
Очищает временный каталог сборки, созданный Portage специально для
этого файла ebuild. Временный каталог сборки обычно содержит
извлеченный из архива исходный код, а также, возможно, так называемый
установочный образ (все файлы, которые будут установлены в локальную
файловую систему или сохранены в пакете). Расположение каталога
сборки определяется значением переменной PORTAGE_TMPDIR. Чтобы узнать
ее текущее значение, выполните \fIemerge \-\-info\fR. О том, как
переопределить эту переменную, смотри \fBmake.conf\fR(5).

Примечание: Portage удаляет практически все данные, оставшиеся после
успешной установки пакета, за исключением тех случаев, когда в
переменной FEATURES явно указано 'noclean'. Если вы добавите noclean
в значение FEATURES, очень скоро большой объем дискового пространства
будет занят ненужными файлами. Не рекомендуется пользоваться этим
режимом постоянно, а лишь в том случае, если исходники пакетов
потребуются вам после установки. Впрочем, возможно и ручное удаление
этих файлов: для этого следует выполнить \fIrm \-rf /var/tmp/portage\fR.
.TP
.BR fetch
Проверяет, все ли источники данных, фигурирующие в SRC_URI, доступны
в каталоге DISTDIR (подробнее см. в \fBmake.conf\fR(5)) и имеют
верную контрольную сумму md5. Если исходные коды недоступны, будет
предпринята попытка загрузить их с серверов, адреса которых указаны
в SRC_URI. Если для того или иного файла имеется несколько адресов
загрузки, Portage проверит каждый из них и выберет тот сервер,
который ближе. (Точность этого выбора на данный момент не
гарантируется.) В первую очередь всегда обрабатываются зеркала Gentoo
Linux, содержащиеся в переменной GENTOO_MIRRORS. Если по какой-либо
причине md5\-дайджест текущих или только что загруженных исходных
кодов не совпадает с дайджестом в files/digest\-[пакет]\-[версия\-ревизия],
выводится предупреждение, и ebuild завершает работу с кодом ошибки 1.
.TP
.BR digest
В настоящее время \- эквивалент команды \fImanifest\fR.
.TP
.BR manifest
Обновляет Manifest\-файл пакета. В результате создаются контрольные суммы
для всех файлов, обнаруженных в одном каталоге с обрабатываемым файлом
ebuild, а также содержимое вложенных каталогов подкаталога files.
При этом контрольные суммы генерируются и для всех файлов, перечисленных
в SRC_URI для каждого файла ebuild. Подробнее о поведении данной команды,
см. в разделе о смысле значения \fIassume\-digests\fR переменной
\fBFEATURES\fR справочного руководства по \fBmake.conf\fR(5). Если вы
не хотите, чтобы дайджесты принимались неявно, см. опцию \fB\-\-force\fR.
.TP
.BR unpack
Извлекает исходные коды в подкаталог \fIкаталога сборки\fR (BUILD_PREFIX),
вызывая функцию \fIsrc_unpack()\fR внутри файла ebuild. Если функция
src_unpack() не определена, для распаковки всех файлов, перечисленных в
SRC_URI, будет использована стандартная src_unpack(). Как правило,
исходники распаковываются в каталог ${BUILD_PREFIX}/[пакет]\-[версия-ревизия]/work.
Обращаться к нему можно с помощью переменной ${WORKDIR}.

Создавая файл ebuild самостоятельно, убедитесь, что переменная S
(каталог исходных файлов), определенная в начале ebuild-сценария, указывает
на каталог, в котором действительно содержатся распакованные исходные коды.
По умолчанию он определяется как ${WORKDIR}/${P}, поэтому, как правило,
ничего не требуется исправлять. Функция src_unpack() также отвечает за
наложение патчей перед компиляцией пакетов.
.TP
.BR prepare
Подготавливает извлеченные из архива исходные коды, вызывая функцию
\fIsrc_prepare()\fR, определенную в ebuild-файле. При запуске src_prepare()
текущим рабочим каталогом становится ${S}. Данная функция поддерживается,
начиная с \fBEAPI 2\fR.
.TP
.BR configure
Производит конфигурирование распакованных исходных кодов, вызывая функцию
\fIsrc_configure()\fR, определенную в ebuild-файле. При запуске src_configure()
текущим рабочим каталогом становится ${S}. Данная функция поддерживается
начиная с \fBEAPI 2\fR.
.TP
.BR compile
Компилирует распакованные исходные коды, вызывая функцию \fIsrc_compile()\fR,
определенную в ebuild-файле. При запуске src_compile() текущим рабочим
каталогом становится ${S}. По завершении работы src_compile() исходные
коды должны быть полностью скомпилированы.
.TP
.BR test
Выполняет специальные тесты для отдельных пакетов, проверяя сборку.
.TP
.BR preinst
Выполняет специальные действия для отдельных пакетов, которые
требуется произвести до установки пакета в текущую файловую систему.
.TP
.BR install
Устанавливает пакет во временный \fIкаталог установки\fR, вызывая
функцию \fIsrc_install()\fR. По завершении каталог установки в
(${BUILD_PREFIX}/[пакет]\-[версия\-ревизия]/image) будет содержать
все файлы, которые должны быть либо установлены в текущую файловую
систему, либо включены в бинарный пакет.
.TP
.BR postinst
Выполняет специальные действия для отдельных пакетов, которые
требуется произвести после установки пакета в текущую файловую
систему. Как правило, при этом выводятся полезные сообщения.
.TP
.BR qmerge
Эта функция устанавливает все файлы в \fIкаталоге установки\fR на
текущую файловую систему. Это производится следующим образом:
сначала запускается функция \fIpkg_preinst()\fR (если она существует).
Затем все файлы устанавливаются в файловую систему, а их дайджесты
контрольной суммы md5 записываются в
\fI/var/db/pkg/${CATEGORY}/${PN}-${PVR}/CONTENTS\fR. Наконец, по
завершении установки всех файлов выполняется функция
\fIpkg_postinst()\fR (если она существует).
.TP
.BR merge
Обычно для установки файла ebuild, необходимо последовательно выполнить
следующие действия: \fIfetch\fR, \fIunpack\fR, \fIcompile\fR,
\fIinstall\fR и \fIqmerge\fR. Если вам нужно только установить
файл ebuild, вы можете использовать данную команду: она сама выполнит
все перечисленные операции и остановится в процессе выполнения только
в том случае, если какая-либо функция отрабатывает с ошибкой.
.TP
.BR unmerge
Эта команда сначала вызывает функцию \fIpkg_prerm()\fR (если она существует).
Затем она удаляет все файлы из текущих файловых систем, файл содержимого
пакета для которых имеет верную контрольную сумму и время изменения.
Все пустые каталоги удаляются вместе с вложенными. Наконец, команда
запускает функцию \fIpkg_postrm()\fR (если она существует). Можно сначала
установить новую версию пакета, а затем удалить прежнюю - собственно,
именно в этом заключается рекомендуемый метод обновления.
.TP
.BR prerm
Запускает для определенного пакета действия, которые необходимо выполнить
до удаления пакета из файловой системы. См. также \fIunmerge\fR.
.TP
.BR postrm
Запускает для определенного пакета действия, которые необходимо выполнить
после удаления пакета из файловой системы. См. также \fIunmerge\fR.
.TP
.BR config
Запускает для определенного пакета действия, которые необходимо выполнить
до начала установки. Как правило, это настройка конфигурационных файлов
или другие настроечные действия, которые пользователь может захотеть
выполнить.
.TP
.BR package
Эта команда очень напоминает \fImerge\fR, за исключением того, что после
загрузки, распаковки, компиляции и установки создается .tbz2-архив
бинарного пакета, который затем сохраняется в каталоге \fBPKGDIR\fR
(см. \fBmake.conf\fR(5)).
.TP
.BR rpm
Собирает RPM\-пакет RedHat из файлов во временном \fIкаталоге установки\fR.
На данный момент сведения о зависимостях файла ebuild не включаются в RPM.
.SH OPTIONS
.TP
.BR "\-\-debug"
Запустить bash с опцией \-x, в результате чего стандартный вывод будет
включать подробную отладочную информацию.
.TP
.BR "\-\-color < y | n >"
Включить или отключить цветное отображение. Эта опция переопределяет
значение переменной \fINOCOLOR\fR (см. \fBmake.conf\fR(5)) и может быть
использована для принудительного назначения цвета в том случае, если
стандартный вывод - не терминал (по умолчанию цвет включен только в том
случае, если стандартный вывод - терминал).
.TP
.BR "\-\-force"
При использовании в связке с командой digest или manifest данная опция
принудительно генерирует новые дайджесты для всех файлов исходного кода,
относящихся к данному файлу ebuild. Если в каталоге ${DISTDIR} требуемых
исходников нет, они будут автоматически загружены.
.TP
.BR "\-\-ignore\-default\-opts"
Не использовать переменную окружения \fIEBUILD_DEFAULT_OPTS\fR.
.TP
.BR "\-\-skip\-manifest"
Пропустить проверку Manifest-файлов.
.SH "БАГТРЕКЕР"
Об обнаруженных ошибках сообщайте на http://bugs.gentoo.org/
.SH "АВТОРЫ"
.nf
Achim Gottinger <achim@gentoo.org>
Daniel Robbins <drobbins@gentoo.org>
Nicholas Jones <carpaski@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
.fi
.SH "ФАЙЛЫ"
.TP
.B /etc/portage/make.conf
Содержит переменные сборки, имеющие приоритет перед значениями,
указанными в файле make.globals.
.TP
.B /etc/portage/color.map
Содержит переменные, позволяющие назначать пользовательские настройки
цветного вывода.
.SH "СМОТРИ ТАКЖЕ"
.BR emerge (1),
.BR ebuild (5),
.BR make.conf (5),
.BR color.map (5)
.TP
Сценарий \fI/usr/sbin/ebuild.sh\fR.
.TP
Вспомогательные приложения в \fI/usr/lib/portage/bin\fR.

.SH "ПЕРЕВОД"
.nf
Переводчик: Елена Гаврилова <e.vl.gavrilova@yandex.ru>
Правка и обновление: Романов Владимир <blueboar2@gmail.com>