Gentoolkit/fr

Gentoolkit est une suite d'outils destinée à faciliter l'administration d'un système Gentoo. Ce document couvre les bases de quelques uns des outils présents dans cette boîte à outils.

Qu'est-ce que le Gentoolkit?
Gentoo est une distribution unique en son genre et présente quelques 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.

Gentoolkit contient tout un ensemble d'outils utiles 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é.

Installation
Comme pour tout paquet Gentoo, l'installation fait appel à une simple commande emerge.

Trouver de la documentation
Toute la documentation dont un outil dispose (autre que les pages de manuel) se trouve dans.

Introduction
est un outil qui affiche des informations utiles à propos des paquets sur votre système. est basé sur un système de modules. Chaque module possède un nom abrégé. Par exemple,  équivaut à code>equery list gcc. explique les options globales et liste tous les modules disponibles et leur nom abrégé. affiche un écran d'aide pour le module nom_module. Pour finir,  procure une explication détaillée sur tous les modules et options disponibles, ainsi que des exemples.

Ci-dessous se trouve une lise des fonctionnalités qui fonctionnent sur la majorité des modules.

Tout comme emerge, equery ne comprend pas les noms partiels de paquet :

À l'inverse d'emerge, equery peut accepter des passe-partout similaires à ceux du shell dans les noms de catégorie et/ou de paquet :

La plupart des modules d'equery accepte des entrées multiples :

Quelques modules acceptent également les expressions régulières :

Les quelques sections qui suivent introduisent rapidement les différents modules de.

Trouver de quel paquet provient un fichier avec le module belongs (b)
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 correspondance. Comme il n'existe pas de fichier qui puisse avoir été installé par deux paquets, c'est là une optimisation sûre.

Retouver les entrées de journalisation concernant des changements avec le module changes (c)
vous permet de voir les entrées de journalisation correspondant à un changement de version (ou plage de versions) d'un paquet. Imaginez qu'après une commande, vous vous rendiez compte que Portage va être mis à jour et que vous vouliez savoir ce qui a changé :

Vérifier l'intégrité d'un paquet avec le module check (k)
Il est parfois utile de vérifier l'intégrité d'un paquet. equery peut vérifier la somme md5 ainsi que l'horodatage d'un paquet pour indiquer s'il a été corrompu, remplacé ou enlevé.

Lister tous les paquets dépendant d'un autre avec le module depends (d)
Vous vous demandez peut-être si un paquet donné est installé sur votre système ? equery est capable de vous donner les noms des paquets qui le listent en tant que dépendance directe. Il faut faire appel pour cela au module depends :

Obtenir le graphe de dépendances avec le module depgraph (g)
est le réciproque de. Vous lui donnez un paquet en paramètre, et il est capable de trouver les paquets dont il dépend et non pas ceux qui dépendent de lui ! Lorsqu'une dépendance est trouvée, il va rechercher, de manière récursive, tous les paquets dont ce dernier dépend. Il est possible de contrôler la profondeur de l'arbre avec l'option --.

Notez bien ici que  est une dépendance directe et que   est une dépendance indirecte si l'option   de la variable USE est validée.

Lister les fichiers appartenant à un paquet avec le module files (f)
peut lister les fichiers installés par un ebuild grâce au module  module. Utilisez l'option  pour obtenir une présentation de l'agencement des répertoires facile à lire. Utilisez l'option  pour vous limiter à un certain type de fichiers. Par exemple, pour savoir où ont été installés les exécutables, utilisez  ,et pour trouver rapidement l'emplacement des fichiers de configuration, essayez.

Chercher les paquets qui utilisent une option spécifique de USE avec le module hasuse (h)
Si vous souhaitez trouver quels paquets sur votre système peuvent utiliser une option USE bien précise,   dispose de la fonction. Ce module ne vous dira pas si l'option est activée, mais seulement si l'option peut être définie. Reportez-vous à la page de manuel de   pour plus de détail sur la manière d'obtenir cette information.

Lister les paquets avec le module list (l)
equery dispose d'un outil puissant permettant de lister les paquets installés sur votre système, dans l'arbre de Portage ou même dans un « arbre alternatif ».

La recherche standard cherchera parmi les paquets installés un nom donné. En donnant '*' tous les paquets du jeu seront listés. Dans le champ le plus à gauche, nous voyons que les paquets sont Installés et qu'ils proviennent de l'arbre de Portage. Ils ne sont pas masqués (le second champ est vide), ils sont tous installés dans le slot par défaut (0).

Dans cet exemple, nous allons utiliser des options locales pour chercher des paquets de notre arbre de Portage et dans les arbres alternatifs (overlays).

Dans cet exemple, vous pouvez voir que la version 7.2.182 est installée et qu'aucune version n'est disponible depuis un arbre alternatif. Vous pouvez aussi voir quelles versions sont masquées par un mot clé sous la forme d'un  dans le deuxième champ.

Voir les Méta-données d'un paquet avec le module meta (m)
Tout paquet de l'arbre Portage fournit au moins quelques méta-données sur qui est chargé de sa maintenance, le herd auquel il appartient, etc. Reportez-vous, pour plus de détails, à Gentoo Metadata. La quantité d'informations utiles dépend du bon vouloir de ses mainteneurs. Sans option,  retourne quelques informations de base.

Lorsque les mainteneurs fournissent des informations supplémentaires, elles peuvent s'avérer très utiles :

Trouver la taille d'un paquet avec le module size (s)
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  ne vous renseignera pas correctement. Pas d'inquiétude,   est là pour vous aider !

Comme vous pouvez le voir,   donne à la fois l'espace disque total occupé en kilooctets et le nombre de fichiers du paquet. Pour avoir la taille totale en octets, utilisez.

Liste des options de USE d'un paquet avec le module uses (u)
Le module  de   peut être utilisé pour obtenir de l'information sur les options de la variable USE utilisées par un paquet donné. Il vous indiquera le positionnement des options de la variable USE utilisées lors de l'installation du paquet, et aussi toutes les options de la variable USE disponibles pour ce paquet.

Dans l'exemple précédent, vous pouvez voir que certaines options de la variable USE sont activées pour le module d'extension , mais également que d'autres options sont disponibles. Pour en savoir plus sur les options de la variable USE, consultez le chapitre La variable USE du Manuel Gentoo.

Trouver où se trouve un ebuild avec le module which (w)
est un simple script qui vous aide à trouver rapidement le chemin vers un ebuild. Si vous passez un nom de paquet sans version,   retourne le chemin vers la version installable de l'ebuild la plus récente. En d'autres termes, l'ebuild que Portage utiliserait si vous tapiez. Donnez un nom de paquet avec version pour obtenir le chemin vers cet ebuild.

En dernier recours, si aucune des fonctionnalités de   ne répond à votre interrogation, essayez   pour rechercher manuellement un ebuid avec des programmes tels que ,   ou  :

Introduction
sert à voir, activer et désactiver les options de la variable USE en différents endroits. Pour plus d'information sur les options de la variable USE, reportez-vous à La variable USE. Consultez  pour obtenir une aide complète et et toutes les options de.

Consulter, activer et désactiver des options de la variable USE
La commande   lit la configuration actuelle des options activées de la variable USE et les affiche.

Vous pouvez aussi utiliser la commande  pour ne consulter que les options globales de la variable USE qui sont activées. La commande   permet d'obtenir la même chose pour les options locales de la variable USE. -g et -l sont des sous-options de  et nécessitent une option donnée auparavant (comme  ) pour fonctionner correctement.

On peut également utiliser   pour activer ou désactiver des options de USE. Les commandes à utiliser sont  (activer une option) et    (désactiver une option).

Activer une option de la variable USE :

Le fichier ressemble à ceci après exécution de la commande :

Désactiver une option de la variable USE :

De nouveau, le fichier  après la commande :

revdep-rebuild
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  pour consulter la liste des paquets qui seront installés avant de procéder.

Si vous devez reconstruire certains paquets, vous pouvez exécuter  sans l'option. Tous les paquets listés seront réinstallés.

glsa-check
sert à garder un œil sur les GLSA (Gentoo Linux Security Advisories ou encore Recommandations Gentoo Linux sur la sécurité, en français). Les fonctions de glsa-check seront incorporées à  et. plus tard.

eread
est un utilitaire simple qui vous permet de lire les fichiers elog produits par. Pour activer l'enregistrement des fichiers elog, paramétrez quelques variables dans votre fichier :

Une fois qu'elog est configuré à votre convenance, lancez simplement  pour visualiser les fichiers d'historique.

Select a number and the file will be displayed using the paging program specified in the PAGER environment variable. If PAGER is not set, it will use. The PAGER environmental variable can be set using  (module  ).

Après avoir vu le fichier, on vous demandera si vous voulez le supprimer.

eclean
est un outil de nettoyage pour retirer les fichiers sources ou binaires inutiles sur votre système.

When you build and install packages, the source files are downloaded and preserved in DISTDIR, usually. This can accumulate several gigabytes of material over time if you don't clean it periodically. You can run  to clean only source files from DISTDIR.

Vous pouvez créer des archives à partir des paquets installés en utilisant  ou FEATURES="buildpkg". Ces archives sont conservées dans PKGDIR, ordinairement. Quand vous n'avez plus besoin de les conserver à portée, ou s'ils sont devenus trop vieux, vous pouvez utiliser  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.

For more information on  and tips on maintaining a cruft-free system, please read   or check the eclean article.

Remerciements
Nous tenons à remercier les auteurs et éditeurs suivants pour leur contribution à ce guide :


 * Matt Butcher
 * John P. Davis
 * Erwin
 * Shyam Mani
 * Xavier Neys
 * Karl Trygve
 * José Luis Rivero
 * Joshua Saddler
 * Douglas Anderson