Gentoolkit
Not to be confused with Genkernel.
Gentoolkit представляет собой набор средств, облегчающих администрирование системы Gentoo. Этот документ охватывает основы некоторых инструментов, присутствующих в Gentoolkit.
Gentoo является уникальным дистрибутивом и имеет некоторые сложности, не существующие для других дистрибутивов. Как только разработчики и контрибьюторы Gentoo обнаружили некоторые из них, они также написали инструменты, с целью помочь пользователям и администраторам обойти эти проблемы. Многие инструменты были внесены как вклад в проект Gentoo и включены в пакет app-portage/gentoolkit.
Gentoolkit содержит целый букет полезных инструментов, которые помогут пользователям управлять пакетами и отслеживать всё что происходит в их системе. Большинство пользователей - особенно те, кто обновляют систему часто - выиграют от того, что Gentoolkit установлен.
The Gentoolkit commands have man pages, type "man <command>" for each command for full documentation.
Установка
Emerge
root #emerge --ask app-portage/gentoolkiteuse
euse is used to set (disable/enable) USE flags in make.conf, without having to edit the file directly. It is also used to get detailed information about use flags like description, status of flags (enabled/disabled), type of flag (global/local), etc.
euse является инструментом для просмотра, активации и деактивации USE-флагов в различных местах. Для получения дополнительной информации об использовании флагов, пожалуйста, обратитесь к главе USE-флаги. Смотрите euse -h для получения помощи и всех опций.
Invocation
user $euse --help euse (0.5.1-r1)
Syntax: euse <option> [suboptions] [useflaglist]
Options: -h, --help - show this message
-V, --version - show version information
-i, --info - show descriptions for the given useflags
-I, --info-installed - show descriptions for the given useflags and
their current impact on the installed system
-g, --global - show only global use flags (suboption)
-l, --local - show only local use flags (suboption)
-a, --active - show currently active useflags and their origin
-E, --enable - enable the given useflags
-D, --disable - disable the given useflags
-R, --remove - remove all references to the given flags from
make.conf and package.use to revert to default
settings
-P, --prune - alias for --remove
-p, --package - used with -E, -D, and -R to apply to a
specific package only
Notes: euse currently works for global flags defined
in make.globals, make.defaults, make.conf, use.force, and use.mask
and local flags defined in package.use and individual package ebuilds.
It might have issues with cascaded profiles. If multiple options are
specified only the last one will be used.
Просмотр, активация и деактивация USE-флагов
Команда euse -a считывает текущие активные USE-флаги и отображает их.
Есть 5 "столбцов", которые euse теперь использует, для того, чтобы показать активен или неактивен флаг и где установлены все флаги. Столбцы следуют -- +/-, установлены в Environment (окружении), установлены в make.Conf, установлены в make.Defaults, и установлены в make.Globals. Результат выглядит [+ECDG].
Full positive values would be [+ECDGFm], full negative values would be [-ecdgfM], full missing values would be [- ].
Example euse -a output (truncated):
root #euse -aX [+ CD ] aalib [+ ] acpi [+ C ] alsa [+ C ] apache2 [+ C ] apm [+ D ] avi [+ D ] berkdb [+ D ] bitmap-fonts [+ D ] bonobo [+ ] cdr [+ C ] crypt [+ CD ] cscope [+ C ] cups [+ CD ] curl [+ ] emboss [+ D ] encode [+ D ] esd [+ ] fam [+ ] fbcon [+ C ] firefox [+ C ] font-server [+ D ] foomaticdb [+ D ] fortran [+ D ] gd [+ C ] gdbm [+ D ] gif [+ CD ] gimpprint [+ C ] gnome [+ CD ] gphoto2 [+ ] gpm [+ CD ] gstreamer [+ C ] gtk [+ D ] gtkhtml [+ C ] guile [+ ] imagemagick [+ ] imlib [+ CD ] innodb [+ ] ipv6 [+ D ] javascript [+ C ] jpeg [+ CD ] kde [+ D ] ldap [+ ] libg++ [+ CD ] libwww [+ CD ] mad [+ CD ] mbox [+ C ] md5sum [+ C ] mikmod [+ CD ] mmx [+ C ] motif [+ CD ] mp3 [+ ] mpeg [+ CD ] mpeg4 [+ C ] mysql [+ C ] ncurses [+ CD ] nls [+ D ] nvidia [+ C ] odbc [+ ] offensive [+ ] ogg [+ CD ] opengl [+ CD ] oss [+ D ] pam [+ CD ] pdflib [+ CD ] perl [+ CD ] png [+ CD ] python [+ CD ] qt [+ D ] quicktime [+ CD ] readline [+ CD ] ruby [+ ] sdl [+ CD ] slang [+ D ] spell [+ CD ] sse [+ C ] ssl [+ CD ] svga [+ CD ] tcltk [+ C ] tcpd [+ D ] tiff [+ C ] truetype [+ CD ] usb [+ C ] vanilla [+ C ] x86 [+ C ] xml [+ ] xosd [+ C ] xv [+ CD ] xvid [+ C ] zlib [+ CD ]
Так же можно использовать команду euse -a -g, чтобы просмотреть только активные глобальные флаги. Команда euse -a -l делает то же самое для активных локальных флагов. -g и -l являются суб-опциями для euse и для корректного функционирования перед ними необходима опция (такая как -a).
Setting, and unsetting USE flags
euse может активировать и деактивировать USE-флаги. Для этого используются команды euse -E flagname(активировать флаг) и euse -D flagname (деактивировать флаг).
Не используйте команды euse -E или euse -D без флага. Это действие активирует/деактивирует ВСЕ USE-ФЛАГИ в /etc/portage/make.conf. Копия будет храниться в /etc/portage/make.conf.euse_backup, тем не менее будьте осторожны при использовании euse -E или euse -D.
Активация USE-флага:
Use the -E option to enable a USE flag.
root #euse -E 3dfx/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup
Файл /etc/portage/make.conf выглядит таким, после запуска команды:
make.confПосле активации USE-флага 3dfxUSE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ ogg odbc offensive opengl pam pdflib perl png python \ quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ vanilla X xosd xv xvid x86 zlib 3dfx"
Деактивация USE-флага:
Use the -D option to remove a USE flag.
root #euse -D 3dfx/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup
Снова, вид файла /etc/portage/make.conf после запуска команды:
make.confПосле деактивации USE-флага 3dfxUSE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ ogg odbc offensive opengl pam pdflib perl png python \ quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ vanilla X xosd xv xvid x86 zlib -3dfx"
euse физически не удаляет флаг из /etc/portage/make.conf. Он просто добавляет
- (минус) перед флагом, чтобы деактивировать его. Возможно, придется вручную очистить /etc/portage/make.conf, чтобы избежать нежелательных переменных. В противном случае, используйте опцию -P(снос) для удаления флага. Например, euse -P 3dfx удалит флаг 3dfx.A disabled USE flag is not the same as the absence of the flag in make.conf. A disabled use flag will actively disable features, whereas not listing a flag at all will use the default - enabled or disabled - as set by the package maintainer.
Remove (prune) a USE flag
Use the -P (purge) option to remove a USE flag.
root #euse -P 3dfxThe example /etc/portage/make.conf file, after the command:
make.confAfter disabling the 3dfx USE flagUSE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ ogg odbc offensive opengl pam pdflib perl png python \ quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ vanilla X xosd xv xvid x86 zlib"
Прочие инструменты
revdep-rebuild
It is not necessary to run this tool for general use. The portage FEATURE preserve-libs makes the original purpose obsolete. The primary purpose of this tool is now ABI changes for specific libraries when instructions are provided by developers.
Этот инструмент является инструментом для пересборки обратных зависимостей в Gentoo. Он будет сканировать установленные файлы ebuild, чтобы найти пакеты, которые повредились в результате обновлении пакета, от которого они зависят. Он может собрать эти пакеты для пользователя автоматически, но также может случиться, что данный пакет не работает с текущей установленной зависимостью, и в этом случае вы должны обновить сломанный пакет до более новой версии. revdep-rebuild передает флаги emerge, что позволяет использовать опцию --pretend, чтобы увидеть что произойдет, прежде чем произвести реальную операцию.
revdep-rebuild will pass flags to emerge which lets the --pretend flag pass through, to see what is going to be emerged again before going any further.
root #revdep-rebuild -p* Configuring search environment for revdep-rebuild * Checking reverse dependencies * Packages containing binaries and libraries broken by a package update * will be emerged. * Collecting system binaries and libraries * Generated new 1_files.rr * Collecting complete LD_LIBRARY_PATH * Generated new 2_ldpath.rr * Checking dynamic linking consistency [ 48% ] * broken /usr/lib/gstreamer-0.10/libgsttaglib.la (requires /usr/lib/libtag.la) [ 64% ] * broken /usr/lib/libgdkglext-x11-1.0.la (requires /usr/lib/libGLU.la) [ 67% ] * broken /usr/lib/libgtkglext-x11-1.0.la (requires /usr/lib/libGLU.la) [ 85% ] * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la (requires /usr/lib/libGLU.la) * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la (requires /usr/lib/libGLU.la) [ 97% ] * broken /usr/qt/3/lib/libqt-mt.la (requires -lpng) [ 100% ] * Generated new 3_broken.rr * Assigning files to packages * /usr/lib/gstreamer-0.10/libgsttaglib.la -> media-plugins/gst-plugins-taglib * /usr/lib/libgdkglext-x11-1.0.la -> x11-libs/gtkglext * /usr/lib/libgtkglext-x11-1.0.la -> x11-libs/gtkglext * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la -> dev-python/pygtkglext * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la -> dev-python/pygtkglext * /usr/qt/3/lib/libqt-mt.la -> x11-libs/qt * Generated new 4_raw.rr and 4_owners.rr * Cleaning list of packages to rebuild * Generated new 4_pkgs.rr * Assigning packages to ebuilds * Generated new 4_ebuilds.rr * Evaluating package order * Generated new 5_order.rr * All prepared. Starting rebuild emerge --oneshot --pretend dev-python/pygtkglext:0 media-plugins/gst-plugins-taglib:0.10 x11-libs/gtkglext:0 x11-libs/qt:3 These are the packages that would be merged, in order: Calculating dependencies... done! [ebuild R ] media-plugins/gst-plugins-taglib-0.10.17 [ebuild R ] x11-libs/gtkglext-1.2.0 [ebuild R ] x11-libs/qt-3.3.8b-r2 [ebuild R ] dev-python/pygtkglext-1.1.0 * Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.
Если нужно пересобрать некоторые пакеты запустите команду revdep-rebuild без опции -р и перечисленные пакеты будут пересобраны.
eread
eread это простая утилита для отображения elog-файлов, представленных в Portage начиная с версии 2.1. Сохранение elog файлов можно настроить, установив пару переменных в /etc/portage/make.conf:
make.confАктивация elogPORTAGE_ELOG_CLASSES="log" PORTAGE_ELOG_SYSTEM="save"
Это только один из способов сохранения elog сообщений. Для получения дополнительной информации о том, как система elog работает в Portage, пожалуйста, обратитесь к соответствующей странице Настольной книги Portage.
После того, как создали удовлетворяющую настройку elog, запустите eread, чтобы посмотреть log файлы.
user $ereadThis is a list of portage log items. Choose a number to view that file or type q to quit. 1) app-portage:gentoolkit-0.2.4_pre2:20070320-000256.log 2) app-portage:gentoolkit-0.2.4_pre2:20070320-000258.log 3) app-portage:gentoolkit-0.2.4_pre2:20070320-000319.log 4) app-portage:gentoolkit-0.2.3:20070320-000408.log Choice?
Выберите номер и файл будет отображаться с использованием программы, указанной в переменной окружения PAGER. Если переменная PAGER не установлена, будет использоваться less. Переменную окружения PAGER можно задать с помощью eselect (модуль pager).
После отображения пункта elog, вам будет предложено удалить файл.
eclean
eclean является инструментом для удаления из системы старых файлов исходного кода и бинарных пакетов.
Во время сборки и установки пакетов, исходные файлы загружаются и сохраняются в DISTDIR, обычно это /usr/portage/distfiles. Со временем они могут накапливаться до нескольких гигабайт, если периодически их не очищать. Пользователь должен запустить eclean-dist, чтобы удалить только исходные файлы из DISTDIR.
Можно создавать архивы установленных пакетов с помощью quickpg или функции FEATURES="buildpkg". Собранные архивы пакетов хранятся в PKGDIR, обычно это /usr/portage/packages. Если они больше не требуется или устарели, то удалить их из PKGDIR можно командой eclean-pkg. Это хороший способ убедиться, что все бинарные пакеты в системе только последних версий.
Более подробную информацию о eclean и советы о том, как поддерживать систему, свободной хлама вы можете прочитать man eclean или проверить статью об eclean.
Смотрите также
This page is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: Matt Butcher, John P. Davis, Erwin, Shyam Mani, Xavier Neys, Karl Trygve, José Luis Rivero, Joshua Saddler, Douglas Anderson
They are listed here because wiki history does not allow for any external attribution. If you edit the wiki article, please do not add yourself here; your contributions are recorded on each article's associated history page.