Gentoolkit/es

Gentoolkit es un conjunto de herramientas que facilitan la administración de un sistema Gentoo. Este documento cubre las acciones básicas de algunas de las herramientas que ofrece Gentoolkit.

¿Qué es Gentoolkit?
Gentoo es una distribución única y presenta algunas complejidades que simplemente no se presentan en otras distribuciones. A medida que los desarrolladores y colaboradores de Gentoo descubrían algunas de estas complejidades, escribieron herramientas para ayudar a usuarios y administradores a resolverlas. Muchas de estas herramientas se han escrito para el proyecto Gentoo y se incluyen en el paquete.

Gentoolkit contiene un amplio conjunto de herramientas útiles para ayudar a administrar los paquetes y seguirle la pista a lo que ocurre en su sistema. La mayoría de usuarios, particularmente aquellos que a menudo actualizan sus sistemas, se beneficiarán de la instalación de gentoolkit.

Instalación
Como para cualquier paquete de Gentoo, la instalación consiste en un simple emerge.

Encontrar documentación
Cualquier documentación que un programa debe tener (aparte de las páginas del manual) se almacena en.

Introducción
es una herramienta que muestra información de útil sobre los paquetes de su sistema. La herramienta  está basada en un sistema de módulos. Cada módulo tiene un nombre corto. Por ejemplo,  es lo mismo que. La orden  muestra las opciones globales y lista todos los módulos disponibles y sus nombres cortos. La orden equery --help module mostrará la pantalla de ayuda para un módulo en particular. Por último,  ofrece una explicación detallada de todos los módulos y opciones disponibles a la vez que ofrece ejemplos útiles.

Abajo se muestra una lista de características que funcionan en la mayoría de los módulos.

Al igual que emerge, equery no comprende los nombres parciales de paquetes:

Al contrario que emerge, equery acepta caracteres comodín en el nombre del paquete o de la categoría:

La mayoría de los módulos de equery aceptan múltiples parámetros:

Algunos módulos también permiten expresiones regulares completas:

La siguientes secciones de este documento ofrecen una introducción breve a los diferentes módulos de.

Encontrar el paquete al que pertenece un fichero con "belongs" (b)
puede buscar ficheros que concuerden con una expresión regular usando la opción. La opción  detiene la búsqueda después de encontrar una coincidencia. Debido a que ningún fichero de su sistema puede pertenecer a más de un paquete, esto es una optimización segura.

Mostrar las entradas en ChangeLog con "changes" (c)
le permite mostrar las entradas del ChangeLog de la versión o rango de versiones de un paquete. Imagine que después de hacer  se da cuenta de que se va a actualizar Portage y quiere comprobar lo que ha cambiado:

Comprobar la integridad de los paquetes con "check" (k)
A veces es útil comprobar la integridad de un paquete. puede verificar sumas MD5 así como marcas de tiempo para indicar cuándo un paquete pudo haber sido corrompido, reemplazado o eliminado.

Listar todos los paquetes que dependen de cierto paquete X con "depends" (d)
¿Alguna vez se ha preguntado porqué cierto paquete se ha instalado en su sistema?. La orden  le puede mostrar qué paquetes muestran a ese paquete como dependencia usando el módulo. Se pueden incluir dependencias indirectas con la opción -D.

Obtener gráficos de dependencias con "depgraph" (g)
El módulo  es el opuesto a. Se le pasa un paquete y encontrará los paquetes de los que éste depende (no de los que dependen de él). Cuando encuentra una dependencia, se buscará recursivamente todas las dependencias de ese nuevo paquete. Se puede controlar lo profundo que debe ser el árbol usando la opción.

Observe que  es una dependencia directa y que   es una dependencia indirecta si el ajuste USE   está habilitado.

Listar los ficheros instalados por un paquete con "files" (f)
La orden  puede listar todos los ficheros instalados por un ebuild mediante el módulo. Pruebe con  para obtener un directorio con una disposición fácil de leer. Utilice para buscar únicamente un tipo de fichero. Por ejemplo, para encontrar el lugar donde se instalaron los ejecutables, utilice, y para encontrar rápidamente la localización de un fichero, pruebe con.

Buscar paquetes que tienen un determinado ajuste USE con "hasuse" (h)
Puede utilizar  para buscar los paquetes que tienen un determinado ajuste USE. El módulo  no le indicará si el ajuste USE está habilitado, únicamente si el ebuild lo muestra como opción. Mire la sección EXAMPLES de  en la página del manual de  para ver más formas de obtener esta información.

Listar paquetes con "list" (l)
El módulo  es simple aunque potente. Permite listar los paquetes que están instalados en el árbol Portage o en un overlay.

La consulta estándar buscará paquetes instalados con el nombre dado. Pasando un '*' se mostrarán todos los paquetes en el conjunto. En el campo más a la izquierda, podemos ver que los paquetes de arriba están nstalados desde el árbol  ortage. No están enmascarados (El segundo campo está en blanco), y se instalaron en la ranura (slot) por defecto (0).

Ahora, utilizaremos opciones locales para buscar paquetes en el árbol Portage y en los overlays.

In this example you can see version 7.2.182 is installed and there are no versions available from an overlay. You can see which versions are keyword masked by the  in the second field.

Viewing Package Metadata with meta (m)
Each package in the Portage tree provides at least some metadata about its maintainer, herd, etc. Read about Gentoo Metadata. The amount of useful information depends on how much package maintainers decide to provide. With no options,  returns some basic useful information.

When the maintainer provides extra information, it can be very useful:

Finding Package Sizes with size (s)
Have you ever been curious to find out how much space a specific package is occupying? Since a package could have its files over a number of directories, the usual  might not give you the correct figure. Not to worry, here comes  to the rescue!

As you can see,  prints the total space used in human-readable units and lists the total number of files the package has. To get the total size in bytes, use.

Listing Per-Package USE Flags with uses (u)
's  module can provide information about what USE flags are available for a specific package, and which of those flags is currently enabled.

Here, a number of USE flags are enabled in 's plugin meta-package, but you can see that there are other USE flags available. For more information on USE flags, please refer to the USE Flags chapter of the Gentoo Handbook.

Finding the Ebuild Path with which (w)
is a simple script to help you quickly find the file path to an ebuild. If you pass an unversioned package name,  will return the path to the newest installable ebuild version, in other words, the ebuild Portage would use if you typed. Pass in a versioned package to get the path to that ebuild.

Lastly, if none of the above features of  have answered your question, try using   to manually search an ebuild with programs like ,   or  :

Introduction
is a tool to see, set and unset USE flags at various places. For more information on USE flags, please refer to the USE Flags. Please see  for complete help and all options.

Viewing, Setting and Unsetting USE Flags
The  command reads the current active USE flags and displays them.

Similarly you can use the  command to only view active global USE flags. The  command does the same for active local USE flags. and  are suboptions to   and need an option before them (like  ) to function correctly.

We can also use  to set or unset use flags. The commands used for this are  (enable a flag) and   (disable a flag).

Enabling a USE Flag:

The file looks like so after the command was ran:

Disabling the USE Flag:

Again, the file after the command:

revdep-rebuild
This tool is Gentoo's Reverse Dependency rebuilder. It will scan your installed ebuilds to find packages that have become broken as a result of an upgrade of a package they depend on. It can emerge those packages for you but it can also happen that a given package does not work any more with the currently installed dependencies, in which case you should upgrade the broken package to a more recent version. revdep-rebuild will pass flags to emerge which lets you use the  flag to see what is going to be emerged again before you go any further.

If you need to rebuild some packages, you may run  without the   flag and the listed packages will be emerged again.

glsa-check
is mainly a test tool that keeps track of the various GLSA's (Gentoo Linux Security Advisory) and will eventually be integrated into  and.

eread
is a simple utility to display elog files produced by >=. You can set the saving of elog files by setting a couple of variables in :

Once you've set up elog to your satisfaction, just run  to view your log files.

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

After displaying the elog item, you will be prompted if you want to delete the file.

eclean
is a tool to remove old source files and old binary packages from your system.

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.

You can create archives of installed packages by using  or FEATURES="buildpkg". These archived packages are kept in PKGDIR, usually. When you no longer need to keep them around, or if they're too old, you can run  to remove them from PKGDIR. It's a good way to ensure that any binary packages you have are only the latest versions.

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

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


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