Gentoo Linux amd64 Handbook: Работа с Portage
Файлы Portage
Конфигурационные директивы
Portage поставляется с настройками по умолчанию, которые хранятся в /usr/share/portage/config/make.globals. Все настройки Portage обрабатываются с помощью переменных. Какие переменные использует Portage и для чего они нужны, будет описано позже.
Так как многие конфигурационные директивы отличаются в разных архитектурах, у Portage есть конфигурационные файлы по умолчанию, которые является частью системного профиля. Этот профиль указывается с помощью символьной ссылки /etc/portage/make.profile; конфигурации Portage находится в файлах make.defaults системного профиля и всех вышестоящих профилей. Мы более детально расскажем о профилях и каталоге /etc/portage/make.profile позднее.
Если требуется изменить конфигурационные переменные, не меняйте /usr/share/portage/config/make.globals или make.defaults. Вместо этого используйте файл /etc/portage/make.conf, у которого больший приоритет над предыдущими файлами. Для получения дополнительной информации прочитайте /usr/share/portage/config/make.conf.example. Как следует из названия, это просто пример — Portage не использует этот файл.
Также можно определить конфигурационные переменные Portage в переменном окружении, но мы не рекомендуем этого делать.
Информация из определенного профиля
Мы уже ознакомились с каталогом /etc/portage/make.profile. На самом деле это не каталог, а символьная ссылка на один из профилей, по умолчанию это /var/db/repos/gentoo/profiles/, однако можно создать свои собственные профили где угодно и ссылаться на них. Профиль, на который указывает символьная ссылка, и есть системный профиль.
Профиль содержит информацию о конкретной архитектуре для Portage, например, список пакетов, которые принадлежат этому системному профилю, список пакетов, которые не работают (или замаскированы) в этом системном профиле, и так далее.
Пользовательская конфигурация
Если нужно изменить поведение Portage относительно того, как устанавливается программное обеспечение, то будет правильно настроить файлы в /etc/portage/. Настоятельно рекомендуется использовать файлы в /etc/portage/ и очень не рекомендуется переопределять поведение Portage в переменном окружении!
Пользователи могут создать в /etc/portage/ следующие файлы:
- package.mask список пакетов, которые Portage никогда не будет устанавливать
- package.unmask список пакетов, которые Portage будет устанавливать, даже если разработчик Gentoo отговаривает пользователей от их установки
- package.accept_keywords список пакетов, которые Portage будет устанавливать, даже если они не подходят для используемой системы или архитектуры (пока)
- package.use список пакетов, для которых необходимо использовать специфичные USE-флаги, а не брать системные USE-флаги
Не обязательно они должны быть файлами; это могут быть каталоги, содержащие по одному файлу для пакета. Больше информации о каталоге /etc/portage/ и весь список возможных файлов, которые можно создать там, можно найти в man-странице Portage:
user $
man portage
Изменение файлов Portage и расположение каталогов
Ранее упомянутые конфигурационные файлы нельзя хранить в любом месте; Portage всегда будет искать эти файлы в строго определенных местах. Однако Portage использует много других каталогов для различных целей: каталог для сборки, хранения исходного кода, расположение Gentoo репозитория, ...
Для этих целей по умолчанию есть хорошо известные каталоги, которые могут быть переопределены в /etc/portage/make.conf. Остальная часть этого раздела объяснить какие специальные каталоги использует Portage и как изменить их расположение в файловой системе.
Данная статья не предназначена для использования в качестве полноценного справочника. С полной информацией можно ознакомиться в man-страницах portage и make.conf:
user $
man portage
user $
man make.conf
Хранение файлов
Gentoo репозиторий ebuild-файлов
Gentoo репозиторий ebuild-файлов по умолчанию находится в /var/db/repos/gentoo. Месторасположение определяется файлом repos.conf, пример которого можно найти в /usr/share/portage/config/repos.conf. Чтобы изменить значения по умолчанию, скопируйте этот файл в /etc/portage/repos.conf/gentoo.conf и измените location. Не забудьте сменить символьную ссылку на /etc/portage/make.profile, если хотите хранить (меняя переменную) Gentoo репозиторий ebuild-файлов в другом месте.
После изменения настройки location в /etc/portage/repos.conf/gentoo.conf рекомендуется изменить следующие переменные /etc/portage/make.conf, так как они не заметят изменений в location. Portage так работает с переменными: PKGDIR, DISTDIR, RPMDIR.
Двоичные пакеты
Хотя по умолчанию Portage не использует двоичные пакеты, в нем есть широкая поддержка их. Когда Portage просят установить бинарный пакет, он будет искать их в каталоге /var/cache/binpkgs. Этот каталог определяется переменной PKGDIR.
Исходный код
По умолчанию исходный код для приложений хранится в каталоге /var/cache/distfiles. Этот каталог определяется переменной DISTDIR.
База Portage
Portage хранит состояние системы (какие пакеты установлены, какие файлы какому пакету принадлежат, ...) в каталоге /var/db/pkg.
Не изменяйте файлы состояния системы вручную! Это может заставить Portage видеть систему по другому.
Кеш Portage
Кэш Portage (с временем изменений, виртуальными пакетами, информации о зависимостях в дереве, ...) хранится в /var/cache/edb. Там располагается просто кэш: пользователи спокойно могут отчистить это каталог, если на данный момент не запущено никаких приложений Portage.
Сборка программного обеспечения
Временные файлы Portage
Временные файлы Portage по умолчанию хранятся в /var/tmp/. Этот каталог определяется с помощью переменной PORTAGE_TMPDIR.
Каталог компиляции
Portage создает специальные каталоги в /var/tmp/portage/ для всех компилируемых пакетов. Этот каталог определяется переменной PORTAGE_TMPDIR и добавлено portage/.
Расположение реальной системы
По умолчанию Portage устанавливает все файлы на текущую файловую систему (/), но это можно изменить, если настроить переменную окружения ROOT. Что весьма удобно, в случае создания новых сборочных образов.
Возможности журналирования
Журналироване для ebuild
Portage может создавать фалы журналов для каждого ebuild, но только в том случае, когда переменная PORT_LOGDIR указывает на каталог, который доступен для записи Portage (пользователю portage). По умолчанию эта переменная не задана. Если переменная PORT_LOGDIR не задана то, в текущей системе журналирования не будет журналов, хотя пользователи могут получить некоторый журналы с помощью новой поддержки elog.
Если переменная PORT_LOGDIR не определена и используется elog, тогда можно получить журналы сборки и любые другие журналы, которые сохраняются программой elog, как показано ниже.
Portage предлагает гибкую систему контроля над журналированием с помощью программы elog:
- PORTAGE_ELOG_CLASSES: определяет какие виды сообщений будут записываться в журнал. Разделяя пробелами можно указать любую комбинацию из: info, warn, error, log и qa.
- info: журналирует "einfo" сообщения от ebuild
- warn: журналирует "ewarn" сообщения от ebuild
- error: журналирует "eerror" сообщения от ebuild
- log: журналирует the "elog" сообщения, которые есть в некоторых ebuild
- qa: журналирует "QA Notice" сообщения от ebuild
- PORTAGE_ELOG_SYSTEM: выбирает модуль(и), которые будут обрабатывать сообщения журналов. Если оставить пустым, то журналирование будет отключено. Разделяя пробелами можно использовать любую комбинацию из: save, custom, syslog, mail, save_summary и mail_summary. По крайней мере хотя бы один модуль должен быть задействован, чтобы использовать elog.
- save: сохраняет один журнал для каждого пакета в $PORT_LOGDIR/elog, или /var/log/portage/elog, если $PORT_LOGDIR не определен.
- custom: передает все сообщения пользовательской команде, которая определена в $PORTAGE_ELOG_COMMAND; об этом будет рассказано позже.
- syslog: передает все сообщения установленной программе журналирования.
- mail: передает все сообщения на определенный пользователем в $PORTAGE_ELOG_MAILURI почтовый сервер; об этом будет рассказано позже. Для работы этой возможности elog необходим >=portage-2.1.1.
- save_summary: похоже на save, но еще сохраняет все сообщения в $PORT_LOGDIR/elog/summary.log или /var/log/portage/elog/summary.log, если $PORT_LOGDIR не определена.
- mail_summary: похоже на mail, но еще отправляет все сообщения в одном письме, когда emerge завершает работу.
- PORTAGE_ELOG_COMMAND: эта переменная используется только в случае когда используется модуль custom. Пользователи могут определить команду для обработки сообщений журнала. Обратите внимание, что команда может использовать две переменные: ${PACKAGE} — это имя и версия пакет, а ${LOGFILE} — это полный путь до файла журнала. Например:
PORTAGE_ELOG_COMMAND="/path/to/logger -p '\${PACKAGE}' -f '\${LOGFILE}'"
- PORTAGE_ELOG_MAILURI: эта переменная содержит настройки для модуля mail, такие как адрес, логин, пароль, почтовый сервер и номер порта. По умолчанию это "root@localhost localhost". Следующий пример для сервера SMTP, который требует аутентификацию на основе логина и пароля на определённом порту (по умолчанию 25):
PORTAGE_ELOG_MAILURI="user@some.domain username:password@smtp.some.domain:995"
- PORTAGE_ELOG_MAILFROM: позволяет пользователю настроить адрес "from" для отправленных по почте журналов; если ничего не задано, то по умолчанию "Portage".
- PORTAGE_ELOG_MAILSUBJECT: позволяет пользователям создать тему для писем с журналами. Обратите внимание, что можно использовать две переменные: ${PACKAGE} отобразит имя и версию пакета, а ${HOST} отобразит полностью определенное доменное имя (FQDN) хоста на котором запущен Portage. Например:
PORTAGE_ELOG_MAILSUBJECT="package \${PACKAGE} was merged on \${HOST} with some messages"
Пользователи, которые использовали Portage-2.0.* с enotice, должны удалить enotice, так как он не совместим с elog.
Настройка Portage
Как говорилось ранее, Portage настраивается с помощью множества переменных, которые могут быть определены в /etc/portage/make.conf или в некоторых подкаталогах /etc/portage/. Пожалуйста, ознакомьтесь с man-страницами make.conf и portage для получения дополнительной информации.
user $
man make.conf
user $
man portage
Параметры работающие во время сборки
Параметры для configure и компилятора
Когда Portage компилирует приложения, он передает компилятору и скрипту configure содержимое следующих переменных:
- CFLAGS и CXXFLAGS
- определяет желаемые флаги компилятора для компиляции кода на C и C++
- CHOST
- определяет информацию о хосте, на котором производиться компиляция (build host), которая передается скрипту configure в приложении
- MAKEOPTS
- передается команде make и в основном используется для определения степени распараллеливания во время компиляции. Больше информации о всех параметрах команды make можно найти в man-странице make.
Также переменная USE используется во время конфигурации и компиляции, но об этом было рассказано в предыдущих главах.
Параметры установки
Когда Portage устанавливает (merged) более новую версию программного обеспечения, он удалит устаревшие файлы старой версии ПО из системы. Portage дает пользователю задержку в 5 секунд перед удалением старых версий. Эти 5 секунд определены в переменной CLEAN_DELAY.
Можно сказать emerge использовать определенные параметры при каждом запуске, настроив их в переменой EMERGE_DEFAULT_OPTS. Некоторые полезные параметры --ask
, --verbose
, --tree
и так далее.
Защита конфигурационных файлов
Каталоги, защищаемые Portage
Portage не перезаписывает старые файлы новыми, из новой устанавливаемой версии, если они хранятся в защищенном месте. Эти защищенные каталоги определяются в переменной CONFIG_PROTECT и, как правило, там перечислены каталоги хранения конфигурационных файлов. Каталоги в списке разделяются пробелами.
Файл, который должен быть записан в такой защищенный каталог, переименовывается, а пользователь получает предупреждение о наличии новой версии (обычно) конфигурационного файла.
Чтобы узнать текущие настройки CONFIG_PROTECT, проверьте вывод команды emerge --info:
user $
emerge --info | grep 'CONFIG_PROTECT='
Больше информации о том, как работает защита конфигурационных файлов в Portage можно найти в разделе CONFIGURATION FILES man-страницы emerge:
user $
man emerge
Исключение каталогов
Чтобы убрать 'защиту' с определенных субкаталогах в защищенных каталогах, можно воспользоваться переменной CONFIG_PROTECT_MASK.
Параметры загрузки
Расположение серверов
Когда запрашиваемая информация или данные не доступны в системе, Portage будет загружать ее из интернета. Расположение серверов с различной информацией и данными определяется в следующих переменных:
- GENTOO_MIRRORS
- определяет список серверов, которые содержат исходный код (distfiles).
- PORTAGE_BINHOST
- определяет расположение конкретного сервера, который содержит бинарные пакеты.
Третий параметр содержит расположение сервера rsync, который используется при обновлении локального Gentoo репозитория. Он определяется в файле /etc/portage/repos.conf (либо в файле внутри данного каталога, если это каталог):
- sync-type
- определяет тип сервера, по умолчанию
rsync
. - sync-uri
- определяет конкретный сервер, который Portage использует чтобы загрузить Gentoo репозиторий.
Переменные GENTOO_MIRRORS, sync-type и sync-uri могут быть установлены автоматически с помощью приложения mirrorselect. Конечно, прежде чем им воспользоваться, необходимо сперва установить пакет app-portage/mirrorselect. Больше информации можно посмотреть в mirrorselect help:
root #
mirrorselect --help
Если требуется использовать прокси-сервер, то можно настроить переменные http_proxy, ftp_proxy и RSYNC_PROXY.
Команды загрузки
Когда Portage необходимо загрузить исходный код, по умолчанию он использует wget. Такое поведение можно изменить с помощью переменной FETCHCOMMAND.
Portage может продолжить загрузку частично загруженного исходного кода. Для этого по умолчанию используется wget, но это можно изменить с помощью переменной RESUMECOMMAND.
Убедитесь, что переменные FETCHCOMMAND и RESUMECOMMAND сохраняют исходный код в правильный каталог. Внутри этих переменных можно воспользоваться переменными \${URI} и \${DISTDIR}, чтобы указать ссылку на исходный код и место для его сохранения соответственно.
Можно определить обработчики для каждого протокола с помощью переменных FETCHCOMMAND_HTTP, FETCHCOMMAND_FTP, RESUMECOMMAND_HTTP, RESUMECOMMAND_FTP и так далее.
Настройка rsync
Нельзя изменить команду rsync, которую использует Portage для обновления Gentoo репозитория, но можно установить некоторые переменные для команды rsync:
- PORTAGE_RSYNC_OPTS
- Определяет ряд значений по умолчанию, которые используются в процессе синхронизации (sync), каждая из которых разделена пробелом. Не стоит менять эту переменную, пока вы точно не будете знать что делаете. Обратите внимание, что некоторые необходимые параметры всегда будут использоваться, даже если переменная PORTAGE_RSYNC_OPTS будет пуста.
- PORTAGE_RSYNC_EXTRA_OPTS
- используется для определения дополнительных параметров во время синхронизации. Каждый параметр должен быть разделен пробелом:
--timeout=<number>
- определяет сколько секунд rsync будет ожидать подключения, прежде чем подключение будет считаться истекшим по временем ожидания. По умолчанию эта переменная установлена в
180
, но пользователи с диалап (dialup) или медленным компьютером могут попробовать установить300
или выше. --exclude-from=/etc/portage/rsync_excludes
- указывает файл, содержащий список пакетов и/или категорий, который rsync должен игнорировать в процессе синхронизации. В этом случае он указывает на /etc/portage/rsync_excludes.
--quiet
- уменьшит вывод на экран.
--verbose
- выводит полный список файлов.
--progress
- отображает процесс загрузки для каждого файла.
- PORTAGE_RSYNC_RETRIES
- определяет, сколько раз rsync должен пытаться соединиться с зеркалом, на который указывает переменная SYNC, прежде чем сообщить об ошибке. По умолчанию, значение этой переменной
3
.
Более подробную информацию о этих и других опциях читайте в rsync man-странице.
Конфигурация Gentoo
Выбор ветви
Можно изменить используемую по умолчанию ветвь с помощью переменной ACCEPT_KEYWORDS. По умолчанию используется стабильная ветвь архитектуры. Больше информации о ветвях Gentoo можно найти в следующей главе.
Возможности Portage
Можно активировать определенные возможности Portage с помощью переменной FEATURES. Возможности Portage уже были рассмотрены в предыдущих главах.
Поведение Portage
Управление ресурсами
С помощью переменной PORTAGE_NICENESS пользователи могут увеличить или уменьшить значение nice, которое будет использовать Portage в своей работе. Значение PORTAGE_NICENESS добавляется к текущему значению nice в Portage.
Более подробную информацию о значениях nice смотрите в Portage niceness и man-странице nice:
user $
man nice
Управление выводом
Переменная NOCOLOR (по умолчанию она установлена в false
) определяет, должен ли Portage отключить использование цветного вывода.
Использование одной ветви
Стабильная ветвь
Переменная ACCEPT_KEYWORDS определяет ветвь для ПО системы. Эта переменная задаётся в /etc/portage/make.conf и по умолчанию выставлена на стабильную ветвь. В нашем случае значением по умолчанию является amd64.
# Следующее значение уже стоит по умолчанию, поэтому его _не_ нужно задавать явно.
ACCEPT_KEYWORDS="amd64"
Для более спокойной работы и снижения риска сбоев и других проблем Руководство рекомендует оставаться на стабильной ветке. Поскольку для Portage эта ветвь выставлена по умолчанию, никаких изменений не требуется. Системным администраторам, которые не боятся этого или хотят устанавливать (по возможности) новейшие обновления рекомендуется прочесть раздел Тестовая ветвь.
Тестовая ветвь
Осторожно, дикие земли! Hic sunt dracones! Использование программного обеспечения с тестовой ветки может вызвать проблемы со стабильностью, пакеты могут быть настроены не самым лучшим образом (напр. неправильные или отсутствующие зависимости), ebuild-файлы могут постоянно пересматриваться (вызывая постоянную компиляцию)... к тому же пакеты могут сломаться и каким-то другим, неожиданном образом. Системным администраторам, которые не очень хорошо разбираются в устройстве Gentoo или Linux-а в целом, следует избегать тестовой ветви. Как было отмечено ранее, в Руководстве рекомендуется оставаться на стабильной, более проверенной ветви.
Если системный администратор хочет запускать новейшее, но менее протестированное ПО, можно выбрать тестовую ветвь. Чтобы переключиться на неё, выставьте значение ACCEPT_KEYWORDS на ~amd64.
# Инструктируем Portage использовать тестовую ветвь (~) для архитектуры amd64.
ACCEPT_KEYWORDS="~amd64"
У любой архитектуры, поддерживаемой проектом Gentoo, есть тестовая ветвь, на которую можно переключиться, добавив префикс ~
(символ тильды) к значению ACCEPT_KEYWORDS для этой архитектуры.
Тестовая ветвь является нестабильной, что и следовало ожидать из названия. Если пакет находится в тестовой ветке, это означает, что разработчики верят в работоспособность пакета, но он недостаточно протестирован. Системы, использующие тестовую ветвь могут в числе первых столкнуться с ошибками в пакете. В этом случае, пожалуйста, отправьте отчёт об ошибке, чтобы сообщить об этом разработчикам.
При переходе со стабильной ветви на тестовую и выполнении обновления набора @world можно ожидать закономерного обновления множества (иногда сотен) пакетов до новейших доступных версий. В тестовой ветви, они примерно соответствуют последним выпускам от upstream-разработчиков (авторов самих программ). Помните, что после перехода на тестовую ветвь, как правило, путь назад, к стабильной ветви, довольно сложен и это обоснованно самой природой обновлений.
Одновременное использование стабильной и тестовой ветвей
package.accept_keywords
Можно указать, чтобы Portage использовал тестовую ветвь только для определенных пакетов, а для остальной системы- стабильную ветвь. Для этого добавьте категорию и имя пакета, для которого вы желаете использовать тестовую ветвь, в файл /etc/portage/package.accept_keywords. Вместо этого можно создать каталог (с таким же именем) и указывать пакеты в файлах, находящихся внутри этого каталога.
Например, для использования тестовой ветви для gnumeric:
app-office/gnumeric
Тестирование определенных версий
Чтобы использовать конкретную версию ПО из тестовой ветви, но не хотите, чтобы Portage использовал тестовую ветвь для последующих версий этого ПО, можно указать в местоположении package.accept_keywords номер необходимой версии. В этом случае используйте оператор =. Также можно указать диапазон версий, используя операторы <=, <, > или >=.
В любом случае, добавляя информацию о версии, вы должны использовать один из этих операторов. Если вы не указываете версию, эти операторы использовать нельзя.
В следующем примере мы просим Portage разрешить установку gnumeric-1.2.13, даже если он находится в тестовой ветви:
=app-office/gnumeric-1.2.13
Замаскированные пакеты
package.unmask
Разработчики Gentoo не поддерживают использование размаскированных пакетов. Пожалуйста, используйте их на свой страх и риск. Просьбы о помощи, связанные с использованием package.unmask и/или package.mask могут остаться без ответа.
Если пакет был замаскирован разработчиками Gentoo, но вы желаете его использовать несмотря на причины блокировки, указанные в файле package.mask (по умолчанию он находится в /var/db/repos/gentoo/profiles/), добавьте желаемую версию (обычно вы получите точно такую же строку, как в файле package.mask в профиле) в файл /etc/portage/package.unmask (или в файл в этом каталоге, если это каталог).
To do so, the system administrator would add the target package version (usually this will be the exact same line from the package.mask file in the profile) to the /etc/portage/package.unmask location.
Например, если =mail-client/mutt-2.2.9
замаскирован (бедняга!), то размаскировать его можно, прописав в package.unmask точно такую же строчку:
=mail-client/mutt-2.2.9
Если запись в /var/db/repos/gentoo/profiles/package.mask содержит диапазон версий пакета, вам следует разблокировать только те версии, которые вам на самом деле необходимы. Прочитайте предыдущий раздел, чтобы узнать, как определять версии с помощью операторов сравнения.
package.mask
Возможно указать Portage, чтобы он не использовал какое-то конкретное ПО или конкретные версии ПО. Чтобы это сделать, замаскируйте пакет, добавив соответствующую запись в /etc/portage/package.mask (либо в такой файл, либо в файл внутри такого каталога).
Если, к примеру, чтобы Portage не устанавливал исходные коды ядра новее, чем gentoo-sources-6.6.21, добавьте такую строку в package.mask:
>sys-kernel/gentoo-sources-6.6.21
dispatch-conf
dispatch-conf — это программа, которая помогает объединять файлы вида ._cfg0000_<имя>. Такие файлы генерируются Portage, когда он хочет перезаписать файл в каталоге, который защищен переменной CONFIG_PROTECT.
С помощью dispatch-conf можно обновлять файлы конфигурации, сохраняя при этом историю изменений. dispatch-conf хранит различия между файлами конфигурации в виде заплаток или в системе управления версиями RCS. Это означает, что если кто-то совершил ошибку при обновлении файла конфигурации, администратор может откатить изменения на предыдущую версию в любое время.
При использовании dispatch-conf, вы можете попросить оставить конфигурационный файл как есть, использовать новый конфигурационный файл, отредактировать текущий, или заменить изменения между ними интерактивно. dispatch-conf также имеет некоторые дополнительные возможности:
- Автоматическое обновление файлов, в которых обновились только комментарии.
- Автоматическое обновление файлов, которые отличаются только количеством пробелов.
Сначала отредактируйте файл /etc/dispatch-conf.conf и создайте каталог, прописанный в переменной archive-dir. Затем запустите dispatch-conf:
root #
dispatch-conf
При запуске dispatch-conf, каждый измененный файл конфигурации будет показан, по одному. Нажмите u для обновления (замены) текущего конфигурационного файла новым и показа следующего файла. Нажмите z, чтобы удалить новый конфигурационный файл и показать следующий файл. Клавиша n сообщит dispatch-conf о том, что нужно пропустить следующий файл. Как только все конфигурационные файлы будут просмотрены, dispatch-conf закончит работу. Вы также можете нажать q, чтобы выйти в любое время.
Для более детальной информации проверьте man-страницу dispatch-conf. Она расскажет вам, как интерактивно слить текущий и новый конфигурационный файл, отредактировать новые конфигурационные файлы, просмотреть разницу между файлами, и многое другое.
user $
man dispatch-conf
quickpkg
С помощью quickpkg пользователи могут создавать архивы пакетов, уже установленных в системе. Эти архивы можно использовать в качестве двоичных пакетов. Запуск quickpkg прост: только укажите имена пакетов, которые нужно архивировать.
Например, чтобы поместить в архив curl, orage и procps:
root #
quickpkg curl orage procps
Двоичные пакеты будут сохранены в $PKGDIR (по умолчанию, в /var/cache/binpkgs/). Эти пакеты помещаются в $PKGDIR/КАТЕГОРИЯ.
Использование подмножества Gentoo репозитория
Исключение пакетов и категорий
Можно выборочно обновлять определенные категории/пакеты, игнорируя обновление других категорий/пакетов. Это достигается путем исключения таких категорий/пакетов программой rsync на этапе выполнения emerge --sync.
Чтобы это заработало, необходимо выключить проверку манифестов, что снижает безопасность использования репозитория. Чтобы выключить проверку, либо отключите USE-флаг rsync-verify для пакета sys-apps/portage, либо установите параметр sync-rsync-verify-metamanifest=no в записи репозитория Gentoo repos.conf.
Определите имя файла, содержащего шаблоны исключаемых пакетов, в переменной PORTAGE_RSYNC_EXTRA_OPTS в файле /etc/portage/make.conf:
PORTAGE_RSYNC_EXTRA_OPTS="--exclude-from=/etc/portage/rsync_excludes"
games-*/*
Заметьте, однако, что это может привести к проблемам с зависимостями, так как новые разрешенные пакеты могут зависеть от других новых, но исключенных из обновления пакетов.
Добавление неофициальных файлов ebuild
Определение пользовательского репозитория ebuild-файлов
Manual creation
Можно настроить Portage так, чтобы он использовал сборочные файлы ebuild, не входящие в официальный Gentoo репозиторий. Создайте новый каталог (к примеру, /var/db/repos/localrepo), в котором будут находиться файлы ebuild сторонних разработчиков. Используйте в точности такую же структуру каталогов, как и в официальном Gentoo репозитории!
root #
mkdir -p /var/db/repos/localrepo/{metadata,profiles}
root #
chown -R portage:portage /var/db/repos/localrepo
Затем выберите подходящее имя для репозитория. В следующем примере в качестве имени используется «localrepo»:
root #
echo 'localrepo' > /var/db/repos/localrepo/profiles/repo_name
Then define the EAPI used for the profiles within the repository:
root #
echo '8' > /var/db/repos/localrepo/profiles/eapi
Сообщим Portage, что главный (master) репозиторий это основной Gentoo репозиторий, и что репозиторий не должен автоматически синхронизироваться (так как это не поддерживается сервером rsync, зеркалом git или другим типом репозитория):
masters = gentoo
auto-sync = false
thin-manifests = true
sign-manifests = false
Наконец, включите репозиторий в локальную систему, создав файл конфигурации для репозитория в /etc/portage/repos.conf. Это сообщит Portage, где можно найти локальный репозиторий:
[localrepo]
location = /var/db/repos/localrepo
Optional: Creating a repo using eselect repository
Alternatively, a custom ebuild repository can be quickly created using the eselect repository module (from app-eselect/eselect-repository). In the following example, substitute localrepo
with a name of choice:
root #
eselect repository create localrepo
Adding localrepo to /etc/portage/repos.conf/eselect-repo.conf ... Repository <ebuild_repository_name> created and added
A bare repository named "localrepo" will be made available at /var/db/repos/localrepo.
Работа с несколькими оверлеями
For those desiring to develop several ebuild repos, test packages before they hit the Gentoo repository, or who want to use unofficial ebuilds from various sources, the app-eselect/eselect-repository package also provides tooling to aid in keeping repositories up to date. See also eselect repository article.
eselect-repository
Например, чтобы включить репозиторий GURU:
root #
eselect repository enable guru
root #
emerge --sync
Программы, поддерживаемые не через Portage
Использование Portage с пакетами самостоятельной сборки
Иногда пользователям может потребоваться настраивать, устанавливать и поддерживать программное обеспечение самостоятельно, без автоматизации со стороны Portage, несмотря на то, что оно поддерживается Portage. Наиболее известные случаи - это исходный код ядра и драйверы от Nvidia. Можно настроить Portage так, чтобы системе стало известно, что определенные пакеты установлены вручную (тогда Portage будет принимать данную информацию во внимание при расчете зависимостей). Данный процесс называется внедрение, и поддерживается Portage посредством файла /etc/portage/profile/package.provided.
Например, чтобы сообщить Portage о том, что пакет gentoo-sources-6.6.21 был установлен вручную, нужно добавить следующую строку в /etc/portage/profile/package.provided:
sys-kernel/gentoo-sources-6.6.21
Это файл, который использует версии без
=
оператора.
Введение в расширенные возможности Portage
Для большинства пользователей полученной до сих пор информации достаточно для их повседневных задач в Linux. Но Portage способен на много другое; множество его возможностей предназначены для целей расширенной подгонки системы под личные нужды или применимы только в особых случаях.
Конечно, из-за большой гибкости может появиться большое количество потенциальных случаев. Невозможно описать их все здесь. Вместо этого, целью является сосредоточение внимания на некоторых основных вопросах, основываясь на которых, можно настроить систему определённым образом. Другие ухищрения и советы по настройке можно найти на страницах Gentoo Wiki.
Большинство, если не все эти дополнительные возможности можно легко найти, почитав man-страницы, которые идут вместе с Portage:
user $
man portage
user $
man make.conf
И, наконец, знайте, что эти дополнительные возможности, в случае, если что-то работает не корректно, могут сделать отладку и поиск проблем очень затруднительными. Убедитесь, что сообщили об использовании таких возможностей, когда будете создавать отчет об ошибке.
Переменные окружения для конкретного пакета
Использование /etc/portage/env
По умолчанию, при сборки пакета, будут использоваться переменные окружения, которые определены в /etc/portage/make.conf, такие как CFLAGS, MAKEOPTS и другие. В некоторых случаях, было бы полезно определить другие переменные для некоторых пакетов. Для таких случаев Portage поддерживает использование каталога /etc/portage/env и файла /etc/portage/package.env.
Файл /etc/portage/package.env содержит список пакетов для которых необходимы отклонения в переменном окружении, а также определенный идентификатор, который сообщит Portage, какие изменения необходимо сделать. Имя идентификатора определяется в свободном формате, Portage будет искать переменные в файле /etc/portage/env/<идентификатор>.
Пример: включение отладки для конкретных пакетов
В качестве примера, включим отладку (debugging) для пакета media-video/mplayer.
Сперва установим переменные для отладки в файле, который называется /etc/portage/env/debug-cflags. Имя выбирается произвольно, но, конечно, видна причина такого именования; чтобы сделать более очевидным позже, почему такое именование было сделано.
root #
mkdir /etc/portage/env
# Добавим -ggdb к CFLAGS для отладки
CFLAGS="-O2 -ggdb -pipe"
FEATURES="${FEATURES} nostrip"
Далее, «отметим» пакет media-video/mplayer для использования нового идентификатора debug в файле package.env:
media-video/mplayer debug-cflags
Вмешиваемся в процесс emerge
Использование /etc/portage/bashrc и связанных файлов
Когда Portage работает с разными ebuild, он использует окружение bash в котором он вызывает различные функции сборки (такие как src_prepare
, src_configure
, pkg_postinst
и так далее). Portage позволяет системным администраторам определять некоторые части окружения bash.
Преимущество использования заранее определенных частей окружения bash в том, что это позволяет вмешиваться в процесс emerge на каждом шаге его выполнения. Этого можно добиться для всех команд emerge (через /etc/portage/bashrc) или используя окружение для конкретного пакета (через /etc/portage/env, как это было описано ранее).
Чтобы вмешаться в процесс, окружение bash может слушать переменные EBUILD_PHASE, CATEGORY, а так же как переменные, которые всегда доступны в процессе работы ebuild (такие как P, PF, ...). На основе значений этих переменных могут быть выполнены дополнительные шаги и функции.
Пример: обновление базы данных файлов
В этом примере будет использоваться /etc/portage/bashrc для вызова некоторых приложений с базами данных файлов, чтобы синхронизировать состояние их баз данных с системой. Приложения, используемые в этом примере, aide (утилита обнаружения вторжений) и updatedb (для использования с mlocate) это просто примеры. Не воспринимайте это как руководство для программы AIDE.
Чтобы данном случае воспользоваться /etc/portage/bashrc, мы должны вмешаться в функции postrm
(после удаления файлов) и postinst
(после установки файлов), потому что именно в этих случаях изменяются файлы в системе.
if [ "${EBUILD_PHASE}" == "postinst" ] || [ "${EBUILD_PHASE}" == "postrm" ];
then
echo ":: Calling aide --update to update its database"
aide --update
echo ":: Calling updatedb to update its database"
updatedb
fi
Выполнения задач после операции синхронизации репозитория
Использование /etc/portage/postsync.d
До этого момента мы говорили только о вмешательстве в процессы ebuild. Однако у Portage также есть и другие важные функции: обновление Gentoo репозитория. Чтобы запустить задачу после обновления Gentoo репозитория, поместите скрипт в каталог /etc/portage/postsync.d и убедитесь, что он отмечен как исполняемый.
Пример: запуск eix-update
Если eix-sync не используется для синхронизации репозитория, то все еще можно обновить его базу данных после выполнения emerge --sync (или emerge-webrsync) добавив в каталоге /etc/portage/postsync.d символьную ссылку на /usr/bin/eix, назвав ее eix-update.
root #
ln -s /usr/bin/eix /etc/portage/postsync.d/eix-update
Если необходимо использовать другое имя, то необходим скрипт, который вызовет /usr/bin/eix-update. Бинарный файл eix смотрит под каким именем его вызвали, чтобы узнать, какую функцию он должен выполнить. Если символьная ссылка указывает на eix, но ссылка называется не eix-update, то это будет работать не корректно.
Переопределение настроек профиля
Использование /etc/portage/profile
По умолчанию Gentoo использует настройки, содержащиеся в профиле, на который указывает /etc/portage/make.profile (символьная ссылка на каталог профиля). Эти профили определяют как специфичные для профиля настройки, так и наследуют настройки из других профилей (через их родительские файлы).
Используя /etc/portage/profile, системные администраторы могут переопределить настройки профиля, такие как пакеты (какие пакеты считаются частью системного набора (@system)), обязательные USE-флаги и другое.
Пример: добавление nfs-utils в набор system
В случае использования критически важных файловых систем на основе NFS, может потребоваться отметить пакет net-fs/nfs-utils в качестве системного, из-за чего Portage будет строго предупреждать системных администраторов в случае, если они попытаются этот пакет удалить.
Чтобы достичь этой цели, необходимо указать в файле /etc/portage/profile/packages пакет, добавив *
перед его именем:
*net-fs/nfs-utils
Применение нестандартных патчей
Patching source code using user patches in /etc/portage/patches/
User patches provide a way to apply patches to package source code when sources are extracted before installation. This can be useful for applying upstream patches to unresolved bugs, or simply for local customizations.
Patches need to be dropped into /etc/portage/patches/. They will automatically be applied during package installation.
Patches can be dropped into any of the following directories:
- /etc/portage/patches/${CATEGORY}/${P}/ e.g. /etc/portage/patches/dev-lang/python-3.3.5-r1/
- /etc/portage/patches/${CATEGORY}/${PN}/ e.g. /etc/portage/patches/dev-lang/python-3.4.2/
- /etc/portage/patches/${CATEGORY}/${P}-${PR}/ e.g. /etc/portage/patches/dev-lang/python-3.3.5-r0/
Пример: применение патчей к Firefox
Пакет www-client/firefox один из множества пакетов, который вызывает функцию eapply_user
(возможно, не напрямую) из ebuild, так что нет необходимости что-либо менять.
В некоторых случаях (например, разработчик предоставил патч и попросил проверить исправляет ли он ошибку), когда необходимо пропатчить Firefox, просто нужно поместить патч в /etc/portage/patches/www-client/firefox (лучше использовать полное имя и версию, так чтобы патч не мешал более ранним версиям) и пересобрать Firefox.
Warning: Display title "Gentoo Linux amd64 Handbook: Работа с Portage" overrides earlier display title "Handbook:AMD64/Full/Portage".