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 é parte de um conjunto de ferramentas instalado com o pacote :

Para informações sobre a instalação do ou outras ferramentas visite o artigo Gentoolkit.

Introdução
é uma ferramenta que exibe informações úteis sobre os pacotes instalados no sistema. é baseado num sistema de módulos. Todo módulo tem um nome curto. Por exemplo, rodar é o mesmo que rodar. Invocando a opção   irá mostrar opções globais e listar todos os módulos disponíveis e seus nomes curtos. Adicionar o nome de um módulo ao final irá mostrar a tela de ajuda para este módulo específico. Por último, rodar fornecerá também uma explicação detalhada de todos os módulos e opções disponíveis junto de alguns exemplos úteis.

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

Assim como o, não entende nomes parciais de pacotes:

Diferente do, aceita englobamento estilo shell no nome do pacote e/ou categoria:

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

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

As próximas seções neste documento darão uma introdução rápida aos diferentes módulos do.

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

Aliases
Uma abordagem comum ao trabalhar com o é criar aliases. Ao usar o bash eles normalmente são colocados no arquivo :

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.

Uma versão encurtada de   também pode ser usada. Por exemplo, para listar a qual pacote pertence:

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.