Equery/es

is a tool to make several common Portage operations simpler. Among other operations, it can display package dependencies, metadata, and installed files.

Emerge
En breve:

Equery is part of a toolset installed with the package. For information on installing or other tools visit the Gentoolkit article.

Introducción
is a tool that displays useful information about the installed packages on the system. is based on a system of modules. Every module has a shorthand name. For example, running is the same as running. Invoking the  option  will output global options and list all available modules and their shorthand names. Adding a module name to the end will display the help screen for that specific module. Lastly, executing will also provide a detailed explanation of all available modules and options along with some useful examples.

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

Like, does not understand partial package names:

Unlike, can accept shell-like globbing in the category and/or package name:

Muchos módulos de equery toman múltiples entradas:

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

The next few sections in this document give a quick introduction to the different modules.

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

Alias
A common approach to working with is to create aliases. When using bash these can usually be placed in the file:

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.

A short version of   can also be used. For example, to list what package belongs to:

Viendo los cambios en ChangeLog con changes (c)
lets the user view ChangeLog entries for a package version or range of versions. Imagine after running an Portage prints out a message saying it is going to be upgraded. To see what has changed this command can be used:

Verificando la integridad de los paquetes con check (k)
Sometimes it is useful to check a package's integrity. can verify MD5 sums as well as timestamps to indicate when a package might have been corrupted, replaced, or removed.

Listando todos los paquetes que dependen de un paquete específico con depends (d)
Ever wonder why a certain package has been installed on the system? can tell which packages list it as a dependency with. Include indirect dependencies with the  option.

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)
can list all the files installed by an ebuild with the  module. Try  to get an easy to read directory layout. Use  to only find a certain type of file. For example, to find where executables were installed use, or to quickly find the configuration file location try.

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

Buscando por paquetes que tengan un USE específico con 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  man page for more tip on getting this kind of information.

Listando paquetes con list (l)
es un simple, pero poderoso módulo para listar paquete que están instalados, en el árbol de Portage o en un overlay.

La consulta estándar buscará paquetes instalados para un nombre de paquete dado. Escribiendo el  mostrará todos los paquetes. En el campo de la izquierda is posible ver todos los paquetes que están (nstalados) y desde el arbol  (portage). No están masked (el segundo campos está en blanco), y todo están instalados en el espacio por defecto (0).

Use opción local para mirar paquetes en el árbol de Portage y overlays.

En este es posible mirar que la versión 7.2.182 está instalada y no hay versiones disponibles de un overlay. Usuarios pueden ver que versiones están enmascaradas por el   en el segundo campo.

Viendo la metadata de los paquetes con meta (m)
Cada paquete en el árbol de Portage provee al menos algún metadata acerca del mantenedor, grupo, etc. La cantidad de información util depende de lo que decidan proveer los mantenedores del paquete. Sin opciones,  imprime el espacio total usado en unidades legible por humanos y lista el número total  de archivos que tiene el paquete. Para obtener el tamaño total en bytes usa.

Listando por-paquetes los parámetros USE con 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.

Aquí un número de parámetros USE que están habilitados en un meta-paquete del plugin de gstreamer, pero se puede ver que hay otros parámetros USE disponible. Para más información sobre los parámetros USE, por favor dirígete al capítulo USE Flags del Gentoo Handbook.

Encontrando la ruta del ebuild con 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 was typed. also accepts a versioned package to get the path to that ebuild.

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

Vea también

 * Q applets - A collection of small and fast Portage helper tools written in C.
 * eix - A set of utilities for searching and diffing the local Portage tree and overlays using a binary cache.
 * Gentoolkit - A suite of tools to ease the administration of a Gentoo system.