Gentoo est une distribution Linux tout à fait unique ; cela engendre des complexités qu'on ne rencontre pas avec les autres distributions. Lorsque les développeurs et contributeurs Gentoo ont découvert ces complexités, ils ont écrit des outils permettant de les contourner. Plusieurs de ces outils ont été intégrés au projet Gentoo et font partie du paquet app-portage/gentoolkit.
Note : Il existe à l'heure actuelle deux versions de gentoolkit : app-portage/gentoolkit et app-portage/gentoolkit-dev. La première contient des scripts servant à l'administration système alors que la seconde rassemble des scripts facilitant le développement de Gentoo. Si vous êtes développeur, vous pouvez inclure votre script à gentoolkit-dev en contactant le mainteneur de Gentoolkit. Ce document ne traitera que de Gentoolkit. |
Gentoolkit contient un bon nombre d'outils qui vous aideront à gérer vos paquets et à garder la trace de ce qui se passe sur votre système. La plupart des utilisateurs (et plus particulièrement ceux qui mettent à jour leur système fréquemment) trouveront gentoolkit utile.
Comme pour n'importe quel paquet Gentoo, l'installation ne nécessite qu'une commande :
Exemple de code 1.1 : Installer gentoolkit |
# emerge gentoolkit
|
Note : Plusieurs outils de gentoolkit révèlent des informations importantes sur votre système ou requièrent les privilèges du super-utilisateur (root). Pour ces raisons, certains de ces programmes ne peuvent être exécutés que par un utilisateur disposant des permissions root alors que d'autres ne fonctionneront correctement que s'ils sont exécutés par un utilisateur disposant de ces permissions. |
Toute documentation relative à un programme gentoolkit (à part les pages man) se trouve dans /usr/share/doc/gentoolkit-[version]/[program-name]/.
L'outil equery est un outil qui montre de nombreuses informations utiles à propos des paquets présents sur votre système et plus encore. La commande equery --help vous donnera la liste complète des options.
Note : Les fonctionnalités listées par equery --help ne sont pas toutes implémentées pour l'instant. Celles qui ne le sont pas sont clairement indiquées comme telles. Vous remarquerez également que toutes les commandes disposent d'une option courte, comme par exemple b à la place de belongs. |
Note : De plus, vous devez savoir qu'actuellement le format de sortie n'est pas le même si vous envoyez les données à travers un pipe ou non. Le format en pipe a été simplifié pour être plus facile à manipuler avec des outils classiques. Vous pouvez cependant empêcher cette simplification en ajoutant l'option --no-pipe. Si vous écrivez des scripts qui utilisent equery, vous devrez alors vous tenir au courant des changements de format. |
Trouver de quel paquet provient un fichier
equery permet également de trouver le paquet auquel un fichier appartient en utilisant la commande belongs (ou plus simplement b).
Exemple de code 2.1 : Trouver l'ebuild ayant installé un certain fichier |
# equery belongs /usr/bin/audacious
[ Searching for file(s) /usr/bin/audacious in *... ]
media-sound/audacious-1.1.2 (/usr/bin/audacious)
|
En utilisant l'option -f vous pouvez chercher les paquets installant des fichiers correspondant à une expression régulière. L'option -e est utile pour terminer la recherche immédiatement après avoir trouvé une réponse.
Vérifier l'intégrité d'un paquet
Il est parfois utile de vérifier l'intégrité d'un paquet. equery peut vérifier la somme md5 ainsi que la marque horaire d'un paquet pour indiquer s'il a été corrompu, remplacé ou enlevé.
Exemple de code 2.2 : Intégrité correcte d'un paquet |
# equery check gentoolkit
[ Checking app-portage/gentoolkit-0.2.0 ]
* 54 out of 54 files good
|
Vous remarquerez que si vous changez des fichiers de configuration après l'installation, ils seront probablement rapportés comme « not good », soit incorrects.
Lister tous les paquets dépendant de...
equery est capable de lister toutes les dépendances directes d'un paquet. Nous utiliserons pour cela la fonction depends et son utilisation est simple :
Exemple de code 2.3 : Chercher les paquets dépendant de pygtk |
# equery depends pygtk
[ Searching for packages depending on pygtk... ]
app-office/dia-0.93
dev-python/gnome-python-2.0.0-r1
gnome-extra/gdesklets-core-0.26.2
media-gfx/gimp-2.0.4
x11-libs/vte-0.11.11-r1
|
equery est capable de vous donner un graphe des dépendances pour un paquet donné. Le graphe de dépendances liste tous les paquets qui ont une dépendance directe ou indirecte pour le paquet en question.
Exemple de code 2.4 : Graphe de dépendances pour cdrtools |
# equery depgraph cdrtools
Displaying dependencies for app-cdr/cdrtools-2.01_alpha37
`-- app-cdr/cdrtools-2.01_alpha37
`-- sys-libs/glibc-2.3.4.20040808 (virtual/libc)
`-- sys-kernel/linux-headers-2.4.22 (virtual/os-headers)
`-- sys-apps/baselayout-1.10.4
`-- sys-apps/sysvinit-2.85-r1
`-- sys-apps/gawk-3.1.3-r1
`-- sys-apps/util-linux-2.12-r4
`-- sys-apps/sed-4.0.9
`-- sys-libs/ncurses-5.4-r4
`-- sys-apps/pam-login-3.14
`-- sys-libs/pam-0.77-r1
`-- sys-libs/cracklib-2.7-r10
`-- sys-apps/miscfiles-1.3-r1
`-- app-arch/gzip-1.3.5-r1
`-- sys-apps/portage-2.0.50-r10
|
Par exemple, si glibc est une dépendance directe pour cdrtools, linux-headers n'est qu'une dépendance indirecte. Remarquez que la sortie donne également des informations sur les paquets virtuels. Dans l'exemple ci-dessus, cdrtools est en fait écrit comme nécessitant virtual/libc et non sys-libs/glibc. Mais dans l'exemple donné, le paquet virtuel virtual/libc sera satisfait grâce à l'installation de sys-libs/glibc.
Lister les fichiers appartenant à un ebuild
equery peut lister les fichiers qui appartiennent à un ebuild installé. Si vous ne savez pas quels fichiers ont été installés par Gentoolkit sur le système, vous pourrez utiliser equery pour les obtenir.
Exemple de code 2.5 : Lister les fichiers de Gentoolkit |
# equery files gentoolkit
[ Searching for packages matching gentoolkit... ]
app-portage/gentoolkit-0.2.0
* Contents of app-portage/gentoolkit-0.2.0:
/usr
/usr/bin
/usr/bin/equery
/usr/bin/etcat
/usr/bin/euse
/usr/bin/glsa-check
/usr/bin/qpkg
/usr/bin/revdep-rebuild
/usr/lib
/usr/lib/gentoolkit
/usr/lib/gentoolkit/pym
/usr/lib/gentoolkit/pym/gentoolkit
/usr/lib/gentoolkit/pym/gentoolkit/__init__.py
/usr/lib/gentoolkit/pym/gentoolkit/gentoolkit.py
/usr/lib/gentoolkit/pym/gentoolkit/pprinter.py
/usr/lib/gentoolkit/pym/glsa.py
/usr/sbin
/usr/share
/usr/share/doc
/usr/share/doc/gentoolkit-0.2.0_pre10
[...]
|
La commande files de equery propose quelques options pour modifier la sortie. Vous pouvez y jeter un œil en lisant la page de manuel de equery.
Chercher les paquets qui utilisent une option USE spécifique
Si vous souhaitez trouver quels paquets sur votre système peuvent utiliser une option USE bien précise, equery dispose de la fonction hasuse.
Exemple de code 2.6 : Chercher les paquets qui utilisent l'option USE firefox |
# equery hasuse firefox
[ Searching for USE flag firefox in all categories among: ]
* installed packages
[I--] [ ] dev-python/gnome-python-extras-2.14.0-r1 (0)
[I--] [ ] media-video/totem-2.16.4 (0)
|
equery dispose d'un outil puissant permettant de lister les paquets appartenant à notre système, à Portage ou même à un « overlay ». Nous allons l'essayer :
Exemple de code 2.7 : Lister les paquets avec equery |
# equery list gentoolkit
[ Searching for package 'gentoolkit' in all categories among: ]
* installed packages
[I--] [ ] app-portage/gentoolkit-0.2.0 (0)
|
La recherche standard cherchera parmi les paquets installés un nom donné. S'il est trouvé, les informations suivantes seront retournées : l'état du paquet sur le système dans les premiers crochets (I pour les paquets Installés, P pour Portage et O pour Overlay), les masques possibles dans les seconds (~ par mot-clef, - par architecture ou M pour Masqué en dur), puis la catégorie, le nom complet et enfin le SLOT dans lequel le paquet est mis.
Dans cet autre exemple, nous allons utiliser des options locales pour chercher des paquets dans notre arbre de Portage et dans l'overlay.
Exemple de code 2.8 : Utilisation d'options locales avec equery |
# equery list -p -o vim
[ Searching for package 'vim' in all categories among: ]
* installed packages
[I--] [ ] app-editors/vim-6.3-r4 (0)
* Portage tree (/usr/portage)
[-P-] [M~] app-editors/vim-7.0_alpha20050126 (0)
[-P-] [M~] app-editors/vim-7.0_alpha20050201 (0)
[-P-] [ ] app-editors/vim-6.3-r2 (0)
[-P-] [M~] app-editors/vim-7.0_alpha20050122 (0)
[-P-] [M~] app-editors/vim-core-7.0_alpha20050126 (0)
[-P-] [ ] app-editors/vim-core-6.3-r3 (0)
[-P-] [M~] app-editors/vim-core-7.0_alpha20050122 (0)
[-P-] [M~] app-editors/vim-core-7.0_alpha20050201 (0)
[-P-] [ ] app-editors/vim-core-6.3-r4 (0)
* overlay tree (/opt/ebuilds)
|
Vous êtes-vous déjà demandé quel espace disque occupe un de vos paquets ? Puisqu'un paquet peut installer des fichiers dans plus d'un répertoire, la commande habituelle du -hc ne vous renseignera pas correctement. Pas d'inquiétude, equery est là pour vous aider !
Exemple de code 2.9 : Obtenir la taille d'un paquet |
# equery size openoffice-bin
* app-office/openoffice-bin-1.1.2
Total Files : 2908
Total Size : 223353.31 KiB
|
Comme vous pouvez le voir, equery donne à la fois l'espace disque total occupé en kilo octets et le nombre de fichiers du paquet.
Liste des options USE d'un paquet
equery peut être utilisé pour obtenir de l'information sur les options USE utilisées par un paquet donné. Il vous indiquera les options USE utilisées lors de l'installation du paquet, et aussi toutes les options USE disponibles pour ce paquet.
Exemple de code 2.10 : Paramétrer les options USE |
# equery uses wireshark
[ Colour Code : set unset ]
[ Legend : (U) Col 1 - Current USE flags ]
[ : (I) Col 2 - Installed With USE flags ]
U I [ Found these USE variables in : net-analyzer/wireshark-0.99.4 ]
- - adns : Adds support for the adns DNS client library
+ + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit)
- - ipv6 : Adds support for IP version 6
- - kerberos : Adds kerberos support
- - portaudio : Adds support for the crossplatform portaudio audio API
- - selinux : !!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur
- - snmp : Adds support for the Simple Network Management Protocol if available
+ + ssl : Adds support for Secure Socket Layer connections
- - threads : Adds threads support for various packages. Usually pthreads
|
On constate dans l'exemple précédent que seules les options USE gtk et ssl étaient actives lorsque j'ai installé wireshark, mais qu'il y a plusieurs autres options USE qui peuvent être utilisées par ce paquet. Pour en savoir plus sur les options USE, consultez le chapitre La variable USE du Manuel Gentoo.
equery peut également être utilisé pour trouver l'ebuild associé à un paquet donné. Pour ce faire, utilisez la commande equery which qui donne le chemin d'accès complet de l'ebuild en question.
Exemple de code 2.11 : Afficher le chemin d'accès d'un ebuild |
# equery which cdrtools
/usr/portage/app-cdr/cdrtools/cdrtools-2.01_alpha37.ebuild
|
L'outil euse sert à consulter la variable USE et à ajouter et retirer des options à cette variable, et ce à différents endroits sur votre système. Pour plus d'informations sur les options USE, consultez le chapitre La variable USE du Manuel Gentoo. Utilisez euse -h pour obtenir une aide complète et toutes les options de euse.
Consulter, ajouter et retirer des paramètres USE
La commande euse -a lit la configuration actuelle des options USE actives et les affiche.
Note : euse utilise désormais cinq colonnes pour montrer si une option est activée ou non et où cette option a été activée. Les colonnes sont précisées comme suit : +/-, activé dans l'Environnement, activée dans make.Conf, activée dans make.Defaults, et dans make.Globals. La sortie ressemble à [+ECDG]. |
Exemple de code 3.1 : Consulter toutes les options USE actives |
# euse -a
X [+ 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 ]
|
Vous pouvez aussi utiliser la commande euse -a -g pour ne consulter que les options USE globales actives. La commande euse -a -l permet d'obtenir la même chose pour les options USE locales actives. -g et -l sont des sous-options de euse et nécessitent une option donnée auparavant (comme -a) pour fonctionner correctement.
Exemple de code 3.2 : Consulter les options USE locales actives |
# euse -a -l
bitmap-fonts [+ D ]
font-server [+ D ]
fortran [+ D ]
gimpprint [+ C ]
md5sum [+ C ]
mpeg4 [+ C ]
nvidia [+ C ]
offensive [+ ]
truetype [+ CD ]
|
On peut également utiliser euse pour activer ou désactiver des options USE. Les commandes à utiliser sont euse -E option (activer une option) et euse -D option (désactiver une option).
Attention : N'utilisez pas les commandes euse -E et euse -D sans préciser d'options USE sinon cela activera/désactivera TOUTES les options USE dans /etc/make.conf. Même si une sauvegarde est créée sur /etc/make.conf.euse_backup, faites attention en utilisant euse -E ou euse -D. |
Exemple de code 3.3 : Activer et désactiver des options USE |
(Activer une option USE) # euse -E 3dfx /etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup (/etc/make.conf après la commande) USE="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" (Désactiver une option USE) # euse -D 3dfx /etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup (/etc/make.conf après la commande) USE="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" |
Note : euse ne supprime pas réellement les options de make.conf ; il les préfixe simplement avec - (moins) afin de les désactiver. Vous souhaiterez peut-être nettoyer manuellement votre make.conf pour retirer les options non désirées. |
Cet outil est le « reconstructeur des dépendances inverses » de Gentoo. Il examine les ebuilds 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.
Exemple de code 4.1 : Exécuter revdep-rebuild en mode « pretend » |
# revdep-rebuild -p
Checking reverse dependencies...
Packages containing binaries and libraries broken by any package update,
will be recompiled.
Collecting system binaries and libraries... done.
(/root/.revdep-rebuild.1_files)
Collecting complete LD_LIBRARY_PATH... done.
(/root/.revdep-rebuild.2_ldpath)
Checking dynamic linking consistency...
broken /usr/lib/ao/plugins-2/libarts.so (requires libartsc.so.0)
broken /usr/lib/kde3/libkpresenterpart.so (requires libartskde.so.1 libqtmcop.so.1
libsoundserver_idl.so.1 libkmedia2_idl.so.1 libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
broken /usr/lib/ruby/site_ruby/1.8/i686-linux/fox.so (requires libFOX-1.0.so.0)
broken /usr/lib/xine/plugins/1.0.0/xineplug_ao_out_arts.so (requires libartsc.so.0)
broken /usr/lib/perl5/vendor_perl/5.8.0/i686-linux/auto/SDL_perl/SDL_perl.so (requires libSDL_gfx.so.0)
broken /usr/lib/libloudmouth-1.so.0.0.0 (requires libgnutls.so.10)
broken /usr/bin/k3b (requires libartskde.so.1 libqtmcop.so.1 libsoundserver_idl.so.1 libkmedia2_idl.so.1
libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
broken /usr/bin/lua (requires libhistory.so.4)
broken /usr/bin/lyx (requires libAiksaurus-1.0.so.0)
broken /usr/bin/luac (requires libhistory.so.4)
broken /usr/bin/avidemux2 (requires libartsc.so.0)
broken /usr/bin/pptout (requires libxml++-0.1.so.11)
broken /usr/bin/xml2ps (requires libxml++-0.1.so.11)
done.
(/root/.revdep-rebuild.3_rebuild)
Assigning files to ebuilds... done.
(/root/.revdep-rebuild.4_ebuilds)
Evaluating package order... done.
(/root/.revdep-rebuild.5_order)
All prepared. Starting rebuild...
emerge --oneshot --nodeps -p =app-cdr/k3b-0.11.14 =app-office/koffice-1.3.2 =app-office/lyx-1.3.4 \
=app-office/passepartout-0.2 =dev-lang/lua-5.0.2 =dev-ruby/fxruby-1.0.29 =media-libs/libao-0.8.5 \
=media-libs/xine-lib-1_rc5-r3 =media-video/avidemux-2.0.26 =net-libs/loudmouth-0.16
These are the packages that I would merge, in order:
Calculating dependencies ...done!
[ebuild R ] app-cdr/k3b-0.11.14
[ebuild R ] app-office/koffice-1.3.2
[ebuild R ] app-office/lyx-1.3.4
[ebuild R ] app-office/passepartout-0.2
[ebuild R ] dev-lang/lua-5.0.2
[ebuild R ] dev-ruby/fxruby-1.0.29
[ebuild R ] media-libs/libao-0.8.5
[ebuild R ] media-libs/xine-lib-1_rc5-r3
[ebuild R ] media-video/avidemux-2.0.26
[ebuild R ] net-libs/loudmouth-0.16
Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.
|
Si vous devez reconstruire certains paquets, vous pouvez exécuter revdep-rebuild sans l'option -p. Tous les paquets listés seront réinstallés.
glsa-check sert essentiellement à garder un œil sur les GLSA (les Recommandations Gentoo Linux sur la sécurité, en anglais « Gentoo Linux Security Advisories »). Les fonctions de glsa-check seront incorporées à emerge et equery plus tard. Pour plus d'informations, visitez la page Portage GLSA Integration (en anglais).
eread est un utilitaire simple qui vous permet de lire les fichiers elog produits par >=portage-2.1. Pour activer l'enregistrement des fichiers elog, paramétrez quelques variables dans votre fichier /etc/make.conf :
Exemple de code 4.2 : Activer elog dans /etc/make.conf |
PORTAGE_ELOG_CLASSES="log" PORTAGE_ELOG_SYSTEM="save" |
Note : 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 du Manuel de Portage. |
Une fois qu'elog est configuré aux petits ognons, lancez simplement eread pour visualiser les fichiers d'historique.
Exemple de code 4.3 : Utiliser eread |
$ eread
This 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ée.
Après avoir vu le fichier, on vous demandera si vous voulez le supprimer.