Gentoo Logo

Portage-utils

Table des matières :

1.  Introduction

portage-utils est une série d'outils très efficaces écrits en C qui ont été conçus dans le but d'offrir une alternative plus rapide, mais avec moins de fonctionnalités, à gentoolkit. Notez que portage-utils n'a pas pour but de remplacer gentoolkit. En effet, les outils de portage-utils sont plus efficaces et mieux conçus que leurs homologues de gentoolkit pour une utilisation dans des scripts appelant souvent Portage, mais n'offrent pas les mêmes fonctionnalités : ils ne prennent pas en compte les eclass et ne fournissent pas d'équivalent à revdep-rebuild et glsa-check.

Vous pouvez trouver plus d'informations sur gentoolkit dans le guide de Gentoolkit.

Vous pouvez obtenir la liste complète des applications de portage-utils en tapant man q ou q --help. Lisez la page du manuel correspondant à chaque outil avant de l'utiliser. Ce guide n'est qu'un bref aperçu des fonctions les plus utiles et ne couvre pas en totalité chacun des outils.

Première étape, pour utiliser portage-utils, installer son paquet :

Exemple de code 1.1 : installer portage-utils

# emerge portage-utils

2.  Utilisation

Trouver à quel paquet appartient un fichier

qfile trouve le paquet auquel un fichier appartient :

Exemple de code 2.1 : trouver à quel paquet un fichier appartient

$ qfile /etc/fonts/fonts.conf
media-libs/fontconfig (/etc/fonts/fonts.conf)
$ qfile /usr/share/keymaps/atari/atari-uk-falcon.map.gz
sys-apps/kbd (/usr/share/keymaps/atari/atari-uk-falcon.map.gz)

Vérifier l'intégrité d'un paquet

Si vous voulez vérifier les sommes MD5 ou mtimes des fichiers installés par un paquet, vous pouvez utiliser l'outil qcheck :

Exemple de code 2.2 : vérifier l'intégrité d'un paquet

$ qcheck portage-utils
Checking app-portage/portage-utils-0.1.13 ...
  * 36 out of 36 files are good

Bien entendu, tout fichier modifié après l'installation sera signalé, mais il n'y pas d'inquiétude à avoir si qcheck vous signale un fichier de configuration que vous avez édité après l'installation.

Lister les dépendances d'un paquet

portage-utils fournit également un outil qui permet de lister toutes les dépendances d'un paquet. C'est outil est qdepends. Utilisez le paramètre -a pour afficher les informations DEPEND, RDEPEND et PDEPEND d'un paquet.

Exemple de code 2.3 : lister les dépendances d'un paquet

$ qdepends -a pygtk
 * DEPEND
dev-python/pygtk-2.8.2: >=dev-lang/python-2.3 >=x11-libs/gtk+-2.8.0
>=dev-libs/glib-2.8.0 >=x11-libs/pango-1.10.0 >=dev-libs/atk-1.8.0
>=gnome-base/libglade-2.5.0 >=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl >=x11-libs/gtkglarea-1.99
>=dev-util/pkgconfig-0.9 sys-devel/patch
 * RDEPEND
dev-python/pygtk-2.8.2: >=dev-lang/python-2.3 >=x11-libs/gtk+-2.8.0
>=dev-libs/glib-2.8.0 >=x11-libs/pango-1.10.0 >=dev-libs/atk-1.8.0
>=gnome-base/libglade-2.5.0 >=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl >=x11-libs/gtkglarea-1.99
 * PDEPEND

Lister les fichiers qui appartiennent à un ebuild

qlist vous donne la liste des fichiers qui appartiennent à un ebuild.

Exemple de code 2.4 : lister les fichiers qui appartiennent à un ebuild

$ qlist vim
/usr/bin/gvim
/usr/bin/gvimdiff
/usr/bin/evim
/usr/bin/eview
/usr/bin/gview
/usr/bin/rgvim
[...]

Rechercher les paquets qui utilisent une option donnée de la variable USE

Il faut pour cela utiliser quse en tant que root. Cela peut prendre un certain temps puisqu'il faut d'abord créer ou mettre à jour le cache de l'ebuild.

Exemple de code 2.5 : chercher les paquets utilisant l'optiom 'firefox' de la variable USE

# quse firefox
app-misc/tracker/tracker-0.12.10-r1.ebuild applet doc eds elibc_glibc exif firefox-bookmarks flac flickr gif
[...]

Obtenir la taille d'un paquet

Il faut utiliser l'outil qsize :

Exemple de code 2.6 : trouver la taille d'un paquet

$ qsize vim
app-editors/gvim-6.4: 10 files, 7 non-files, 2327.516 KB
app-editors/vim-6.4: 6 files, 2 non-files, 2058.14 KB
app-editors/vim-core-6.4: 1024 files, 68 non-files, 10950.984 KB
[...]

Interroger l'arbre Portage

Un des outils les plus puissants de portage-utils est qsearch. Il vous permet de faire une recherche dans l'arbre Portage beaucoup plus rapidement qu'avec la commande par défaut emerge -s.

Voici quelques exemples de son utilisation :

Exemple de code 2.7 : utiliser qsearch pour interroger l'arbre

(J'ai oublié le nom du paquet contenant mes polices préférées.)
$ qsearch terminus
media-fonts/terminus-font A clean fixed font for the console and X11

(Je veux remercier la personne qui les a créées. Quelle est l'adresse de son site personnel ?)
$ qsearch -H terminus
media-fonts/terminus-font http://www.is-vn.bg/hamster/jimmy-en.html

(J'ai besoin d'un client jabber, c'est urgent.)
$ qsearch -S "jabber client"
app-emacs/emacs-jabber A Jabber client for Emacs.
net-im/gajim Jabber client written in PyGTK
net-im/gnome-jabber Gnome Jabber Client
net-im/gossip Lightweight Jabber client for GNOME
net-im/imcom Python commandline Jabber Client
net-im/psi QT 3.x Jabber Client, with Licq-like interface
net-im/tkabber Featureful Jabber client for tcl/tk.
x11-themes/psi-themes Iconsets for Psi, a QT 3.x Jabber Client

Extraire des informations des journaux d'installation

L'outils qui vous permet d'extraire de très intéressantes informations du fichier emerge.log s'appelle qlop. Il peut être utile pour estimer le temps de compilation d'un paquet ou pour comparer votre temps à celui que met l'ordinateur de vos amis. Il vous permet également de connaître quel paquet est en train d'être compilé et quel est le temps restant - ce qui est bien pratique lorsque vous travaillez à partir de la console et que vous n'avez par conséquent aucun autre moyen de connaître cette information.

Exemple de code 2.8 : lire les journaux d'installation avec qlop

(Je commence l'installation de perl et je veux connaître combien de temps cela me prendra.)
$ qlop -tH perl
perl: 7 minutes, 52 seconds for 4 merges
(Voyons maintenant quelle installation est en cours.)
$ qlop -c
* perl-5.8.8-r23
    started: Mon May 21 12:41:11 2007
    elapsed: 19 seconds


Imprimer

Dernière mise à jour le 13 janvier 2013

La version originale de cette traduction n'est plus maintenue

Résumé : Ce guide traite quelques usages courants de portage-utils, une série d'outils écrits en C pour faciliter et accélérer l'utilisation de Portage.

Łukasz Damentko
Auteur

Joshua Saddler
Correcteur

Marcelo Góes
Correcteur

Guillaume Bouzillé
Traducteur

José Fournier
Traducteur

Donate to support our development efforts.

Copyright 2001-2014 Gentoo Foundation, Inc. Questions, Comments? Contact us.