Portage log/ru

When using for building a package, it is not uncommon to notice messages coming from Portage itself. Since they may contain important information from Gentoo developers it is a good idea to read them, but often this is not immediately possible because they rapidly scroll out of the screen. This can be easily solved by enabling a Portage feature called elog, whose purpose is to save messages to disk for later review. But other logging capabilities exist as well...

Подсистема elog в portage
The Portage elog subsystem keeps track of specific, ebuild-provided log messages that developers have put in the ebuilds to attract attention of the administrator or user. Often, these messages contain important or interesting information related to the build of said package.

Настройка
С помощью переменной PORTAGE_ELOG_CLASSES выберите какой тип информации нужно журналировать. Возможные значения,  ,  ,   и  :

Настройка для хранения в виде файлов
Portage может обрабатывать события elog в ряде случаев.

Для того чтобы сохранить события elog на диск, включите модуль  в переменной PORTAGE_ELOG_SYSTEM :

Сообщения будут сохранены в файл или в файл, если указанная переменная установлена.

Для того чтобы создать файлы elog для каждой категории, включите. Это заставить Portage в каталоге создавать подкаталоги для каждой категории.

Настройка для e-mail
Для того чтобы отправить журнал по почте, включите модуль. Для модуля mail необходимо установить некоторые дополнительные переменные. Чтобы получить больше информации, прочитайте.

Ниже, показан пример настройки, который говорит, надеемся, сам за себя:

Другой пример для nullmailer или sendmail:

Сопутствующее программное обеспечение
Далее идет список сопутствующего для elog программного обеспечения:


 * - утилита сделанная на библиотеки curses для разбора содержимого файлов elog
 * - просмотрщик файлов elog сделанный на основе Python

Build logs
With the Portage elog subsystem, package build logs are saved on disk or mailed to a remote recipient, regardless of failure or success. This allows for administrators to review builds later or retrieve build logs for support tickets.

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

Next, a number of FEATURES settings influence how Portage handles build logs.


 * With  set, even binary package deployments will have their logs saved
 * When  is set, regular log file clean operations are executed. The command that is executed is defined by PORT_LOGDIR_CLEAN and defaults to a retention of the files of 7 days.
 * With  set, build logs are stored in category-named subdirectories of

Очистка
When  is set, Portage will execute the command defined by PORT_LOGDIR_CLEAN after every build or unmerge operation. By default, the following command is used:

When defining a custom command, do not forget to escape the PORT_LOGDIR variable (or immediately hardcode the right location).

Внешние ресурсы

 * Underestimated or underused: Portage (e)logging on (Sven Vermeulen's blog)