Gentoolkit
emerge — configuration — ebuild repository — dispatch-conf
world file — USE flags — ebuilds — profiles
upgrades — using testing packages — binary packages
tools — gentoolkit — eselect
Portage FAQ — cheat sheet — FAQ
all articles
Gentoolkit est une suite d'outils, dont Portage, destinée à faciliter l'administration d'un système Gentoo.
Gentoo est une distribution unique en son genre qui présente des complexités qui n'existent tout simplement pas dans d'autres distributions. Au fur et à mesure que les développeurs et contributeurs de Gentoo découvraient ces complexités, ils écrivirent des outils pour aider les utilisateurs et les administrateurs à les surmonter. Beaucoup de ces outils ont été apportés au projet Gentoo et sont inclus dans le paquet app-portage/gentoolkit.
Gentoolkit contient des outils pour vous aider à gérer vos paquets et garder la trace de ce qui se passe sur votre système. La plupart des utilisateurs — en particuliers ceux qui mettent souvent leur système à jour — tireront un bénéfice à avoir gentoolkit installé.
The gentoolkit commands have man pages, type "man <command>" for each command for full documentation.
Installation
USE flags
USE flags for app-portage/gentoolkit Collection of administration scripts for Gentoo
test
|
Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently) |
Emerge
Install gentoolkit:
root #emerge --ask app-portage/gentoolkiteclean
eclean est un outil de nettoyage pour retirer les fichiers sources ou binaires inutiles sur votre système.
Lorsque vous compilez et installez des paquets, les fichiers source sont téléchargés et sauvegardés dans DISTDIR, ordinairement /var/cache/distfiles. Ce fonctionnement peut conduire à l'accumulation de gigaoctets au fil du temps si vous ne les nettoyez pas régulièrement. Vous pouvez utiliser la commande eclean-dist pour retirer les fichiers source de DISTDIR.
Vous pouvez créer des archives des paquets installés en utilisant quickpkg ou FEATURES="buildpkg". Ces paquets archivés sont conservées dans PKGDIR, ordinairement /var/cache/binpkgs. Quand vous n'avez plus besoin de les conserver ou s'ils sont devenus trop vieux, vous pouvez utiliser eclean-pkg pour les retirer de PKGDIR. C'est une bonne façon de garantir que les paquets binaires que vous avez correspondent aux dernières versions.
Pour plus d'information sur eclean et sur la manière de tenir à jour un système sans résidu, lisez man eclean ou consultez l'article eclean.
epkginfo
epkginfo is a tool used to display package metadata information. It is a shortcut to using the equery meta command.
equery
equery is a tool to make several common Portage operations simpler. Among other operations, it can display package dependencies, metadata, and installed files.
eread
eread est un utilitaire simple qui vous permet de lire les fichiers elog produits par Portage depuis la version 2.1. Pour activer l'enregistrement des fichiers elog, paramétrez quelques variables dans votre fichier /etc/portage/make.conf :
make.confActiver elogPORTAGE_ELOG_CLASSES="log"
PORTAGE_ELOG_SYSTEM="save"
Ce n'est qu'un exemple. Pour savoir comment fonctionne le système elog de Portage, veuillez vous référer à la page appropriée de Portage Handbook.
Une fois qu'elog est configuré à votre convenance, lancez simplement eread pour visualiser les fichiers d'historique.
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?
Choisissez le numéro du fichier à examiner et celui-ci sera affiché par le programme défini par la variable d'environnement PAGER. Si PAGER n'est pas définie, less sera utilisé. La variable d'environnement PAGER peut être définie à l'aide de eselect (module pager).
Après avoir vu le fichier, il sera demandé à l'utilisateur s'il veut le supprimer.
eshowkw
Display keywords for specified package or for package that is in pwd.
To show keywords for a specific package, indicate that package on the command line, for example:
root #eshowkw gentoo-sources
Keywords for sys-kernel/gentoo-sources:
| | u |
| a a p s l r a | n |
| m r h p p i o i s l m m | e u s | r
| d a m p p c a x a o s 3 p 6 i | a s l | e
| 6 r 6 p p 6 r 8 6 n c 9 h 8 p | p e o | p
| 4 m 4 a c 4 c 6 4 g v 0 a k s | i d t | o
----------+-------------------------------+--------------+-------
4.14.302 | o o o o o o + o o o o o o o o | 8 o 4.14.302 | gentoo
----------+-------------------------------+--------------+-------
4.14.305 | + + + ~ + + ~ + ~ o o ~ ~ ~ ~ | 8 o 4.14.305 | gentoo
----------+-------------------------------+--------------+-------
4.14.309 | + ~ ~ + ~ + ~ + ~ o ~ ~ ~ ~ ~ | 8 o 4.14.309 | gentoo
----------+-------------------------------+--------------+-------
4.14.311 | ~ ~ ~ ~ ~ ~ ~ ~ ~ o ~ ~ ~ ~ ~ | 8 o 4.14.311 | gentoo
----------+-------------------------------+--------------+-------
4.14.312 | ~ ~ ~ ~ ~ ~ ~ ~ ~ o ~ ~ ~ ~ ~ | 8 o 4.14.312 | gentoo
euse
euse provides functionality to set (disable/enable) and obtain information about USE flags in make.conf, without having to edit the file directly.
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.
Cet outil est le « reconstructeur des dépendances inverses » de Gentoo. Il examine les paquets installés sur votre système pour trouver ceux qui ne fonctionnent plus à cause de la mise à jour de paquets dont ils dépendent. Il peut aussi installer ces paquets manquants pour vous, mais lorsqu'un paquet ne fonctionne plus avec les versions des dépendances déjà installées, il est conseillé de mettre à jour ce paquet vers une version récente. Si vous spécifiez des options, revdep-rebuild les passera à la commande emerge, ce qui vous permet d'utiliser l'option --pretend pour consulter la liste des paquets qui seront installés avant de procéder.
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.
user $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.
Pour reconstruire certains paquets, exécutez revdep-rebuild sans l'option -p. Tous les paquets listés seront réinstallés.
root #revdep-rebuildOther tools
gentoolkit also provides other tools:
| Name | Description |
|---|---|
| ebump | Ebuild revision bumper (more useful for developers). |
| enalyze | Gentoo's installed packages analysis and repair tool. See man page, which states "CAUTION: This is beta software and is not yet feature complete". |
| imlate | Displays candidates for keywords for an architecture (more useful for developers?). |
See the man pages for each of these tools for more info.
Voir aussi
- Equery — a tool to make several common Portage operations simpler.
- Eclean — un outil visant à nettoyer les fichiers sources du dépôt et les paquets binaires
- Epkginfo — a tool used to display package metadata information.
- Q applets — une collection d'outils de requête (query) de Portage petits et rapides écrits en C.
- Useful Portage tools — provides a list of Gentoo-specific system management tools, notably for Portage, available in the ebuild repository.
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.