Handbook:Parts/Working/Portage/ru

Добро пожаловать в Portage
Система Portage — вероятно, самое известное нововведение Gentoo в управлении программным обеспечением. Благодаря высокой гибкости и чрезвычайно богатым возможностям, она зачастую считается лучшим средством управления программным обеспечением из существующих в Linux.

Portage полностью написан на Python и Bash и, следовательно, полностью прозрачен для пользователей, поскольку это скриптовые языки.

Большинство пользователей взаимодействует с Portage с помощью команды. Эта глава не будет дублировать информацию, доступную в emerge man странице. Для полного обзора опций emerge, пожалуйста, обратитесь к странице man:

Ebuilds
Когда в документации Gentoo говорится о пакетах имеется ввиду программы, которые доступны Gentoo пользователям в дереве Portage. Дерево Portage это коллекция ebuild (сборочных файлов) - файлы содержащие всю информацию, которая нужна Portage для управления программным обеспечением (установка, поиск, запросы, ...). По умолчанию файлы ebuild находятся в.

Всякий раз, когда кто-то просит Portage выполнить некоторые действия в отношении некоторого программного обеспечения, он будет использовать ebuild в качестве базы. Поэтому важно, регулярно обновлять ebuild в системе, позволяя Portage узнать о новых программах, обновлениях безопасности и т.д.

Обновление дерева Portage
Дерево Portage обычно обновляется с помощью, средства быстрой разностной передачи файлов. Обновление выполняется довольно просто, так как в имеется интерфейс для :

Иногда ограничения файрвола ограничивают в доступе к зеркалу. В этом случае обновите дерево Portage с помощью ежедневно генерируемых Gentoo снимков дерева Portage. Утилита автоматически загрузит и установит последний снимок в систему:

Дополнительным преимуществом использования, это то что она позволяет администратору загружать в дерево Portage снимки, которые подписаны ключом GPG для разрабатываемых релизов Gentoo. Более подробную информацию об этом можно найти в статье возможности Portage в секции проверенные снимки дерева Portage.

Поиск программного обеспечения
Есть несколько способов поиска программ в дереве Portage. Один из способов использовать. По умолчанию находит имена пакетов, которые совпадают (полностью или частично) с заданным условием поиска.

Например, чтобы найти все пакеты, содержащие «pdf» в названии:

Для поиска пакетов еще и по тексту описания используйте опцию  (или  ):

Обратите внимание, что вывод команды возвращает много информации. Поля четко обозначены, поэтому мы не будем вдаваться в подробности их значения:

Установка программы
Когда программное обеспечение было найдено, его легко можно установить командой. Например, для установки gnumeric:

Поскольку многие приложения зависят друг от друга, любая попытка установить какой-либо пакет может привести к установке нескольких зависимостей. Не беспокойтесь об этом, Portage учтет и эти зависимости. Чтобы увидеть что Portage будет устанавливать, добавьте опцию. Например:

Во время установки пакета, Portage скачает необходимый исходный код из интернета (если необходимо) и по умолчанию сохранит его в. После этого он распакует, скомпилирует и установить пакет. Для того чтобы Portage только загрузил исходный код без его установки, добавьте опцию  к команде emerge:

Поиск документации для установленных пакетов
Многие пакеты поставляются с собственной документацией. Иногда, USE флаг  определяет будет ли установлена документация из пакета или нет. Чтобы увидеть есть ли USE флаг doc в пакете используйте.

Лучший способ настроить doc USE флаг это настроить его для каждого пакета с помощью, так документация будет устанавливаться только для требуемых пакетов. Для большего количества информации, пожалуйста, прочитайте главу USE флаги.

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

Удаление программы
Для удаления пакета из системы используйте. Она попросит Portage удалить все файлы установленные пакетом из системы. Одним исключением из этого являются файлы конфигурации этого приложения, если они были изменены пользователем. Сохранение конфигурационных файлов позволяет пользователям продолжать работать с пакетом, без необходимости настраивать снова пакет, если он будет установлен снова позже.

Когда удаляется пакет из системы, зависимости от этого пакета, которые установились при установки пакета, все еще остаются в системе. Для того чтобы Portage нашел все зависимости, которые теперь можно удалить, используйте опцию emerge  о которой мы расскажем позже.

Обновление системы
Чтобы сохранить систему в отличной форме (не говоря уже об установке последних обновлений безопасности) необходимо регулярно обновлять систему. Так как Portage проверяет сборочные файлы только в локальном дереве Portage, поэтому сперва нужно обновить дерево Portage. После обновления дерева Portage можно обновить систему с помощью. В следующем примере также используется опция, которая попросит Portage вывести список пакетов, которые нужно обновить, и запросит подтверждение:

Portage будет искать более новые версии для установленных приложений. Однако, будут проверятся только явно установленные (приложения, перечисленные в ), но не будут тщательно проверятся их зависимости. Чтобы обновить зависимости этих пакетов тоже, добавьте опцию :

Но все еще это не означает все пакеты: некоторые пакеты в системе необходимы для компиляции и во время создания пакетов, но как только пакет установлен, эти зависимости больше не требуется. Portage называет это "build зависимостями". Чтобы обновить и эти пакеты тоже добавьте опцию :

Поскольку обновления по безопасности бывают и в пакетах, которые явно не установлены в системе (но которые "тянутся" в качестве зависимостей для других программ), рекомендуется изредка запускать эту команду.

Когда настройки USE в системе были изменены, то рекомендуется также добавить. В этом случаи Portage проверит требуется ли после этих изменений установить новые пакеты или перекомпилировать существующие:

Метапакеты
У некоторых пакетов в дереве Portage нет содержимого, но они используются для установки набора других пакетов. Например, установит полное окружение KDE в системе, устанавливая в качестве зависимостей различные пакеты, которые нужны KDE.

Удаление такого пакета из системы, запуская пакет, не принесет должного эффекта, так как его зависимости останутся в системе.

Portage также имеет функциональность для удаления ненужных зависимостей, но поскольку доступное программное обеспечение динамически зависит друг от друга, важно сначала обновить всю систему полностью, в том числе и новые изменения, получившихся из-за изменения USE флагов. После этого можно запустить для удаления ненужных зависимостей. Когда это будет сделано, возможно будет необходимо пересобрать приложения, которые раньше были динамически связанны с удаленным теперь программами и теперь больше не нуждаются в них, в последнее время поддержка этого была добавлена Portage.

Все это можно сделать следующими тремя командами:

входит в пакет ; не забудьте установить его:

Лицензии
Начиная с версии Portage 2.1.7 можно принять или отклонить установку программного обеспечения основываясь на лицензии. Все пакеты в дереве содержат запись LICENSE в ebuild. Запуск покажет лицензию пакета.

По умолчанию, Portage позволяет все лицензии, за исключением лицензионного соглашения с конечным пользователем (EULA), которое требуют прочтения и подписание соглашения о принятии.

Переменная, которая контролирует допустимые лицензии называется ACCEPT_LICENSE. Ее можно настроить в. В следующем примере показано значение по умолчанию:

При такой конфигурации пакеты требующие подтверждения EULA при инсталляции не будут установлены. Пакеты без EULA можно будет установить.

Можно настроить ACCEPT_LICENSE глобально в файле или специально для отдельного пакета в файле.

Например, чтобы разрешить лицензию для пакета  добавьте следующее в :

Это разрешит установку версий truecrypt с лицензией, но не позволит устанавливать версии с лицензией.

Определяя группы лицензий в ACCEPT_LICENSE, поставьте перед ними знак. Часто настраивают так, что разрешают только установку свободного программного обеспечения и документации. Чтобы сделать это, удалите все разрешенные лицензии на данный момент (используя ), а затем разрешите только лицензии из группы FREE:

В этом случае "free", в основном, определяется FSF и OSI. Любой пакет, лицензия которого не соответствует этим требованиям, не будет установлен на системе.

Терминология
Как отмечалось ранее, Portage поддерживает многие возможности и является чрезвычайно мощным инструментом, как и другие инструменты управления программами. Чтобы понять это, разберем несколько аспектов Portage, не вдаваясь в детали.

С помощью Portage разные версии отдельного пакета могут сосуществовать в одной системе. В то время как другие системы управления стремятся называть пакеты в соответствии с версией (например freetype и freetype2), Portage использует технологию под названием SLOT. Ebuild присваивает определенный SLOT для одной версии пакета. Ebuild с разными SLOT способны сосуществовать в одной системе. Например, пакет freetype имеет разные ebuild для SLOT="1" и SLOT="2".

Есть также пакеты, которые обеспечивают ту же функциональность, но реализуются по-разному. Например, metalogd, Sysklogd и syslog-ng это все системные службы журналирования. Приложения, которым "нужен" "системный журнал" не могут зависеть только от, например metalogd, остальные программы журналирования также могут быть хорошим выбором. В Portage предусмотрены виртуальные пакеты: каждая служба журналирования описана в нем как "эксклюзивная" зависимость от службы журналирования в виртуальном пакете журналирования виртуальной категории, поэтому остальные приложения могут зависеть от пакета. Если еще не была установлена служба журналирования, то при установке виртуального пакета он "подтянет" первый пакет журналирования из "эксклюзивных" зависимостей (если любой такой пакет уже был установлен, то в этом случае виртуальная зависимость считается удовлетворенной).

Программное обеспечение в дереве Portage может располагаться в различных ветвях. По умолчанию система устанавливает только пакеты, которые в Gentoo считаются стабильными. Многие программ при обновлении, будут добавлены в тестовую ветвь, что означает, что пакет должен быть протестирован до того как он станет стабильным. Несмотря на то что ebuild для таких программ есть в дереве Portage, он не будет обновлять их пока они не будут помещены в стабильную ветвь.

Некоторые программы доступны только для некоторых архитектур. Либо программное обеспечение не работает на других архитектурах, либо требуется дополнительное тестирования, либо разработчик, который загрузил (закоммитил) программное обеспечение в дерево Portage, не в состоянии проверить, работает ли пакет на других архитектурах.

Каждая инсталляция Gentoo, также придерживается определенного профиля, который содержит помимо прочей информации еще и список пакетов, необходимых для работоспособности системы.

Заблокированные пакеты
В файлах ebuild есть специальные поля, сообщающие Portage о зависимостях. Есть две возможные зависимости: сборочные зависимости, объявленные в переменной DEPEND и зависимости выполнения, аналогично объявленные в RDEPEND. Когда одна из этих зависимостей явно указывает на пакет или виртуальный пакет, которые не совместимы, это вызывает блокировку.

Хотя последние версии Portage достаточно умны, чтобы обойти незначительные блокировки без вмешательства пользователя, иногда такие блокировки необходимо разрешить вручную.

Чтобы исправить блокировку, пользователи могут, либо не устанавливать пакет, либо удалить конфликтующий пакет. В данном примере, можно отказаться от установки Postfix или сперва удалить SSMTP.

Иногда бывает также, что блокируются пакеты с конкретными версиями, например. В этом случае, обновление блокирующего пакета до более новой версии может удалить блок.

Также возможно, что два пакета, которые должны быть установлены, блокируют друг друга. В этом редком случае, попытайтесь выяснить, почему они должны быть установлены. В большинстве случаев достаточно оставить один из пакетов. Если это не так, то пожалуйста, сообщите об ошибке в системе слежения ошибок Gentoo.

Замаскированные пакеты
When trying to install a package that isn't available for the system, this masking error occurs. Users should try installing a different application that is available for the system or wait until the package is marked as available. There is always a reason why a package is masked:

Необходимо изменить USE флаг
Сообщение об ошибке может отображаться и так, если  не установлен:

Такое предупреждение или ошибка происходит когда пакет, который требуется установить, зависит не только от другого пакета, но также требует, чтобы этот пакет был скомпилирован с особым USE флагом (или набором USE флагов). В данном примере, пакет app-text/feelings должен быть скомпилирован с USE="test", но это USE флаг не задан в системе.

Чтобы исправить это добавьте нужный USE флаг к глобальным USE флагам в файле или добавьте его для отдельного пакета в файле.

Отсутствующие зависимости
Приложение, которое требуется установить, зависит от другого пакета, который не доступен системе. Пожалуйста, проверьте Bugzilla, возможно проблема известна, и если нет, пожалуйста, сообщите об этом. Если система не настроена для смешивания ветвей, то этого не должно происходить, и это баг.

Неоднозначное имя ebuild
Название приложения, которое введено для установки, соответствует более чем одному пакету. Укажите также название категории для решения этой проблемы. Portage сообщит пользователю о возможных совпадений, чтобы помочь выбрать.

Циклические зависимости
Two (or more) packages to install depend on each other and can therefore not be installed. This is most likely a bug in one of the packages in the Portage tree. Please re-sync after a while and try again. It might also be beneficial to check Bugzilla to see if the issue is known and if not, report it.

Ошибка загрузки
Portage was unable to download the sources for the given application and will try to continue installing the other applications (if applicable). This failure can be due to a mirror that has not synchronized correctly or because the ebuild points to an incorrect location. The server where the sources reside can also be down for some reason.

Retry after one hour to see if the issue still persists.

Защита системного профиля
The user has asked to remove a package that is part of the system's core packages. It is listed in the profile as required and should therefore not be removed from the system.

Ошибка проверки подписи
This is a sign that something is wrong with the Portage tree - often, it is because a developer may have made a mistake when committing a package to the tree.

When the digest verification fails, do not try to re-digest the package personally. Running will not fix the problem; it will almost certainly make it worse!

Instead, wait an hour or two for the tree to settle down. It's likely that the error was noticed right away, but it can take a little time for the fix to trickle down the Portage tree. Check Bugzilla and see if anyone has reported the problem yet or ask around on (IRC). If not, go ahead and file a bug for the broken package.

После того, как ошибка была исправлена, повторно синхронизируйте дерево Portage, чтобы загрузить исправленный дайджест.