Equery/pt-br

é uma ferramenta para tornar algumas operações comuns do Portage mais simples. Junto de outras operações, ela pode exibir dependências de pacotes, metadata, e arquivos instalados.

Emerge
Equery is part of a toolset installed with the package:

For information on installing or other tools visit the Gentoolkit article.

Introdução
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.

Abaixo está uma lista de funcionalidades que funcionam na maioria dos módulos.

Like, does not understand partial package names:

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

A maioria dos módulos do equery tem múltipla saída:

Alguns módulos também permitem totalmente expressões regulares:

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

Capacidades
Para uma lista de todas as capacidades do equery, apenas rode o seguinte comando sem argumentos:

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

Encontrando um pacote ao qual um arquivo pertence (b)
procura por arquivos correspondendo à uma expressão regular com a opção. A opção  para a busca ao encontrar um resultado correspondente. Como nenhum arquivo em seu sistema deve ser propriedade de dois pacotes, esta é uma otimização segura.

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

Visualizando entradas do ChangeLog com 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 integridade de pacotes com 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 os pacotes que dependem de outro com 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.

Um segundo exemplo lista todos os pacotes dependendo diretamente de udev:

Obtendo gráficos de dependências com depgraph (g)
é o oposto de. Ele irá encontrar todos os ebuilds dos quais um dado pacote depende (e não os ebuilds que dependem deste pacote). Quando ele encontra uma dependência, irá recursivamente buscar as dependências daquele pacote. Controle o quão a fundo a árvore consegue com a opção.

Reparou como  é uma dependência direta e   é uma dependência indireta se a USE flag   USE está definida?

Listando arquivos instalados por um pacote com 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.

Another example, to list all files installed by :

Descriptions of other modules and additional command line flags can be found in the equery man page.

Procurando por pacotes que tem uma USE flag específica com hasuse (h)
can be used to find packages with a given USE flag. will not indicate if the flag has been enabled or not; it simply outputs a list of ebuilds that have the queried flag as an option. See the EXAMPLES section of  in the  man page for more tip on getting this kind of information.

Listando pacotes com list (l)
é um módulo simples, porém poderoso para listar pacotes instalados da árvore do Portage ou de um overlay.

A consulta padrão irá buscar pacotes instalados para o nome de pacote informado. Passado com  exibe os pacotes no conjunto. No campo mais à esquerda é possível ver que todos os pacotes acima estão (nstalados) e oriundos da árvore do  (ortage). Eles não estão mascarados (o segundo campo está vazio), e todos estão instalados no slot padrão (0).

Use opções locais para buscar pacotes na árvore do Portage e overlays.

Neste é possível ver que a versão 7.2.182 está instalado e não há versões disponíveis de um overlay. Usuários podem ver quais versões estão mascaradas com  no segundo campo.

Visualizando metadata de pacotes com meta (m)
Each package in the Portage tree provides at least some metadata about its maintainer, etc. The amount of useful information depends on how much package maintainers decide to provide. With no options,  returns some basic useful information.

Alguns mantenedores fornecem informações extras sobre o pacote que podem ser úteis:

Encontrando tamanho de pacotes com 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 command might not give the correct figure. Not to worry, to the rescue!

Use  para exibir o espaço total usado em unidades legíveis e listar o número total de arquivos que um pacote possui. Para obter o tamanho total em bytes use.

Listando USE flags por pacote com 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.

Aqui está um número de USE flags ativas no pacote de plugins do gstreamer, mas pode ser visto que há outras USE flags disponíveis. Para mais informações sobre USE flags, consulte o capítulo USE Flags do Gentoo Handbook.

Encontrando o caminho dos ebuilds com 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 :

Veja também

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