User:Raraneda/wiki/Equery

equery es una herramienta para hacer muchas operaciones comunes de Portage en forma simple. Entre otras operaciones, puede desplegar dependencias de paquetes, metadata, y archivos instalados.

Instalación
En breve:

Equery es parte de un set de herramientas instalada con el paquete. Para información referente a como instalar equery u otra herramienta visita el articulo Gentoolkit.

Introducción
equery Es una herramienta que despliegue información bastante util sobre paquetes instalados en el sistema. equery está basado en un sistema modular. Cada módulo tiene un nombre abreviado. Por ejemplo, ejecutando equery l gcc es lo mismo que ejecutar equery list gcc. Invocando la opción  ( equery --help ) esta arrojará las opciones globales y listará todos los módulos disponibles con su correspondiente nombre abreviado. Agregando el nombre del módulo al final(equery --help module) se mostrará la ayuda específica para el modulo. Por último, ejecutando man equery también proporcionará una explicación detallada de todos los módulos y opciones disponibles, junto con algunos ejemplos útiles.

A continuación se muestra una lista de características que funcionan sobre la mayoría de los módulos.

Como emerge, equery no entiende los nombres parciales de los paquetes:

Por el contrario a emerge</tt>, equery</tt> puede aceptar formato de expansión de comodines (Globbing) tipo shell en la categoría y/o nombre del paquete:

Most equery modules take multiple input:

Algunos módulos también permiten expresiones regulares en forma completa:

Las siguientes secciones de este documento ofrecen una rápida introducción a los diferentes módulos de equery</tt>.

Capacidades
Para mirar una lista de todas las capacidades de equery, simplemente ejecútalo sin argumentos:

Alias
Un buen acercamiento para trabajar con equery</tt> es creando alias. Cuando usamos bash estas pueden ser incorporadas en el archivo :

Encontrando el paquete al cual pertenece un archivo con belongs (b)
Puede buscar por archivos en base a una expresión regular con la opción. La opción  para la búsqueda después de que encuentre la primera. Debido a que ningún archivo debe ser parte de dos paquetes esta opción se considera segura.

Una corta versión de   puede también ser usada. Por ejemplo, para listar el paquete al que pertenece equery</tt>:

Viendo los cambios en ChangeLog con changes (c)
Permite al usuario ver las entradas de ChangeLog para la versión de un paquete o un grupo de versiones. Imagine después de ejecutar emerge --sync</tt> Portage imprime un mensaje indicando que va a ser actualizado. Para ver que cambió puedes usar este comando:

Verificando la integridad de los paquetes con check (k)
A veces es muy util para verificar la integridad de los paquetes. equery</tt> puede verificar sumas MD5 así como las marcas de tiempo para indicar cuándo un paquete pudo haber sido corrompido, reemplazado o eliminado.

Listando todos los paquetes que dependen de un paquete específico con depends (d)
¿Alguna vez se preguntó por que un determinado paquete se instaló en el sistema? equery</tt> puede decir que paquetes y listarlos con. Incluye dependencias indirectas con la opción.

Un segundo ejemplo lista todos los paquetes dependiendo de udev:

Obtener gráficos de dependencia con depgraph (g)
es lo opuesto a. Este encontrará todos los ebuilds del que depende este paquete (no los ebuilds que dependan de este paquete). Cuando este encuentra una dependencia, este buscará recursivamente esas dependencias del paquete. Controla la profundidad del arbol con la opción.

Nota como  es una dependencia directa y   es una dependencia indirecta si el USE   es usado?

Listando archivos instalados por un paquete con files (f)
equery</tt> puede listar todos los archivos instalados por un ebuild con el módulo. Intenta  para obtener una fácil lectura del directorio. Usa  para solo encontrar un cierto tipo de archivo. Por ejemplo, para encontrar donde los ejecutables son instalados usa, o para rapidamente encontrar el lugar de los archivo de configuración intenta.

Otro ejemplo, para listar todos los módulos por ncmpcpp:

Descripciones de otros módulos y comandos adicionales pueden ser encontrados en el equery man page ( man equery ).

Looking for packages that have a specific USE flag with hasuse (h)
can be used to find packages with a given USE flag. will not indicate if the flag is enabled, only if the ebuild lists it as an option. See the EXAMPLES section of  in the equery</tt> man page for more tip on getting this kind of information.

Listing packages with list (l)
is a simple, yet powerful module to list packages that are installed, in the Portage tree or in an overlay.

The standard query will search installed packages for the given package name. Passing in  displays all packages in the set. In the leftmost field it is possible to see all the above packages are (nstalled) and from the  (ortage) tree. They are not masked (the second field is blank), and they are all installed in the default slot (0).

Use local options to look for packages in the Portage tree and overlays.

In this is it possible to see version 7.2.182 is installed and there are no versions available from an overlay. Users 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. The amount of useful information depends on how much package maintainers decide to provide. With no options,  returns some basic useful information.

Some maintainers provide extra information about the package which be very useful:

Finding package sizes with size (s)
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 du -hc</tt> command might not give the correct figure. Not to worry, equery</tt> to the rescue!

Using  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)
equery</tt>'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 gstreamer's plugin meta-package, but it can be seen 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 users quickly find the file path to an ebuild. If an unversioned package name is passed using  it will return the path to the newest installable ebuild version. In other words, it would return the ebuild Portage would use if emerge example/package</tt> was typed. also accepts a versioned package to get the path to that ebuild.

Lastly, if none of the above features of equery</tt> have provided an answer, try using  to manually search an ebuild with programs like cat</tt>, <tt>less</tt> or <tt>grep</tt>: