Introduction

Introduction @@ -54,8 +63,10 @@ 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. Le présent -document ne discutera que de gentoolkit. +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.

@@ -115,19 +126,256 @@ epm (et par l'outil qpkg maintenant obsolète) tout en ajoutant ses propres fonctions qui le rendent particulièrement utile. equery --help vous donnera la liste complète des options. À terme, equery -remplacera complètement etcat. +pourrait remplacer complètement etcat.

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. +indiquées comme telles. Vous remarquerez également que toutes les commandes +disposent d'une option courte, comme par exemple b à la place de +belongs. + +Vous devez savoir de plus 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 mais +est peu populaire et sera probablement modifié dans le futur. Si vous écrivez +des scripts utilisant equery vous devez vous tenir au courant des changements. + + + + +

+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). +

+ +

+# equery belongs /usr/bin/xmms
+[ Searching for file(s) /usr/bin/xmms in *... ]
+media-sound/xmms-1.2.10-r9 (/usr/bin/xmms)
+

+ +

+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é. +

+ +

+# equery check gentoolkit
+[ Checking app-portage/gentoolkit-0.2.0 ]
+ * 54 out of 54 files good
+

+ +

+Vous remarquerez que si vous chanez des fichiers de configuration après +l'installation ils seront probablement rapportés comme « not good », +soit incorrects. +

-Obtenir la taille d'un paquet +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 : +

+ +

+# 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
+

+ + +

+Graphes de dépendances + + +

+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. +

+ +

+# 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 indique é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é isntallés par Gentoolkit sur le +système vous pourrez utiliser equery pour les obtenir. +

+ +

+# 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 utilisant une option USE spécifique + + +

+Si vous souhaitez trouver quels paquets sur votre système peuvent utiliser une +option USE bien précis, equery dispose de la fonction hasuse. +

+ +

+# equery hasuse mozilla
+[ Searching for USE flag mozilla in all categories among: ]
+ * installed packages
+[I--] [  ] dev-java/blackdown-jre-1.4.2.01 (1.4.2)
+[I--] [  ] mail-client/evolution-2.0.2 (2.0)
+

+ + +

+Lister les paquets + + +

+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 : +

+ +

+# 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-clefs, - par architectures ou M pour Masqués en dur), puis la catégorie et +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. +

+ +

+# 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)
+

+ + +

+Trouver la taille d'un paquet

@@ -204,43 +452,6 @@ # equery which cdrtools /usr/portage/app-cdr/cdrtools/cdrtools-2.01_alpha37.ebuild - - -

-Graphe des dépendances - - -

-Grâce à equery, vous pouvez afficher un graphe des dépendances d'un -paquet. Ce graphe contient tous les paquets qui sont des dépendances directes -ou indirectes du paquet donné. -

- -

-# 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
-

- -

-Dans l'exemple précédent, on voit que glic est une dépendance directe de -cdrtools alors que linux-headers est une dépendance indirecte. -