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

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.

En este ejemplo se puede comprobar que se ha instalado la versión 7.2.182 y que no hay versiones disponibles en el overlay. Se puede también observar qué versiones están enmascaradas por palabra clave comprobando el  en el segundo campo.

Mostrar los metadatos del paquete con "meta" (m)
Cada paquete del árbol Portage ofrece algún tipo de metadato sobre su mantenedor, herd, etc. Más información en Gentoo Metadata. La cantidad de información de utilidad dependerá de lo que decidan ofrecer los mantenedores del paquete. Sin opciones,  devuelve información básica que puede ser útil.

Cuando el mantenedor ofrece información extra, ésta puede ser de gran utilidad:

Conocer el tamaño de los paquetes con "size" (s)
¿Alguna vez ha tenido la curiosidad de averiguar cuánto espacio ocupa un paquete en particular?. Debido a que un paquete puede tener sus archivos repartidos en más de un directorio, puede que el habitual  no le proporcione una cifra correcta. No se preocupe, ¡ viene al rescate!

Como puede ver,  muestra el espacio total utilizado en unidades legibles por un humano así como el número total de ficheros que tiene el paquete. Para obtener el tamaño total en bytes, utilice.

Listar los ajustes USE para cada paquete con "uses" (u)
El módulo de    puede proporcionar información sobre los ajustes USE que están disponibles para un paquete en particular, y cuáles de esos ajustes están habilitados actualmente.

Aquí, algunos ajustes USE están habilitados en el plugin del metapaquete de, sin embargo, se puede comprobar que hay otros ajustes USE disponibles. Para más información sobre los ajustes USE, por favor, consulte el capítulo sobre los ajustes USE del Manual de Gentoo.

Buscar la ruta del ebuild con "which" (w)
El módulo  es un guión simple que le ayudará a encontrar rápidamente la ruta de un ebuild. Si se le pasa un nombre de paquete sin especificar la versión,  devolverá la ruta a la versión del ebuild más reciente que se puede instalar. En otras palabras, el ebuild que Portage usaría si escribiera  en la línea de comandos. Pásele un paquete con una versión específica para obtener la ruta a ese ebuild.

Finalmente, si ninguna de las características de  mencionadas arriba le es de utilidad, intente usar   para buscar manualmente un ebuild con programas como ,   o  :

Introducción
es una herramienta para ver, activar y desactivar los ajustes USE en varios lugares. Para más información acerca de los ajustes USE, por favor consulte el documento sobre los ajustes USE. Por favor, utilice  para ver la ayuda completa y todas las opciones.

Ver, activar y desactivar los ajustes USE
La orden  lee los ajustes USE actuales que están activos y los muestra.

Del mismo modo, puede usar la orden  para ver únicamente los ajustes USE globales que están activados. La orden  hace lo mismo para los ajustes USE locales activados. Las subopciones  y   de   requieren una opción anterior a ellas (como ) para funcionar correctamente.

También podemos usar  para activar o desactivar ajustes use. Las órdenes empleadas para ello son (activa un ajuste) y  (desactiva un ajuste).

Activar un ajuste USE:

El fichero tiene este aspecto después de ejecutar la orden:

Desactivar el ajuste USE:

De nuevo, el fichero después de la órden:

revdep-rebuild
Esta herramienta es el reconstructor de dependencias inversas de Gentoo. Realizará una búsqueda de todos los ebuilds instalados que no funcionen a causa de alguna actualización de un paquete del cual dependan. Puede hacer emerge de esos paquetes pero puede ocurrir que un paquete determinado ya no funcione con las dependencias actuales instaladas, en cuyo caso, debe actualizar el paquete que no funciona a una versión más reciente. La herramienta revdep-rebuild le pasará parámetros a emerge que le permiten hacer uso de  para ver de qué paquetes se va a hacer emerge de nuevo antes de proceder.

Si necesita reconstruir algunos paquetes, puede lanzar  sin el parámetro   y se hará emerge de nuevo de los paquetes listados.

glsa-check
es principalmente una herramienta de verificación que le sigue la pista a los diversos GLSAs (Advertencia de Seguridad de Gentoo Linux o Gentoo Linux Security Advisory) y que acabará por integrarse en  y.

eread
es una sencilla herramienta para visualizar ficheros elog creados por Portage a partir de la versión. Puede habilitar la grabación de ficheros elog definiendo un par de variables en :

Una vez ha configurado elog de la forma deseada, lance  para ver sus ficheros de registro.

Seleccione un número y el fichero se mostrará mediante el programa de paginación especificado en la variable de entorno PAGER. Si esta variable no está definida, se utilizará. La variable de entorno PAGER puede definirse utilizando  (módulo  ).

Una vez mostrado el elemento elog, se le preguntará si desea eliminar el fichero.

eclean
es una herramienta para eliminar ficheros fuente y paquetes antiguos de su sistema.

Cuando se construyen e instalan los paquetes, los ficheros fuente se descargan y conservan en DISTDIR, normalmente en el directorio. Esto puede acumular varios gigabytes de material a lo largo del tiempo si no se limpia periodicamente. Puede ejecutar  para limpiar únicamente los ficheros fuente de DISTDIR.

Puede crear archivos de los paquetes instalados usando  o FEATURES="buildpkg". Estos paquetes archivados se guardan en PKGDIR, normalmente en el directorio. Cuando no se necesitan más, o si son antiguos, puede ejecutar  para eliminarlos de PKGDIR. Es una buena forma de asegurarse de que tiene las últimas versiones de los paquetes binarios.

Para más información sobre  y los consejos sobre el mantenimiento de un sistema libre de código obsoleto, por favor, lea.

Agradecimientos
Nos gustaría dar las gracias a los siguientes autores y editores por sus contribuciones a esta guía:


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