Gentoolkit/ru

Gentoolkit представляет собой набор средств, облегчающих администрирование системы Gentoo. Этот документ охватывает основы некоторых инструментов, присутствующих в Gentoolkit.

Что такое Gentoolkit?
Gentoo является уникальным дистрибутивом и имеет некоторые сложности, не существующие для других дистрибутивов. Как только разработчики и контрибьюторы Gentoo обнаружили некоторые из них, они также написали инструменты, с целью помочь пользователям и администраторам обойти эти проблемы. Многие из этих инструментов были внесены как вклад в проект Gentoo и включены в пакет.

Gentoolkit содержит целый букет полезных инструментов, которые помогут управлять пакетами и отслеживать всё что происходит в вашей системе. Больше всего от наличия этого пакета выиграют особенно те пользователи, которые часто обновляют свои системы.

Установка
Как и с любым другим пакетом Gentoo, для установки просто используйте emerge.

Поиск документации
Любая документация, которую программа может иметь (кроме справочных страниц) хранится в.

Введение
является инструментом, который отображает полезную информацию о пакетах в вашей системе. основан на системе модулей. Каждый модуль имеет краткое название. Так, например,  является тем же, что и. объясняет глобальные параметры и списки всех доступных модулей и их сокращения. вызовет справку для конкретного модуля. Наконец,  содержит подробное описание всех доступных модулей и опций, а также предоставляет полезные примеры.

Ниже приведен список функций, которые работают в большинстве модулей.

Как и emerge, equery не понимает частичные названия пакетов:

В отличие от emerge, equery может принимать подстановку подобно shell в категории и/или названии пакета:

Большинство модулей equery принимают многократный ввод:

Несколько модулей также позволяют полностью регулярные выражения:

Следующие несколько разделов в этом документе дают краткое введение в другие модули.

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

Просмотр записей чейнджлога с помощью changes (c)
позволяет просматривать изменения в чейнджлоге для версии пакета или диапазона версий. Представьте себе, после  вы заметите, что Portage собирается обновиться и хотите проверить изменения:

Проверка целостности пакетов с помощью check (k)
Иногда бывает полезно проверить целостность пакета. может проверить контрольные суммы MD5, а также временные метки, чтобы определить, когда пакет мог быть поврежден, заменен или удален.

Перечисление всех пакетов зависимых от пакета Х с помощью depends (d)
Вы никогда не задумывались, почему определенный пакет был установлен в вашей системе? может сказать, какие пакеты являются зависимостями, с помощью. Включая косвенные зависимости с помощью опции.

Получение графы зависимостей с помощью depgraph (g)
является противоположностью. Вы передаете ему пакет, и он найдет пакеты от которых зависит it (не зависящие от него). Когда он находит зависимость, то будет рекурсивно искать все, что имеет отношение к зависимостям пакета. Контроль глубины древа поиска осуществляется опцией.

Обратите внимание, как   является прямой зависимостью и   становится косвенной зависимости если USE-флаг   будет установлен.

Вывод списка файлов, установленных пакетом с помощью files (f)
может получить список всех файлов, установленных с помощью ebuild, используя модуль. Попробуйте , чтобы получить удобочитаемую структуру директорий. Используйте, чтобы найти определенный тип файла. Например, чтобы найти, где были установлены исполняемые файлы, используйте  и для того, чтобы быстро найти местоположение файла конфигурации, попробуйте.

Ищите пакеты, имеющие конкретный USE-флаг, с помощью hasuse (h)
Вы можете использовать, чтобы узнать какие пакеты имеют конкретный USE-флаг. не скажет вам, если флаг установлен, только если ebuild перечислит его в качестве опции. См. раздел ПРИМЕРОВ  в  man-странице   для получения этой информации.

Перечисление пакетов с помощью list (l)
представляет собой простой, но мощный модуль, отображающий список пакетов, которые будут установлены, в дереве портежей или оверлее.

Стандартный запрос будет искать установленные пакеты для заданного имени пакета. Указывание '*' отобразит все пакеты в сете. В крайнем левом поле, мы видим, что все вышеперечисленные пакеты установлены (nstalled) и из дерева   (ortage). Они не замаскированы (второе поле пустым), и все установлены в слот по умолчанию (0).

На этот раз мы собираемся использовать локальные опции для поиска пакетов в дереве Portage и оверлеях.

В этом примере вы можете увидеть, что версия 7.2.182 установлена и нет версий, доступных из оверлея. Вы можете увидеть, какие версии замаскированы по ключевым словам знаком   во втором поле.

Просмотр метаданных пакета с помощью meta (m)
Каждый пакет в дереве портежей обеспечивает по крайней мере некоторые метаданные о его сопровождающем, группе и т.д. Прочтите Gentoo Metadata.Количество полезной информации зависит от того, сколько пакетов сопровождающие решат предоставить. Если параметры не заданы,  возвращает некоторую базовую, но полезную информацию.

Когда сопровождающий предоставляет дополнительную информацию, она может быть очень полезна:

Определение размера пакета с помощью size (s)
Вам когда-нибудь было любопытно узнать, сколько места занимает конкретный пакет? Поскольку пакет может иметь свои файлы в нескольких каталогах, обычный  не сможет дать корректную информацию. Не волнуйтесь, к Вам идет на помощь !

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

Листинг USE-флагов по пакету с помощью uses (u)
's  module can provide information about what USE flags are available for a specific package, and which of those flags is currently enabled.

Here, a number of USE flags are enabled in 's plugin meta-package, but you can see that there are other USE flags available. For more information on USE flags, please refer to the USE Flags chapter of the Gentoo Handbook.

Finding the Ebuild Path with which (w)
is a simple script to help you quickly find the file path to an ebuild. If you pass an unversioned package name,  will return the path to the newest installable ebuild version, in other words, the ebuild Portage would use if you typed. Pass in a versioned package to get the path to that ebuild.

Lastly, if none of the above features of  have answered your question, try using   to manually search an ebuild with programs like ,   or  :

Introduction
is a tool to see, set and unset USE flags at various places. For more information on USE flags, please refer to the USE Flags. Please see  for complete help and all options.

Viewing, Setting and Unsetting USE Flags
The  command reads the current active USE flags and displays them.

Similarly you can use the  command to only view active global USE flags. The  command does the same for active local USE flags. and  are suboptions to   and need an option before them (like  ) to function correctly.

We can also use  to set or unset use flags. The commands used for this are  (enable a flag) and   (disable a flag).

Enabling a USE Flag:

The file looks like so after the command was ran:

Disabling the USE Flag:

Again, the file after the command:

revdep-rebuild
This tool is Gentoo's Reverse Dependency rebuilder. It will scan your installed ebuilds to find packages that have become broken as a result of an upgrade of a package they depend on. It can emerge those packages for you but it can also happen that a given package does not work any more with the currently installed dependencies, in which case you should upgrade the broken package to a more recent version. revdep-rebuild will pass flags to emerge which lets you use the  flag to see what is going to be emerged again before you go any further.

If you need to rebuild some packages, you may run  without the   flag and the listed packages will be emerged again.

glsa-check
is mainly a test tool that keeps track of the various GLSA's (Gentoo Linux Security Advisory) and will eventually be integrated into  and.

eread
is a simple utility to display elog files produced by >=. You can set the saving of elog files by setting a couple of variables in :

Once you've set up elog to your satisfaction, just run  to view your log files.

Select a number and the file will be displayed using the paging program specified in the PAGER environment variable. If PAGER is not set, it will use. The PAGER environmental variable can be set using  (module  ).

After displaying the elog item, you will be prompted if you want to delete the file.

eclean
is a tool to remove old source files and old binary packages from your system.

When you build and install packages, the source files are downloaded and preserved in DISTDIR, usually. This can accumulate several gigabytes of material over time if you don't clean it periodically. You can run  to clean only source files from DISTDIR.

You can create archives of installed packages by using  or FEATURES="buildpkg". These archived packages are kept in PKGDIR, usually. When you no longer need to keep them around, or if they're too old, you can run  to remove them from PKGDIR. It's a good way to ensure that any binary packages you have are only the latest versions.

For more information on  and tips on maintaining a cruft-free system, please read   or check the eclean article.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Matt Butcher
 * John P. Davis
 * Erwin
 * Shyam Mani
 * Xavier Neys
 * Karl Trygve
 * José Luis Rivero
 * Joshua Saddler
 * Douglas Anderson